الانتقال إلى المحتوى الرئيسي
كل المقالات
دليل16 دقيقة قراءة

الدفع عبر الإنترنت في المغرب سنة 2026: كيف تستخلصون (الطرق والرسوم والإجراءات)

بطاقة ‎3-D Secure، ونقد في الوكالة، وروابط، واشتراكات: ما يكلّفه الاستخلاص عبر الإنترنت في المغرب، والإجراءات من السندبوكس إلى الإنتاج.

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

الوضع سنة 2026

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

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

طرق الاستخلاص، مقارنةً

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

الطريقةلمنتوفر الأموالما يلزم تقنيًانقاط الانتباه
البطاقة البنكية عبر الإنترنت (‎3-D Secure)كل بيعة لزبون يملك بطاقة مفعَّلة للإنترنتفي اللحظة في حساب الأداء، فور تأكيد بنك المشتريصفحة دفع مستضافة، برابط أو بجلسة؛ لا تمر أي بيانات بطاقة عبركمالدفع غير متزامن: النتيجة حجتها الويب هوك، لا صفحة العودة
النقد في الوكالة بالمرجعزبناء بلا بطاقة، سلات مرتفعة، طلبيات لا تريدون تسليمها مقابل الدفعفي اللحظة في حساب الأداء، فور تأكيد الشبكة للإيداعالصفحة المستضافة نفسها: يختار الزبون النقد، ويتلقى مرجعًا، ويودع في وكالة من شبكة Chariالمهلة بين الطلبية والإيداع بيد الزبون: حدّدوا صلاحية وتذكيرًا
رابط الدفعمتاجر بلا مطوّر، بيع عبر واتساب وإنستغرام، عروض أسعار، فعالياتفي اللحظة، كما أعلاهالبوابة — أو POST /v1/payment-links؛ استعمال وحيد أو متعدد، إرسال بالبريد الإلكتروني، QR، ملصقالرابط متعدد الاستعمال لا يقول من دفع إن لم تقرؤوا الإشعار: املؤوا metadata أو externalId
صفحة الدفع المستضافة (الجلسات)مواقع وتطبيقات بمطوّر، سلة، نظام خلفيفي اللحظة، كما أعلاهPOST /v1/payment-sessions بالمبلغ بالدرهم، توجيه إلى checkoutUrl، ويب هوك موقَّعIdempotency عند الإنشاء، معالجة الويب هوكس، orderId وexternalId متمايزان
الاشتراكقاعات رياضية، مدارس، برمجيات، صناديق اشتراك، إيجارات — كل ما يُدفع عند الاستحقاقفي اللحظة، عند كل استحقاق مستخلَصزبون (POST /v1/clients) ثم اشتراك (POST /v1/subscriptions)؛ أول دفعة بـ ‎3-D Secure، ثم اقتطاعات تلقائيةموافقة الزبون، إشعار قبل الاقتطاع، إعادة المحاولة بعد يوم و3 و7 أيام: اختبروا الدورة كاملة في السندبوكس

البطاقة البنكية، مع ‎3-D Secure

هي الطريقة التي ينتظرها الجميع، وهي الأسهل تركيبًا: يُدخل زبونكم بطاقته على صفحة تستضيفها ChariPay، ويطلب منه بنكه مصادقة ‎3-D Secure، ويعود — وتصلكم النتيجة عبر ويب هوك. لا تلمسون رقم بطاقة أبدًا، لا في خادمكم ولا في متصفحكم: شهادة PCI DSS من المستوى الأول شهادتنا نحن لا شهادتكم، ويبقى نطاقكم نطاق تاجر لا يرى بيانات بطاقة أبدًا.

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

النقد في الوكالة، بالمرجع

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

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

رابط الدفع

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

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

صفحة الدفع المستضافة، بجلسات الدفع

ما إن تكون لديكم سلة ونظام خلفي، تحل جلسة الدفع محل الرابط. يستدعي خادمكم POST /v1/payment-sessions بالمبلغ بالدرهم ومرجع طلبيتكم وبيانات المشتري؛ وتعيد لكم الواجهة checkoutUrl توجّهون الزبون إليه. تتكفل الصفحة المستضافة بالبطاقة ومصادقة ‎3-D Secure واختيار النقد؛ أما خادمكم فينتظر الويب هوك.

الجلسة وحيدة الاستعمال افتراضيًا وتنتهي من تلقاء نفسها — بعد 72 ساعة من إنشائها إن لم تحددوا شيئًا، أو في التاريخ الذي تحددونه. ويمكنكم أن تلحقوا بها metadata تُعاد كما هي في الإشعار، وexternalId الخاص بكم، ويشرح القسم التقني أدناه أثره.

