Create Fiat Withdrawal

POST

/v2.0/payment/fiat/createWithdrawal

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.

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

curl --location --request POST '/v2.0/payment/fiat/createWithdrawal' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
}'

Responses

🟢200OK

application/json

Body

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

Modified at 2026-04-15 03:56:48

Activate Same Name Withdrawal Webhook

Submit Additional Information for Fiat Withdrawal Request