# قائمة التحقق قبل الوضع المباشر

كيف سيفتح التفعيل المدفوعات الحقيقية، وما الذي تجهّزه، وما الذي تتحقق منه قبل التبديل من مفاتيح الاختبار إلى مفاتيح الوضع المباشر.

تعمل اليوم كل حسابات AdProMaxPay في بيئة الاختبار. تُفتح المدفوعات الحقيقية مع **التفعيل**، وهو قادم:
تعرّفنا بنشاطك التجاري، فنتحقق منه، ثم يصبح حسابك مفعّلًا. تشرح هذه الصفحة كيف سيعمل التفعيل وما
الذي تجهّزه، وتسرد ما تتحقق منه في تكاملك، ليكون الانتقال إلى الوضع المباشر تغييرًا للمفاتيح لا
للكود.

وهذا ممكن لأن وضع الاختبار والوضع المباشر يشغّلان الكود نفسه: انظر
[بيئة الاختبار والوضع المباشر: الفروق](https://pay-docs.adpromax.com/ar/sandbox/differences).

## كيف يعمل التفعيل

تبيّن قيمة `activation_status` لحسابك، في [`GET /v1/account`](https://pay-docs.adpromax.com/ar/get-started/api-keys)، أين وصل. وتبقى
`sandbox` إلى أن تطلب التفعيل.

تفعيل الحساب:

- `sandbox` → `submitted`: ترسل طلبك
- `submitted` → `under_review`
- `under_review` → `information_requested`
- `information_requested` → `under_review`
- `under_review` → `partner_review`: موافقتنا
- `partner_review` → `active`: موافقة شريكنا
- `under_review` → `rejected`: رفض
- `partner_review` → `rejected`

1. **ترسل** بيانات نشاطك التجاري ووثائقه من لوحة التحكم.
2. **يراجعها فريقنا.** إذا نقص شيء أو لم يكن واضحًا، نطلب معلومات إضافية مع مهلة محددة، ونعرض
   السبب بجانب كل حقل معني. وبعد ردّك يعود الملف إلى المراجعة.
3. **شريكنا المرخّص في مجال الدفع**، وهو الذي يحتفظ بالأموال، يوافق بعد ذلك بدوره على نشاطك
   التجاري. وتعرض لوحة التحكم المدة التي يستغرقها ذلك عادة.
4. **يصبح حسابك `active`**: تعمل مفاتيح الوضع المباشر، والمدفوعات في الوضع المباشر حقيقية.

يُفعَّل الدفع بالبطاقة والدفع نقدًا كلٌّ على حدة. ويعرض `GET /v1/account` حالة كل منهما في
`capabilities.card_payments` و`capabilities.cash_payments`: `inactive` أو `pending` أو `active`.

إذا رُفض التفعيل، تتلقى السبب وتبقى مؤسستك في بيئة الاختبار: تستمر مفاتيح الاختبار وبيانات الاختبار
في العمل. ولاحقًا، قد يصبح الحساب المفعّل `restricted`، فتتوقف المدفوعات أو التسويات مؤقتًا ريثما
تجري مراجعة حجز.

## ما الذي تجهّزه

القائمة أدناه قيد التأكيد وقد تتغير. تجهيزها مبكرًا يوفر عليك الوقت.

* **نشاطك التجاري**: الشكل القانوني، والاسم القانوني، ورقم السجل التجاري (RC) ومدينته، والتعريف
  الموحد للمقاولة ICE (15 رقمًا)، والتعريف الضريبي (IF)، والتسجيل في الرسم المهني، والعنوان،
  والنشاط، وموقعك الإلكتروني أو حسابك على مواقع التواصل الاجتماعي. المقاول الذاتي
  (*auto-entrepreneur*): بطاقة المقاول الذاتي بدل السجل التجاري.
* **أشخاصه**: الممثل القانوني والمستفيدون الفعليون، مع اسم كل منهم وبطاقة هويته وحصته.
* **حسابه البنكي**: كشف التعريف البنكي RIB (24 رقمًا) وشهادة البنك.
* **الوثائق**: النظام الأساسي، وبطاقات الهوية، وإثبات العنوان.
* **البيانات العلنية**: الاسم الذي يظهر في كشوف حسابات عملائك، وبريد إلكتروني وهاتف للدعم، وشعارك.
* **تسجيل دخول فريقك**: بريد إلكتروني تم التحقق منه، والتحقق بخطوتين لكل شخص سيعمل في الوضع
  المباشر (انظر [الأمان](https://pay-docs.adpromax.com/ar/account/security)).

## تحقّق من تكاملك

راجع هذه القائمة قبل التبديل. يحيل كل سطر إلى الصفحة التي تشرحه.

1. **نقطة استقبال webhook للوضع المباشر.** تنتمي كل نقطة استقبال إلى وضع واحد: أنشئ واحدة
   للوضع المباشر، واحفظ سرّها الخاص، وتحقّق من [توقيع](https://pay-docs.adpromax.com/ar/webhooks/signatures) كل عملية تسليم، وعالج
   التسليم الذي يصل مرتين، وأجب بـ `2xx` سريعًا
   ([إعادة المحاولة والترتيب وإزالة التكرار](https://pay-docs.adpromax.com/ar/webhooks/retries)).
2. **سلّم الطلبية بناءً على الإشارة الصحيحة**: `payment_intent.succeeded`، أو حالة نية الدفع
   (payment intent) مقروءة بمفتاحك السري؛ وليس العودة إلى `success_url` أبدًا
   ([كيف تعمل المدفوعات](https://pay-docs.adpromax.com/ar/payments/how-payments-work#إعادة-التوجيه-وإشعارات-webhook-بأيهما-تثق)).
3. **عدم التكرار (idempotency)**: ترويسة `Idempotency-Key` في كل طلب يحرّك أموالًا، مع الاحتفاظ بها
   نفسها عند إعادة المحاولة ([عدم التكرار](https://pay-docs.adpromax.com/ar/api-reference/idempotency)).
4. **الأخطاء**: يتفرع كودك بحسب `code`، لا بحسب `message` أبدًا، ويسجّل `request_id`
   ([معالجة الأخطاء](https://pay-docs.adpromax.com/ar/errors)).
5. **المفاتيح**: المفاتيح السرية على خادمك فقط، تُقرأ من بيئته أو من مخزن أسرار
   ([الأمان](https://pay-docs.adpromax.com/ar/account/security)).
6. **الحدود**: يعالج كودك `429` و`Retry-After`؛ واطلب حدًا أعلى قبل أي حملة
   ([حدود المعدل](https://pay-docs.adpromax.com/ar/api-reference/rate-limits)).
7. **الدفع نقدًا**: تعرض قيمة `amount_to_pay` وأجل القسيمة كما وردا، وتعالج الرموز المنتهية
   الصلاحية، وتحترم الحد الأدنى 100.00 MAD ([الدفع نقدًا](https://pay-docs.adpromax.com/ar/payments/cash-payments)).
8. **الاسترداد**: لا تُسترد إلا المدفوعات بالبطاقة، وقد يستغرق الاسترداد في الوضع المباشر وقتًا أطول
   ليكتمل؛ ويعرف عملاؤك سياستك في المدفوعات النقدية قبل أن يدفعوا
   ([المبالغ المستردة](https://pay-docs.adpromax.com/ar/payments/refunds)).
9. **العلامة التجارية**: شعارك واسمك المعروض وجهة اتصال الدعم على صفحات الدفع، من
   **الإعدادات ← العلامة التجارية**.
10. **الفريق**: لكل شخص الدور الذي يحتاجه، والجميع يستخدم التحقق بخطوتين
    ([الفريق والأدوار](https://pay-docs.adpromax.com/ar/account/team-and-roles)).
11. **كل سيناريو** في [اختبر تكاملك](https://pay-docs.adpromax.com/ar/get-started/test-your-integration) ينجح.

## الانتقال إلى الوضع المباشر

بعد تفعيل حسابك:

1. بدّل لوحة التحكم إلى الوضع المباشر، وأنشئ مفاتيح الوضع المباشر من **المطوّرون ← مفاتيح API**.
   يُعرض المفتاح السري للوضع المباشر (`apx_sk_live_…`) مرة واحدة فقط، عند إنشائه: احفظه حينها.
2. ضع مفاتيح الوضع المباشر في إعدادات بيئة الإنتاج فقط. وتحتفظ أجهزة التطوير والاختبار بمفاتيح
   الاختبار.
3. أنشئ نقطة استقبال الـ webhook للوضع المباشر، واحفظ سرّها.
4. أنشئ عملاءك وروابط الدفع من جديد في الوضع المباشر: تبقى كائنات الاختبار في وضع الاختبار.
5. اقرأ [بيئة الاختبار والوضع المباشر: الفروق](https://pay-docs.adpromax.com/ar/sandbox/differences) مرة أخرى: في الوضع المباشر تكون
   صفحة البطاقة هي الصفحة الآمنة لشريكنا في البطاقات، ويأتي 3-D Secure من بنك عميلك، وتُفحص رموز
   الدفع النقدي كل دقيقتين، وتصبح الأموال متاحة بعد فترة الحجز المحددة عند التفعيل، وقد تبقى
   عمليات الاسترداد `pending` مدة أطول.
6. نفّذ أول دفعة حقيقية صغيرة، وتتبّعها حتى يصلك إشعار الـ webhook الخاص بها.

## ما القادم

سيجلب التفعيل، دون تواريخ محددة بعد:

* التفعيل من لوحة التحكم: بياناتك ووثائقك وتقدّم المراجعة؛
* مفاتيح الوضع المباشر والوضع المباشر نفسه؛
* التحقق بخطوتين إلزاميًا للوضع المباشر، ومطلوبًا من جديد عند الإجراءات الحساسة مثل إنشاء مفتاح
  للوضع المباشر أو تغيير فريقك؛
* التسويات إلى حسابك البنكي، مع تقاريرها؛
* فترة الحجز لرصيدك في الوضع المباشر؛
* الرسوم والفواتير.

سنعلن عن كل منها في [سجل التغييرات](https://pay-docs.adpromax.com/ar/changelog).