Enterprise & Finanz-Risiko-API · v1 · REST & HMAC-SHA256 Webhooks

Echtzeit-Lösungs- & Chargeback-Risiko-API für Banken, Zahlungsdienste & ERP-Systeme

Fragen Sie verifizierte 96-Stunden-Lösungsquoten und Visa 13.1 / Mastercard 4853 Chargeback-Risikoscores in Echtzeit ab und synchronisieren Sie Streitfälle bidirektional mit SAP, Zendesk, Salesforce oder Shopify.

Enterprise-Abonnement starten (19.900,00 ₺ / Monat) Alle Unternehmenstarife vergleichen

SHA-256 Bearer-Schlüssel (`czm_ent_live_...`)

HMAC-SHA256 signiert (`X-Uzlasio-Signature`)

300 Anfragen / Min. · Enterprise-SLA

19.900,00 ₺ / Monat · 199.000,00 ₺ / Jahr (inkl. MwSt.)

Drei Enterprise-Integrationsschichten

1. Bank- & PSP-Händler-Chargeback-Risikoscore-API

0..100 Risikobewertung auf Basis verifizierter 96h-Lösungsraten, offener Sanktionen, wiedereröffneter Fälle und Domain-/Steuernummer-Prüfung.

2. Bidirektionale ERP- / CRM-Fallsynchronisation

Rufen Sie Streitfälle ab (`GET /cases`), antworten Sie direkt aus SAP oder Zendesk (`POST /respond`) und melden Sie Rückerstattungen (`POST /outcome`).

3. Kryptografische Sicherheit & Live-Tarifisolierung

Klartext-Schlüssel werden niemals gespeichert (nur SHA-256-Hashes). Bei Widerruf oder Ablauf des Enterprise-Abos wird der Zugriff sofort gesperrt.

REST-Endpunkt-Referenz

Basis-URL: https://uzlasio.com/api/v1/enterprise

Jede Anfrage erfordert `Authorization: Bearer czm_ent_live_...` (oder `X-API-Key`). Alle Antworten erfolgen als UTF-8 JSON.

Methode	Endpunkt	Berechtigung	Beschreibung
GET	/api/v1/enterprise/risk/brands	risk:read	Liste aller verifizierten Händler inkl. 96h-Compliance & Chargeback-Score.
GET	/api/v1/enterprise/risk/brands/:slug	risk:read	Einzelner Händler-Risikobericht (`LOW`..`CRITICAL`), Underwriting-Empfehlung & Metriken.
GET	/api/v1/enterprise/cases	cases:read	Aktive und abgeschlossene Fälle Ihrer verifizierten Unternehmensmarke.
GET	/api/v1/enterprise/cases/:id	cases:read	Detailansicht eines Unternehmensfalls inkl. Version und SLA-Status.
POST	/api/v1/enterprise/cases/:id/respond	cases:write	Sendet eine offizielle Unternehmensantwort aus dem ERP (akzeptiert `INVITED` automatisch).
POST	/api/v1/enterprise/cases/:id/outcome	cases:write	Übermittelt das Lösungsergebnis (`FULL_REFUND`, `PARTIAL_REFUND`, `REPLACEMENT`, `REPAIR`, `REJECTED`).

Beispiel 1 · Händler-Chargeback-Risikoscore abfragen

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
  }
}

Beispiel 2 · HMAC-SHA256 Webhook-Signatur prüfen (`X-Uzlasio-Signature`)

HMAC-SHA256

Uzlasio signiert jedes ausgehende Ereignis (`case.message_received`, `case.outcome_confirmed`, `webhook.ping`) im Format `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));

Chargeback-Risikoscore (0..100) Risikoklassen

0 – 24 · LOW (Niedriges Risiko)

Hohe 96h-Einigungsquote, keine offenen Verstöße, verifizierte Domain & Steuernummer.

25 – 49 · MODERATE (Mittleres Risiko)

Normale Lösungsmetriken; Standard-Auszahlungsfristen empfohlen.

50 – 74 · HIGH (Hohes Risiko)

Mehrere 96h-Verstöße; verlängerte Auszahlungsfrist oder Sicherheitseinbehalt empfohlen.

75 – 99 · CRITICAL (Kritisches Risiko)

Wiederholte unbeantwortete 96h-Fälle; manuelle Risikoprüfung erforderlich.

Standard-HTTP-Status- & Fehlercodes

HTTP 401	UNAUTHENTICATED	`Authorization: Bearer czm_ent_live_...` Header fehlt.
HTTP 401	INVALID_API_KEY	Ungültiger oder unbekannter Enterprise-API-Schlüssel.
HTTP 401	REVOKED_API_KEY	API-Schlüssel wurde im Firmenpanel widerrufen.
HTTP 403	ENTERPRISE_SUBSCRIPTION_INACTIVE	Enterprise-Abonnement ist abgelaufen oder nicht aktiv.
HTTP 404	BRAND_NOT_FOUND	Kein verifizierter Händler für den angegebenen `slug` gefunden.
HTTP 429	RATE_LIMITED	Ratenlimit von 300 Anfragen/Minute überschritten.

Verbinden Sie Ihr ERP- & Risikosystem noch heute

Nach Aktivierung per PayTR 3D Secure oder Proforma-Überweisung werden API-Schlüssel und Webhooks sofort im Firmenpanel freigeschaltet.

Enterprise-Abonnement starten (19.900,00 ₺ / Monat)