Create C2C / C2B International Transfer

POST 
/v2/international-disbursement

Important Notice - Transaction ID Format Change

Action Required by June 20, 2026

The International Transfer transaction ID format will change from Integer to BigInteger (18-digit format) on June 20, 2026.

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 18-digit numbers — use json-bigint or treat IDs as strings.

Read the full announcement →

An endpoint to create the international transfer C2C/C2B transaction.

Request

Responses

200

Create International Disbursement response

401

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

422

Sample error response

Callbacks

POST createInternationalDisbursementCallback

POST 
/your-callback-url

International transfer callback will be sent to you if you transaction status is changed. Please make sure that you have set the International Transfer 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).