Exchange withdrawal
Need to cash out? It’s easier than ever! 💸 Simply request a withdrawal in cryptocurrency, and the system will seamlessly convert it to euros. Your money arrives quickly on your card at the best available rate!
Exchange withdrawal is a process, which consists of two steps:
- exchange money from one of your wallets to another
- withdrawal - transferring money from your wallet to your customer.
Looking for something?Feel free to contact us if you are looking for some other options.
Request
For standard request withdrawal (withdrawal) adds param "walletCurrency"(*). Which indicates the currency of the wallet for automatic exchange.
{"merchantOrderId": "payout-1743577103","amount": "10","currency": "usd","counterparty": {"type": "cardNumber","number": "4111111111111111"},"walletCurrency": "eur","webhookUrl": "https://webhook.site/#!/view/f2708f89-ea72-4dae-874a-5d9a0469edcd","description": "payout usd card exchange from eur"}
*(*) - Before integration, agree on the terms with your Account Manager
Response
{"data": {# An identifier of the order on our side"id": "e484b953-9e9f-4cc7-959a-53e3a65b99d8",# Provided identifier"merchantOrderId": "payout-1743573135",# Type of order"type": "exchange_payout","createdAt": "2025-04-02T05:52:17+00:00",# Status of order"status": "new"},"error": null}
Errors list
Code | Description |
---|---|
INVALID_DATA | Invalid request data. Check json syntax |
VALIDATION | Validation error. See error.validationErrors for details |
METHOD_NOT_FOUND | Endpoint not found |
INVALID_HTTP_METHOD | Only POST method allowed |
AUTHENTICATION_FAILED | Check your api token |
ORDER_ALREADY_EXISTS | Order with same merchantOrderId already exists |
ORDER_NOT_FOUND | Specified order was not found |
REJECTED_DUE_TO_TECHNICAL_ISSUE | Rejected due to technical issue |
REQUEST_FROM_UNTRUSTED_SOURCE | Request from untrusted source (ip not allowed) |
PAYIN_DISABLED | Payment disabled. Contact us to enable |
PAYOUT_DISABLED | Withdrawal disabled. Contact support to enable |
WALLET_NOT_FOUND | Wallet not found. Contact support to enable wallet |
WALLET_INACTIVE | Wallet inactive. Contact support to enable wallet |
ROUTING_NOT_CONFIGURED | Routing not configured. Please contact us for details |
POINT_NOT_FOUND | There is no way to process transaction. If issue is persistent please contact us for additional details |
AMOUNT_GREATER_THAN_ALLOWED | Operation amount greater than allowed |
AMOUNT_LESS_THAN_ALLOWED | Operation amount less than allowed |
NOT_ENOUGH_BALANCE | Operation amount greater than available balance |
OPERATION_NOT_SUPPORTED | Operation not supported |
REFERER_REQUEST_DOES_NOT_MATCH_ALLOWED_SOURCES | Referer from request does not match user hosts. Please contact us if you have any questions. |
UNKNOWN | Unknown error |
Order Status
Refer to the Status & Webhook section for generic guidance.
The new
order status means that the order has not yet been processed.
This status is not final and will change.
{"data": {"id": "132bad65-843e-4fda-874a-11220bd4fc6b","merchantOrderId": "payout-1743592268","type": "exchange_payout","createdAt": "2025-04-02T11:11:08+00:00","status": "new","subStatus": null,"merchantSourceWallet": {"amount": "9.09","currency": "eur"},"merchantTargetWallet": null,"transactions": [{"type": "exchange","id": "ae66a12e-693d-4500-a208-acf55030ce07","status": "completed","merchantSourceWallet": {"amount": "9.09","currency": "eur"},"merchantTargetWallet": {"amount": "10","currency": "usd"},"createdAt": "2025-04-02T11:11:08+00:00","completedAt": "2025-04-02T11:11:08+00:00"},{"type": "payout","id": "833c2512-551a-4341-90a1-a88dafe48870","status": "new","merchantWallet": {"amount": "10","currency": "usd"},"paidOut": {"amount": "10","currency": "usd"},"counterpartyInfo": {"type": "card","mask": "411111******1111","binInfo": {"brand": "VISA","issuerName": "JPMORGAN CHASE BANK, N.A.","country": "USA"}},"paymentInfo": null,"createdAt": "2025-04-02T11:11:08+00:00","completedAt": null,"rejectReason": null}]},"error": null}