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.

RESPONSE

{
  "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

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.

New

Processing

Completed

Rejected

The new order status means that the order has not yet been processed.

This status is not final and will change.

RESPONSE

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

Exchange withdrawal

Request

Response

Errors list

Order Status

Are there any inquiries still outstanding?

Exchange withdrawal