الاشتراك

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

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

ما يكلّفه الاستخلاص عبر الإنترنت في المغرب

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

البنود الخمسة لعرض السعر

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

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

أرقامنا

تسعير ChariPay يسع بضعة أسطر، وصفحة التسعير لا تقول أكثر.

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

الإجراءات: من السندبوكس إلى الإنتاج

هناك إجراءان، ولا يتشابهان. الأول لا يطلب شيئًا من أحد: هو السندبوكس، التي تفتحونها بأنفسكم. والثاني إداري: تفعيل الإنتاج، الذي يفترض شركة متحقَّقًا منها.

السندبوكس، في ثماني خطوات

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

  1. 1سجّلوا على portal-psp.charipay.ma/register ببريدكم المهني.
  2. 2فعّلوا حسابكم من الرابط الذي يصلكم بالبريد، واختاروا كلمة مروركم. رمز التفعيل لا يوجد إلا في هذا البريد.
  3. 3ادخلوا إلى البوابة. حسب صلاحيات حسابكم، قد تطلب منكم تسجيل تطبيق مصادقة ثنائية — احتفظوا برموز الاستعادة.
  4. 4اختاروا شركتكم. هذه الخطوة، لا تسجيل الدخول، هي ما يفتح جلسة عملكم.
  5. 5اجتازوا إعادة المصادقة. إنشاء مفتاح واجهة برمجية فعل حساس: تصدر البوابة رمز تأكيد قصير العمر، مطلوبًا في الخطوة 7.
  6. 6انظروا في الصلاحيات المتاحة، ولا تمنحوا مفتاحكم إلا ما يستدعيه إدماجكم فعلًا.
  7. 7أنشئوا مفتاحكم. يبدأ بـ chari_sk_test_ ولا يُعرض إلا مرة واحدة، في تلك اللحظة: ضعوه فورًا في خزنة أسرار أو متغير بيئة، لا في كود صفحة (حماية مفاتيح الواجهة).
  8. 8تحققوا أن كل شيء متماسك بـ GET /v1/wallet: إن أجابكم الرصيد، فأنتم موثَّقون.

توجد بطاقة اختبار واحدة في السندبوكس: 4918914107195005، رمز CVV هو 123، ورمز ‎3-D Secure هو 555. وهي تكفي لإجراء دفعة كاملة، بمصادقتها، ولتلقي أول ويب هوك لكم. وعنوان القاعدة هو نفسه في الإنتاج — https://api-psp.charipay.ma — لأن المفتاح هو ما يختار البيئة، لا العنوان.

تفعيل الإنتاج

يُفعَّل الإنتاج على حسابكم بعد التحقق من شركتكم. عمليًا، ترسلون ملف شركتكم؛ يدرسه الفريق، ويحدد العمولة والكفالة، ويوجّه إليكم عرضًا مرقَّمًا. تؤدون حينها رسوم التفعيل — 6 000 درهم شاملة الضريبة، مرة واحدة — ويُفتح الإنتاج.

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

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

الإدماج حسب وضعكم

لا يوجد إدماج واحد صحيح، بل أربعة، وإدماجكم أنتم يتوقف على سؤالين: هل لديكم مطوّر، وهل تستخلصون مرة واحدة أم عند الاستحقاق؟

متجر بلا مطوّر: روابط الدفع

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

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

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

مع مطوّر، يُختصر الإدماج في قطعتين: إنشاء جلسة دفع عند كل طلبية، ومعالجة الإشعار العائد منها. يبدو الإنشاء هكذا:

bash
curl -X POST https://api-psp.charipay.ma/v1/payment-sessions \
  -H "X-CHARI-PAY-API-KEY: chari_sk_test_…" \
  -H "Idempotency-Key: order-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250.00,
    "orderId": "ORD-2026-0001",
    "externalId": "order-2026-0001",
    "config": {
      "customer": {
        "firstName": "Amine", "lastName": "Bennani",
        "email": "amine@example.com", "phone": "+212600000000"
      },
      "urls": {
        "accept": "https://votre-site.ma/merci",
        "decline": "https://votre-site.ma/echec",
        "notification": "https://votre-site.ma/webhooks/charipay"
      }
    }
  }'

المبلغ بالدرهم، دون حقل عملة: الواجهة البرمجية لا تعمل إلا بالدرهم. تحمل الاستجابة checkoutUrl الذي توجّهون المشتري إليه. الترويسة Idempotency-Key، المشتقة من مرجع طلبيتكم، تجعل النداء قابلًا للإعادة بلا خطر؛ وexternalId، الفريد في كل بيئة، يجعل نداءً ثانيًا للطلبية نفسها يعيد لكم الجلسة القائمة برمز 200 بدل إنشاء جلسة جديدة.

