API ReferenceMerchant API
Платежные пропуски (Passes)
Использование системы платежных пропусков для гарантированной маршрутизации платежей и управления комиссиями в Syncra V2
Платежные пропуски (Passes)
Механизм платежных пропусков (Passes) — это продвинутая функция платформы Syncra V2, позволяющая мерчантам резервировать определенные реквизиты (карты/номера телефонов) для конкретных плательщиков на заданный период времени.
Это гарантирует успешное прохождение платежей от VIP-игроков, оптимизирует маршрутизацию и защищает реквизиты от перегрузок (Anti-Spam).
Создание платежного пропуска
POST /api/v1/p2p/merchant/passesПараметры запроса (JSON Body)
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
amount | int64 | Да | Сумма бронирования в минимальных единицах валюты. |
currency_id | string(UUID) | Да | UUID валюты из справочника валют платформы. |
requisite_type | string | Да | Тип реквизитов (например, BANK_CARD, SBP). |
expires_at | string(RFC3339) | Да | Время истечения срока действия пропуска. |
provider_id | string(UUID) | Нет | UUID конкретного провайдера (если требуется привязать). |
Пример запроса
{
"amount": 1000000,
"currency_id": "4ac148fe-19a3-45bb-b992-019fac55b72c",
"requisite_type": "BANK_CARD",
"expires_at": "2026-07-12T18:30:00Z"
}Пример ответа (200 OK)
{
"data": {
"pass_id": "812d77a0-0d3a-4422-b91c-7cb052a21abc",
"status": "ACTIVE",
"amount": 1000000,
"currency_id": "4ac148fe-19a3-45bb-b992-019fac55b72c",
"requisite_type": "BANK_CARD",
"expires_at": "2026-07-12T18:30:00Z"
}
}Статусы платежных пропусков
Платежный пропуск может находиться в следующих состояниях:
ACTIVE(Активен): Пропуск создан, реквизиты зарезервированы, ожидает платежа.EXPIRED(Истек): Клиент не совершил платеж в течение отведенного времени.