Ủy quyền trích nợ

Đăng ký ủy quyền

POST/api/v1/end-user/autodebit-register
Authorization + AESFirm banking

Bắt đầu đăng ký trích nợ. Trên đường truyền, body là { data } đã mã hóa AES. Tài liệu này mô tả payload nghiệp vụ trước khi mã hóa.

Sandbox nhận { data } mã hóa AES-256-CBC (PKCS7, base64). Key dài 32 byte và vector dài 16 byte, cả hai là UTF-8. Try mã hóa payload trên form trong trình duyệt rồi gửi. Key không rời máy bạn.

Header

TrườngMô tả
Content-TypeBắt buộcapplication/json
AuthorizationBắt buộcAuthorization key Fintwin cấp cho company code.

Body

TrườngMô tả
com_cdBắt buộcMã doanh nghiệp.
bank_cdBắt buộcMã NAPAS ngân hàng nguồn.
contract_idBắt buộcMã hợp đồng phía doanh nghiệp.
cusTypeBắt buộcCA_NHAN hoặc DOANH_NGHIEP.
nationalIdBắt buộcSố định danh cá nhân dạng thử nghiệm.
registrationNumberBắt buộcSố đăng ký doanh nghiệp khi cusType là doanh nghiệp.
sourceNumberBắt buộcSố tài khoản nguồn.
sourceNameBắt buộcTên chủ tài khoản.
phoneNumberBắt buộcSố điện thoại nhận OTP.
emailTùy chọnEmail nhận thông tin.

Mã mẫu

curl -X POST 'https://sandbox.example.invalid/api/v1/end-user/autodebit-register' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"data":"<base64 AES-256-CBC of the business JSON>"}'