Документация Froddy

Froddy стоит перед выплатой, принимает один запрос и возвращает allow, hold или block до движения денег.

Froddy — слой контроля перед выплатой для автоматизированных выплат. Он помогает остановить дубли, сломанные лимиты и ошибки payout-логики до отправки денег. Финальное действие остаётся за вашей системой.

Что делает Froddy

Проверяет запрос до отправки выплаты
Возвращает один из вердиктов: allow, hold, block
Помогает находить дубли, ошибки правил и сбои логики
Оставляет единый журнал решений до движения денег

Чего Froddy не делает

не отправляет деньги
не является банком, PSP или payout rail
не заменяет KYC/AML
не является полной антифрод-системой

Как это работает

Ваша система отправляет запрос в Froddy перед выплатой.
Froddy проверяет правила и контекст запроса.
В ответ вы получаете allow, hold или block.
Финальное действие — отправить выплату, поставить её на hold или остановить — остаётся на вашей стороне.

Что передавать в запросе

Передавайте только данные, которые нужны для принятия решения. По умолчанию Froddy не требует сырые персональные данные. Во многих сценариях достаточно хешированных или псевдонимизированных идентификаторов, а также технических и бизнес-полей, которые помогают проверить дубли, лимиты и правила.

Обычно достаточно передать:

идентификатор выплаты или перевода
идентификатор пользователя, аккаунта или партнёра
сумму и валюту
маршрут, способ или тип назначения
метаданные, важные для проверки правил
ключ идемпотентности или внешний идентификатор
время события и связанный контекст

Какие вердикты возвращает API

allow — запрос можно пропускать дальше
hold — запрос нужно остановить для дополнительной проверки или ручного решения
block — запрос нужно отклонить

Используйте этот набор вердиктов последовательно во всей интеграции.

Быстрый старт

Откройте демо и посмотрите формат запроса и ответа.
Создайте аккаунт и получите доступ к тестовой среде.
Подключите один pre-payout вызов перед отправкой денег.
Обработайте allow, hold или block на своей стороне.
При необходимости подключите webhook-уведомления.

Пример запроса

POST /v1/evaluate
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "external_id": "po_20260306_001",
  "actor_id": "usr_9f1c2a7b",
  "amount": 15000,
  "currency": "RUB",
  "destination_id": "dst_7dbcb2c1",
  "method": "card",
  "idempotency_key": "idem_8d1d5b4a",
  "metadata": {
    "partner_id": "partner_42",
    "route": "manual_payout"
  },
  "event_time": "2026-03-06T10:15:00Z"
}

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

{
  "verdict": "hold",
  "reason": "duplicate_check_pending",
  "decision_id": "dec_01HR9Y7J8R4M2K6P5T3W1X9Z"
}

Уведомления

Froddy поддерживает webhook-уведомления о событиях, связанных с обработкой запросов. Используйте webhook как основной способ получать такие сигналы.

Данные и журнал решений

Froddy помогает строить журнал решений до движения денег. По умолчанию можно работать без сырых персональных данных, используя хешированные или псевдонимизированные идентификаторы. Это упрощает минимизацию данных и аудит решений по выплатам.

Если вам нужны DPA или описание обработки данных, свяжитесь с нами.

FAQ

Это антифрод?

Нет. Froddy не заменяет полную антифрод-систему. Он закрывает проверки перед выплатой: дубли, лимиты, ошибки логики и механику hold до движения денег.

Нужно ли передавать сырые персональные данные?

Не обязательно. Во многих сценариях достаточно хешированных или псевдонимизированных идентификаторов и технических полей, которые нужны для проверки правил.

Кто принимает финальное решение по выплате?

Финальное действие остаётся за вашей системой. Froddy возвращает allow, hold или block до отправки денег.

С чего начать?

Начните с демо, затем создайте аккаунт и подключите один pre-payout вызов перед отправкой денег.