POST receipt.create | hold

Создание чека

POST /api/v1/partner/receipt/create

Данный метод вызывается партнёром на этапе формирования оплаты. В запросе передаются сумма, идентификатор мерчанта и номер телефона инициатора. В результате метод возвращает идентификатор предварительного чека, статус "создано", а при наличии комиссии — информацию о ней. После создания чека, сформированный Beepul ID платежа (поле id) используется в последующих методах: /authorize, /pay и /check-id.

info

• ВНИМАНИЕ! Партнер может создавать чеки только для мерчантов, к которым имеет доступ.

Внимание!

Поле payment_initiator — логин или номер телефона инициатора платежа. Является необязательным и может быть включено по запросу партнёра для хранения информации об инициаторе в деталях платежа.

Запрос

{
  "tid": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
  "merchant_id": 1000002,
  "description": "Описание назначения чека",
  "is_hold": false,
  "amount": 10000,
  "account": [
    {
      "key": "payment_initiator",
      "value": "998901234567"
    },
    {
      "key": "clientid",
      "value": "998900227122"
    }
  ],
  "details": {
    "receipt_type": 0,
    "items": [
      {
        "title": "string",
        "unit_price": 10000,
        "count": 2,
        "spic": "00702001001000001",
        "pinfl": "",
        "tin": "",
        "package_code": "123456",
        "units": 241092,
        "vat_percent": 15,
        "discount": 10000
      }
    ]
  }
}

Свойство	Пример значения	Описание	Обязательное поле
tid	string, любое строковое значение уникальное для партнера	Идентификатор транзакции, формируемый инициатором, необходим для идентификации уникальности запроса	Да
merchant_id	long	Идентификатор мерчанта	Да
amount	long	Сумма платежа в тийинах	Да
account	array account	Массив с объектами, {key, value}. Словарь дополнительных деталей для платежа по мерчанту	Опциональное (поле payment_initiator - логин или номер телефона инициатора платежа)
description	string	Описание назначения чека	Нет
is_hold	boolean	Признак использования функционала холдирования. Подробно: Оплата с холдированием	Нет
details	object details	Объект детализации платежа, необязательный параметр	Нет

Ответ

{
  "tid": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
  "id": "01JXHV0TP2MK3KC4QQ083ZRGH7",
  "state": 0,
  "create_date": 1705925906340,
  "pay_date": 0,
  "cancel_date": 0,
  "error": null,
  "type": 1,
  "description": "описание платежа",
  "merchant": {
    "merchant_id": 3000,
    "merchant_name": "Beeline TV - KINOM",
    "category_id": 1,
    "logo_url": "https://cdn.beepul.uz/merchant-logos/91cb41f9-6f0c-4695-9167-0db332d959c2.png",
    "min_amount": 50000,
    "max_amount": 200000000
  },
  "account": [
    {
      "key": "payment_initiator",
      "value": "998903541335"
    }
  ],
  "ofd": {
      "id": "72c2a36c-4841-422a-8b6a-a051ae136f03",
      "code": 0,
      "message": "accepted",
      "terminalId": "AA000000001234",
      "receiptId": 1234,
      "time": "20250604180253",
      "fiscalSign": "665546960905",
      "qrCodeUrl": "https://ofd.soliq.uz/epi?t=EX000000000123&r=1234&c=20250101123045&s=123456789012",
      "tin": "20183800",
      "spic": "10305008003000000",
      "vatRate": 0,
      "label": "Beeline TV - KINOM",
      "packageCode": "1546532",
      "type": "Продажа",
      "merchantInfo": {
        "tin": "3057123456",
        "pinfl": "12345678901234"
  },
    "items": [
    {
      "title": "Подписка на кино",
      "unit_price": 100000,
      "count": 1,
      "spic": "10305008003000000",
      "pinfl": "12345678901234",
      "tin": "3057123456",
      "package_code": "123456",
      "units": 1,
      "vat_percent": 12,
      "discount": 0
    },
    {
      "title": "Пакет сериалов",
      "unit_price": 50000,
      "count": 2,
      "spic": "10305008003000001",
      "pinfl": "12345678901235",
      "tin": "3057123457",
      "package_code": "123456",
      "units": 1,
      "vat_percent": 12,
      "discount": 5000
    }
  ]
},
  "amount": 20000010,
  "init_amount": 0,
  "currency": 860,
  "comission": 0,
  "is_verify": true,
  "rrn": "433712924811"
}

Свойство	Тип и пример значения	Описание
tid	string, уникальное строковое значение для партнера	Идентификатор транзакции, сформированный инициатором при создании чека (receipt/create)
id	string	Идентификатор платежа, сформированный Beepul и возвращаемый в ответе метода /create после успешного создания чека. Используется в последующих методах: /authorize, /pay и /check-id.
state	integer ReceiptState	Состояние чека
create_date	integer, timestamp	Время создания чека (в формате timestamp)
pay_date	integer, timestamp	Время оплаты чека (в формате timestamp)
error	string	Описание ошибки, связанной с чеком (если применимо)
type	integer ReceiptType	Тип чека
description	string	Описание платежа
merchant	object MerchantDetails	Информация о поставщике
account	array account	Дополнительные детали платежа по мерчанту
ofd	object OFDResponseDetails	Фискальные данные ОФД (доступны только для чека в статусе "Продажа")
amount	long	Сумма платежа в тийнах
init_amount	long	Первоначальная сумма платежа (указывается при частичном возврате)
currency	integer ISO 4217	Код валюты в соответствии со стандартом ISO 4217
commission	long	Сумма комиссии
is_verify	boolean	Признак необходимости авторизации. При true, переход в метод /authorize, false переход в метод /pay
rrn	string	RRN списания в платежной системе