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

شهادة RIB لحساب الأداء: الـRIB والتصدير والإيصالات والتحويلات الواردة

شهادة RIB لحساب الأداء: تحميلها من بوابة التاجر أو عبر API، وتلقي تحويلات زبنائكم، وتصدير مراجع كل حركة، وحفظ إيصالات الفواتير المؤداة.

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

RIB حساب الأداء، باسم الشركة

ChariPay منصة دفع مغربية، مزوّد خدمات دفع (PSP) تشغّله Chari Money، مؤسسة أداء مرخَّصة من بنك المغرب. والحساب الذي يتلقى مستخلصاتكم حساب أداء حقيقي، تمسكه Chari Money، مفتوح باسم شركتكم، بـRIB بهذا الاسم وشهادة PDF قابلة للتنزيل من بوابة التاجر أو عبر API. يستقبل مستخلصاتكم والتحويلات الواردة، ويخدم عمليات الأداء الخاصة بكم.

توضيحان يمنعان سوء الفهم. ChariPay ليس بنكًا: حساب الأداء الخاص بكم تمسكه Chari Money. إنه يكمّل بنككم ولا يعوّضه: فحسابكم البنكي يبقى وجهة دفعاتكم. وRIB حساب الأداء هو إذن RIB ثانٍ، خاص بالحساب الذي يؤدّي فيه زبناؤكم، إلى جانب RIB بنككم.

أما ما ليس عليه هذا الحساب، وكيف يُقارَن بالحساب البنكي، ففي دليل حساب الأداء في المغرب. وهنا نكتفي بالوثائق.

تحميل شهادة RIB لحساب الأداء

طريقان يوصلان إلى الشهادة.

  1. 1من بوابة التاجر. تُحمَّل شهادة PDF من بوابة التاجر، المتاحة بالفرنسية والإنجليزية. وهو أبسط طريق حين يتعلق الأمر بإرسالها إلى زبون.
  2. 2عبر API. إن كان نظامكم الداخلي يحتاج إلى عرض الـRIB أو إرفاق الشهادة بفاتورة، فنداءان يكفيان: يعيد GET /v1/wallet/account بيانات الحساب، ويعيد GET /v1/wallet/account/rib-document الشهادة بصيغة PDF. والعنوان الأساسي واحد — https://api-psp.charipay.ma — والمفتاح هو ما يحدّد البيئة.
bash
# Account details (RIB) — JSON
curl -X GET 'https://api-psp.charipay.ma/v1/wallet/account' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...'

# RIB certificate — PDF
curl -X GET 'https://api-psp.charipay.ma/v1/wallet/account/rib-document' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...' \
  -o attestation-rib.pdf

ويرد النداءان في وحدة «المحفظة» في توثيق API، إلى جانب قراءة الرصيد (GET /v1/wallet). وإن لم تكن محفظة الحساب مفعَّلة، أجابت هذه النداءات بـ422 WALLET_NOT_ACTIVE؛ ويتلقى مفتاح chari_sk_live_… الرد 403 PRODUCTION_ACCESS_NOT_ENABLED إلى أن يُفعَّل الإنتاج. ويبقى المفتاح من جهة الخادم: لا يوضع أبدًا في المتصفح، ولا في تطبيق محمول، ولا في مستودع git، ولا في لقطة شاشة.

أما استعمال الشهادة لدى طرف ثالث، فلا نفترض فيه شيئًا: اسألوا زبونكم، أو الجهة المعنية، عن الوثيقة التي ينتظرها.

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

تلقي تحويل على حساب الأداء

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

حالتان يفيد فيهما ذلك:

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

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

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

مراجع كل حركة وتصدير CSV

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

ما يفعله محاسبكم بذلك:

الحاجةأين يجدها
حركات فترة ما، كلٌّ منها بمرجعهاتصدير CSV للفترة، من بوابة التاجر أو عبر API
المبلغ المدفوع والرسوم والصافي لعملية بيعبوابة التاجر، التي تميّز بينها
تفاصيل عملية بعينهاGET /v1/transactions/{operationId} وتسلسلها الزمني GET /v1/transactions/{operationId}/timeline
فترة تتجاوز 10 000 سطرعدة تصديرات، مقسَّمة بـfrom وto
الأيام المحاسبية بالتوقيت المغربيتحويل من UTC إلى التوقيت المغربي قبل الجمع

ويرد وصف النداءات في وحدة «المعاملات» في توثيق API. أما الطريقة اليومية — ما يُطابَق، وبأي ترتيب، وأي فوارق يُنتظر — ففي دليل مطابقة المستخلصات.

مرجع الدفعة في كشف حسابكم البنكي

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

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

الإيصالات: الفواتير المؤداة والزبناء

