Scoring API

Syncra Scoring API — программный интерфейс контура клиентского скоринга. Он отвечает на два вопроса интегратора в момент, когда клиент собрался платить:

1. Кто этот клиент? — POST /v1/client/score: сегмент (NEW, STICKY, PAYING, TRUSTED, BLOCKED), эмпирическая вероятность оплаты, флаг бота.
2. Можно ли выдать реквизит сейчас? — POST /v1/client/verdict: вердикт checkout с учётом cooldown-лестницы (второй запрос подряд подождёт, третий — дольше).

API построен для платформ, которые показывают клиенту способы оплаты и выдают платёжные реквизиты: казно, беты-платформы, платёжные шлюзы. Первым клиентом является legacy-платформа Syncra; контракт одинаков для всех интеграторов.

Базовая информация

Базовый URL

https://api.syncra.money/api/v1/scoring

Стейдж (для интеграционного тестирования):

https://api-stage.syncra.money/api/v1/scoring

Формат данных

• Запросы: POST, тело application/json (UTF-8), размер ≤ 16 KiB.
• Имена полей — camelCase.
• Денежные суммы — десятичные строки ("amountRequested": "1500.00"). JSON-число в поле суммы — ошибка 400.
• Успешные ответы — плоский JSON-объект ({"clientGroup": "NEW", ...}).
• Ошибки — через точку публикации приходят в обёртке RFC 9457 problem+json; исходный KA-текст {"message": "..."} едет в поле detail дословно (см. Ошибки).

Аутентификация

Один заголовок — X-KA-Access-Key (см. Аутентификация). Ключ выдаёт владелец платформы Syncra; каждый ключ ограничен набором ручек (scoped). Ответы на запросы вне выданной зоны — 403.

Что API не делает

• Не выдаёт платёжные реквизиты — только скоринг и вердикты; реквизиты выдаёт платёжный контур платформы.
• Не принимает персональные данные: PAN, полные реквизиты, имена владельцев карт в запросы не передаются — и из ответов не возвращаются.
• Не списывает и не двигает деньги.

Ограничение частоты

Точка публикации использует общий бакет неаутентифицированных запросов шлюза: порядка 20 запросов в секунду с одного IP. Доменные лимиты платформы выражаются семантикой ответа (WAIT + waitSeconds), а не HTTP 429. Подробности — в Лимитах.

Дальше

• Быстрый старт — первый вызов за 5 минут.
• Аутентификация — ключи и scoped-модель.
• Гайд по score и гайд по verdict.
• OpenAPI-спецификация — источник истины.