Create Fiat Withdrawal

API Overview

Item	Value
API Status	Stable
Current Version	v2.0
Backward Compatibility	Yes
Applicable Environment	Production
Applicable User Roles	PSP and Direct Client

Description
Submit withdrawal request.
About missingFields please refer to here

About the amount field
The amount field represents different values in the request and response depending on how fees are charged. Please read carefully before integrating.
Fee charging behavior

First-party withdrawal (withdrawalType=1): fees are charged internally — deducted from the amount you submit. The recipient receives less than the requested amount.
Third-party withdrawal (withdrawalType=2): fees are charged externally — added on top of the amount you submit. The total amount deducted from your account exceeds the requested amount.

amount in the request
Withdrawal TypeMeaning of amountFirst-party (internal fee)Gross amount: total to be deducted from your account, including fees.Third-party (external fee)Net amount: amount the recipient will receive, excluding fees.
amount in the response
In both withdrawal types, the response amount represents the gross amount — the total deducted from your account, including fees. It always satisfies:
amount (response) = fees + estimatedAmountReceivable
⚠️ Important compatibility note
For third-party withdrawals, the value of amount is not the same in the request and the response:

Request amount = net (receivable) amount
Response amount = gross (deducted) amount

Request

Authorization

Body Params application/json

Example

{
    "participantCode": "B0100106",
    "requireSameNamePayout": true,
    "withdrawalType": 1,
    "currency": "USD",
    "amount": "339.97",
    "swiftChargingCode": 1,
    "to": "US12345678901234567890",
    "paymentReference": "PAY-20260415-001",
    "clientReference": "REF202604150008",
    "bankInfo": {
        "type": 1,
        "typeOfThirdParty": 2,
        "corporateCountryCode": "US",
        "label": "Business Withdrawal Account",
        "bankAccountNumber": "US98765432109876543210",
        "swiftCode": "CHASUS33",
        "bankName": "JPMorgan Chase Bank",
        "bankAddress": "270 Park Avenue",
        "bankCountry": "US",
        "bankState": "NY",
        "bankCity": "New York",
        "postCode": "10017",
        "routingNumber": "021000021",
        "intermediaryBank": [
            {
                "currency": "USD",
                "swiftCode": "IRVTUS3N",
                "bankName": "The Bank of New York Mellon",
                "bankAddress": "225 Liberty Street",
                "bankCountry": "US"
            }
        ],
        "relationship": "Subsidiary",
        "beneficiaryOfThirdParty": {
            "name": "Scott Rippin",
            "email": "scott.rippin@example.com",
            "addressInfo": {
                "country": "US",
                "state": "Utah",
                "city": "Salt Lake City",
                "postCode": "84101",
                "addressLine1": "123 Main Street",
                "addressLine2": "Suite 400"
            }
        }
    },
    "purposeOfTransaction": "withdrawal",
    "proofFile": "550e8400-e29b-41d4-a716-446655440000",
    "idorPassportFile": "660e8400-e29b-41d4-a716-446655440001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "fiatWithdrawalId": "WD2026041514300001",
        "participantCode": "B0100106",
        "requireSameNamePayout": false,
        "withdrawalType": 1,
        "currency": "USD",
        "amount": "517.19",
        "fees": "15.00",
        "swiftChargingCode": 3,
        "estimatedAmountReceivable": "502.19",
        "to": "US12345678901234567890",
        "paymentReference": "PAY-20260415-002",
        "clientReference": "REF202604150009",
        "bankInfo": {
            "label": "Business Withdrawal Account",
            "bankAccountNumber": "US98765432109876543210"
        },
        "purposeOfTransaction": "invoice",
        "proofFile": "550e8400-e29b-41d4-a716-446655440000",
        "idorPassportFile": "660e8400-e29b-41d4-a716-446655440001",
        "status": 2,
        "statusInfo": "PROCESSING",
        "missingFields": [
            "documents.boardResolution",
            "highRiskCountries"
        ],
        "createdAt": 1776046508000,
        "updatedAt": 1776132908000
    }
}