استخلاص التسبيق عبر الإنترنت: رابط مع عرض الأثمان ورابط ثانٍ للباقي

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

استخلاص التسبيق عبر الإنترنت: المبدأ في رابطين

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

1. 1قبول عرض الأثمان: ترسلون رابط التسبيق.
2. 2تسليم الخدمة: ترسلون رابط الباقي.

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

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

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

الخطوة 1: رابط التسبيق، يُرسَل مع عرض الأثمان

يُنشأ رابط التسبيق لحظة موافقة الزبون على عرض الأثمان، ويُرسَل معه. وأربعة إعدادات مهمة:

• لاستعمال واحد، بمبلغ التسبيق: صفقة واحدة، وزبون واحد، ومبلغ واحد. ويُستهلك الرابط بعد أداء ناجح واحد، فلا يستطيع الزبون الأداء مرتين.
• وصف يحمل رقم عرض الأثمان: «تسبيق — عرض الأثمان D-2026-118». فيعرف الزبون ما يؤدّيه، وتجدون الصفقة في بوابة التاجر.
• مدة صلاحية مطابقة لصلاحية عرض الأثمان: 24 ساعة، أو 7 أيام، أو 30 يومًا، أو تاريخ محدد. فعرض أثمان صالح لشهر يستدعي رابطًا تنتهي صلاحيته في التاريخ نفسه؛ وبعد ذلك تُخبر الصفحة الزبون بأن العرض لم يعد متاحًا، ولا يمكن لأي أداء أن يمرّ، وتقررون أنتم تجديد عرضكم أو عدمه. وتصلح هذه المدة لرابط يُؤدّى بالبطاقة: ولزبون يؤدّي نقدًا، أنشئوا الرابط بخيار «Paiement en agence» (الأداء في الوكالة)، دون مدة صلاحية.
• زبون مسجَّل: ستفيدكم معلوماته مرة أخرى في رابط الباقي.

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

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

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

الخطوة 2: رابط الباقي، عند التسليم

عند تسليم الخدمة، أنشئوا رابطًا ثانيًا لاستعمال واحد بالمبلغ المتبقي، مع رقم عرض الأثمان نفسه في الوصف: «الباقي — عرض الأثمان D-2026-118». وأرسلوه في الموعد المتفق عليه في شروطكم، عبر القناة نفسها التي أرسلتم بها الأول.

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

ومثل الأول، يُؤدّى هذا الرابط بالبطاقة، بمدة صلاحية أقصر من مدة عرض الأثمان، 7 أيام مثلًا، حتى لا يبقى الباقي مفتوحًا بلا نهاية؛ ولزبون يؤدّي نقدًا، أنشئوه بخيار «Paiement en agence»، دون مدة صلاحية.

المهندسون المعماريون، وممونو الحفلات، والمصوّرون، والحرفيون، والوكالات: متى يُرسَل كل رابط

يتوقف التوقيت على إيقاع مهنتكم. ويقترح الجدول أدناه معالم؛ أما مبلغ التسبيق فيبقى قرارًا تجاريًا يحدده عرض أثمانكم.

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

ربط التسبيق والباقي بالصفقة نفسها

أداءان لعرض أثمان واحد: عليكم أن تجدوهما معًا، بعد ستة أشهر كما غدًا.

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

• `externalId` مختلف لكل رابط — مثلًا quote-d-2026-118-deposit ثم quote-d-2026-118-balance. وهو فريد لكل حساب ولكل بيئة: فاستعمال externalId نفسه للرابطين سيعيد لكم الأول بدل إنشاء الثاني.
• `metadata` نفسه، وهو كائن مسطَّح يحمل رقم عرض الأثمان (quoteId) والجزء المعني. ويعود كما هو عند قراءة الرابط وفي حدث الأداء.

curl -X POST 'https://api-psp.charipay.ma/v1/payment-links' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: quote-d-2026-118-deposit' \
  -d '{
    "amount": 3000.00,
    "description": "Acompte devis D-2026-118",
    "singleUse": true,
    "expiresAt": "2026-10-31T23:59:59Z",
    "externalId": "quote-d-2026-118-deposit",
    "customerEmail": "amine.bennani@example.com",
    "customerPhone": "+212600000000",
    "metadata": { "quoteId": "D-2026-118", "part": "deposit" }
  }'

ويعيد رابط الباقي النداء نفسه بمبلغه الخاص، وexternalId خاص به، وIdempotency-Key خاص به، مع "part": "balance". وعند وصول أداء بالبطاقة، يقرأ نظامكم metadata.quoteId ليجد الصفقة وmetadata.part ليعرف أي جزء أُدّي. أما للأداء نقدًا، فاقرؤوا حالة الرابط عبر GET /v1/payment-links/{reference}.

الزبون بلا بطاقة: تسبيق يُؤدّى نقدًا

بعض الزبناء يفضّلون أداء التسبيق نقدًا، وبعضهم ليست لديه بطاقة مفتوحة للأداء عبر الإنترنت. والرابط لاستعمال واحد يستقبلهم دون أي إجراء إضافي منكم. في صفحة رابط دفع يُستعمل مرة واحدة، يختار زبونكم النقد، ويتلقى مرجعًا، ويسدّده في وكالة من شبكة Chari، ويصلكم الإشعار بمجرد أن تؤكد الشبكة الإيداع. والأداء نقدًا في الوكالة يعتمد دائمًا على رابط لاستعمال واحد — مرجع واحد لكل إيداع. في بوابة التاجر، تفعيل خيار «Paiement en agence» (الأداء في الوكالة) على رابط يعطّل مدة صلاحيته: يبقى الرابط قابلًا للأداء بلا حدّ زمني. فالرابط الذي يحمل تاريخ انتهاء يُقدَّم إذن كرابط يُؤدّى بالبطاقة؛ ولزبون يؤدّي نقدًا، أنشئوا رابطًا بهذا الخيار، دون مدة صلاحية.

