Перейти к содержанию

api/sbp/sbp-credit-precheck - Проверка возможности выплаты через СБП

  • HTTP‑метод: POST
  • URL: /api/sbp/sbp-credit-precheck
  • Форма взаимодействия: Сервер-сервер
  • Формат тела запроса: application/json
  • Назначение: выполнение проверки возможности выплаты через СБП.

URL

1
https://gateway-docs.wallet.kvell.group/api/sbp/sbp-credit-precheck

1
/api/sbp/sbp-credit-precheck

Структура запроса

Поле Тип Обяз. Описание
terminal str ✔ Уникальный идентификатор учетной записи ТСП в ПЦ.
order_id int ✔ Уникальный идентификатор Заказа в ПЦ, полученный по результатам Запроса api/register.
signature str ✔ Цифровая подпись запроса. Алгоритм расчёта — см. Формирование подписи.
Необязательные параметры
receiver object Данные Получателя. Значимые поля (см. структуру payer/receiver): phone (если было задано при регистрации Заказа, значение берётся из Заказа), bank_id — идентификатор банка из справочника участников СБП, payment_mean_token — СБП-токен, полученный ТСП во время осуществления привязки. Чтобы осуществлять выплаты по такому СБП-токену, необходимо предварительно разово провести по нему операцию списания с последующей отменой.

Структура ответа

Поле Тип Обяз. Описание
precheck_tx_id str ✔ Идентификатор операции проверки. Пример: b8777c68e0a041ada283c3e89c413636
amount int ✔ Сумма заказа в минимальных единицах валюты (для RUB — копейки). Пример: 1074
recipient_bank_id str Банк Получателя денежных средств. Пример: 100000000091
pam str Имя Получателя денежных средств. Пример: Svetlana L

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

{
    "precheck_tx_id": "b8777c68e0a041ada283c3e89c413636",
    "amount": 1074,
    "recipient_bank_id": "100000000091",
    "pam": "Svetlana L"
}

{
    "error_code": "TERMINAL_NOT_FOUND",
    "technical_message": "Terminal not found",
    "timestamp": 1751976000,
    "details": null,
    "request_id": "b3b3c1f0-4b3a-4f3a-9b1a-1234567890ab"
}

Примечания

  • receiver.payment_mean_token не используется для совершения выплаты.