الدفع الإلكتروني لمتجركم في المغرب: البطاقة، النقد في الوكالة، وصفحة الدفع المستضافة

الدفع الإلكتروني للتجارة الإلكترونية في المغرب يقوم على طريقتين ينبغي أن يعرضهما متجركم: البطاقة، مع مصادقة ‎3-D Secure، والنقد — لكن نقدًا يُسدَّد في وكالة مقابل مرجع، عند الطلب، لا عند الاستلام. تُستخلص البطاقة على صفحة دفع مستضافة لا تحتاجون إلى برمجتها، ويمرّ النقد عبر رابط دفع لاستعمال واحد يُنشأ للطلب، وتصل الحصيلتان إلى حساب أداء باسم شركتكم، متاحتين في اللحظة. تشرح هذه الصفحة ما يريد زبناؤكم الدفع به، وما يكلّفه الدفع عند الاستلام فعلًا، وكيف تربطون Shopify أو WooCommerce أو موقعًا مطوَّرًا حسب الطلب دون أي إضافة، وكم يكلّف ذلك، وبأي ترتيب تنطلقون.

ما يريد زبناؤكم المغاربة الدفع به، وكيف

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

تفصيل مهم بالنسبة إلى الزبون الأول: كثير من البطاقات المغربية مغلقة افتراضيًا أمام الأداء عبر الإنترنت، وعلى حاملها أن يطلب تفعيلها من بنكه. لا نقدّم رقمًا هنا — فلا يوجد مصدر عمومي يسمح بذلك بجدية — لكن النتيجة واضحة: جزء من أداءاتكم بالبطاقة سيفشل لسبب لا علاقة له بموقعكم. ويعرض دليل ‎3-D Secure ونسب النجاح أسباب الفشل بالترتيب الذي تظهر به، وما يمكنكم تصحيحه منها.

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

ما تدافع عنه هذه الصفحة يُقرأ في العمود الأخير: السطران الأولان يُعالَجان بالأدوات نفسها، ويعوّضان السطرين الأخيرين دون أن تخسروا الزبون الذي لا يملك بطاقة.

الدفع عند الاستلام: كلفته الحقيقية

المرتجعات والرفض والسيولة المجمّدة والتحصيل

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

أضيفوا إلى ذلك ما يُنسى عادة: المكالمات لتأكيد الطلب قبل شحنه، والزبناء الذين لا يجيبون، والنقد الذي يتجوّل مع عامل التوصيل، والفوارق بين ما حُصّل وما صُرّح به. لن نعطيكم نسبة رفض وطنية — فلا توجد نسبة يمكن الاستناد فيها إلى مصدر موثوق — لكنكم تعرفون نسبتكم أنتم، وتعرفون أنها ترتفع كلما ارتفعت قيمة السلة.

البديل: النقد في الوكالة عند الطلب

الفكرة بسيطة: نحتفظ بالنقد، ونُخرج عامل التوصيل من المعادلة. في صفحة رابط دفع لاستعمال واحد، يختار زبونكم «نقدًا» بدل «بطاقة»، فيتلقى مرجعًا، ثم يودع المبلغ في وكالة من شبكة Chari — قبل أن تشحنوا أي شيء. وما إن تؤكد الشبكة الإيداع حتى يصلكم الإشعار عبر الويب هوك نفسه الذي يُبلّغكم بأداء البطاقة، ويصبح المبلغ متاحًا في اللحظة في حساب الأداء الخاص بكم. يخرج الطلب مدفوعًا، ويختفي الطرد المرفوض، ولا يعود عامل التوصيل حاملًا لرقم معاملاتكم.

ChariPay هي بوابة الدفع الوحيدة في المغرب التي تستخلص النقد في الوكالة أيضًا. ومن جهة الإدماج، ثمة قاعدة واحدة ينبغي معرفتها: يمرّ النقد عبر رابط دفع لاستعمال واحد، يُنشأ للطلب من البوابة أو عبر POST /v1/payment-links، أما جلسة الدفع المنشأة عبر API فلا تستخلص إلا البطاقة. وكل ما عدا ذلك مشترك: الويب هوك payment.succeeded نفسه، والكشف نفسه، والتصدير نفسه. فبإمكان متجركم إذن أن يعرض «البطاقة» عبر الجلسة و«النقد في الوكالة» عبر الرابط، أو أن يمرّر كل شيء عبر رابط لاستعمال واحد يختار الزبون فيه بنفسه. غير أن هناك عادتين ينبغي اكتسابهما: حدّدوا مدة صلاحية للمرجع، لأن الزبون يدفع حين يمرّ بالوكالة وعلى مسار طلبكم أن يقبل حالة الانتظار هذه؛ ولا تجهّزوا الطلب إلا بعد وصول إشعار الإيداع. ويصف دليل التحصيل نقدًا بلا صندوق — الدفع بالمرجع مسار الزبون، وإمكانية التتبّع، والنقاط التي تستحق الانتباه.