القطعة الثانية هي نقطة الويب هوك لديكم. يحمل كل تسليم X-CHARI-SIGNATURE، وهو HMAC-SHA256 بالنظام الست عشري محسوب على السلسلة timestamp + "." + rawBody، وX-CHARI-TIMESTAMP، الطابع الزمني بالميلي ثانية. والتحقق يسع بضعة أسطر:

javascript
import { createHmac, timingSafeEqual } from 'node:crypto';

export function verifyChariSignature(rawBody, headers, secret) {
  const timestamp = headers['x-chari-timestamp'];
  const signature = headers['x-chari-signature'];
  if (!timestamp || !signature) return false;

  // تسامح ±5 دقائق، كما في جانب ChariPay
  if (Math.abs(Date.now() - Number(timestamp)) > 5 * 60 * 1000) return false;

  const expected = createHmac('sha256', secret)
    .update(`${timestamp}.${rawBody}`)
    .digest('hex');
  return expected.length === signature.length
    && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}

أربع قواعد تكفي بعد ذلك. تحققوا على الجسم الخام، قبل أي تحليل. أزيلوا التكرار بـ Chari-Event-Id: قد يُسلَّم الحدث نفسه عدة مرات، وهذه ضمانة لا عيب. أجيبوا بـ 200 فور كتابة الحدث في مكان ما، وأنجزوا الباقي في الخلفية. وإن لم يجب خادمكم، فلا تقلقوا: نعيد المحاولة بعد دقيقة، و5 دقائق، و30 دقيقة، وساعة، ثم كل 6 ساعات، حتى 16 محاولة على مدى نحو 72 ساعة — وسجل البوابة يتيح لكم إعادة تشغيل أي تسليم بنقرة واحدة. ويفصّل إنجاح دمج الويب هوك الأخطاء الخمسة التي نراها أكثر من غيرها.

أما الباقي — الزبناء، والمنتجات والطلبيات، والاسترجاعات، والمعاملات، والتصديرات — فيغطيه توثيق الواجهة البرمجية في 12 وحدة و62 نقطة نهاية، مع أمثلة بأربع لغات، ومجموعة Postman، وعقد OpenAPI، وحزمة جاهزة لتسليمها إلى مساعد البرمجة لديكم.

الاشتراكات

يضيف إدماج الاشتراك خطوة قبل الجلسة: الزبون. تنشئونه بـ POST /v1/clients، ثم تفتحون الاشتراك بـ POST /v1/subscriptions — المبلغ، والوتيرة، وتاريخ البداية، وقناة الإشعار، وexternalId الخاص بكم. يمر الاستخلاص الأول عبر صفحة الدفع المستضافة مع ‎3-D Secure ويسجّل وسيلة الدفع؛ والاستخلاصات التالية تلقائية، يُخطَر بها الزبون بالبريد الإلكتروني قبل الاقتطاع.

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

السوق الإلكترونية والتوزيع

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

الأخطاء الكلاسيكية

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

  • التسليم على صفحة العودة. المشتري الذي يغلق تبويبه بعد الدفع لن يرى صفحة تأكيدكم أبدًا. وإن كانت طلبيتكم لا تُؤكَّد إلا هناك، فلن تُؤكَّد أبدًا — بينما المال وصل فعلًا إلى حساب الأداء الخاص بكم. القاعدة بسيطة: صفحة العودة تشكر، والويب هوك يسلّم.
  • نسيان Idempotency. شبكة تنقطع بين ندائكم واستجابتنا، ومستخدم ينقر مرتين، ومهمة تُعاد: بلا Idempotency-Key على إنشاءاتكم وبلا externalId فريد، ستنتهون بإنشاء جلستين لطلبية واحدة، أو بالشحن مرتين. يشرح لا تحصّلوا مرتين أبدًا — شرح Idempotency كيف تشتقون هذه المفاتيح من مراجعكم أنتم بدل سحبها عشوائيًا.
  • تجاهل النقد. التاجر الذي لا يقبل عبر الإنترنت سوى البطاقة يواصل تدبير النقد عند التسليم، خارج أي نظام، ولا يحسبه تكلفة. وإتاحة الإيداع في الوكالة على صفحة الدفع نفسها تعيد هذا المال إلى الكشف، قبل الشحن.
  • المطابقة يدويًا. مقارنة تصدير بنكي بورقة طلبيات، آخر كل شهر، عرض لإدماج لم يستعمل externalId وmetadata. هذان الحقلان يعودان إليكم في كل إشعار وفي تصديرات CSV: فتصبح المطابقة ربط جداول، لا قراءة. ويبيّن مطابقة تحصيلاتكم مع محاسبتكم الطريقة.
  • تبديل المفتاح دون تبديل السر. يوم الانتقال إلى الإنتاج، يتغير مفتاح الواجهة البرمجية ويتغير معه سر توقيع الويب هوكس. ونسيان الثاني يعطي أكثر الحوادث إرباكًا على الإطلاق: تمر المدفوعات، ولا تنطلق الطلبيات.

