Links

Объекты API v0.9.0

Кошелёк 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

Объект содержит данные о проведенной банковской операции.
Поле
Тип
Обязательно
Значение
id
String
Да
Внутренний идентификатор объекта Slip в системе Кошелька.
paymentType
Enum
Да
Механизм оплаты:
storeId
String
Да
Идентификатор торговой точки (см. Подключение к API).
terminalId
String
Да
Идентификатор кассы.
orderId
String
Да
Номер пречека (идентификатор покупки в системе ТСП).
paymentTransactionId
String
Да
Идентификатор транзакции (покупки в системе Кошелька).
refundTransactionId
String
Нет
Идентификатор транзакции возврата.
merchantId
String
Да (для paymentType = SBP)
Идентификатор ТСП, выданный банком-получателем.
Обязателен для оплаты через СБП.
operationDateTime
Date
Да
Дата транзакции в формате:
yyyy-MM-dd'T'HH:mm:ss.SSSZ Часовой пояс всегда равен Z (+0).
operationId
String
Нет
Идентификатор транзакции, присвоенный системой банка.
qrcId
String
Да (для paymentType = SBP)
Идентификатор транзакции, зарегистрированный в СБП. Обязателен для оплаты через СБП.
totalAmount
Number
Да
Оплаченная сумма (в копейках).

6. Объект PaymentMethod

Объект описывает используемый способ оплаты.
Поле
Тип
Обязательно
Значение
type
Enum
Да
Механизм оплаты:
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).