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