Payment with exchange

Top up your account in euros – and let the system handle the rest! 🚀 Your funds are instantly converted into cryptocurrency and credited to your balance. No extra steps – just a great exchange rate and fast processing!

Payment with exchange is a process, which consists of two steps:

  • payment customer make pay
  • exchange money from one of your wallets to another
Looking for something?

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

Request

For standard request payment (payment) adds param "walletCurrency"(*). Which indicates the currency of the wallet where the funds will be credited and the currency for automatic exchange.

Request
{
"merchantOrderId": "payin-1743659906-eur_form",
"invoice": {
"amount": "17.23",
"currency": "eur"
},
"walletCurrency": "usd",
"returnUrl": "https://example.com/return-url/1697633610",
"webhookUrl": "https://example.com/webhook-url/1697633610"
}
*

(*) - Before integration, agree on the terms with your Account Manager

Response

Response
{
"data": {
"id": "eec20596-df2e-4656-a30e-e8dae7f18ed2",
"merchantOrderId": "payin-1743659703-eur_form",
"type": "exchange_payin",
"createdAt": "2025-04-03T05:55:03+00:00",
"auth": {
"type": "redirect",
"redirectUrl": "https://example.com/fp/check?orderId=33bf4dd6-7ba7-40aa-9b2d-14b96db68dde&nextPage=/challenge/869885d4-d162-4a8f-9bc7-418207e848e7"
},
"status": "new",
"rejectReason": null
},
"error": null
}

Errors list

CodeDescription
INVALID_DATAInvalid request data. Check json syntax
VALIDATIONValidation error. See error.validationErrors for details
METHOD_NOT_FOUNDEndpoint not found
INVALID_HTTP_METHODOnly POST method allowed
AUTHENTICATION_FAILEDCheck your api token
ORDER_ALREADY_EXISTSOrder with same merchantOrderId already exists
ORDER_NOT_FOUNDSpecified order was not found
REJECTED_DUE_TO_TECHNICAL_ISSUERejected due to technical issue
REQUEST_FROM_UNTRUSTED_SOURCERequest from untrusted source (ip not allowed)
PAYIN_DISABLEDPayment disabled. Contact us to enable
PAYOUT_DISABLEDWithdrawal disabled. Contact support to enable
WALLET_NOT_FOUNDWallet not found. Contact support to enable wallet
WALLET_INACTIVEWallet inactive. Contact support to enable wallet
ROUTING_NOT_CONFIGUREDRouting not configured. Please contact us for details
POINT_NOT_FOUNDThere is no way to process transaction. If issue is persistent please contact us for additional details
AMOUNT_GREATER_THAN_ALLOWEDOperation amount greater than allowed
AMOUNT_LESS_THAN_ALLOWEDOperation amount less than allowed
NOT_ENOUGH_BALANCEOperation amount greater than available balance
OPERATION_NOT_SUPPORTEDOperation not supported
REFERER_REQUEST_DOES_NOT_MATCH_ALLOWED_SOURCESReferer from request does not match user hosts. Please contact us if you have any questions.
UNKNOWNUnknown 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.

RESPONSE
{
"data": {
"id": "682cad33-bf23-47a2-822f-772b8bd8f6b1",
"merchantOrderId": "payin-1743660508-eur_form",
"type": "exchange_payin",
"createdAt": "2025-04-03T06:08:28+00:00",
"status": "new",
"subStatus": null,
"merchantSourceWallet": null,
"merchantTargetWallet": null,
"transactions": [
{
"type": "payin",
"id": "2202d387-3166-4fba-9927-34b9834f53aa",
"status": "new",
"authorized": {
"amount": "17.23",
"currency": "eur"
},
"requested": null,
"merchantWallet": {
"amount": "17.23",
"currency": "eur"
},
"counterpartyInfo": null,
"paymentInfo": null,
"createdAt": "2025-04-03T06:08:28+00:00",
"completedAt": null,
"rejectReason": null
},
{
"type": "exchange",
"id": "f23ba741-a23b-4024-ab6d-cb988f91d70c",
"status": "planned",
"merchantSourceWallet": {
"amount": "17.23",
"currency": "eur"
},
"merchantTargetWallet": {
"amount": "18.95",
"currency": "usd"
},
"createdAt": "2025-04-03T06:08:28+00:00",
"completedAt": null
}
]
},
"error": null
}

Are there any inquiries still outstanding?

Our team of experts is available 24/7 to answer all your questions. Feel free to reach out to us at any time, and we will be happy to help you address any inquiries or issues. Your comfort and satisfaction are our priority.

Need help?

Contact support