Exchange
Do you want to use?
Request
POST /api/v3/order/exchange/create
{"merchantOrderId": "1697637323","amountFrom": "1.23","currencyFrom": "usd","currencyTo": "eur","webhookUrl": "https://example.com/webhook-url/1697637323"}
Response
Response
{"data": {"id": "38435d18-23d3-46af-853d-faf16d336cd6","merchantOrderId": "1697637323","type": "exchange","createdAt": "2024-07-18T09:18:12+00:00","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.
POST /api/v3/order/get-status
{"merchantOrderId": "1697637323"}
Processing
Completed
Rejected
Response
{"data": {"id": "38435d18-23d3-46af-853d-faf16d336cd6","merchantOrderId": "exchange-1721294292-uah_usd","type": "exchange","createdAt": "2024-07-18T09:18:12+00:00","status": "processing","merchantSourceWallet": {"amount": "19.23","currency": "usd"},"merchantTargetWallet": {"amount": "18.92","currency": "eur"},"transactions": [{"type": "exchange","id": "7f9c1e68-dc3c-43e9-a622-78dbe077a710","status": "processing","merchantSourceWallet": {"amount": "19.23","currency": "usd"},"merchantTargetWallet": {"amount": "18.92","currency": "eur"},"createdAt": "2024-07-18T09:18:12+00:00","completedAt": "2024-07-18T09:18:12+00:00"}]},"error": null}