Payments
Модель, описывающая оплаты в чеке.
| Название | Тип данных | Обязательность | Описание параметра |
|---|---|---|---|
| type | int64 | Обязательный | Форма оплаты в VCR: 1 - наличные, 2 - банковская карта / платёжная система |
| value | int64 | Обязательный, если не заполнен payment_id; в Receipt.Refund обязателен всегда |
Сумма оплаты в тийинах. Не может быть меньше 0 |
| payment_id | string | Необязательный | id платежа в VCR, созданный методом Payment.Create или Payment.Start |
| card_type | int32 | Необязательный | Тип карты: 1 - корпоративная, 2 - личная, 3 - социальная. По умолчанию - 2 |
| card_number | string | Обязательный при type = 2 и card_type = 3, если оплата не создана через Payment.Create или Payment.Start |
Номер социальной карты покупателя. Передаётся 16 цифр; в ответах и печати используется маскированное значение |
| RRN | string | Необязательный | Идентификатор транзакции платёжного процессинга, если доступен |
При оплате наличными (type = 1) обязательны type и value; поле payment_id передавать нельзя.
При оплате через Payment.Create или Payment.Start передайте локальный id платежа в поле payment_id. В чеке продажи такой платёж можно использовать только один раз.
В Receipt.Sale при заполненном payment_id VCR использует сумму и данные созданного платежа.
В Receipt.Refund поле payment_id не запускает денежный возврат. Оно связывает чек с уже подтверждённой операцией возврата исходного интегрированного платежа; value должен быть равен сумме этой операции. Для возврата наличными или иной формой поле не передаётся.
Оплата UzQR регистрируется как карточная безналичная оплата; идентификатор оплаты UzQR используется как RRN.
Для QR-платежей перед закрытием чека нужно убедиться, что Payment.Get вернул status = 3.
Важно: в одном чеке можно передать не более одного объекта оплаты с type = 2.