واجهة Enterprise ومخاطر التمويل · v1 · REST و HMAC-SHA256 Webhook

واجهة برمجية فورية لمخاطر استرداد المدفوعات والحلول لـ البنوك ومؤسسات الدفع وأنظمة ERP

استعلم فورياً عن معدلات الحل الموثقة خلال 96 ساعة ودرجات مخاطر استرداد المدفوعات (Visa 13.1 / Mastercard 4853)، وزامن ملفات النزاعات ثنائياً مع SAP و Zendesk و Salesforce و Shopify.

تفعيل اشتراك Enterprise (19,900.00 ₺ / شهرياً) مقارنة جميع باقات الشركات

مفتاح Bearer مشفر بـ SHA-256 (`czm_ent_live_...`)

موقّع بـ HMAC-SHA256 (`X-Uzlasio-Signature`)

300 طلب / دقيقة · اتفاقية مستوى خدمة مؤسسية

19,900.00 ₺ / شهرياً · 199,000.00 ₺ / سنوياً (شامل الضريبة)

ثلاث طبقات للتكامل المؤسسي

1. واجهة درجة مخاطر استرداد المدفوعات للبنوك وبوابات الدفع

مؤشر مخاطر من 0 إلى 100 يُحسب من نسبة الحل خلال 96 ساعة، المخالفات النشطة، والملفات المعاد فتحها، وتوثيق النطاق والرقم الضريبي.

2. مزامنة ثنائية الاتجاه مع أنظمة ERP / CRM

اسحب الملفات إلى نظامك الداخلي (`GET /cases`)، وأرسل ردود الشركة مباشرة من SAP أو Zendesk (`POST /respond`) وأثبت نتيجة الاسترداد أو الاستبدال (`POST /outcome`).

3. أمان تشفيري وعزل فوري للاشتراك

لا تُخزّن المفاتيح الخام أبداً (فقط بصمة SHA-256). عند إلغاء المفتاح أو انتهاء اشتراك Enterprise يتوقف الوصول فوراً.

مرجع نقاط النهاية REST

الرابط الأساسي: https://uzlasio.com/api/v1/enterprise

يتطلب كل طلب ترويسة `Authorization: Bearer czm_ent_live_...` وتكون جميع الاستجابات بصيغة UTF-8 JSON.

الطريقة	المسار	النطاق	الوصف
GET	/api/v1/enterprise/risk/brands	risk:read	قائمة التجار الموثقين مع درجة مخاطر استرداد المدفوعات (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	تفاصيل ملف نزاع مؤسسي واحد مع رقم الإصدار وحالة مهلة 96 ساعة.
POST	/api/v1/enterprise/cases/:id/respond	cases:write	إرسال رد مؤسسي رسمي من نظام ERP/CRM.
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));

فئات تصنيف درجة مخاطر Chargeback (0..100)

0 – 24 · LOW (مخاطر منخفضة)

التزام عالٍ بمهلة 96 ساعة، صفر مخالفات نشطة، ونطاق ورقم ضريبي موثقان.

25 – 49 · MODERATE (مخاطر متوسطة)

أداء حل قياسي؛ يُوصى بسياسة التسوية المعتادة.

50 – 74 · HIGH (مخاطر مرتفعة)

عدة تجاوزات لمهلة 96 ساعة؛ يُوصى بتمديد فترة التسوية أو ضمان إضافي.

75 – 99 · CRITICAL (مخاطر حرجة)

مخالفات متكررة بدون رد خلال 96 ساعة؛ تتطلب مراجعة مخاطر يدوية.

رموز الحالة والأخطاء القياسية

HTTP 401	UNAUTHENTICATED	ترويسة `Authorization: Bearer czm_ent_live_...` مفقودة.
HTTP 401	INVALID_API_KEY	مفتاح API غير صالح أو غير مسجل.
HTTP 401	REVOKED_API_KEY	تم إلغاء مفتاح API من لوحة الشركة.
HTTP 403	ENTERPRISE_SUBSCRIPTION_INACTIVE	اشتراك Enterprise غير نشط أو انتهت صلاحيته.
HTTP 404	BRAND_NOT_FOUND	لم يتم العثور على تاجر موثق بالمعرّف المطلوب.
HTTP 429	RATE_LIMITED	تم تجاوز الحد الأقصى (300 طلب في الدقيقة).

اربط منظومتك المؤسسية اليوم

بمجرد تفعيل اشتراك Enterprise عبر PayTR 3D Secure أو الحوالة البنكية، يتم فتح توليد مفاتيح API وإعدادات Webhook فوراً في لوحة الشركة.

تفعيل اشتراك Enterprise (19,900.00 ₺ / شهرياً)