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

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

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

POSThttps://ocp.onchainpay.io/api-gateway/make-invoice

Header parameters

Body

application/json

advancedBalanceId*string

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

externalIdstring

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

orderstring

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

descriptionstring

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

currency*string

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

amount*string

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

includeFeeboolean

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

additionalFeesarray of string

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

insurancePercentstring

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

slippagePercentstring

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

webhookURLstring

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

returnURLstring

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

lifetime*integer

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

currencies*array of array of any

Список монет и сетей доступных для оплаты, при указании пустого массива будут выбраны все монеты/сети доступные в системе

Response

200

Body

application/json

success*boolean

Признак успешности запроса

response*MakeInvoiceResponse (object)

Тело ответа инвойса

Request

JavaScriptCurl

const response = await fetch('https://ocp.onchainpay.io/api-gateway/make-invoice', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "advancedBalanceId": "3e8eed11-69a6-40d2-8b1f-d5d1b3f1fd72",
      "currency": "USD",
      "amount": "20",
      "currencies": [
        []
      ]
    }),
});
const data = await response.json();

Response

{
  "success": false,
  "response": {
    "id": "97bdc6ac-d586-4929-813f-b5b3a05ca8db",
    "advancedBalanceId": "3e8eed11-69a6-40d2-8b1f-d5d1b3f1fd72",
    "externalId": "merchantExternalId123",
    "orderId": "ad71343a-e1e8-4285-a02d-234ab23ef239",
    "orderLink": "https://payment.domain/ad71343a-e1e8-4285-a02d-234ab23ef239",
    "invoiceLink": "https://invoices.domain/97bdc6ac-d586-4929-813f-b5b3a05ca8db",
    "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": false,
    "additionalFees": [
      "SEPA_WITHDRAWAL"
    ],
    "insurancePercent": "1",
    "slippagePercent": "2",
    "webhookURL": "https://merchant.domain/webhooks/invoice",
    "returnUrl": "https://merchant.domain/",
    "expiresAt": "2024-05-07T11:27:55.612Z",
    "createdAt": "2024-05-07T11:27:25.613Z",
    "currencies": [
      {
        "currency": "USDT",
        "networks": [
          {
            "name": "ethereum",
            "amount": "25"
          }
        ]
      }
    ]
  }
}