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

2026-07-07 Update

Request Body Additions

amountType (integer, required) — 1=Debit (gross debit amount), 2=Receive (net received amount). Backward Compatibility: when not provided by callers not yet upgraded, the backend falls back on withdrawalType (first-party → Debit, third-party → Receive), matching legacy behavior. New integrations must provide this field.

feeBearer (integer, optional, default=1) — 1=Customer (borne by trading party), 2=Partner (borne by platform partner). Default behavior is unchanged.

Modified Fields

amount — meaning now depends on amountType (previously relied on implicit withdrawalType convention). See field description for details.

Response Data Additions

amountType, feeBearer (echoed from request)

debitAmount (string) — gross debit amount

feeAmount (string) — platform fee (alias for legacy field fees)

feeCurrency (string) — fee currency

receivedAmount (string) — net amount received by payee (alias for legacy field estimatedAmountReceivable)

Legacy Fields Retained as Aliases: fees ≡ feeAmount, estimatedAmountReceivable ≡ receivedAmount.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

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
    }
}