Exchange withdrawal

Хочете вивести свої кошти у фіат? Це простіше, ніж будь-коли! 💸 Просто ініціюйте виведення у криптовалюті – і система автоматично конвертує її у євро. Гроші швидко надходять на вашу картку за найвигіднішим курсом.

Обмін з виплатою (Exchange withdrawal) проходить у 2 кроки:

exchange - Обмін потрібної суми з одного гаманця в інший
withdrawal - Виплата з вашого гаманця вашому клієнту.

Looking for something?
Feel free to contact us if you are looking for some other options.

Request

До стандартного запиту на виплату (withdrawal) додається параметр "walletCurrency"(*), який вказує, з якого гаманця потрібно зробити автоматичний обмін. Таким чином currency буде вказувати, в якій валюті клієнт отримає кошти, а walletCurrency - валюту, в якій кошти будуть списані з мерчанта

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

*
(*) - Перед інтеграцією погодьте умови з вашим Аккаунт менеджером

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

Посилання на Status & Webhook розділ основного мануалу.

New

Processing

Completed

Rejected

Оrder status new означає що ми взяли в систему але ордер чекає щоб піти в процесінг.

Це не фінальний статус і буде змінений.

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