Host-to-Host

COMPLIANCE
In 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
}

Host-to-Host

Request

Response

Errors list

Order status

Are there any inquiries still outstanding?

Host-to-Host