الدفع عبر رمز QR في المغرب: ملصق في نقطة البيع يستخلص الأداء بالبطاقة

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

الدفع عبر رمز QR في المغرب كما تقترحه ChariPay

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

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

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

من أين يأتي الرمز: بوابة التاجر، وصورة PNG، وملصق PDF للطباعة

كل رمز QR للدفع ينطلق من رابط موجود. أنشئوا الرابط أولًا — المبلغ، والوصف، ومدة الصلاحية، ولاستعمال واحد أو، عبر API، قابلًا لإعادة الاستعمال — مستعينين عند الحاجة بدليلنا عن إنشاء رابط دفع. ثم تتاح لكم صيغتان:

• رمز QR وحده في صورة PNG: لإدراجه في وثيقة، أو قائمة طعام، أو وصل تسليم، أو أي دعامة تصمّمونها بأنفسكم.
• ملصق PDF للطباعة لنقطة البيع: يحمل رمز QR والمبلغ.

في بوابة التاجر، يظهر رمز QR الخاص بكل رابط بنقرة واحدة من قائمة روابط الدفع، ويُستخرج الملصق من صفحة الرابط. وعبر API، يعيد نداءان رمز QR والملصق انطلاقًا من مرجع الرابط reference (pl_…):

# PNG QR code that encodes the link's payUrl
curl -X GET 'https://api-psp.charipay.ma/v1/payment-links/pl_3ND8xk/qr' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...' \
  -o pl_3ND8xk-qr.png

# Printable poster (PDF) with the QR code and the amount
curl -X GET 'https://api-psp.charipay.ma/v1/payment-links/pl_3ND8xk/poster' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...' \
  -o pl_3ND8xk-poster.pdf

يعيد GET /v1/payment-links/{reference}/qr صورة PNG، ويعيد GET /v1/payment-links/{reference}/poster ملف PDF للملصق. وهكذا تستطيع شبكة نقاط بيع إنتاج ملصقاتها دفعةً واحدة من أداتها الخاصة. وتصف وحدة «روابط الدفع» في توثيق API المعاملات وردود الأخطاء.

واختبروا الملصق بمسحه بأنفسكم قبل تعليقه. يُفتح وضع الاختبار بمجرد تفعيل حسابكم، دون موافقة تنتظرونها: ابدؤوا في وضع الاختبار — ثلاثة حقول (الاسم، والبريد الإلكتروني المهني، والمؤسسة)، ورابط تفعيل يصلكم بالبريد لاختيار كلمة المرور، ثم بوابة التاجر حيث تنشئون بأنفسكم مفتاح الاختبار بعد إعادة مصادقة؛ ولا يُعرض المفتاح كاملًا إلا مرة واحدة. أنشئوا رابطًا، واعرضوا رمز QR الخاص به من قائمة الروابط، وامسحوه بهاتفكم، وادفعوا ببطاقة الاختبار ‎4918 9141 0719 5005، CVV 123، وأي تاريخ انتهاء مستقبلي، ورمز ‎3-D Secure 555: هذه البطاقة هي الوحيدة المقبولة، ولا يتحرك أي مال حقيقي. ويجري التحقق من مؤسستكم (KYB) بالتوازي ولا يشترطه إلا الانتقال إلى الإنتاج.

رمز QR قابل لإعادة الاستعمال أم لاستعمال واحد: أي رابط خلف الصورة

لا يغيّر رمز QR شيئًا في قواعد الرابط الذي يحمله. فكل شيء يُحسم لحظة إنشاء هذا الرابط.

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

أين تضعون رمز QR للدفع

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

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

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

ماذا يرى زبونكم حين يمسح الرمز

يمر الزبون بخمس خطوات، دون أي تطبيق يثبّته:

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

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

تتبّع الأداءات التي يتلقاها الملصق

الملصق القابل لإعادة الاستعمال يستخلص طوال اليوم؛ وعليكم أن تعرفوا، في أي لحظة، ما الذي جلبه.

• في بوابة التاجر، يصلكم إشعار عند كل استخلاص، ويحتفظ الرابط بحالته ومصدره في القائمة.
• عبر API، يعيد GET /v1/payment-links/{reference} من بين ما يعيده useCount، أي عدد مرات أداء الرابط، وtotalCollected، أي مجموع ما استُخلص عبره.
• في قمع الرابط، تعرض بوابة التاجر كم فتحوا الصفحة، وكم أدخلوا بطاقتهم، وكم أتمّوا.

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

تجديد الملصق أو إلغاؤه

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

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

واحتفظوا بقائمة بسيطة للملصقات المتداولة — المكان، والمبلغ، ومرجع الرابط —: فيوم تغيير الثمن، تعرفون بالضبط أي الملصقات تنزعون.

الأخطاء التي ينبغي تجنّبها مع رمز QR للدفع

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

أسئلة شائعة

كيف أنشئ رمز QR للدفع؟

أنشئوا أولًا رابط دفع — عبر API بـsingleUse: false لملصق دائم في نقطة البيع —، ثم اعرضوا رمز QR الخاص به من قائمة الروابط في بوابة التاجر. وعبر API، يعيد GET /v1/payment-links/{reference}/qr صورة PNG، ويعيد GET /v1/payment-links/{reference}/poster ملصق PDF للطباعة يحمل الرمز والمبلغ. والرمز يحمل عنوان صفحة الدفع الخاصة بالرابط.

هل يمكن للزبون أن يؤدّي نقدًا بمسح الملصق؟

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

هل يمكن استعمال رمز QR نفسه لعدة زبناء؟

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

ما البطاقات التي تعمل مع رمز QR للدفع؟

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

كيف أغيّر ثمن ملصق دفع سبق طبعه؟

المبلغ هو مبلغ الرابط، فلا بد إذن من رابط جديد. ألغوا القديم، الذي لن يمكن أداؤه بعد ذلك، وأنشئوا رابطًا بالمبلغ الجديد، واطبعوا ملصقه، ثم انزعوا كل الملصقات القديمة. والاحتفاظ بقائمة لملصقاتكم المتداولة، بمكانها ومرجع رابطها، يجعل هذا الاستبدال سريعًا ودون أي نسيان.

كيف أعرف كم استخلص الملصق؟

في بوابة التاجر، يصلكم إشعار عند كل استخلاص. وعبر API، يعيد GET /v1/payment-links/{reference} قيمة useCount، أي عدد الأداءات، وtotalCollected، أي مجموع ما استُخلص عبر هذا الرابط. ويعرض قمع الرابط أيضًا كم شخصًا فتح الصفحة وأدخل بطاقته وأدّى، وهو ما يساعدكم على رصد ملصق يُساء فهمه.

هل تنتهي صلاحية رمز QR للدفع؟

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

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

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