Chi hộ

Chuyển tiền đơn

POST/api/v1/cms_1100

Authorization + chữ kýFirm banking

Chuyển tiền từ tài khoản doanh nghiệp tới tài khoản người nhận. Chi hộ theo lô chưa có path riêng trên cổng này.

API này cần header Signature. Cổng ký khi đã cấu hình khóa của company code. Chưa có khóa thì sandbox nhận request không kèm chữ ký.

Header

Trường	Mô tả
`Content-Type`Bắt buộc	application/json
`Authorization`Bắt buộc	Authorization key Fintwin cấp cho company code.
`Signature`Bắt buộc	Chữ ký toàn vẹn body. Khóa ký cấp cùng đợt với key.

Body

Trường	Mô tả
`REQ_DATA.TRT_INST_CD`Bắt buộc	Mã tổ chức do Fintwin cấp. Ví dụ dùng TEST0001.
`REQ_DATA.TRSC_DT`Bắt buộc	Ngày giao dịch, định dạng YYYYMMDD.
`REQ_DATA.TRSC_SEQ_NO`Bắt buộc	Số thứ tự duy nhất trong ngày. Gửi lại cùng số không tạo giao dịch mới.
`REQ_DATA.TRSC_AMT`Bắt buộc	Số tiền.
`REQ_DATA.RCV_BNK_CD`Bắt buộc	Mã NAPAS ngân hàng nhận.
`REQ_DATA.ACCT_NO`Bắt buộc	Số tài khoản nhận.
`REQ_DATA.RCV_ACCT_NM`Bắt buộc	Tên tài khoản nhận.
`REQ_DATA.WDRW_BNK_CD`Bắt buộc	Mã NAPAS ngân hàng trích.
`REQ_DATA.SERVICE_TYPE`Bắt buộc	00 nội bộ, 02 CITAD, 03 NAPAS.
`REQ_DATA.REMARK`Bắt buộc	Nội dung chuyển tiền.
`REQ_DATA.RCV_ACCT_DV_CD`Tùy chọn	00 số tài khoản, 01 số thẻ.
`REQ_DATA.WDRW_ACCT_NO`Tùy chọn	Số tài khoản trích.
`REQ_DATA.WDRW_ACCT_NM`Tùy chọn	Tên tài khoản trích.

Mã mẫu

curl -X POST 'https://sandbox.example.invalid/api/v1/cms_1100' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"REQ_DATA":{"TRT_INST_CD":"TEST0001","TRSC_DT":"20261014","TRSC_SEQ_NO":"0000100","TRSC_AMT":"10000","RCV_BNK_CD":"970422","ACCT_NO":"000000000000TEST","RCV_ACCT_NM":"NGUYEN VAN TEST","WDRW_BNK_CD":"970422","SERVICE_TYPE":"03","REMARK":"TEST PORTAL"}}'