Create Agent Disbursement

POST 
/v2/agent-disbursements

Important Notice - Transaction ID Format Change

Action Required by December 8, 2025

The Money Transfer transaction ID format will change from Integer to BigInteger (19-digit format) on December 8, 2025.

Ensure your system stores transaction IDs as BigInteger or String to prevent data truncation and integration issues. JavaScript / TypeScript / Node.js users: default JSON.parse() silently rounds 19-digit numbers — use json-bigint or treat IDs as strings.

Read the full announcement →

This is the endpoint for creating disbursement for Agent that has been verified.

Request

Responses

200

Create Special Disbursement Response

401

Sample response when Your Flip api secret key value for Authorization is missing or invalid

404

Response when the agent Id is invalid

422

Sample error response

Callbacks

POST createAgentDisbursementCallback

POST 
/your-callback-url

Agent Disbursement callback will be sent to you if you transaction status is changed to DONE or CANCELLED. This callback is used for the V2 and V3 Disbursement. Please make sure that you have set the Transaction callback URL on the Flip for Business dashboard.

Callbacks Responses

200

URL must return a 200 HTTP Status Code. If the URL returns another HTTP Status Code or if our system doesn’t receive any response within 30 seconds (timeout), our system will retry the request 5 times, with a 2-minute interval for the transaction callback (Money Transfer, Accept Payment, International Transfer).