FintwinDeveloper Portal
Ctrl K
Đăng nhập

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

Xác nhận liên kết

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

Xác nhận OTP để hoàn tất liên kết và nhận resourceId.

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.
comCodeBắt buộcMã doanh nghiệp.
bankCodeBắt buộcMã ngân hàng.
sourceNumberBắt buộcSố tài khoản.
attemptIdBắt buộcattemptId từ bước liên kết.
otpBắt buộcOTP.

Mã mẫu

curl -X POST 'https://sandbox.example.invalid/api/v1/end_user_topup/confirm-topup' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"clientMessageId":"MSG-TEST-002","comCode":"TEST0001","bankCode":"970422","sourceNumber":"000000000000TEST","attemptId":"ATT-TEST-001","otp":"000000"}'