Мы используем cookie-файлы
Хорошо
Справочник методов API - Чеки (для РФ)

С помощью API вы можете получать информацию о чеках, для которых вы отправили данные через Paybox.

Для обращения к ресурсу чеков, будут доступны следующие методы:
  • POST v1/receipts - Создание чека
  • GET v1/receipts - Получение списка чеков
  • GET v1/receipts/{receipt_id} - Получение информации по чеку
Объект чека

Объект чека (pg_receipt) содержит актуальную информацию о чеке, созданном для платежа или возврата.

Вложенные параметры объекта company
Вложенные параметры массива positions
Вложенные параметры объекта positions.mark_quantity
Вложенные параметры массива positions.payment_object_industry_details
Вложенные параметры объекта positions.mark_code_type
Вложенные параметры объекта positions.supplier
Вложенные параметры массива settlements
Вложенные параметры объекта additional_user_props
Вложенные параметры массива receipt_industry_details
Вложенные параметры объекта receipt_operating_details

{
    "data": {
        "merchant_id": "542088",
        "receipt_id": "bb938d6c-6c1c-44a0-aa54-32c3e14fddb7",
        "operation_type": "sell",
        "receipt_format": "ru_1_05",
        "status": "registered",
        "fiscal_document_number": 10605,
        "fiscal_storage_number": "9999078900006286",
        "fiscal_attribute": 923085333,
        "registered_at": "29.03.2023 17:37:00",
        "created_at": "29.03.2023 20:39:16",
        "fiscal_provider_id": "5e402526-0c20-41c3-b30a-b52e7f903922",
        "positions": [
            {
                "name": "Товар №1",
                "quantity": 2,
                "price": 50,
                "vat_code": "vat_20",
                "payment_method": "full_payment",
                "payment_object": "goods",
                "sum": 100
            },
            {
                "name": "Товар №2",
                "quantity": 1,
                "price": 100,
                "vat_code": "vat_20",
                "payment_method": "full_payment",
                "payment_object": "goods",
                "sum": 100
            }
        ],
        "total": 200,
        "settlements": [
            {
                "type": "cashless",
                "sum": 200
            }
        ],
        "receipt_method": "separately",
        "error": null,
        "link": "https: //consumer.1-ofd-test.ru/v1?fn=9999078900006286&fp=923085333&i=10605&t=20230329T173700&s=7&n=2",
        "payment_id": "764239789"
    }
}

Создание чека
Запрос позволяет отправить данные для формирования чека в вашу онлайн-кассу.

С помощью данного запроса можно сформировать чек зачёта предоплаты, если вы используете способ Чек вместе с платежом. Также, необходимо использовать данный запрос для создания чека прихода и чека возврата прихода, если у вас подключен способ Чек отдельно от платежа.

Вложенные параметры объекта customer
Вложенные параметры объекта company
Вложенные параметры массива positions
Вложенные параметры объекта positions.mark_quantity
Вложенные параметры массива positions.payment_object_industry_details
Вложенные параметры объекта positions.mark_code_type
Вложенные параметры объекта positions.supplier
Вложенные параметры массива settlements
Вложенные параметры объекта additional_user_props
Вложенные параметры массива receipt_industry_details
Вложенные параметры объекта receipt_operating_details
Пример запроса

curl --location --request POST 'https://api.freedompay.uz/v5/receipts' \
--header 'Accept: application/json' \
--header 'X-JWS-Signature: {{Ваш JWS-токен}}' \
--header 'Content-Type: application/json' \
--data-raw \
'{
  "receipt_format": "ru_1_05",
  "merchant_id": 542088,
  "payment_id": 764239789,
  "operation_type": "sell",
  "customer": {
    "email": "customer@mail.ru"
  },
  "positions": [
    {
      "price": 50.00,
      "name": "Товар №1",
      "quantity": 2.00,
      "vat_code": "vat_20",
      "payment_method": "full_payment",
      "payment_object": "goods"
    },
    {
      "price": 100.00,
      "name": "Товра №2",
      "quantity": 1.00,
      "vat_code": "vat_20",
      "payment_method": "full_payment",
      "payment_object": "goods"
    }
  ],
  "settlements": [
    {
      "type": "cashless",
      "sum": 200.00
    }
  ]
}'

