Batch debit

Upload batch file

POST/api/v1/batch-file/cms_upload_batch_request

Authorization + signatureFirm bankingSchema in review

Uploads a multipart batch file in field file, with header x-file-size. Portal Try accepts only a sample file description.

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.

Body

Fields	Description
`fileName`Required	Sample file name.

Samples

curl -X POST 'https://sandbox.example.invalid/api/v1/batch-file/cms_upload_batch_request' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"fileName":"batch-TEST.txt"}'