Скоринг клиента
POST /v1/client/score — сегмент, вероятность оплаты, флаг бота
Скоринг клиента
POST /v1/client/score отвечает на вопрос «кто этот клиент» до показа
способов оплаты. Вызовите его, когда клиент собрался платить: ответ содержит
сегмент, эмпирическую вероятность оплаты и флаг бота.
Когда звать
- Открыт чекаут и известна сумма корзины — до рендера способов оплаты.
- Сумма или метод изменились существенно — можно переспросить (ручка
идемпотентна по паре
sellPointKey+clientIdKey). - Не чаще пары раз на один чекаут: скоринг не «пинг», а решение.
Запрос
{
"sellPointKey": "my-shop-ru-1",
"clientIdKey": "client-4711",
"amountRequested": "1500.00",
"toPayCurrency": "RUB",
"selectedMethodKey": "card_ru",
"fingerprint": "9f8e2ab41c",
"ip": "203.0.113.7",
"userAgent": "MyPlatform/1.0",
"clientHints": { "jsOk": true, "honeypotTriggered": false }
}| Поле | Обяз. | Тип | Описание |
|---|---|---|---|
sellPointKey | да | string ≤256 | стабильный идентификатор точки продажи |
clientIdKey | да | string ≤256 | стабильный идентификатор клиента |
amountRequested | да | decimal-string | сумма корзины; строкой, число = 400 |
selectedMethodKey | да | string ≤256 | выбранный/предпочитаемый метод |
toPayCurrency | нет | string 3-4 | ISO 4217; при отсутствии — валюта платформы |
fingerprint | нет | string ≤256 | ваш стабильный отпечаток браузера/устройства |
ip | нет | string ≤64 | IP клиента как вы его видите |
userAgent | нет | string ≤512 | User-Agent клиента |
clientHints | нет | object | jsOk — страница исполнила JS; honeypotTriggered — заполнена ловушка |
Необязательные поля повышают качество анти-бот-складки. Если можете
передавать fingerprint, ip и userAgent — передавйте: они же
участвуют в velocity-сигналах (частота запросов, разделение
отпечатков между клиентами).
Ответ
{
"clientGroup": "TRUSTED",
"paymentScore": "0.9812",
"preferredAcceptorKey": ["acc-7"],
"isBot": false
}| Поле | Всегда | Описание |
|---|---|---|
clientGroup | да | NEW, STICKY, PAYING, TRUSTED, BLOCKED |
paymentScore | да | вероятность оплаты, 4 знака; новый клиент — 0.5000 |
isBot | да | флаг анти-бот-складки |
preferredAcceptorKey | нет | только для STICKY — привязка клиента |
payLimitValue | нет | когда платформа включает скоринговые лимиты — список строк |
Сегменты
| Группа | Смысл | Что делать |
|---|---|---|
NEW | первый контакт | стандартный флоу, скор нейтрален |
STICKY | привязан к реквизиту | учесть preferredAcceptorKey |
PAYING | платил без привязки | стандартный флоу |
TRUSTED | устойчивая история оплат | можно ослаблять внутренние трения |
BLOCKED | блокировка (решение или цепочка неоплат) | не показывать оплату |
BLOCKED — терминальная рекомендация: платформа уже учла цепочки
неоплат. Показывать такому клиенту реквизиты — ваш риск.
paymentScore
Эмпирическая вероятность успешной оплаты: отношение успешных финалов к
общим, со сглаживанием (новый клиент — 0.5000, а не 0). Монотонно
растёт с историей. Трактовка порогов — за интегратором; типовое:
< 0.6 — осторожно, > 0.9 — доверие.
isBot
Складка анти-бот-сигналов: velocity-паттерны, разделение отпечатков,
honeypot, поведение. true — показывать реквизиты не стоит; вердикт-ручка
дополнительно применит свои правила.