Create Disbursement
POST/v3/disbursement
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.
This API is used to create a common disbursement transaction. For company operating as a Money Transfer Company (Perusahaan Transfer Dana), or anything related to that, please use Create Special Money Transfer V3 endpoint instead
Request
Responses
- 200
- 401
- 422
Expected Response
Sample response when Your Flip api secret key value for Authorization is missing or invalid
Sample error response
Callbacks
- POST createDisbursementCallback
POST/your-callback-url
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).