Пример тела ответа

{
    "data": {
        "merchant_id": "542088",
        "receipt_id": "adec9d48-be2a-4bf4-8ca1-3432fd8920c5",
        "operation_type": "sell",
        "receipt_format": "ru_1_05",
        "status": "pending",
        "fiscal_document_number": "",
        "fiscal_storage_number": null,
        "fiscal_attribute": "",
        "registered_at": null,
        "created_at": "10.04.202315:34:12",
        "fiscal_provider_id": null,
        "positions": [
            {
                "name": "Товар №1",
                "quantity": 2,
                "price": 50,
                "measure": "piece",
                "vat_code": "vat_20",
                "payment_method": "full_payment",
                "payment_object": "goods",
                "sum": 10
            },
            {
                "name": "Товар №2",
                "quantity": 1,
                "price": 100,
                "measure": "piece",
                "vat_code": "vat_20",
                "payment_method": "full_payment",
                "payment_object": "goods",
                "sum": 2
            }
        ],
        "total": 200,
        "settlements": [
            {
                "type": "cashless",
                "sum": 200
            }
        ],
        "company": {
            "inn": "5544332219",
            "email": "customer@mail.ru",
            "tax_system": "osn",
            "payment_address": "shop.ru"
        },
        "receipt_method": "separately",
        "error": null,
        "link": null,
        "payment_id": "764239789"
    }
}

Получение списка чеков

Данный запрос позволяет получить список чеков магазина, отфильтрованный по определённым критериям. Критерии могут быть различными, например, список можно отфильтровать по номеру платежа или возврата, по наименованию товара или сумме чека.

Параметры запроса
вложенные параметры массива created_at
Пример запроса

curl --location --globoff --request GET 'https://api.freedompay.uz/v5/receipts?created_at[gte]=2023-03-01&created_at[lte]=2023-03-31&offset=1&limit=2&utc=3' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json'

Пример тела ответа

{
    "data": [
        {
            "merchant_id": "542088",
            "receipt_id": "8e6fa8d3-bf01-4a93-b453-4a018f15318d",
            "operation_type": "sell",
            "receipt_format": "ru_1_05",
            "status": "registered",
            "fiscal_document_number": "11900",
            "fiscal_storage_number": "9999078900006369",
            "fiscal_attribute": "790695398",
            "registered_at": "30.03.202315:20:00",
            "created_at": "30.03.202315:20:29",
            "fiscal_provider_id": "da7d533f-b547-46ca-b127-d0b2ba6cf9f1",
            "positions": [
                {
                    "name": "Товар №1",
                    "quantity": 1,
                    "price": 100,
                    "measure": "piece",
                    "vat_code": "vat_20",
                    "payment_method": "full_payment",
                    "payment_object": "goods",
                    "sum": 100
                },
                {
                    "name": "Товар №2",
                    "quantity": 2,
                    "price": 50,
                    "measure": "piece",
                    "vat_code": "vat_20",
                    "payment_method": "full_payment",
                    "payment_object": "goods",
                    "sum": 100
                }
            ],
            "total": 200,
            "settlements": [
                {
                    "type": "cashless",
                    "sum": 200
                }
            ],
            "company": {
                "inn": "5544332219",
                "email": "customer@mail.ru",
                "tax_system": "osn",
                "payment_address": "shop.ru"
            },
            "receipt_method": "separately",
            "error": null,
            "link": "https://consumer.1-ofd-test.ru/v1?fn=9999078900006369&fp=790695398&i=11900&t=20230330T152000&s=7&n=1",
            "payment_id": "764239789"
        },
        {
            "merchant_id": "542088",
            "receipt_id": "4e7dcdef-ccfc-485c-b63f-1f83dc66845c",
            "operation_type": "sell",
            "receipt_format": "ru_1_05",
            "status": "registered",
            "fiscal_document_number": "11552",
            "fiscal_storage_number": "9999078900006286",
            "fiscal_attribute": "3717461957",
            "registered_at": "30.03.202315:10:00",
            "created_at": "30.03.202315:12:37",
            "fiscal_provider_id": "f3b26edd-a098-42c9-952c-e981a0cff900",
            "positions": [
                {
                    "name": "Товар №1",
                    "quantity": 1,
                    "price": 300,
                    "measure": "piece",
                    "vat_code": "vat_20",
                    "payment_method": "full_payment",
                    "payment_object": "goods",
                    "sum": 300
                },
                {
                    "name": "Товар №2",
                    "quantity": 3,
                    "price": 50,
                    "measure": "piece",
                    "vat_code": "vat_20",
                    "payment_method": "full_payment",
                    "payment_object": "goods",
                    "sum": 150
                }
            ],
            "total": 450,
            "settlements": [
                {
                    "type": "cashless",
                    "sum": 150
                }
            ],
            "company": {
                "inn": "5544332219",
                "email": "customer@mail.ru",
                "tax_system": "osn",
                "payment_address": "shop.ru"
            },
            "receipt_method": "separately",
            "error": null,
            "link": "https://consumer.1-ofd-test.ru/v1?fn=9999078900006286&fp=3717461957&i=11552&t=20230330T151000&s=7&n=1",
            "payment_id": "763548541"
        }
    ]
}

