Account linking

Query link

POST/api/v1/end_user_topup/get-link

Authorization + signatureFirm banking

Queries link state by attempt or resource.

This API needs a Signature header. The portal signs when that company code has a signing key configured. Without it, the sandbox receives the request unsigned.

Headers

Fields	Description
`Content-Type`Required	application/json
`Authorization`Required	Authorization key Fintwin issues for the company code.
`Signature`Required	Body integrity signature. The signing key is issued with the API key.
`Timestamp`Required	Request time.

Body

Fields	Description
`clientMessageId`Required	Message id.
`comCode`Required	Enterprise code.
`bankCode`Required	Bank code.
`query_type`Required	Query mode.
`id`Required	attemptId or resourceId.

Samples

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"}'