Russian
Объекты API
Кошелёк Pay API

1. Объект CheckoutInvoice

Объект содержит данные о пречеке.
Поле
Тип
Обязательно
Значение
orderId
String
Да
Номер пречека (идентификатор покупки в системе ТСП). До 36 символов.
totalAmount
Number
Да
Сумма к оплате (итоговая сумма) с учетом скидки в копейках.
Неотрицательное целое число, не более 10 цифр.
discountAmount
Number
Нет
Сумма скидки в копейках.
Неотрицательное целое число, не более 10 цифр.
subTotalAmount
Number
Нет
Полная сумма без учета скидки в копейках (включая НДС).
Неотрицательное целое число, не более 10 цифр.
items
Array of Item
Да
Массив товаров, включенных в покупку (каждый товар — объект Item).

2. Объект Item

Объект описывает отдельное товарное наименование, оплаченное с помощью Кошелёк Pay.
Поле
Тип
Обязательно
Значение
name
String
Да
Наименование товара.
article
String
Да
Артикул.
price
Number
Да
Цена за единицу товара в копейках.
quantity
Number
Да
Количество.
totalAmount
Number
Да
Сумма к оплате (итоговая) в копейках.
discountAmount
Number
Нет
Сумма скидки в копейках.
subTotalAmount
Number
Нет
Полная сумма без учета скидки в копейках.
tax
Enum
Да
Ставка налога:
  • none — без НДС.
vat0 —НДС по ставке 0%.
vat10 — НДС чека по ставке 10%.
vat20 — НДС чека по ставке 20%.
vat110 — НДС чека по расчетной ставке 10/110.
vat120 — НДС чека по расчетной ставке 20/120.

3. Объект User

Объект содержит данные о пользователе (клиенте, совершающем покупку).
Поле
Тип
Обязательно
Значение
loyaltyId
String
Да
Идентификатор клиента в программе лояльности (ключ карты лояльности).
До 36 символов.

4. Объект paymentTypeAvailabilityInfo

Объект содержит сведения о провайдере платежей.
Поле
Тип
Обязательно
Значение
paymentType
String
Да
Наименование провайдера платежей (до 36 символов).
available
Boolean
Да
Доступность провайдера платежей:
true - доступен.
false - недоступен.
message
String
Нет
Дополнительная информация о провайдере.

5. Объект Slip

Объект содержит данные о проведенной банковской операции.
Поле
Тип
Обязательно
Значение
paymentType
Enum
Да
Способ (система) оплаты:
SBP — система быстрых платежей.
storeId
String
Да
Идентификатор торговой точки (см. Подключение к API).
terminalId
String
Да
Идентификатор кассы.
orderId
String
Да
Номер пречека (идентификатор покупки в системе ТСП).
transactionId
String
Да
Идентификатор транзакции (покупки в системе Кошелька).
merchantId
String
Да (для СБП)
Идентификатор ТСП, выданный банком-получателем.
Обязателен для оплаты через СБП.
dateTime
Date
Да
Дата в формате:
YYYY-MM-DDTHH24:MI:SS+GMT
sourceId
String
Да
Идентификатор транзакции, переданный Кошельком в систему банка.
operationId
String
Да
Идентификатор транзакции, присвоенный системой банка.
qrcId
String
Да (для СБП)
Идентификатор транзакции, зарегистрированный в СБП. Обязателен для оплаты через СБП.
totalAmount
Number
Да
Оплаченная сумма (в копейках).
commission
Number
Нет
Сумма комиссии (в копейках).

6. Объект PaymentMethod

Объект описывает используемый способ оплаты.
Поле
Тип
Обязательно
Значение
type
Enum
Да
Механизм оплаты:
SBP — Система быстрых платежей.
meta
Object
Нет
Объект, содержащий дополнительные поля, например: скидки, бонусы и т.д. (набор пар "ключ-значение").

7. Объект Invoice

Объект содержит сведения о фискальном чеке.
Поле
Тип
Обязательно
Значение
orderId
String
Да
Номер пречека (до 36 символов).
receiptId
String
Да
Номер чека (до 36 символов).
merchantName
String
Да
Полное наименование ТСП (до 999 символов).
merchantAddress
String
Да
Адрес ТСП (до 999 символов)
inn
String
Да
ИНН ТСП (ровно 12 цифр; для ЮЛ - 2 первых нуля)..
dateTime
Datetime
Да
Формат даты:
YYYY-MM-DDTHH24:MI:SS+GMT
shift
String
Да
Смена (до 32 символов).
cashier
String
Да
ФИО или номер кассира (до 256 символв).
taxation
Enum
Да
Система налогообложения. Перечисление с возможными значениями:
  • osn – общая СН;
  • usn_income – упрощенная СН (доходы);
  • usn_income_outcome – упрощенная СН (доходы минус расходы);
  • envd – единый налог на вмененный доход;
  • esn – единый сельскохозяйственный налог;
  • patent – патентная СН.
kktRegNumber
String
Да
Регистрационный номер ККТ (до 64 символов).
fnNumber
String
Да
Номер фискального накопителя (до 64 символов).
fpd
String
Да
Фискальный признак документа (до 64 символов).
fdNumber
String
Да
Номер фискального документа (до 64 символов).
website
String
Да
Сайт для проверки данных чека (например, nalog.ru), (до 64 символов).
receiptType
Enum
Да
Признак расчета. Перечисление с возможными значениями:
  • debit - приход;
  • credit - расход;
  • refund - возврат.
totalAmount
Number
Да
Сумма к оплате (итоговая сумма) в копейках, неотрицательное целое число, до 10 цифр.
discountAmount
Number
Нет
Сумма скидки в копейках, неотрицательное целое число, до 10 цифр.
subTotalAmount
Number
Нет
Полная сумма без учета скидки в копейках, неотрицательное целое число, до 10 цифр.
taxAmount
Number
Да
Сумма налога в копейках, неотрицательное целое число, до 10 цифр.
qr
String
Да
QR-код для загрузки электронной версии чека (до 999 символов).
items
Array of Item
Да
Массив товаров, включенных в покупку (каждый товар - объект Item).
Last modified 11d ago