Подтверждение оплаты счета для двустадийного платежа

Обновлено 14 февраля 2025

PUT

/invoices/{invoice_id}

Инициатор присылает полное или частичное подтверждение для завершения оплаты счета при двухстадийной оплате. Счет должен находиться в состоянии 3 «Деньги временно заблокированы». По завершении счет переходит в состояние 0 «Оплачен»

Запрос

Path Parameters

invoice_id

string

required

ID счета

Header Parameters

author

string

Пользователь, который производит изменения

• application/json

Body

Инфо о подтверждении/отмене счета

invoice object
Информация о созданном счете
order objectrequired
amount
integer
Сумма счета без разделителя, в копейках. Например, 1 рубль передается в этом поле как 100.
Если в запросе указывается корзина товаров, то это поле должно быть равно сумме стоимости всех товаров в корзине sum(order_bundle.item_amount).
currency
string
Код валюты в формате ISO 4217.
Поддерживается только значение RUB
order_bundle object[]
Описание корзины покупок для передачи в налоговую и формирования фискального чека.
Не требуется заполнять, например, при создании счета на предавторизацию.
Обязательно нужно указывать в счетах на оплату, иначе оплата не состоится
Array [
position_id
integer
required
Номер позиции в корзине для добавления в фискальный чек.
Должен быть уникален в рамках заказа
name
string
required
Наименование или описание товарной позиции
item_params object[]
Дополнительные параметры, уточняющие товарную позицию
Array [
key
string
required
Название параметра
value
string
required
Значение параметра
]
quantity object
Описание количественных характеристик определенной позиции корзины
value
number
required
Количество товара в позиции.
Для разделителя используйте точку. Не более 3 знаков после запятой
measure
string
required
Единица измерения товара в позиции
item_amount
integer
Сумма стоимости всех товарных позиций одного positionId, в копейках
currency
string
Код валюты в формате ISO 4217.
Поддерживается только значение RUB
item_code
string
Номер (идентификатор) товарной позиции в системе магазина.
Параметр должен быть уникальным в рамках запроса
item_price
integer
Стоимость одного товара в позиции без разделителя, в копейках
discount_type
string
Тип скидки на товарную позицию
discount_value
number
Значение скидки на товарную позицию.
Используется для формирования фискального чека, сумму рассчитывает разработчик
interest_type
string
Тип агентской комиссии за продажу товара.
Применимо только для агентской схемы
interest_value
number
Значение агентской комиссии за продажу товара.
Применимо только для агентской схемы
tax_type
integer
Ставка НДС:
• 0 — без НДС;
• 1 — НДС по ставке 0%
• 2 — НДС чека по ставке 10%
• 3 — НДС чека по ставке 18%
• 4 — НДС чека по расчетной ставке 10/110;
• 5 — НДС чека по расчетной ставке 18/118;
• 6 — НДС чека по ставке 20%
• 7 — НДС чека по расчетной ставке 20/120.
Значение «НДС по ставке 0%» отличается от варианта «без НДС» только формированием чека в зависимости от системы налогообложения. По сумме налога разницы нет
tax_sum
integer
Сумма налога, высчитанная продавцом, без разделителя, в копейках
image
url
Ссылка на картинку
]

Ответы

• 200
• 400
• 401
• default

Счет подтвержден

• application/json

• Схема
• Пример из схемы

Schema

error object

user_message

string

Сообщение для пользователя

error_description

string

Техническое описание ошибки

error_code

string

Код ответа

{
  "error": {
    "user_message": "",
    "error_description": "",
    "error_code": "0"
  }
}

bad input parameter

• application/json

• Схема
• Пример из схемы

Schema

error object

user_message

string

Сообщение для пользователя

error_description

string

Техническое описание ошибки

error_code

string

Код ответа

{
  "error": {
    "user_message": "",
    "error_description": "",
    "error_code": "0"
  }
}

Access token is missing or invalid

Unexpected error

• application/json

• Схема
• Пример из схемы

Schema

error object

user_message

string

Сообщение для пользователя

error_description

string

Техническое описание ошибки

error_code

string

Код ответа

{
  "error": {
    "user_message": "",
    "error_description": "",
    "error_code": "0"
  }
}

Loading...

Loading...