ولا تحتاجون إلى أي التزام لتروا ذلك بأعينكم، فالمساران — البطاقة والنقد — قابلان للتجربة اليوم: ابدؤوا في وضع الاختبار. ثلاثة حقول — الاسم، والبريد الإلكتروني المهني، والشركة —، ثم رابط تفعيل يصلكم بالبريد لاختيار كلمة المرور، ثم مفتاح اختبار تنشئونه بأنفسكم من البوابة، وأول أداء تجريبي ببطاقة الاختبار. السندبوكس مجانية، بلا حدّ زمني، ولا موافقة تنتظرونها؛ أما التحقق من شركتكم (KYB) فلا يشترطه إلا الانتقال إلى الإنتاج.

الركائز الأربع للدفع في التجارة الإلكترونية

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

جلسة الدفع

يتحوّل كل طلب إلى جلسة: نداء واحد POST /v1/payment-sessions بالمبلغ، ومرجع طلبكم، وبيانات المشتري. ويحمل الرد عنوان صفحة الدفع. الجلسة صالحة لاستعمال واحد، وتنتهي صلاحيتها افتراضيًا بعد 72 ساعة من إنشائها؛ ويمكنكم تقصير هذه المدة، وهو أمر مفيد لحجز أو لمخزون محدود. وعناوين العودة اختيارية: في غيابها تُطبَّق العناوين المضبوطة في حسابكم. ويفصّل نموذج جلسات الدفع في التوثيق كل حقل على حدة.

صفحة الدفع المستضافة مع ‎3-D Secure

تشغّل ChariPay صفحة الدفع: موقعكم لا يعرض أبدًا استمارة بطاقة، ولا يتعامل مع أي بيانات بطاقة. يدفع الزبون فيها بالبطاقة، مع مصادقة ‎3-D Secure التي يطلبها بنكه. والجلسة المنشأة عبر API لا تستخلص إلا البطاقة: فلكي تعرضوا النقد في الوكالة عند الطلب، أنشئوا رابط دفع لاستعمال واحد عبر POST /v1/payment-links — صفحته تترك للزبون الاختيار بين البطاقة والنقد، ويؤكد الويب هوك payment.succeeded نفسه الأداء. وتحمل الصفحة اسمكم وشعاركم وألوانكم. وثمة قاعدة واحدة يجب احترامها: افتحوها في علامة التبويب الرئيسية، لا داخل إطار iframe مخفي أبدًا — فالمصادقة البنكية لا تعمل كما ينبغي في غير ذلك.

ويب هوك موقَّع

عودة الزبون إلى صفحة النجاح لديكم تعني أنه عاد، لا أن الأداء تمّ: فالزبون الذي يغلق علامة التبويب بعد الدفع لن يرى أبدًا صفحة التأكيد، مع أن المال وصل فعلًا. الويب هوك هو ما يُعتدّ به. كل إشعار موقَّع بـ HMAC-SHA256 ومؤرَّخ؛ تتحققون من التوقيع، وتزيلون التكرار اعتمادًا على معرّف الحدث، وتجيبون برمز 2xx. وإن لم يُجب خادمكم، تعيد المنصة المحاولة — بعد دقيقة، ثم 5 دقائق، ثم 30 دقيقة، ثم ساعة، ثم كل 6 ساعات، حتى 16 محاولة على مدى 72 ساعة تقريبًا — ويتيح سجل الإرسال في البوابة إعادة الإرسال بنقرة واحدة.

الاسترداد

طلب أُلغي، أو سلعة أُرجعت، أو بادرة تجارية تجاه زبون: يتم الاسترداد من البوابة أو عبر POST /v1/refunds، كليًا أو بمبلغ جزئي، مع ذكر السبب ومرجعكم الخاص. ويؤدي هذا المرجع دور مفتاح Idempotency: إعادة النداء لا تسترد المبلغ مرتين. واسترداد المال لزبون مجاني. ويقدّم نموذج الاستردادات الحقول ورموز الرد.

