Платіж з обміном
Поповнюйте свій рахунок у євро – і нехай система зробить усе за вас! 🚀 Ваші кошти миттєво конвертуються у криптовалюту та зараховуються на ваш баланс. Жодних зайвих кроків – тільки вигідний курс і швидке зарахування!
Payment with exchange відбуається в 2 кроки:
Looking for something?Feel free to contact us if you are looking for some other options.
Request
До стандартного запиту платежу (payment) додається параметр "walletCurrency"(*), що вказує валюту гаманця, на який будуть зараховані кошти. Таким чином invoice.currency - валюта, в якій будуть кошти будуть списані із клієнта, walletCurrency - валюта, в якій гроші будуть зараховані на ваш гаманець
{"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"}
*(*) - Перед інтеграцією погодьте умови з вашим Аккаунт менеджером
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
Посилання на Status & Webhook розділ основного мануалу.
Оrder status new
означає що ми взяли в систему але ордер чекає щоб піти в процесінг.
Це не фінальний статус і буде змінений.
{"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}