Подтверждение оплаты заказа

Оплата счёта подтверждается одним вызовом:

метод: POST
ресурс: /v3/payment/api/invoice/confirm
тело запроса - объект CreateInvoicePaymentRequest
тело ответа - объект InvoicePaymentResponse
Возможные ошибки

Пример запроса

POST /v3/payment/api/invoice/confirm
Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e
Content-Type: application/json
User-Agent: MyApp 1.0
Accept: application/json
{
    "paymentOperationId" : "117a58b0-7dc9-424c-8f07-b8a865e8bcc7",
    "paymentOrderNumber" : "1342",
    "paymentOrderDate" : "2026-08-04",
    "amount" : 19658.45,
    "currencyId" : "RUB",
    "customer" : {
      "type" : "legal",
      "name" : "ООО Ромашка",
      "vatNumber" : "7710044140",
      "taxRegistrationReasonCode" : "770001001",
      "settlementAccount" : "40702810800190000253",
      "correspondentAccount" : "30101810700000000187",
      "bankName" : "ПАО ВТБ",
      "bic" : "044039142"
    }
}

Ответ:

{
  "data": {
    "id": "8c0e116d-31a5-4210-b62e-6b6917851f69",
    "invoiceId": "01771534-1a57-f184-dee3-ebeb91dded75",
    "paymentOperationId": "117a58b0-7dc9-424c-8f07-b8a865e8bcc7",
    "amount": 19658.45,
    "currencyId": "RUB",
    "status": "paid"
  }
}

CreateInvoicePaymentRequest

Свойство	Тип	Описание	Пример значения
invoiceId *	string(36)	Id счёта	`01771534-1a57-f184-dee3-ebeb91dded75`
paymentOperationId *	string(36)	Id операции	`117a58b0-7dc9-424c-8f07-b8a865e8bcc7`
amount *	float	Сумма платежа	`19658.45`
currencyId *	string(3) enum	Код валюты счёта в соответствии с ISO 4217	`RUB`, `USD`,`EUR`, `GBP`
paymentOrder	PaymentOrder	Детали платежа)
status	string(50) enum	Статус платежа (paid, pending)	`paid`

PaymentOrder

Свойство	Тип	Описание	Пример значения
type *	string(10) enum	Тип плательщика	`legal` - юр. лицо, `private` - физ лицо
number	string(36)	Номер платёжного поручения	`1342`
date	string(36)	Дата платёжного поручения	`2026-08-04`
amount *	float	Сумма платежа	`19658.45`
currencyId *	string(3) enum	Код валюты счёта в соответствии с ISO 4217	`RUB`, `USD`,`EUR`, `GBP`
name	string(500)	Наименование плательщика	`ООО Ромашка`
phone	string(100)	Номер телефона	`79001112233`
vatNumber	string(20)	ИНН	`7710044140`
taxRegistrationReasonCode	string(9)	КПП	`770001001`
settlementAccount	string(20)	Номер расчт. счёта	`40702810800190000253`
correspondentAccount	string(20)	Номер корр. счёта	`30101810700000000187`
bankName	string(100)	Наименование банка	`ПАО ВТБ`
bic	string(9)	БИК	`044039142`
kbk	string(20)	Код бюджетной классификации (КБК)	`18210501011011000110`
paymentPurpose	string(210)	Назначение платежа	`Оплата по счёту №10-2946153 за авиабилеты, НДС не выделяется`

InvoicePaymentResponse

Повторяет свойства объекта CreateInvoicePaymentRequest с дополнительными свойствами:

Свойство	Тип	Описание	Пример значения
id *	string(36)	Идентификатор транзакции в системе Инвойсбокс	`8c0e116d-31a5-4210-b62e-6b6917851f69`

NotificationErrorCode

Код ошибки	Описание
`out_of_service`	Техническая ошибка обработки запроса, при получении этого кода ошибки необходимо пытаться повторить запрос еще несколько раз в течение последующих суток.
`invoice_already_paid`	Счёт уже оплачен другим инструментом оплаты :warning:
`invoice_not_found`	Счёт не найден в учётной системе
`signature_error`	Ошибка проверки подписи запроса

Внимание

Обратите внимание, в случае, если аналогичный запрос на оплату уже был обработан ранее успешно и заказ был отмечен как оплаченный, то в этом случае будет возвращён статус успешной обработки success. В случае, если заказ был оплачен ранее под другим идентификатором или иным платёжным инструментом, вернётся ошибка invoice_already_paid.

Подпись запроса

При отправке запросе необходимо сформировать и передать подпись тела запроса в заголовке X-Signature. При ошибке проверки подписи будет сформирован ответ NotificationError с NotificationErrorCode signature_error. Электронная подпись формируется путем криптографического преобразования содержимого тела запроса с использованием ключа и согласованного алгоритма. По умолчанию используется алгоритм sha1 и метод hmac.