POST receipt.pay
Оплата
POST /api/v1/partner/receipt/pay
Метод используется для проведения оплаты по ранее созданному идентификатору чека. В запросе необходимо передать токен карты и OTP-код, полученный владельцем карты при вызове метода /authorize. Результатом выполнения метода является успешное списание средств с карты и фискализация данных в ОФД, если налоговая фискализация осуществляется на стороне Beepul.
info
ВНИМАНИЕ! Если партнёр или пользователь трижды введёт некорректный OTP по одному чеку, этот чек переходит в состояние Cancelled, и потребуется создать новый.
Запрос
{
"id": "01JXHV0TP2MK3KC4QQ083ZRGH7",
"card": {
"token": "4d6441c4-8db2-4f6f-b962-924719cce1d5"
},
"otp" : "123456"
}
| Параметр | Тип | Описание | Обязательное поле |
|---|---|---|---|
id | string | Идентификатор платежа, сформированный Beepul и возвращаемый в ответе метода /create после успешного создания чека. Используется в последующих методах: /authorize, /pay и /check-id. | Да |
card.token | string | Токен карты для платежа | Да |
otp | string | OTP код который был отправлен пользователю при вызове метода /api/v1/partner/receipt/authorize | Да (может быть не обязательным в зависимости от типа мерчанта на стороне Beepul) |
Ответ
{
"tid": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
"id": "01HMRHQ3X4P310THNTZW0DGK3J",
"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",
"card_number": "986027******3758"
}
| Свойство | Тип и пример значения | Описание |
|---|---|---|
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 списания в платежной системе |
card_number | string | Номер карты в маскированном виде. |