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

Hỏi trạng thái liên kết

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

Hỏi trạng thái liên kết theo attempt hoặc resource.

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.
query_typeBắt buộcCách truy vấn.
idBắt buộcattemptId hoặc resourceId.

Mã mẫu

curl -X POST 'https://sandbox.example.invalid/api/v1/end_user_topup/get-link' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"clientMessageId":"MSG-TEST-004","comCode":"TEST0001","bankCode":"970422","query_type":"RESOURCE","id":"RES-TEST-001"}'