FintwinDeveloper Portal
Ctrl K
Đăng nhập

Liên kết tài khoản

Bắt đầu liên kết

POST/api/v1/end_user_topup/link-topup
Authorization + chữ kýFirm banking

Bắt đầu liên kết tài khoản thanh toán bằng SMS OTP hoặc App-to-App.

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ườngMô tả
Content-TypeBắt buộcapplication/json
AuthorizationBắt buộcAuthorization key Fintwin cấp cho company code.
SignatureBắt buộcChữ ký toàn vẹn body. Khóa ký cấp cùng đợt với key.
TimestampBắt buộcThời điểm gửi yêu cầu.

Body

TrườngMô tả
clientMessageIdBắt buộcMã thông điệp duy nhất.
companyRefBắt buộcMã tham chiếu phía doanh nghiệp.
comCodeBắt buộcMã doanh nghiệp.
bankCodeBắt buộcMã ngân hàng.
linkTypeBắt buộcHình thức liên kết.
sourceNumberBắt buộcSố tài khoản nguồn.
customerCodeBắt buộcMã khách hàng.
customerInfoBắt buộcname, personalId, phoneNumber, releaseDate.

Mã mẫu

curl -X POST 'https://sandbox.example.invalid/api/v1/end_user_topup/link-topup' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"clientMessageId":"MSG-TEST-001","companyRef":"REF-TEST-001","comCode":"TEST0001","bankCode":"970422","linkType":"SMS_OTP","sourceNumber":"000000000000TEST","customerCode":"CUS-TEST-001","customerInfo":{"name":"NGUYEN VAN TEST","personalId":"000000000000","phoneNumber":"0900000000","releaseDate":"20200101","email":"test.user@example.invalid"}}'