Create B2C / B2B International Transfer

POST 
/v2/international-disbursement/create-with-attachment

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 B2C/B2B transaction.

Request

Responses

200

Create B2B International Disbursement response

401

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

422

Sample error response