Create Special Money Transfer
POST/v3/special-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.
Special Money Transfer is a type of disbursement for a company with PJP (Penyedia Jasa Pembayaran) license, operating as a Money Transfer Company (Perusahaan Transfer Dana). While in Money Transfer disbursement the original sender is the company, in Special Money Transfer the original sender is the company’s user.
Request
Responses
- 200
- 401
- 422
Create Special Disbursement Response
Sample response when Your Flip api secret key value for Authorization is missing or invalid
Sample error response
Callbacks
- POST createSpecialDisbursementCallback
POST/your-callback-url
Special 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 Special 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).