Enterprise & Finans Risk API · v1 · REST & HMAC-SHA256 Webhook

Banka, Ödeme Kuruluşu ve ERP Sistemleri İçin Canlı Çözüm & Chargeback Risk API'si

Satıcıların doğrulanmış 96 saatlik çözüm oranlarını ve Visa 13.1 / Mastercard 4853 ters ibraz (chargeback) risk skorlarını gerçek zamanlı sorgulayın; kurumsal uyuşmazlık dosyalarını SAP, Zendesk, Salesforce, Shopify veya İkas sistemlerinizle çift yönlü senkronize edin.

Enterprise Aboneliği Başlat (19.900,00 ₺ / ay) Tüm Kurumsal Paketleri İncele

SHA-256 Bearer Anahtarı (`czm_ent_live_...`)

HMAC-SHA256 İmzalı (`X-Uzlasio-Signature`)

300 İstek / Dakika · Kurumsal SLA

19.900,00 ₺ / ay · 199.000,00 ₺ / yıl (KDV Dahil)

Üç Kurumsal Entegrasyon Katmanı

1. Banka & PF Chargeback Risk Skoru API

Sanal POS (PayTR, iyzico vb.), banka üye işyeri tahsisi ve pazaryerleri için her satıcının doğrulanmış 96s çözüm hızı, açık yaptırım sicili, yeniden açılan söz ihlalleri ve VKN/domain doğrulamasından hesaplanan 0..100 risk skoru.

2. Çift Yönlü ERP / CRM Dosya Senkronizasyonu

Firmanıza yönlendirilen uyuşmazlıkları kendi iç sisteminize çekin (`GET /cases`), SAP / Zendesk içerisinden doğrudan resmi yanıt iletin (`POST /respond`) veya iade/değişim sonucunu bildirin (`POST /outcome`).

3. Kriptografik Güvenlik & Anlık Abonelik İzolasyonu

Ham API anahtarları veritabanında asla tutulmaz (yalnızca SHA-256 özeti saklanır). Abonelik süresi dolduğunda veya anahtar iptal edildiğinde tüm uçlar milisaniyeler içinde kilitlenir.

REST Uç Noktaları Referansı

Temel URL: https://uzlasio.com/api/v1/enterprise

Tüm isteklerde `Authorization: Bearer czm_ent_live_...` (veya `X-API-Key`) başlığı zorunludur. Yanıtlar UTF-8 JSON formatındadır.

Metot	Uç Nokta	Yetki Kapsamı	Açıklama
GET	/api/v1/enterprise/risk/brands	risk:read	Tüm doğrulanmış satıcıların 96s uyum ve Chargeback Risk Skoru (0..100) listesi.
GET	/api/v1/enterprise/risk/brands/:slug	risk:read	Tekil satıcının (`slug`) risk katmanı (`LOW`..`CRITICAL`), underwriting önerisi ve sicil metrikleri.
GET	/api/v1/enterprise/cases	cases:read	Anahtar sahibinin doğrulanan kurumsal markasına ait aktif ve kapanmış çözüm dosyaları.
GET	/api/v1/enterprise/cases/:id	cases:read	Tek bir kurumsal çözüm dosyasının sürüm (`version`), SLA ve kanıt özeti.
POST	/api/v1/enterprise/cases/:id/respond	cases:write	ERP/CRM sisteminden dosyaya kurumsal yanıt gönderir (`INVITED` ise otomatik kabul eder).
POST	/api/v1/enterprise/cases/:id/outcome	cases:write	ERP üzerinden çözüm sonucunu (`FULL_REFUND`, `PARTIAL_REFUND`, `REPLACEMENT`, `REPAIR`, `REJECTED`) işler.

Örnek 1 · Satıcı Chargeback Risk Skoru Sorgusu (Banka / PF / Pazaryeri)

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

Örnek 2 · Gelen ERP Webhook İmzasını Doğrulama (`X-Uzlasio-Signature`)

HMAC-SHA256

Uzlasio her giden olayda (`case.message_received`, `case.outcome_confirmed`, `webhook.ping`) ham JSON gövdesini `t=<unix_ts>,v1=<hex_hmac_sha256>` formatında imzalar:

# 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 Risk Skoru (0..100) Derecelendirme Katmanları

0 – 24 · LOW (Düşük Risk)

Yüksek 96 saatlik uzlaşma oranı, sıfır açık yaptırım sicili, doğrulanmış kurumsal alan adı ve VKN. Standart POS valörü için uygundur.

25 – 49 · MODERATE (Orta Risk)

Standart çözüm performansı veya yeni sicil geçmişi. Standart valör ve rutin SLA takibi önerilir.

50 – 74 · HIGH (Yüksek Risk)

Birden fazla 96 saatlik kalkan ihlali veya gecikmeli çözüm. Uzatılmış POS valörü / ek bloke teminat önerilir.

75 – 99 · CRITICAL (Kritik Risk)

Yoğun cevapsız 96s ihlali, açık TÜBİS / Visa 13.1 / MC 4853 yaptırım dosyaları. Manuel risk ve üye işyeri denetimi gerekir.

Standart HTTP Durum ve Hata Kodları

HTTP 401	UNAUTHENTICATED	`Authorization: Bearer czm_ent_live_...` başlığı eksik.
HTTP 401	INVALID_API_KEY	API anahtarı hatalı veya sistemde kayıtlı değil.
HTTP 401	REVOKED_API_KEY	API anahtarı Firma Paneli üzerinden iptal edilmiş.
HTTP 403	ENTERPRISE_SUBSCRIPTION_INACTIVE	Anahtar geçerli ancak firmanın Enterprise aboneliği sona ermiş veya düşürülmüş.
HTTP 404	BRAND_NOT_FOUND	Sorgulanan `slug` için doğrulanmış marka veya sicil kaydı bulunamadı.
HTTP 429	RATE_LIMITED	Dakikada 300 istek sınırı aşıldı (`Retry-After` ile tekrar deneyin).

Kurumsal Sisteminizi Bugün Bağlayın

PayTR 3D Secure kurumsal kart veya Proforma Havale/EFT ile Enterprise aboneliğinizi aktifleştirdiğiniz saniye Firma Panelinizde API anahtarı üretimi ve Webhook konsolu açılır.

Enterprise Aboneliği Başlat (19.900,00 ₺ / ay)