Enterprise & Финансовый Риск-API · v1 · REST и HMAC-SHA256 Webhook

API урегулирования и оценки рисков чарджбэка для банков, платёжных систем и ERP

Запрашивайте в реальном времени подтверждённые показатели решения за 96 часов и скоринг рисков чарджбэка (Visa 13.1 / Mastercard 4853), а также двусторонне синхронизируйте споры с SAP, Zendesk, Salesforce и Shopify.

Подключить Enterprise (19 900,00 ₺ / мес.) Сравнить все корпоративные тарифы

SHA-256 Bearer-ключ (`czm_ent_live_...`)

Подпись HMAC-SHA256 (`X-Uzlasio-Signature`)

300 запросов / мин · Корпоративный SLA

19 900,00 ₺ / мес. · 199 000,00 ₺ / год (с НДС)

Три уровня корпоративной интеграции

1. Скоринг рисков чарджбэка продавцов для банков и PSP

Оценка риска 0..100 на основе доли подтверждённых решений за 96ч, активных санкций, повторно открытых дел и верификации домена/ИНН.

2. Двусторонняя синхронизация дел с ERP / CRM

Загружайте дела в свою систему (`GET /cases`), отправляйте официальные ответы из SAP или Zendesk (`POST /respond`) и фиксируйте возвраты (`POST /outcome`).

3. Криптографическая защита и мгновенная изоляция подписки

Исходные ключи никогда не хранятся в БД (только SHA-256 хэш). При отзыве ключа или истечении подписки Enterprise доступ блокируется мгновенно.

Справочник REST-эндпоинтов

Базовый URL: https://uzlasio.com/api/v1/enterprise

Каждый запрос требует заголовок `Authorization: Bearer czm_ent_live_...` (или `X-API-Key`). Формат ответов — UTF-8 JSON.

Метод	Эндпоинт	Права	Описание
GET	/api/v1/enterprise/risk/brands	risk:read	Список всех верифицированных продавцов с метриками 96ч и скорингом чарджбэка (0..100).
GET	/api/v1/enterprise/risk/brands/:slug	risk:read	Детальный риск-отчёт по продавцу (`LOW`..`CRITICAL`), рекомендация андеррайтинга и метрики.
GET	/api/v1/enterprise/cases	cases:read	Список активных и закрытых споров вашего верифицированного бренда.
GET	/api/v1/enterprise/cases/:id	cases:read	Полный снимок дела для ERP с версией (`version`) и статусом SLA.
POST	/api/v1/enterprise/cases/:id/respond	cases:write	Отправка официального ответа компании из ERP/CRM (автоматически принимает `INVITED`).
POST	/api/v1/enterprise/cases/:id/outcome	cases:write	Фиксация результата (`FULL_REFUND`, `PARTIAL_REFUND`, `REPLACEMENT`, `REPAIR`, `REJECTED`).

Пример 1 · Запрос скоринга риска чарджбэка продавца

HTTP 200 JSON

curl -sS https://uzlasio.com/api/v1/enterprise/risk/brands/ornek-elektronik \
  -H "Authorization: Bearer czm_ent_live_YOUR_SECRET_KEY"

# Response (200 OK):
{
  "brand_slug": "ornek-elektronik",
  "display_name": "Örnek Elektronik A.Ş.",
  "vkn_verified": true,
  "domain_verified": true,
  "chargeback_risk_score": 11,
  "risk_tier": "LOW",
  "metrics": {
    "shared_cases": 42,
    "verified_resolved_cases": 40,
    "verified_resolution_rate_pct": 95,
    "sanctioned_96h_breach_cases": 0,
    "reopened_cases": 0,
    "median_resolution_seconds": 14400
  }
}

Пример 2 · Проверка подписи исходящего Webhook (`X-Uzlasio-Signature`)

HMAC-SHA256

Uzlasio подписывает каждое событие (`case.message_received`, `case.outcome_confirmed`, `webhook.ping`) в формате `t=<unix_ts>,v1=<hex_hmac_sha256>`:

# Header:
# X-Uzlasio-Event: case.outcome_confirmed
# X-Uzlasio-Signature: t=1762857600,v1=8f4a9c...

signed_payload = `${timestamp}.${rawRequestBody}`;
expected_v1 = crypto
  .createHmac("sha256", process.env.UZLASIO_WEBHOOK_SECRET)
  .update(signed_payload, "utf8")
  .digest("hex");

crypto.timingSafeEqual(Buffer.from(expected_v1), Buffer.from(v1));

Уровни скоринга риска чарджбэка (0..100)

0 – 24 · LOW (Низкий риск)

Высокая доля решений за 96ч, нет активных нарушений, подтверждённый домен и налоговый номер.

25 – 49 · MODERATE (Умеренный риск)

Стандартные показатели урегулирования; рекомендуются базовые условия расчётов.

50 – 74 · HIGH (Высокий риск)

Несколько нарушений 96-часового щита; рекомендуется увеличенный холд или резерв.

75 – 99 · CRITICAL (Критический риск)

Систематическое игнорирование споров свыше 96ч; требуется ручная проверка рисков.

Стандартные HTTP-коды и ошибки

HTTP 401	UNAUTHENTICATED	Отсутствует заголовок `Authorization: Bearer czm_ent_live_...`.
HTTP 401	INVALID_API_KEY	Неверный или неизвестный ключ Enterprise API.
HTTP 401	REVOKED_API_KEY	API-ключ был отозван в панели компании.
HTTP 403	ENTERPRISE_SUBSCRIPTION_INACTIVE	Подписка Enterprise истекла или неактивна.
HTTP 404	BRAND_NOT_FOUND	Верифицированный продавец с указанным `slug` не найден.
HTTP 429	RATE_LIMITED	Превышен лимит 300 запросов в минуту.

Подключите вашу корпоративную систему сегодня

Сразу после оплаты через PayTR 3D Secure или по счёту-проформе (Havale/EFT) выпуск API-ключей и настройка Webhook открываются в панели компании.

Подключить Enterprise (19 900,00 ₺ / мес.)