Create Crypto 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
Create Crypto Withdrawal Request

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 beneficiaryWallet ownership (first-party wallet → Debit, third-party wallet → 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

receivedAmount (string) — net amount received by payee

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",
    "currency": "USD",
    "amount": "420.45",
    "beneficiaryWalletLabel": "Ethereum Deposit Wallet",
    "purposeOfPayment": 7,
    "otherPurpose": "Cross-border trading settlement",
    "relationshipWithThirdParty": 8,
    "otherRelationship": "Business Partner",
    "fileProofOfTransfer": "550e8400-e29b-41d4-a716-446655440000",
    "fileIDOrPassport": "660e8400-e29b-41d4-a716-446655440001",
    "filePurposeOfRecurring": "770e8400-e29b-41d4-a716-446655440002"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "cryptoWithdrawalId": "WD2026072000290001",
        "withdrawalType": 1,
        "participantCode": "B0100348",
        "txHash": null,
        "currency": "USDT",
        "feeCurrency": null,
        "amount": "50.000000",
        "feeAmount": "3.000000",
        "debitAmount": "50.000000",
        "receivedAmount": "47.000000",
        "amountType": 1,
        "feeBearer": 1,
        "status": 1,
        "statusInfo": null,
        "beneficiaryWallet": {
            "blockchain": "ETH",
            "label": "usdt-out",
            "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7",
            "walletType": 1,
            "isOwner": true,
            "ownerInfo": {
                "details": {}
            }
        },
        "purposeOfPayment": 8,
        "otherPurpose": null,
        "relationshipWithThirdParty": 7,
        "otherRelationship": null,
        "fileProofOfTransfer": null,
        "fileIDOrPassport": null,
        "filePurposeOfRecurring": null,
        "kytInfo": {
            "kytType": 2,
            "kytResult": 1,
            "kytDetails": null
        },
        "createdAt": 1784478549000,
        "updatedAt": 1784478549000,
        "clientReference": null
    }
}