# بوابة الدفع الإلكتروني في المغرب | Aslan Payment

> https://aslan.ma/ar/payment

**حصّلوا عبر الإنترنت، على طريقتكم.**

واجهة API دفع محايدة: إدماج واحد لجميع تحصيلاتكم عبر الإنترنت — صفحة دفع مستضافة، روابط، QR code، و cash to web.

## أربع قنوات. إدماج واحد.

- **صفحة دفع مستضافة** — صفحة دفع مطابقة للمعايير وتحمل علامتكم التجارية، يستضيفها Aslan — بيانات البطاقة لا تمر أبداً عبر خوادمكم.
- **رابط الدفع** — أنشئوا رابطاً، وشاركوه عبر WhatsApp أو البريد الإلكتروني أو الفاتورة — حصّلوا دون موقع إلكتروني.
- **QR code** — اعرضوا، امسحوا، تم التحصيل — عند الشباك أو على الشاشة.
- **Cash to web** — يدفع عملاؤكم طلباتهم عبر الإنترنت نقداً، من خلال شبكة من نقاط الأداء.

## ما يعمل في الخلفية.

يعمل Aslan Payment على مسارات مرخّصة — Aslan هو الوكيل الرئيسي لمؤسسة أداء معتمدة من طرف بنك المغرب.

- **علامة بيضاء** — صفحات الدفع والإيصالات والرسائل الإلكترونية بألوانكم — لا يرى عملاؤكم إلا علامتكم التجارية.
- **API محايدة** — إدماج واحد، مستقل عن المسارات التي تعمل تحته — مساراتكم لا تتغير عندما تتطور البنية التحتية.
- **Webhooks والحالات** — كل دفعة تُخطر نظامكم الخلفي في الوقت الفعلي — منشأة، مدفوعة، فاشلة، مستردة.
- **أمان SAQ-A** — صفحات وحقول مستضافة: يبقى الامتثال الخاص بالبطاقات لدينا، لا في شيفرتكم.
- **لوحة التحكم** — تتبع المعاملات، والاستردادات، والتصدير — لفرقكم، لا لمطوريكم فقط.

## عملاؤكم جاهزون للدفع.

إدماج واحد، كل القنوات — لنتحدث عن إدماجكم.

Aslan Payment

بوابة الدفع الإلكتروني

Aslan Payment بوابة دفع إلكتروني للمقاولات في المغرب. واجهة API واحدة للتحصيل عبر صفحة دفع مستضافة، وروابط الدفع، و QR code، و cash to web، بالدرهم. تُدخَل بيانات البطاقة في صفحات مستضافة ولا تلمس خوادمكم أبداً. Aslan هو الوكيل الرئيسي لمؤسسة أداء معتمدة من طرف بنك المغرب.

### من مفتاح API إلى أول دفعة.

- **احصلوا على مفاتيحكم** — مفاتيح الاختبار تنشئ معاملات في بيئة الاختبار، دون أموال حقيقية؛ ومفاتيح live تعالج المدفوعات الحقيقية. تبقى المفاتيح السرية على خادمكم.
- **أنشئوا جلسة أو رابطاً** — يرسل خادمكم مبلغاً بالسنتيمات وعناوين URL للعودة. ويعيد Aslan عنوان URL لصفحة دفع مستضافة — أو رابطاً للمشاركة، مع QR code الخاص به.
- **عميلكم يدفع** — على صفحة مستضافة بألوانكم، بالبطاقة أو عبر cash to web. في حالة الدفع نقداً، يتلقى العميل مرجعاً ويدفع في وكالة أداء.
- **نظامكم الخلفي يتلقى الإخطار** — يؤكد webhook موقّع النتيجة: payment.succeeded أو payment.failed أو payment.expired، و payment.pending_cash ما دامت دفعة نقدية منتظرة.
- **فرقكم تتولى الباقي** — المعاملات، والاستردادات الكلية أو الجزئية، والتصدير موجودة في لوحة التحكم — دون الحاجة إلى مطور في العمل اليومي.

### ما يمكنكم الاعتماد عليه.