أسئلة شائعة

هل يمكن استعمال Stripe في المغرب؟

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

هل يلزم مطوّر للاستخلاص عبر الإنترنت؟

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

كم يكلّف فتح حساب؟

السندبوكس مجانية وبلا حد زمني. والانتقال إلى الإنتاج يكلّف 6 000 درهم شاملة الضريبة رسوم تفعيل، تُدفع مرة واحدة. وتُحدَّد العمولة عن كل معاملة ناجحة والكفالة بعد دراسة ملفكم، وتعرفونهما قبل الالتزام. واسترجاع مبلغ لزبون مجاني.

متى يكون المال متاحًا؟

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

ماذا يحدث إن كان خادمي متوقفًا حين تكتمل الدفعة؟

لا شيء يضيع. يُعاد تسليم الويب هوك بعد دقيقة، و5 دقائق، و30 دقيقة، وساعة، ثم كل 6 ساعات، حتى 16 محاولة على مدى نحو 72 ساعة. ويعرض سجل التسليمات في البوابة كل محاولة وردّ خادمكم، ويتيح لكم إعادة تشغيل تسليم بنقرة واحدة. ولأن كل حدث يحمل Chari-Event-Id نفسه في كل محاولة، تبقى المعالجة التي تزيل التكرار صحيحة مهما كان عدد الإعادات.

كيف أسترجع مبلغًا لزبون؟

بـ POST /v1/refunds، مع تعيين الدفعة بـ operationId الخاص بها أو بـ externalId الخاص بكم، ومع refundReference خاص بكم وسبب. يمكن أن يكون الاسترجاع كليًا أو جزئيًا — refundAmount للجزئي — ويجيب النداء بـ 202 بينما تُنفَّذ العملية؛ وإعادة refundReference نفسه تعيد لكم الاسترجاع القائم برمز 200، دون خصم مرتين. وهو مجاني.

هل تمر بيانات البطاقة عبر موقعي؟

لا. يتم الإدخال على صفحة الدفع التي تستضيفها ChariPay، ومصادقة ‎3-D Secure لدى بنك المشتري، ولا يتلقى خادمكم سوى إشعار موقَّع. ChariPay حاصلة على شهادة PCI DSS من المستوى الأول، وتُعالَج البيانات في إطار القانون ‎09-08. ويبقى نطاق امتثالكم نطاق تاجر لا يرى رقم بطاقة أبدًا؛ ويبقى تحديد استبيان التقييم الذاتي المنطبق عليكم من اختصاص مستشاركم.

هل يمكنني الاستخلاص بعملة غير الدرهم؟

لا. تقبل الواجهة البرمجية مبالغ بالدرهم وليس فيها حقل عملة؛ ChariPay مصممة لشركة مغربية تستخلص من زبناء في المغرب، في حساب أداء مغربي.

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

إن قرأتم إلى هنا، فأنتم تعرفون ما تريدون استخلاصه وكيف. والباقي في ثلاث حركات.

  1. 1افتحوا السندبوكس على portal-psp.charipay.ma/register — ثماني خطوات، بلا موعد، بلا التزام — وأجروا أول دفعة ببطاقة الاختبار.
  2. 2اختاروا إدماجكم: رابط من البوابة إن لم يكن لديكم مطوّر، وجلسة وويب هوك إن كان لديكم واحد، واشتراك إن كنتم تستخلصون عند الاستحقاق.
  3. 3اطلبوا عرضكم حين يستقر الإدماج في السندبوكس: يُدرس الملف، وتُبلَّغون بالعمولة والكفالة، ويُفتح الإنتاج بعد أداء رسوم التفعيل.

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

بقلم فريق ChariPay.

اقرؤوا بعده

دليلدقيقتا قراءة

التحصيل على Shopify في المغرب

متجر Shopify وزبناء مغاربة — كيف تقبلون البطاقة والنقد بالدرهم، والمال متاح فورًا في حساب أداء حقيقي.

دليلدقيقتا قراءة

التحصيل على WooCommerce في المغرب

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

سؤال حول عملية الدمج لديكم؟

يجيب فريقنا التجّار والمطوّرين على حد سواء، من أول اختبار حتى الإطلاق.