نظرة عامة

يتيح AdProMaxPay لأي نشاط تجاري في المغرب قبول المدفوعات عبر الإنترنت بواجهة API واحدة، بالدرهم المغربي (MAD):

• الدفع بالبطاقة، على صفحة دفع مستضافة: يغادر عميلك موقعك ليدفع، ثم يعود إليه.
• الدفع نقدًا: يحصل عميلك على رمز دفع ويسدده نقدًا لدى وكيل دفع.

تنشئ دفعة، وترسل عميلك ليدفع، وتعرف النتيجة من إشعار webhook. ويعمل الكود نفسه مع الطريقتين.

بيئة الاختبار أولًانسخ رابط القسم

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

الاختبار والمباشر وضعان منفصلان. لكل منهما مفاتيحه وبياناته: لا تظهر دفعة الاختبار في الوضع المباشر أبدًا، والعكس صحيح.

الدفعة من البداية إلى النهايةنسخ رابط القسم

كل دفعة هي نية دفع (payment intent). تمر بحالات قليلة، ويقرأ كودك الحالة بدل تخمينها.

عند رفض البطاقة أو انتهاء صلاحية رمز الدفع النقدي تعود الدفعة إلى requires_payment_method، ويمكن لعميلك أن يحاول من جديد. تنجح الدفعة مرة واحدة فقط، وبعد تأكيد الدفع ومطابقة المبلغ.

ماذا بعدنسخ رابط القسم

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