- القنوات صفحة دفع مستضافة، روابط دفع مع QR code، و cash to web.
- SDK رسمية Node.js (TypeScript)، و PHP مع حزمة Laravel، و Python، و Go، و Ruby، و React Native، فوق API من نوع REST.
- أمان البطاقات نطاق PCI DSS SAQ A: تُدخَل بيانات البطاقة في صفحات مستضافة ولا تصل أبداً إلى بنيتكم التحتية.
- المبالغ أعداد صحيحة بسنتيمات الدرهم: 5000 تعادل 50.00 درهم.
- Webhooks payment.succeeded، payment.failed، payment.expired، payment.pending_cash، refund.created، refund.updated — موقّعة بـ HMAC-SHA256.
- الاستردادات كلية أو جزئية، مع إمكانية عدة استردادات جزئية حتى المبلغ الأصلي.
- وضع الاختبار مفاتيح اختبار ومفاتيح live منفصلة؛ معاملات الاختبار لا تحرّك أي أموال حقيقية.
- التوثيق مرجع API عمومي على doc.aslan.ma.

### رابط دفع أم صفحة مستضافة؟

كلاهما يعتمد على نفس API ونفس نموذج الأمان. ما يتغير هو المكان الذي تبدأ فيه الدفعة.

- 
- رابط الدفع
- صفحة الدفع المستضافة

### أسئلة المقاولات.

#### كيف أقبل الدفع بالبطاقة في المغرب دون موقع إلكتروني؟

أنشئوا رابط دفع من لوحة تحكم Aslan أو عبر API، ثم شاركوه عبر WhatsApp أو البريد الإلكتروني أو SMS أو على فاتورة. يفتحه عميلكم ويدفع على صفحة مستضافة آمنة؛ ويمكنكم أيضاً طباعة QR code الخاص بالرابط. وتتلقون نفس الإخطارات ونفس التقارير كما في الإدماج على موقع.
#### ما هي بوابة الدفع؟

بوابة الدفع هي الطبقة الواقعة بين مقاولتكم وشبكات الدفع. تعرض على العميل استمارة دفع آمنة، وتُحيل المعاملة للتفويض، وتعيد النتيجة إلى نظامكم. ويضيف Aslan Payment إلى ذلك الصفحات المستضافة، وروابط الدفع، و cash to web، و webhooks، خلف API واحدة.
#### ما هي لغات البرمجة المتوافقة مع Aslan Payment؟

أي لغة قادرة على استدعاء API من نوع REST. توجد SDK رسمية لـ Node.js (TypeScript)، و PHP — مع حزمة Laravel مخصصة — و Python، و Go، و Ruby، و React Native. يفتح SDK الخاص بـ React Native صفحة الدفع المستضافة داخل WebView: لا حاجة إلى أي إعداد أصلي.
#### هل تلزم شهادة PCI DSS لقبول البطاقة مع Aslan؟

تُدخَل بيانات البطاقة في صفحات يستضيفها Aslan: فهي لا تمر أبداً عبر خوادمكم. ويبقى نطاقكم هو نطاق SAQ A، أخف استبيان للتقييم الذاتي في PCI DSS، بدلاً من تدقيق كامل لبنيتكم التحتية. أما أمان موقعكم ومفاتيح API الخاصة بكم فيبقى من مسؤوليتكم.
#### ما هو cash to web؟

يتيح cash to web للعملاء الذين لا يرغبون في الدفع بالبطاقة تسديد طلب عبر الإنترنت نقداً. تمنحهم صفحة الدفع رمزاً مرجعياً؛ فيدفعون في وكالة أداء، ويتلقى نظامكم الخلفي payment.pending_cash عند إصدار الرمز، ثم payment.succeeded بمجرد تأكيد الدفع النقدي.
#### هل يمكن اختبار Aslan Payment قبل الانتقال إلى الإنتاج؟

نعم. مفاتيح الاختبار تنشئ معاملات في بيئة الاختبار دون أموال حقيقية، بنفس API ونفس الصفحات المستضافة ونفس webhooks كما في الإنتاج. وبعد التحقق من إدماجكم، تنتقلون إلى مفاتيح live دون تعديل شيفرتكم.
#### هل يمكن استرداد مبلغ لعميل؟

نعم. يمكن أن تكون الاستردادات كلية أو جزئية، من لوحة التحكم أو عبر API، وتُتاح عدة استردادات جزئية حتى المبلغ الأصلي. وكل استرداد يطلق webhooks من نوع refund.created و refund.updated ليبقى نظامكم محدّثاً.