BUILD / DEVELOPERS

ابنِ اتصالك مع ناز.

هوية موحدة وواجهات موثقة وعقود واضحة للربط والاختبار.

PARTNER API / V1

اربط منشأتك. شارك القدرات المعتمدة فقط.

يمكن لأي منشأة تقديم اتصال دون اشتراط وجود متجر. تعتمد إدارة ناز الدخول الموحد والخدمات والاشتراكات والفواتير والمنتجات والطلبات بشكل مستقل. بعد التفعيل تُطبق البيانات الصحيحة تلقائياً، وتظهر أسباب رفض البيانات غير الصالحة في سجل المزامنة.

عقد النظام المصدر — OpenAPI TypeScript SDK PHP SDK

POST /api/v1/partner/events
X-Naz-Connection: <approved-connection-id>
X-Naz-Signature: t=<unix-seconds>,v1=<hmac-sha256>

signed bytes = timestamp + "." + raw JSON body
{version: 1, id, type, entityId, revision, occurredAt, data}

يظل السعر والضريبة والمخزون وعرض الترقية والفاتورة الأصلية من مسؤولية المصدر. لا يغير تحديث الكتالوج عقد اشتراك قائم، ولا يمنح الاستيراد التاريخي نقاطاً. يتطلب الشراء اختبار الحجز والفوترة والتنفيذ والاسترداد لدى المصدر والمزود الحقيقيين.

الدخول الموحد

OpenID Connect مع Authorization Code وPKCE. لكل منصة عميل مستقل ونطاقات مشاركة وعناوين عودة مطابقة.

Issuer
https://sso.naz.sa/identity/realms/naz

Discovery
/identity/realms/naz/.well-known/openid-configuration

قواعد العمليات

مبالغ الواجهات بالهللات الصحيحة، والنقاط وحدات صحيحة.
مفتاح Idempotency-Key ثابت لكل عملية وتكراراتها.
الرصيد في دفتر ناز هو مصدر الحقيقة.
الحجز والتثبيت والإلغاء عمليات مستقلة.
اعتماد منفصل لكل منصة ومتجر وقدرة.

الاستبدال

POST /api/v1/redemptions/authorize
POST /api/v1/redemptions/{id}/capture
POST /api/v1/redemptions/{id}/void

Cookie: __Host-naz_session=<session>
X-CSRF-Token: <csrf_from_auth_me>
Idempotency-Key: order-123-capture

صلاحية العميل والمتجر وموافقة صاحب النقاط شروط مستقلة.

الدفع والرسائل

Nalpay للروابط والاشتراكات والإشعارات الموقعة، وموصلات مستقلة لـSMS وواتساب. التشغيل الحقيقي ينتظر المفاتيح والاعتماد.

توثيق Nalpay

POST /hooks/nalpay

استخدم بيئة الاختبار فقط حتى اعتماد الربط. مفاتيح التكامل لا توضع في المتصفح أو تطبيق الهاتف.