ربط متجركم

لنقلها قبل الدخول في التفاصيل: لا توجد إضافة ChariPay تُثبَّت في Shopify ولا في WooCommerce، ولا نَعِد بها. تستخلص المتاجر عبر آليتين لا تعتمدان على أي امتداد: رابط الدفع، بلا برمجة، وصفحة الدفع عبر API، للأتمتة. وتعمل الآليتان بالطريقة نفسها مهما كانت المنصة؛ ولا يتغير إلا أسلوب ربط الأداء بالطلب.

Shopify: رابط الدفع ثم صفحة الدفع عبر API، بلا إضافة

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

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

WooCommerce: الآلية نفسها، بلا إضافة

يُبلّغكم WordPress بكل طلب؛ فتردّون برابط دفع، أو يربط مطوّركم جلسة دفع عند تأكيد السلة ونقطة استقبال للويب هوك تنقل الطلب إلى حالة «مكتمل». لا شيء يُثبَّت في WordPress، ولا شيء يحتاج إلى صيانة عند كل تحديث. والمسار الكامل، من الطلب «قيد الانتظار» إلى الطرد المشحون المدفوع، تجدونه في التحصيل على WooCommerce في المغرب.

موقع مطوَّر حسب الطلب: الجلسات والويب هوك والاستردادات

بالنسبة إلى موقع طُوِّر خصيصًا لكم، يتلخّص الإدماج في ثلاث خطوات: إنشاء الجلسة من جهة الخادم، ثم التحويل إلى صفحة الدفع، ثم التأكيد عبر الويب هوك. إليكم مثالًا لإنشاء جلسة بقيمة 249 درهمًا في السندبوكس، بمفتاح اختبار؛ ينتقل المفتاح في الترويسة X-CHARI-PAY-API-KEY، ولا يوضع أبدًا في شيفرة تُنفَّذ لدى الزبون.

curl -X POST 'https://api-psp.charipay.ma/v1/payment-sessions' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: commande-2026-0001-session' \
  -d '{
    "amount": 249.00,
    "orderId": "ORD-2026-0001",
    "externalId": "commande-2026-0001",
    "config": {
      "customer": {
        "email": "amine.bennani@example.com",
        "firstName": "Amine",
        "lastName": "Bennani",
        "phone": "+212600000000"
      },
      "urls": {
        "accept": "https://votre-boutique.ma/paiement/succes",
        "decline": "https://votre-boutique.ma/paiement/echec",
        "notification": "https://votre-boutique.ma/webhooks/charipay"
      }
    },
    "metadata": { "cartId": "c_987", "source": "web" }
  }'

يحمل الرد، برمز 201، كلًّا من sessionId، وcheckoutUrl الذي تحوّلون إليه المشتري، وexpiresAt. وإعادة إرسال externalId نفسه تُرجع الجلسة الموجودة برمز 200 بدل إنشاء جلسة ثانية: نقرة مزدوجة أو انقطاع في الاتصال لا يكلّفان أبدًا استخلاصًا مزدوجًا. المبلغ بالدرهم، بالوحدات الكبرى، دون حقل للعملة. وعنوان القاعدة نفسه يخدم السندبوكس والإنتاج؛ والمفتاح — chari_sk_test_… أو chari_sk_live_… — هو الذي يحدد البيئة. وتعرض صفحة الأداء عبر الإنترنت صفحة الدفع المستضافة، وعناوين العودة، والمتجر المستضاف.

المتجر المستضاف من ChariPay: البيع بلا موقع

ليس لديكم موقع بعد، أو يقتصر كتالوجكم على بضعة منتجات؟ انشروا منتجاتكم على الواجهة المستضافة: يطلب زبناؤكم، ويدفعون بالبطاقة أو نقدًا، وتتابعون كل طلب من البوابة — في انتظار الأداء، ثم مدفوع، ثم مشحون، ثم مُسلَّم. أنشئوا حساب الاختبار: يُفتح عبر الإنترنت منذ التسجيل، ويتيح لكم تجربة كل ذلك دون أي التزام.

رابط الدفع أم صفحة الدفع: أيّهما لأيّ متجر

تعتمد الأداتان على الصفحة المستضافة نفسها، والويب هوك نفسه، والكشف نفسه. لكنهما لا تستخلصان الطرق نفسها تمامًا — فالجلسة المنشأة عبر API تستخلص البطاقة، والرابط لاستعمال واحد يستخلص البطاقة والنقد في الوكالة — ولا تستجيبان للحجم نفسه، ولا لدرجة الأتمتة نفسها.

