Linked-account payment

Initiate payment

POST/api/v1/topups/initiate-topup

Authorization + signatureFirm bankingSchema in review

Initiates a payment with a linked account. The body schema is still being added from the backend. After sign-in, Try sends the form body to the sandbox.

The detailed schema is still being confirmed. After sign-in, Try still sends the form body to the sandbox.

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	Unique message id.
`comCode`Required	Enterprise code.

Samples

curl -X POST 'https://sandbox.example.invalid/api/v1/topups/initiate-topup' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"clientMessageId":"PAY-TEST-001","comCode":"TEST0001"}'