Вердикт checkout
POST /v1/client/verdict — можно ли выдать реквизит сейчас, cooldown-лестница
Вердикт checkout
POST /v1/client/verdict отвечает на вопрос «можно ли выдать реквизит
этому клиенту сейчас». Вызовите его после score, непосредственно перед
выдачей реквизита.
Когда звать
- Непосредственно перед показом реквизита.
- При повторной попытке после
WAIT— не раньше истеченияwaitSeconds. - При смене метода или суммы — переспросить.
Не звать «про запас»: каждый вызов участвует в velocity-сигналах, а повторные вызовы двигают клиента по cooldown-лестнице.
Запрос
{
"sellPointKey": "my-shop-ru-1",
"clientIdKey": "client-4711",
"method": "card_ru",
"amountRequested": "1500.00",
"toPayCurrency": "RUB",
"orderRef": "order-100500"
}| Поле | Обяз. | Тип | Описание |
|---|---|---|---|
sellPointKey | да | string ≤256 | точка продажи |
clientIdKey | да | string ≤256 | клиент |
method | да | string ≤256 | метод, под который запрашивается реквизит |
amountRequested | да | decimal-string | сумма |
toPayCurrency | нет | string 3-4 | ISO 4217 |
orderRef | да | string ≤256 | ваш идентификатор заказа (для платформы непрозрачен) |
Ответ
{
"verdict": "GET_NEW",
"reason": "ladder level 1 granted",
"ruleVersion": "p2.v10",
"isBot": false
}| Поле | Всегда | Описание |
|---|---|---|
verdict | да | одна из четырёх команд (таблица ниже) |
waitSeconds | нет | только с WAIT — сколько ждать до повторного запроса |
stickyRequisiteRef | нет | только с GET_SAME_STICKY — ссылка на привязанный реквизит |
reason | да | человекочитаемое объяснение (свободная форма) |
ruleVersion | да | версия набора правил |
isBot | да | флаг бота |
Вердикты и что с ними делать
| Вердикт | Смысл | Действие интегратора |
|---|---|---|
GET_NEW | выдать новый реквизит | запрашивайте реквизит у платёжного контура |
GET_SAME_STICKY | показать привязанный (stickyRequisiteRef) | не запрашивать новый, показать существующий |
WAIT | cooldown-лестница | показать таймер на waitSeconds, потом переспросить |
BLOCK | отказ | не выдавать реквизит; показать поддержку |
Cooldown-лестница
Платформа ограничивает частоту выдачи реквизитов одному клиенту:
- первый запрос — без ожидания;
- второй запрос, если первый не дошёл до оплаты, — ожидание уровня 1 (десятки секунд);
- третий — уровня 2 (минуты);
- дальше — уровня 3 (десятки минут).
Счётчик сбрасывается успешной оплатой или долгим отсутствием клиента
(порядка суток). Уровни настраиваются платформой; конкретные секунды
приходят в waitSeconds — не хардкодьте их.
WAIT — не ошибка и не отказ: это инструкция «покажи таймер и
переспроси». Повторный запрос раньше waitSeconds получит следующий
уровень лестницы.
ruleVersion
Версия набора правил, вынесших вердикт (сейчас p2.v10). При разборе
спорных кейсов указывайте её владельцу платформы вместе с orderRef.