لا يوجد ترتيب مفروض: كثير من المتاجر تبدأ بالرابط وتنتقل إلى صفحة الدفع حين يبرّر الحجم ذلك. ويفصّل دليل رابط دفع أم صفحة دفع مدمجة — أيّهما تختارون المعايير، بما فيها فخّ إعادة التوجيه.

الاشتراكات والسلال المتكرّرة

علبة شهرية، أو تجديد مستهلكات، أو ولوج إلى خدمة: إن كان متجركم يستخلص في آجال منتظمة، فالاشتراك يُغنيكم عن التذكير اليدوي. يمنح الزبون موافقة صريحة على حفظ بطاقته عند أول أداء؛ ويتلقى إشعارًا قبل كل اقتطاع، قبل الاستحقاق بـ 0 إلى 30 يومًا، و3 أيام افتراضيًا؛ وتُعاد المحاولة تلقائيًا عند كل فشل مؤقت — عند الاستحقاق، ثم بعد 1 و3 و7 أيام. وما دام استحقاق غير مؤدًّى، لا تُفوتر أي فترة جديدة: لا يراكم زبونكم دينًا صامتًا.

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

الاستردادات والنزاعات والمطابقة

الاسترداد عملية يومية في التجارة الإلكترونية، ويجب ألا يكلّف شيئًا وأن يترك أثرًا. في ChariPay، يُخصم الاسترداد — كليًا كان أو جزئيًا — من الرصيد المتاح في حساب الأداء الخاص بكم؛ وإن لم يكفِ الرصيد، تُوقَف العملية بدل أن تُحدث مكشوفًا صامتًا. ويُسجَّل الاسترداد عمليةً مرتبطة بالأداء الأصلي، ويصلكم الحدث refund.succeeded عبر ويب هوك حين يُسوّى — فالاسترداد ليس فوريًا من جهة البنك. واسترداد المال لزبون مجاني.

وفي ما يخص الاعتراضات، يكون أفضل دفاع في البداية: تمرّ أداءات البطاقة عبر مصادقة ‎3-D Secure، حيث يؤكد حامل البطاقة لدى بنكه، ما يحمي التاجر من أغلب حالات عدم الأداء والنزاعات. ولكل أداء فاشل، تسجّل البوابة وواجهة API سبب الرفض، ويُظهر الخط الزمني لكل عملية ما حدث، خطوة بخطوة.

يبقى بعد ذلك ما كان الدفع عند الاستلام يجعله مستحيلًا: المطابقة. كل حركة — أداء بالبطاقة، أو إيداع نقدي، أو استرداد، أو دفعة — تحمل مرجعها في البوابة وفي تصدير CSV، المتاح من البوابة أو عبر API؛ ويُميَّز فيه المبلغ المدفوع والرسوم والصافي. والتوقيت مسجّل بـ UTC بينما المغرب على UTC+1: على أداتكم أن تقوم بالتحويل. ويعالج دليل مطابقة تحصيلاتكم مع محاسبتكم الفوارق الثلاثة المعتادة — الرسوم، والدفعات، والاستردادات.

كم يكلّف ذلك

لا ننشر إلا أرقامنا، ولا نخترع غيرها. السندبوكس مجانية، بلا حدّ زمني ولا التزام. ورسوم التفعيل 6 000 درهم شاملة الضريبة، تُؤدّى مرة واحدة عند الانتقال إلى الإنتاج — ولا شيء قبل ذلك. أما العمولة عن كل معاملة ناجحة، بنسبة مئوية، والكفالة، فتُحدَّدان بعد دراسة ملفكم، حسب منتجاتكم ووسائل الدفع وأحجامكم؛ ويصلكم عرض مفصّل بالأرقام قبل أي التزام. واسترداد المال لزبون مجاني. وتسرد صفحة التسعير كذلك ما هو مشمول دون مقابل إضافي: حساب الأداء مع RIB، والبوابة، والنقد في الوكالة، والمستخدمون والأدوار، والويب هوكس.

