Host-to-Host
COMPLIANCEIn order to use this method, you have to be PCI DSS compliant.
Feel free to contact our team if you have any questions.
Request
POST /api/v3/order/payment/create
{# A unique id on the merchant side. Required"merchantOrderId": "1697633610","invoice": {# The quantity of currency to be paid. Numeric-string. Required"amount": "100.54",# Three-letter ISO currency code, in lowercase. Required"currency": "eur"},"counterparty": {"type": "card","number": "0000000000000000","year": "2029","month": "12","cvv": "000"},"browserInfo": {"accept": "string","userAgent": "string","language": "string","timezoneOffset": 0,"javaEnabled": true,"screenColorDepth": 0,"screenHeight": 0,"screenWidth": 0,"documentHeight": 0,"documentWidth": 0},"client": {# ...},# Endpoint that will be used to return client on your site. Optional"returnUrl": "https://example.com/return-url/1697633610",# Endpoint that is expected to receive webhook. Optional"webhookUrl": "https://example.com/webhook-url/1697633610"}
Response
- Order was created successfully and actions should be performed by the customer
- Order was rejected by third party
Order was created successfully
Order was rejected by third party
{"data": {"id": "33bf4dd6-7ba7-40aa-9b2d-14b96db68dde","merchantOrderId": "1697633610","type": "payin","createdAt": "2024-07-15T14:45:22+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": "processing","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.
POST /api/v3/order/get-status
{"merchantOrderId": "1697633610"}
Processing
Completed
Rejected
Underpaid / Overpaid
The processing
order status indicates that the order is awaiting its final status.
This status is not final and can be changed.
RESPONSE
{"data": {"id": "2d75f116-5c79-49cd-9ce3-32003bd45efe","merchantOrderId": "1697633610","type": "payin","createdAt": "2023-10-18T12:53:32+00:00",# Status of order"status": "processing","subStatus": "awaiting_confirmation","merchantSourceWallet": null,"merchantTargetWallet": null,"transactions": [{"type": "payin","id": "2eab2f9e-8374-4ff6-bfeb-204b9cee3dbe",# Status of transaction"status": "processing",# Amount of money that will be charged from customer,# valid for any currency: EUR, USD, etc."authorized": {"amount": "100.54","currency": "eur"},# Amount of money that will be received# by merchant after order completion, valid# for any currency: EUR, USD, etc."merchantWallet": {"amount": "100.54","currency": "eur"},"counterpartyInfo": null,"paymentInfo": null,"createdAt": "2023-10-18T12:53:32+00:00","completedAt": null,"rejectReason": null}]},"error": null}