Оплата с холдированием
warning
Данная страница актуальна только в случае, если в вашем модуле используется холдирование. Для подключения функции холдирования обратитесь в поддержку Beepul.
Холдирование позволяет временно блокировать сумму на карте клиента до окончательного подтверждения оплаты. Метод используется при создании чека с параметром "is_hold": true (/api/v1/partner/anonymous/create).
После вызова метода:
- Клиент видит обновлённый баланс с учётом удержанной суммы.
- Статус транзакции для клиента — «Платёж в обработке».
- После подтверждения оплаты со стороны сервиса (мерчанта) статус меняется на «Успешно».
Результат метода:
- Успешное списание средств с карты клиента.
- Фискализация данных в ОФД.
Подтверждение холдирования
POST /api/v1/partner/anonymous/hold-confirm
Запрос
{
"id": "string"
}
| Параметр | Тип | Описание | Обязательное поле |
|---|---|---|---|
id | string | Идентификатор платежа, сформированный Beepul и возвращаемый в ответе метода /create после успешного создания чека. Используется в последующих методах: /authorize, /pay и /check-id. | Да |
Ответ
{
"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 | Время создания чека |
pay_date | integer, timestamp | Время оплаты чека |
error | string | Состояние чека |
type | integer ReceiptType | Тип чека |
description | string | Описание платежа |
merchant | object MerchantDetails | Поставщик |
account | array account | |
amount | long | Сумма платежа в тийнах |
init_amount | long | Первоначальная сумма платежа (поле будет приходит в случае если по чеку был осуществлён частичный возврат) |
currency | integer ISO 4217 | Тип валюты |
commission | long | Комиссия |