В ответ на запрос вернется список чеков с учетом отправленных фильтров. В списке будет присутствовать информация о чеках за весь период деятельности конкретного магазина, идентификатор которого был передан при генерации JWT. Список будет отсортирован повремени создания чеков в порядке убывания.

Получение информации по чеку
Запрос позволяет получить информацию о текущем состоянии чека по его уникальному идентификатору.

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

В URL необходимо передать идентификатор чека в Paybox.


curl --location --request GET 'https://api.freedompay.uz/v5/receipts/1a624e49-41c3-4d0f-84d3-497483e81153' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json'

Пример тела ответа
В ответ на запрос придет объект чека в актуальном статусе.

{
    "data": {
        "merchant_id": "542088",
        "receipt_id": "1a624e49-41c3-4d0f-84d3-497483e81153",
        "operation_type": "sell",
        "receipt_format": "ru_1_05",
        "status": "registered",
        "fiscal_document_number": "9322",
        "fiscal_storage_number": "9999078900006369",
        "fiscal_attribute": "855240058",
        "registered_at": "28.03.202314:24:00",
        "created_at": "28.03.202317:24:02",
        "fiscal_provider_id": "509a911b-5d96-43ac-9df0-3e5d05cfc16a",
        "positions": [
            {
                "name": "Товар №1",
                "quantity": 1,
                "price": 100,
                "measure": "piece",
                "vat_code": "vat_20",
                "payment_method": "full_payment",
                "payment_object": "goods",
                "sum": 100
            },
            {
                "name": "Товар №2",
                "quantity": 2,
                "price": 50,
                "measure": "piece",
                "vat_code": "vat_20",
                "payment_method": "full_payment",
                "payment_object": "goods",
                "sum": 100
            }
        ],
        "total": 100,
        "settlements": [
            {
                "type": "cashless",
                "sum": 100
            }
        ],
        "company": {
            "inn": "5544332219",
            "email": "customer@mail.ru",
            "tax_system": "osn",
            "payment_address": "shop.ru"
        },
        "receipt_method": "together",
        "error": null,
        "link": "https://consumer.1-ofd-test.ru/v1?fn=9999078900006369&fp=855240058&i=9322&t=20230328T142400&s=7&n=1",
        "payment_id": "762881172"
    }
}