Чек передается в авторизационном запросе . Для этого необходимо в запросе передать дополнительный параметр ChequeItems, в котором передаётся структура в формате JSON, как в следующем примере.
Пример структуры чека в параметре ChequeItems:
{"items":[ {"id": 1, "product": "123460176", "name": "Первый товар", "price": 201.45, "quantity": 42.345, "amount": 8530.40, "tax": "vat10", "fpmode": 1}, {"id": 2, "product": "123460189", "name": "Второй товар", "price": 15301.01, "quantity": 0.128, "amount": 1958.53, "tax": "vat18", "fpmode": 1} ]} |
В структуре передаются следующие параметры позиций чека:
Название | Обязательное поле | Тип значения | Описание |
id | Да | int | Позиция в чеке (уникальное число для чека) |
product | Да/Нет* | string(50) | Код товара по справочнику товаров магазина |
name | Да/Нет* | string(250) | Наименование товара |
price | Да | float(10.2) | Стоимость единицы товара (услуги) |
quantity | Да | float | Количество/объем товара/услуги в единицах измерения товара (может быть дробным числом) |
amount | Да | float(15.2) | Стоимость позиции price*quantity |
tax | Да** | string(10) | |
fpmode | Нет** | int |
*Должен быть определен один из параметров - код товара или его наименование, либо оба параметра должны быть переданы (при формировании чека они объединяются в одну строку).
**Параметры tax и fpmode не передаются в запросе на отмену или возврат средств.
Значения параметров price и amount всех позиций в чеке должны быть в одной валюте, и эта валюта должна совпадать с валютой заказа (параметр OrderCurrency в авторизационном запросе).
Сумма всех позиций чека (по параметру amount) должна быть равна сумме заказа (параметр OrderAmount в авторизационном запросе).
Если указанные выше условия не соблюдаются, чек признается неверным и происходит ошибка авторизационного запроса.
При двустадийном механизме работы финансовое подтверждение интернет-магазин может осуществить в течение 4 дней в Личном кабинете либо с помощью веб-сервиса.
Для подтверждения оплаты нужно отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8).
URL запроса для передачи финансового подтверждения и список параметров запроса подтверждения оплаты совпадают с указанными здесь. Для передачи чека подтверждения в запросе HTTP POST добавляется лишь дополнительный параметр ChequeItems, в котором передаётся структура в формате JSON, как в следующем примере.