بمجرد أن تؤكد الشبكة الإيداع، يصبح الرابط «مدفوعًا» ويصلكم الإشعار في بوابة التاجر؛ ومن جهة الخادم تُقرأ حالة الرابط عبر GET /v1/payment-links/{reference}. ويصبح المبلغ متاحًا في حسابكم في لحظة الإيداع، تمامًا كتسبيق مؤدّى بالبطاقة. وإن كنتم تعملون عبر API، فإن paymentMethod: "CASH" يختار النقد مسبقًا في الصفحة. وChariPay هي بوابة الدفع الوحيدة في المغرب التي تستخلص النقد أيضًا في الوكالة.

الإلغاء: إلغاء الرابط أو استرداد التسبيق

كل شيء يتوقف على اللحظة التي تتوقف فيها الصفقة.

• رابط التسبيق لم يُؤدَّ: ألغوه، من بوابة التاجر أو بالنداء POST /v1/payment-links/{reference}/cancel. فالرابط الملغى لا يمكن أداؤه؛ وهكذا لا يؤدّي أي زبون عرض أثمان متروكًا.
• رابط الباقي لم يُؤدَّ بعد: الحركة نفسها، ألغوه إن لم تكتمل الخدمة.
• التسبيق أُدّي بالبطاقة: استردّوا لزبون، كليًا أو جزئيًا، من بوابة التاجر أو عبر API. الاسترداد مجاني؛ ويُخصم مبلغه من رصيدكم المتاح، وإذا لم يكفِ الرصيد تُوقَف العملية بدل إحداث رصيد مدين. والاسترداد ليس فوريًا من جهة البنك. وتجدون الإجراء كاملًا في دليلنا عن استرداد مبلغ لزبون.

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

في المحاسبة: استخلاصان وصفقة واحدة

بالنسبة إلى محاسبكم، ينتج عرض أثمان بتسبيق استخلاصين منفصلين، مرتبطين بالصفقة نفسها. وChariPay تحفظ لكم هذا الأثر. تحمل كل حركة في الحساب مرجع البيع أو الاسترداد أو الدفعة التي تفسّرها؛ وتميّز بوابة التاجر بين المبلغ المدفوع والرسوم والصافي، ويحتفظ تصدير CSV بهذه المراجع — من بوابة التاجر أو عبر GET /v1/transactions/export.csv (حتى 10 000 سطر؛ وفوق ذلك قسّموا حسب الفترة بـfrom/to). والطوابع الزمنية بتوقيت UTC؛ والمغرب على UTC+1: فعلى أداة المطابقة لديكم أن تحوّل.

وثلاث عادات تجعل المطابقة بديهية:

• رقم عرض الأثمان في وصف كل رابط، وفي فاتورتكم النهائية.
• مطابقة الأداءين مع الوثيقة المحاسبية نفسها، لا معاملتهما كبيعتين مستقلتين.
• تتبّع أي استرداد كحركة مستقلة، مرتبطة بالأداء الأصلي.

وتجدون الطريقة اليومية مفصَّلة في مطابقة المستخلصات، ولائحة النقاط التي ينبغي التحقق منها في القائمة المحاسبية للاستخلاص. أما معالجة التسبيق في حساباتكم، فمن اختصاص محاسبكم.

أسئلة شائعة

كيف أطلب تسبيقًا من زبون عبر الإنترنت؟

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

ما مبلغ التسبيق الذي أطلبه؟

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

هل يمكن استخلاص التسبيق نقدًا؟

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

هل يمكن أن تنتهي صلاحية رابط التسبيق مع عرض الأثمان؟

نعم، لرابط يُؤدّى بالبطاقة. عند إنشاء الرابط، اختاروا مدة صلاحية من 24 ساعة، أو 7 أيام، أو 30 يومًا، أو تاريخًا محددًا: تاريخ نهاية صلاحية العرض. وبعده تُخبر الصفحة الزبون بأن العرض لم يعد متاحًا، ولا يمكن لأي أداء أن يمرّ. وإن عاد الزبون لاحقًا وتمسكتم بعرضكم، فأنشئوا رابطًا جديدًا، بـexternalId جديد إن كنتم تعملون عبر API.

كيف أجد التسبيق والباقي لعرض الأثمان نفسه؟

ضعوا رقم عرض الأثمان في وصف الرابطين: فتجدونهما جنبًا إلى جنب في بوابة التاجر وفي تصدير CSV. وعبر API، أعطوا كل رابط externalId خاصًا به وmetadata نفسه، مثل quoteId، الذي يعود كما هو في حدث الأداء. وهكذا يربط نظامكم كل أداء بعرض الأثمان الصحيح.

كيف أستردّ التسبيق إن ألغى الزبون؟

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

هل يصبح التسبيق متاحًا في الحساب فورًا؟

نعم. بمجرد نجاح أداء — بطاقة مصادَق عليها بـ‎3-D Secure أو مرجع مسدَّد نقدًا في الوكالة — يصبح المبلغ متاحًا في حساب الأداء ChariPay الخاص بكم وقابلًا للاستعمال فورًا. وليس ذلك تحويلًا بنكيًا فوريًا: فالدفعة نحو بنككم تبقى عملية مستقلة. وحساب الأداء الخاص بكم تمسكه Chari Money؛ وهو يكمّل بنككم ولا يعوّضه.

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

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