الانتقال إلى التشغيل

كيف تحصل على مفاتيح التشغيل

1. نفذ قائمة الاعتماد كاملة في بيئة التجربة.
2. لوحة المطورين تسجل أغلب البنود تلقائيا وأنت تجرب.
3. شغل اختبار الاعتماد الآلي من اللوحة. يتحقق من ربط، وقائمة منشورة، وطلب كامل حتى completed، وحدث webhook وصل إلى عنوانك.
4. بعد نجاح الاختبار يراجع فريقنا حسابك ويوافق.
5. بعد الموافقة تصدر مفاتيح التشغيل pk_live_xxx وsk_live_xxx.

قبل الاعتماد يرد عنوان التشغيل 403 PARTNER_NOT_CERTIFIED.

حالة حسابك

عند الإطلاق ننشئ حسابات الشركاء بأنفسنا. بعدها يفتح التسجيل الذاتي في لوحة المطورين: يبدأ حسابك «بانتظار الاعتماد»، وتعمل بيئة التجربة فورا.

عند التسجيل توافق على شروط الشركاء، ونحفظ نسخة الشروط ووقت الموافقة. إذا تغيرت الشروط نطلب موافقتك من جديد.

الواجهة مجانية في الفترة التجريبية، مع حدود استخدام. سنعلن الأسعار لاحقا.

قائمة الاعتماد

التوقيع والأمان

• طلب صحيح ينجح.
• توقيع خاطئ، ووقت قديم، ورقم عشوائي مكرر: كل واحد يرفض، ونظامك يسجل رمز الخطأ.
• الأسرار في خادمك فقط، لا في تطبيق ولا متصفح ولا سجلات.
• الوقت على خوادمك مضبوط بـ NTP.
• عنوان الـ webhook https عام، وكذلك عنوان التسعير إن وجد.
• لا تطلب customer:contact إلا إذا احتجت رقم العميل كاملا، ونظامك يعمل بالرقم المخفي.

منع التكرار

• إعادة PUT بنفس المفتاح ترجع Idempotent-Replayed: true.
• إعادة المحاولة تأخذ توقيعا جديدا ونفس المفتاح.

الربط

• يعرض نظامك الرمز نصا وQR.
• يعالج link.created.
• بعد link.removed يتوقف كل اتصال بذلك المكان.

القائمة

• نشر قائمة كاملة بصيغة CM v1 ينجح.
• تعديل بنسخة قديمة يعالج: قراءة، ثم إعادة النشر.
• نفاد صنف عند التاجر يصل إلى AurMap خلال 5 ثوان.
• تحديث الحالة يرسل قائمة النفاد كاملة، لا الصنف الجديد وحده.
• menu.changed من التاجر ينعكس في نظامك.
• المطابقة الليلية بـ POST /menus/reconcile تعمل.

الأحداث

• التوقيع يتحقق بمقارنة ثابتة الزمن.
• الرسائل الأقدم من 5 دقائق ترفض.
• الأحداث المكررة تتجاهل حسب event_id.
• الأنواع والحقول غير المعروفة تتجاهل.
• الرد 200 خلال 10 ثوان.

الطلبات

• قبول الطلب قبل accept_by.
• رفض بسبب.
• المسار الكامل حتى completed.
• إلغاء التاجر بعد القبول.
• order.cancelled بسبب customer وtimeout يزيل الطلب من شاشة المطبخ.
• طلب نقدي يكتمل عند الاستلام.

التعافي

• بعد 10 دقائق من توقف عنوانك، يستعيد نظامك الطلبات المنتظرة من GET /orders?status=received أو سجل الأحداث.
• رد 429 يعاد بعد Retry-After.

التشغيل

• بريد دعم فني لفريقك، ووسيلة للتواصل عند الأعطال.

لأنظمة المحاسبة قريبا

• اليوم المغلق يطابق التحويل.
• التصحيحات تسجل في يومها الصحيح.

يوم الإطلاق

1. أضف مفاتيح التشغيل وعنوان التشغيل إلى خادمك.
2. سجل عنوان webhook للتشغيل، واحفظ سره.
3. أرسل «إرسال تجربة» من اللوحة وتأكد أنه وصل.
4. اربط فرعا واحدا لتاجر حقيقي أولا، وتابع أول طلب معه.
5. بعدها افتح الربط لكل تجارك.