نوعان من الإيصالات يكمّلان الملف.

  • إيصالات الفواتير التي تؤدّونها من الحساب. حين تؤدّون فاتورة لدى الدائنين المعتمدين، يُقتطع المبلغ من رصيدكم المتاح، دون رسوم إضافية، ويُرسَل الإيصال عبر SMS. احفظوه مع الفاتورة المعنية.
  • إيصالات زبنائكم. «تتبّع المعاملات وإيصالات الزبناء» ضمن ما هو مشمول دون رسوم إضافية.

أما المسار الكامل للفواتير المؤداة من الحساب — الدائن، والمرجع، والفواتير غير المؤداة، والرموز — ففي دليل أداء الفواتير من حساب الأداء.

سجل التدقيق، الوثيقة التي لا يُعاد كتابتها

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

وما يهمّ ملفكم من ذلك:

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

وبالنسبة إلى فترة معيّنة، تبقى الوثيقة المرجعية هي التصدير بمراجعه: وهو ما تسلّمونه لمحاسبكم، مرفقًا بمراجع الدفعات والإيصالات.

الملف الوثائقي للحساب، في قائمة واحدة

لمسيّركم ومحاسبكم، هذا هو الملف الكامل، وأين تجدون كل وثيقة:

  • شهادة RIB (PDF): من بوابة التاجر أو عبر GET /v1/wallet/account/rib-document؛ تُرسل إلى الزبناء الذين يؤدّون لكم بالتحويل.
  • بيانات الحساب: من بوابة التاجر أو عبر GET /v1/wallet/account.
  • تصدير CSV ومراجعه: من بوابة التاجر أو عبر GET /v1/transactions/export.csv، حتى 10 000 سطر في كل تصدير، والطوابع الزمنية بتوقيت UTC.
  • مرجع كل دفعة: في كشف حسابكم البنكي، والمرجع نفسه في التصدير.
  • إيصالات الفواتير المؤداة: عبر SMS، تُحفظ مع كل فاتورة.

ويُضاف إلى ذلك سجل التدقيق المسلسل الذي تمسكه المنصة: لا يمكن إعادة كتابة التاريخ.

ولتقرّروا مع محاسبكم، قبل أول استخلاص، كيف تدخل هذه الوثائق في محاسبتكم، اتبعوا القائمة المحاسبية للاستخلاص.

أسئلة شائعة

هل لحساب الأداء الخاص بي لدى ChariPay رقم RIB؟

نعم. حساب الأداء تمسكه Chari Money، مؤسسة أداء مرخَّصة من بنك المغرب، وهو مفتوح باسم شركتكم، بـRIB بهذا الاسم وشهادة PDF. وChariPay ليس بنكًا: فهذا الـRIB هو RIB حساب الأداء الخاص بكم، الذي يكمّل بنككم ولا يعوّضه، ويستقبل مستخلصاتكم والتحويلات الواردة. ويصلح كذلك لتلقّي أداءات زبنائكم المهنيين بالتحويل.

أين أحمّل شهادة RIB لحساب الأداء؟

من بوابة التاجر، أو عبر API بالنداء GET /v1/wallet/account/rib-document الذي يعيد الشهادة بصيغة PDF؛ ويعيد GET /v1/wallet/account بيانات الحساب. ويستعمل النداءان العنوان https://api-psp.charipay.ma والترويسة X-CHARI-PAY-API-KEY، بمفتاح محفوظ من جهة الخادم. وتصفهما وحدة المحفظة في توثيق API، ويمكن لنظامكم الداخلي أيضًا إرفاق الشهادة بفواتيركم إن احتاج إلى ذلك.

هل الـRIB باسم الشركة أم باسم مسيّرها؟

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

هل يستطيع زبون أن يؤدّي لي بالتحويل على هذا الـRIB؟

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

كيف أجد دفعة ChariPay في كشف حسابي البنكي؟

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

هل تصدير CSV للمعاملات محدود؟

نعم: يغطي تصدير CSV الواحد حتى 10 000 سطر. وفوق ذلك، قسّموا حسب الفترة بالمعاملين from وto، من بوابة التاجر أو عبر GET /v1/transactions/export.csv. ويحتفظ كل سطر بمرجع البيع أو الاسترداد أو الدفعة التي تفسّره، وتميّز بوابة التاجر بين المبلغ المدفوع والرسوم والصافي.

لماذا لا تطابق أوقات التصدير التوقيت المغربي؟

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

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

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

بقلم فريق ChariPay.

اقرؤوا بعده

دليل4 دقائق قراءة

مطابقة تحصيلاتكم مع محاسبتكم

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

مستعدون للتجربة بأنفسكم؟

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

  • مجاني ودون التزام
  • وضع الاختبار منذ التسجيل
  • لا موافقة تنتظرونها