Send crypto payout with conversion
POST/api/withdrawal/crypto-external
Creates a withdrawal to an external crypto destination with currency exchange and returns the created transaction.
Use this method to pay out crypto to an external wallet from a balance in another currency, for example USDT from your USD wallet. The conversion is part of the payout. To pay out from a balance in the same currency, use Send crypto payout.
- Send the same body to Check crypto payout with conversion first: it checks the request without creating a transaction.
actiondefines which sideamountrefers to: withGIVEit is what leaves your wallet, withGETwhat the recipient receives. To see the rate first, use Get exchange rate.- Every request that passes validation creates a new transaction, even if it repeats an earlier one. After a timeout, check Get transaction history before you send it again.
- For networks that need a destination tag or memo, pass it in
address.memo. A blockchain transaction cannot be reversed.
Step by step: Payout method 3: Send crypto payouts with conversion.
Request
- application/json
- Body
- Example
Bodyrequired
External crypto withdrawal creation payload.
Src Wallet Id.
USD123456789012Amount.
Possible values: >= 0
10.25Action.
Possible values: [GIVE, GET]
GIVENote.
Possible values: <= 255 characters
Sandbox transfer noteDest Currency.
Possible values: [BTC, ETH, SOL, TRX, XRP, TON, LTC, AVAX, BNB, POL, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, USDT_TON, USDC, USDC_ERC20, USDC_BEP20, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
USDaddress objectrequired
Merchant Crypto Address schema.
Address.
test-valueMemo.
test-valuereceiverInfo object
Merchant Receiver Info schema.
First Name.
Possible values: <= 30 characters
LeoLast Name.
Possible values: <= 30 characters
PeoDate Of Birth.
30/01/1991Company Name.
Possible values: >= 3 characters and <= 100 characters
PotterCompanySrc Currency.
Possible values: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
USD{
"srcWalletId": "USD123456789012",
"amount": 10.25,
"action": "GIVE",
"note": "Sandbox transfer note",
"destCurrency": "BTC",
"address": {
"address": "TLxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"memo": null
},
"receiverInfo": {
"firstName": "Leo",
"lastName": "Peo",
},
"srcCurrency": "USD"
}
Responses
- 200
- 400
- 401
- 404
- 500
OK
- application/json
- Schema
- Example
Schema
Transaction Id.
11111111-1111-4111-8111-111111111111Payment Method Type.
Possible values: [INTERNAL_OWN, INTERNAL_OTHERS, INTERNAL_SCI, CRYPTOWALLET, CRYPTO_EXTERNAL, BALANCE_ADJUSTMENT, CURRENCY_EXCHANGE_ADJUSTMENT, SYSTEM_PAYMENT, BANK_CARD_TEST_PAYMENT, SYSTEM_BONUS, USER_SUBSCRIPTION, BANK_CARD, BANK_CARD_LIMITED, BANK_CARD_EXTENDED, APPLE_PAY_CRYPTO, GOOGLE_PAY_CRYPTO, VISA, VISA_EXTENDED, VISA_LIMITED, MASTERCARD, MASTERCARD_EXTENDED, MASTERCARD_LIMITED, AMERICAN_EXPRESS, DINERS_CLUB, DISCOVER, INSTAPAYMENT, JCB, LASER, MAESTRO, MIR, YANDEX_MONEY, SWIFT, SEPA, SWIFT_EUR, LOCAL_BANK_TRANSFER, EPS_LOCAL_BANK_TRANSFER, EPS_SWIFT, EPS_CIPS, EPS_FPS, EPS_BANK_CARD_RU, CRYPTO_COLLECTION, CARD_PROGRAM_ISSUE_PAYMENT, CARD_PROGRAM_DELIVERY_PAYMENT, CARD_PROGRAM_VIEW_PIN_PAYMENT, CARD_PROGRAM_MONTHLY_FEE, CARD_PROGRAM_YEARLY_FEE, CARD_PROGRAM_REACTIVATION_FEE, CARD_PROGRAM, GLOBAL_PLUS, EUROPE_VISA_PLASTIC, EUROPE_VISA_VIRTUAL, EUROPE_MC_PLASTIC, EUROPE_MC_VIRTUAL, APAC_MC_PLASTIC, DIGITAL]
INTERNAL_OWNTransaction Type.
Possible values: [DEPOSIT, INTERNAL_TRANSFER_OTHER, INTERNAL_TRANSFER_OWN, SMS_DELIVERY_PAYMENT, ADDITIONAL_COMMISSION, SYSTEM_PAYMENT, WITHDRAWAL, REFUND]
DEPOSITStatus.
Possible values: [PENDING, COMPLETED, CANCELED, REFUNDED]
COMPLETEDDirection.
Possible values: [DEPOSIT, WITHDRAWAL]
DEPOSITTransaction direction.
Possible values: [INCOMING, OUTGOING, EXCHANGE]
OUTGOINGCurrency.
Possible values: [USD, EUR, BTC, BNB, BNB_BEP20, BNB_BEP2, BNB_ERC20, BCH, DAI, DOGE, DOGE_DOGENT, DOGE_BEP2, DOGE_BEP20, ETH, LTC, USDP, XRP, SHIB, SHIB_BEP20, SHIB_ERC20, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, TUSD, USDC, USDC_ERC20, USDC_BEP20, USDC_BEP2, ZEC, BUSD, BUSD_BEP20, BUSD_ERC20, BUSD_TRC20, TON, SOL, ADA, AVAX, DOT, LINK, NEAR, POL, DASH, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
USDAmount.
10.25Created At.
Payment Scope.
Possible values: [PERSONAL, BUSINESS, MERCHANT_API, PAYMENT_GATEWAY]
PERSONALOrder Id.
ORDER_123456Wallet Src Id.
USD123456789012Wallet Dest Id.
USD123456789012Full Commission.
10.25Comment.
Sandbox transfer noteCrypto Currency Tx Hash.
4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5eCompleted At.
{
"transactionId": "11111111-1111-4111-8111-111111111111",
"paymentMethodType": "CRYPTO_EXTERNAL",
"transactionType": "WITHDRAWAL",
"status": "CREATED",
"direction": "WITHDRAWAL",
"transactionDirection": "OUTGOING",
"currency": "USD",
"amount": 10.25,
"createdAt": "2026-01-15T10:30:00",
"paymentScope": "PERSONAL",
"orderId": "ORDER_123456",
"walletSrcId": "USD123456789012",
"walletDestId": "USD123456789012",
"fullCommission": 10.25,
"comment": "Sandbox transfer note",
"cryptoCurrencyTxHash": "4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e",
"completedAt": "2026-01-15T10:30:00"
}
Bad request. The request is malformed or contains invalid parameters.
- application/json
- Schema
- Example
Schema
- Array [
- ]
Response status.
Possible values: [error]
errordata objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Stable machine-readable error code.
disabledError category.
FORMShort unique error identifier for support and logs.
errTest1234Human-readable error description.
REQUESTED OPERATION IS DISABLED FOR THE MERCHANT APIRequest field related to the error, if any.
nullAdditional error parameters.
Request parameters captured for diagnostics.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "disabled",
"errorType": "FORM",
"errorId": "errTest1234",
"errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}
Unauthorized. Merchant authentication headers are missing or invalid.
- application/json
- Schema
- Example
Schema
- Array [
- ]
Response status.
Possible values: [error]
errordata objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Stable machine-readable error code.
userDoesNotExistExceptionError category.
GENERALShort unique error identifier for support and logs.
errTest1234Human-readable error description.
NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]Request field related to the error, if any.
nullAdditional error parameters.
Request parameters captured for diagnostics.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "userDoesNotExistException",
"errorType": "GENERAL",
"errorId": "errTest1234",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}
Not found. The requested resource does not exist.
- application/json
- Schema
- Example
Schema
- Array [
- ]
Response status.
Possible values: [error]
errordata objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Stable machine-readable error code.
resourceNotFoundError category.
GENERALShort unique error identifier for support and logs.
errTest1234Human-readable error description.
Resource not foundRequest field related to the error, if any.
nullAdditional error parameters.
Request parameters captured for diagnostics.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "resourceNotFound",
"errorType": "GENERAL",
"errorId": "errTest1234",
"errorDescription": "Resource not found",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}
Internal server error. Unexpected error please contact support
- application/json
- Schema
- Example
Schema
- Array [
- ]
Response status.
Possible values: [error]
errordata objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Stable machine-readable error code.
internalServerErrorError category.
GENERALShort unique error identifier for support and logs.
errTest1234Human-readable error description.
Internal server errorRequest field related to the error, if any.
nullAdditional error parameters.
Request parameters captured for diagnostics.
{
"status": "error",
"data": {
"errors": [
{
"errorMessage": "internalServerError",
"errorType": "GENERAL",
"errorId": "errTest1234",
"errorDescription": "Internal server error",
"errorField": null,
"params": [],
"requestParams": {}
}
]
}
}