البند الذي تستهين به المتاجر هو السيولة. كل أداء ناجح — بطاقةً أو نقدًا — متاح في اللحظة في حساب الأداء الخاص بكم، وهو حساب أداء حقيقي تمسكه Chari Money، مع RIB باسم شركتكم: لا «يوم + 1»، ولا رصيد نائم في انتظار التسوية. تؤدّون لمورّد في الصباح من حصيلة الليلة، عبر تحويل من الحساب؛ وتتبع الدفعة نحو بنككم بالإيقاع الذي يناسبكم، تلقائيًا كل ليلة متى ضُبط حساب للتسوية، أو عند الطلب. وتصف صفحة حساب الأداء في المغرب ما يمكنكم فعله من هذا الحساب.

الأمان والامتثال

ثلاث حقائق تكفي لتقييم بوابة دفع لمتجر إلكتروني. ChariPay تشغّلها Chari Money، مؤسسة أداء مرخَّصة من بنك المغرب: يُمسَك مالكم في حساب أداء خاضع للتنظيم، لا في صندوق داخلي لدى مزوّد تقني. والمنصة حاصلة على شهادة PCI DSS من المستوى الأول، تُجدَّد كل سنة، وتعتمد أداءات البطاقة على ‎3-D Secure. وتُعالَج المعطيات الشخصية في إطار القانون ‎09-08.

وبالنسبة إلى موقعكم، تختصر النتيجة العملية في جملة واحدة: لا بيانات بطاقات على خوادمكم. فاستمارة البطاقة تستضيفها ChariPay، وأرقام البطاقات لا تُكتب أبدًا في قاعدة بيانات، ويبقى نطاق امتثالكم نطاقَ تاجر لا يرى أي رقم بطاقة. ومن جهة الحساب، لكل مستخدم دوره — مالك، أو مسيّر، أو أمين صندوق، أو محاسب —، وتستلزم العمليات الحساسة إعادة المصادقة، ويمكن حماية التحويلات من البوابة برمز لمرة واحدة. وتفصّل صفحة الأمان كل نقطة من هذه النقاط.

لائحة التحقق قبل الإطلاق

1. 1أنشئوا حساب السندبوكس عبر الإنترنت — الاسم، والبريد الإلكتروني المهني، والشركة — وفعّلوه عبر البريد: يُفتح وضع الاختبار فورًا، دون موافقة تنتظرونها.
2. 2أنشئوا بأنفسكم مفتاح الاختبار من البوابة وأجروا أول نداء؛ وتمرّ مجموعة Postman على الخطوات الثماني بالترتيب.
3. 3اختبروا أداءً بالبطاقة ببطاقة الاختبار 4918 9141 0719 5005، وCVV 123، ورمز ‎3-D Secure 555؛ واختبروا أيضًا مسارًا لا يكتمل.
4. 4اختبروا أداءً نقديًا: أنشئوا رابطًا بطريقة النقد، وافتحوا الصفحة، وتحققوا من أن مسار طلبكم يقبل حالة «في انتظار الإيداع».
5. 5صرّحوا بنقطة استقبال الويب هوك عبر HTTPS، وتحققوا من التوقيع على النص الخام، وأزيلوا التكرار، وأرسلوا حدثًا تجريبيًا، واقرؤوا سجل الإرسال.
6. 6اختبروا استردادًا جزئيًا، من البوابة أو عبر API، وتحققوا من أن الحدث refund.succeeded يصلكم فعلًا.
7. 7أطلقوا التحقق KYB من البوابة — وثائق الهوية والسجل التجاري — بينما يتقدّم الإدماج: فهو لا يشترطه إلا الإنتاج.
8. 8راجعوا إشعاراتكم القانونية وشروط البيع: الأسعار بالدرهم شاملة الضريبة، وآجال التسليم، وسياسة الإرجاع والاسترداد، وبيانات الشركة.
9. 9توصّلوا بالعرض المفصّل بالأرقام، وأدّوا رسوم التفعيل، ثم أطلقوا التحقق من البوابة: يُنشأ مفتاح الإنتاج تلقائيًا. وما دام الولوج غير مفعّل، تُرجع API في الإنتاج 403 PRODUCTION_ACCESS_NOT_ENABLED.
10. 10يوم الانطلاق، غيّروا المفتاح وسرّ الويب هوك — لا شيء غير ذلك —، واحتفظوا بالسندبوكس بيئةً للتجربة، وطابقوا أول تصدير CSV مع محاسبتكم.

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

أسئلة شائعة

هل يجب الإبقاء على الدفع عند الاستلام؟

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

هل يمكن لزبنائي الدفع دون بطاقة؟

