Фискализация чеков

Платежная система (ПС) OCTO предоставляет услугу фискализации чеков для магазинов.

Подключение фискализации

Для подключения фискализации магазину необходимо предоставить менеджеру проекта следующие данные:

• Полное название магазина.
• ИНН магазина.
• Код упаковки.
• Код ИКПУ.
• Информация о наличии НДС на товар.

Указание email или телефона

При инициации платежа (/prepare_payment) Партнёр обязан передать в параметре user_data один из следующих элементов:

• Email: Для отправки чека с ссылкой на фискальный чек, зарегистрированный в ГНК.
• Номер телефона: Для регистрации фискального чека на данный номер в ГНК.

Метод получение данных фискального чека /fiscal-data

• URL: https://secure.octo.uz/fiscal-data
• Method: POST
• Content-type: application/json

Пример запроса

{
    "octo_shop_id": 10000,
    "octo_secret": "2d45df74-bb95-47cf-a616-8d6dcee2e10d",
    "payment_uuid": "1145df74-bb95-47cf-a616-8d6dcee2e222"
}

Параметры запроса

Параметр	Тип	Обязательность	Описание
octo_shop_id	Integer	Да	Уникальный ID магазина (доступен в личном кабинете магазина).
octo_secret	String	Да	Персональный секретный ключ магазина.
payment_uuid	String	Да	Уникальный идентификатор платежа, созданный системой OCTO.

---

Пример успешного ответа

{
    "error": 0,
    "errMessage": "",
    "data": {
        "phone": "998781290011",
        "code": 0,
        "message": "accepted",
        "terminalID": "EZ000000000102",
        "receiptId": 2121,
        "dateTime": "20220929013159",
        "fiscalSign": "420808230750",
        "qrCodeURL": "https://ofd.soliq.uz/epi?t=EZ000000000102&r=2121&c=20220929013159&s=420808230750"
    }
}

Параметры успешного ответа

Параметр	Тип	Обязательность	Описание
error	Integer	Да	Код ошибки.
errMessage	String	Да	Сообщение об ошибке.
data	Object	Нет	Основные данные транзакции.
phone	String	Да	Номер телефона пользователя.
code	Integer	Да	Код подтверждения операции.
message	String	Да	Сообщение о статусе операции.
terminalID	String	Да	Идентификатор терминала, на котором была проведена операция.
receiptId	Integer	Да	Идентификатор чека для операции.
dateTime	String	Да	Дата и время операции в формате YYYYMMDDHHMMSS.
fiscalSign	String	Да	Фискальный признак документа.
qrCodeURL	String	Да	URL для доступа к QR-коду чека.

---

Пример неуспешного ответа

{
    "error": 1,
    "errMessage": "wrong secret",
    "data": null
}