Создание счета на оплату

Метод позволяет создать счет на оплату без строгого указания монеты и сети, вы можете указать оплату 30 USD и список доступных к оплате монет/сетей, пользователь сам выберет в чем ему удобнее оплатить. Сумма автоматически пересчитается в выбранную монету для оплаты

Создание счета на оплату

post

/api-gateway/make-invoice

Header parameters

x-api-public-keystring

Публичный API-ключ

x-api-signaturestring

Подпись тела запроса приватным API-ключем

Content-typestring

Тип тела запроса

Example: application/json

Body

advancedBalanceIdstringrequired

Идентификатор авансового баланса для списания комиссий

Example: 1503cf18-597f-447f-b172-112dfe377e1b

externalIdstring

Уникальный идентификатор в системе мерчанта, для предотвращения дублирования создания инвойсов

Example: merchantExternalId123

orderstring

Идентификатор ордера в системе мерчанта

Example: Order #123456

descriptionstring

Описание ордера

Example: Payment by order #123456

externalUserIdstring

Внешний идентификатор пользователя в вашей системе. При указании идентификатора будет использован функционал раздела "Персональные адреса" - будет зарезервирован статический адрес под данного пользователя, но вебхук придет на указанный в этом запросе адрес

Example: 10099

payerEmailstring

Почта плательщика. Если указана в связке с параметром 'externalUserId' - будет создан пользователь с таким email в разделе "Персональные адреса"

Example: [e-mail]

currencystringrequired

Монеты для оплаты. Можно указывать любую доступную монету, в том числе фиатную. На странице инвойса сумма в указанной монете будет пересчитана к доступным для оплаты монет

Example: USD

amountstringrequired

Сумма к оплате в указанной монете. На странице инвойса сумма будет пересчитана по курсу к доступным для оплаты монетам

Example: 20

includeFeeboolean

Флаг позволяет включить в сумму к оплате комиссию сети блокчейна выбранного для оплаты. Будет полезно чтобы заложить свои издержки на вывод монет после оплаты.

additionalFeesstring[]

Название тарифа

Example: SEPA_WITHDRAWAL

insurancePercentstring

Позволяет добавить к сумме оплаты указанный процент

Example: 1

slippagePercentstring

При открытия страници инвойса пользователь может провести на ней столько времени что курс смениться. Если после перехода к оплате сумма измениться больше указанного процента, то сумма к оплате будет пересчитана по текущему курсу

Example: 2

paymentTolerancePercentstring

Допустимый процент недоплаты ОРДЕРА. Например, после выбора монеты инвойса был создан ордер на 100 USDT. Если параметр установлен как 1.5%, то ордер завершится с успехом при оплате 98.5 USDT

Example: 1.5

webhookURLstring

URL для уведомлений при изменении статуса инвойса или полученной суммы

Example: https://merchant.domain/webhooks/invoice

returnURLstring

URL для указания в качестве "Вернуться в магазин" на странице оплаты

Example: https://merchant.domain/

lifetimeintegerrequired

Время жизни инвойса в минутах

currenciesany[][]required

Тело доступной к оплате монеты в конкретной сети, указывается в формате [CURRENCY, NETWORK]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ocp.onchainpay.io/api-gateway/make-invoice' \
  --header 'Content-Type: application/json' \
  --data '{
    "advancedBalanceId": "1503cf18-597f-447f-b172-112dfe377e1b",
    "externalId": "merchantExternalId123",
    "order": "Order #123456",
    "description": "Payment by order #123456",
    "externalUserId": "10099",
    "payerEmail": "[e-mail]",
    "currency": "USD",
    "amount": "20",
    "includeFee": true,
    "additionalFees": [
      "SEPA_WITHDRAWAL"
    ],
    "insurancePercent": "1",
    "slippagePercent": "2",
    "paymentTolerancePercent": "1.5",
    "webhookURL": "https://merchant.domain/webhooks/invoice",
    "returnURL": "https://merchant.domain/",
    "lifetime": 1,
    "currencies": [
      []
    ]
  }'

200

200

{
  "success": true,
  "response": {
    "id": "411f57b6-224d-4bf6-8ded-740fd3a7f3c9",
    "advancedBalanceId": "1503cf18-597f-447f-b172-112dfe377e1b",
    "externalId": "merchantExternalId123",
    "externalUserId": "10099",
    "payerEmail": "[e-mail]",
    "orderId": "a7ff7a80-dd8e-40e7-a262-4599b007211b",
    "orderLink": "https://payment.domain/a7ff7a80-dd8e-40e7-a262-4599b007211b",
    "invoiceLink": "https://invoices.domain/411f57b6-224d-4bf6-8ded-740fd3a7f3c9",
    "status": "INIT",
    "order": "Order #123456",
    "description": "Payment by order #123456",
    "currency": "USD",
    "amount": "20",
    "receivedNetwork": "USDT",
    "receivedCurrency": "USDT",
    "receivedAmount": "100.32",
    "receivedAmountInInvoiceCurrency": "100.94",
    "rate": "100.32",
    "includeFee": true,
    "additionalFees": [
      "SEPA_WITHDRAWAL"
    ],
    "insurancePercent": "1",
    "slippagePercent": "2",
    "paymentTolerancePercent": "1.5",
    "webhookURL": "https://merchant.domain/webhooks/invoice",
    "returnUrl": "https://merchant.domain/",
    "expiresAt": "2024-12-26T08:22:03.213Z",
    "createdAt": "2024-12-26T08:21:33.213Z",
    "currencies": [
      {
        "currency": "USDT",
        "networks": [
          {
            "name": "ethereum",
            "amount": "25"
          }
        ]
      }
    ]
  }
}