نعم. في صفحة رابط دفع لاستعمال واحد، يختار الزبون النقد، فيتلقى مرجعًا ويودع المبلغ في وكالة من شبكة Chari. ويصلكم الإشعار ما إن تؤكد الشبكة الإيداع، عبر الويب هوك نفسه الذي يُبلّغ بأداء البطاقة، ويصبح المال متاحًا في اللحظة في حساب الأداء الخاص بكم. فـ ChariPay هي بوابة الدفع الوحيدة في المغرب التي تستخلص النقد في الوكالة أيضًا.

هل تُقبل البطاقات الأجنبية؟

البطاقات المقبولة افتراضيًا هي Visa وMastercard وMaroc Pay، مع مصادقة ‎3-D Secure؛ ويمكن تفعيل وسائل أخرى بطلب من الفريق، حسب نشاطكم. وكل المبالغ بالدرهم، دون أي تحويل للعملة من جهتكم: صفحة الدفع تعرض المبلغ بالدرهم المغربي. وقبل إطلاق عرض موجّه إلى زبناء في الخارج، اطرحوا علينا السؤال مع حالتكم بالتحديد، لنجيبكم عن وضعكم أنتم.

هل يمكن استعمال باي بال PayPal لمتجر مغربي؟

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

وماذا عن سترايب Stripe؟

لا: المغرب غير موجود في اللائحة الرسمية للبلدان التي تتوفر فيها Stripe، المنشورة على stripe.com/global والتي أعدنا قراءتها في 2 أكتوبر 2026؛ ولذلك لا تستطيع شركة مستقرة في المغرب أن تفتح فيها حسابًا. أما الالتفاف عبر شركة أجنبية فينقل المشكلة إلى مكان آخر — أموال خارج المغرب، وصرف، وضريبة على القيمة المضافة، وخطر إغلاق الحساب. ويشرح دليلنا Stripe في المغرب الأسباب، وكيف تستخلصون بالدرهم بمفردات API مألوفة.

كيف أسترد المال لزبون؟

من البوابة، أو عبر POST /v1/refunds مع الإشارة إلى الأداء الأصلي، وذكر السبب، ومرجع استرداد خاص بكم — كليًا بشكل افتراضي، أو بمبلغ جزئي. يُخصم الاسترداد من رصيدكم المتاح، ويُسجَّل عمليةً مرتبطة بالأداء، ويؤكده الويب هوك refund.succeeded. وإعادة إرسال المرجع نفسه لا تسترد المبلغ مرتين. واسترداد المال لزبون مجاني، كليًا كان أو جزئيًا.

هل يلزم سجل تجاري؟

للاختبار، لا: يُفتح وضع الاختبار منذ التسجيل، دون أي موافقة. أما لاستخلاص أداءات حقيقية، فتخضع شركتكم لتحقق KYB — وثائق الهوية والسجل التجاري، مع موافقة بشرية مزدوجة — يجري من البوابة، بالتوازي مع الإدماج، ولا يشترطه إلا الانتقال إلى الإنتاج. ويبقى مستشاركم وحده المؤهَّل للحكم في شكلكم القانوني والتزاماتكم.

متى يصبح المال متاحًا؟

في لحظة نجاح الأداء، بالبطاقة أو نقدًا: يُقيَّد المبلغ في حساب الأداء ChariPay الخاص بكم ويصبح قابلًا للاستعمال فورًا، لتحويل أو لأداء فاتورة أو لاسترداد. أما الدفعة نحو حسابكم البنكي فعملية مستقلة — تلقائية كل ليلة متى ضُبط حساب للتسوية، أو بتحويل عند الطلب، مع بيان الرسوم قبل التأكيد.

بأي عملة يتم الأداء؟

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

هل توجد إضافة ChariPay لـ Shopify أو WooCommerce؟

لا، لا توجد، ولا نَعِد بها. تستخلص متاجر Shopify وWooCommerce عبر روابط الدفع، التي تُنشأ من البوابة وتُرسل إلى الزبون، ثم عبر صفحة الدفع المستضافة بواسطة API حين يبرّر الحجم الأتمتة: جلسة لكل طلب، وويب هوك موقَّع يعلّم الطلب مدفوعًا. ويشرح الدليلان المخصّصان لكل منصة كل خطوة، دون أي امتداد يُثبَّت أو يُصان.

الخطوة التالية

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

المصادر

• Stripe — التوفر العالمي (Global availability) — قُرئ في 2026-10-02