Stripe في المغرب سنة 2026: غير متاحة — وكيف تحصّلون رغم ذلك

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

الجواب في 50 كلمة

لا، Stripe غير متاحة في المغرب سنة 2026. فالقائمة الرسمية للبلدان المدعومة، المنشورة على stripe.com/fr/global، لا تشمل المغرب، ولم يُعلَن علنًا عن أي جدول زمني للافتتاح. وبالتالي لا تستطيع شركة مغربية إنشاء حساب لديها لتحصيل مدفوعات زبنائها.

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

لماذا لا تُرتجَل خدمة دفع أجنبية في المغرب

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

ترخيص بنك المغرب

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

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

التسوية بالدرهم، في حساب مغربي

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

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

الضريبة على القيمة المضافة والفاتورة

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

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

الحلول الالتفافية المتداولة، وما تكلّفه فعلًا

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

تأسيس شركة في الخارج

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

ما يتغير هو كل ما عدا ذلك:

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

المرور عبر حساب طرف ثالث

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

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

خلاصة القول

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

التحصيل في المغرب مع ChariPay: المفردات التي تعرفونها سلفًا

ChariPay هي بوابة الأداء الخاصة بـChari، تشغّلها Chari Money، مؤسسة أداء مرخَّصة من بنك المغرب. إن كنتم قد أدمجتم بوابة حديثة من قبل، فلن تبدؤوا من الصفر: المفاهيم هي نفسها، والواجهة البرمجية REST، والمبالغ بالدرهم، والنتيجة تصل عبر ويب هوك موقَّع. وهذه المطابقة، مفهومًا مفهومًا.

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

جلسة الدفع: نداء واحد، وعنوان واحد

تنشئون جلسة من جهة الخادم بالمبلغ بالدرهم — لا يوجد حقل للعملة، فكل شيء بالدرهم المغربي (MAD)، بالوحدات الكبرى مع رقمين عشريين — ومرجع طلبكم، والمشتري، وعناوين العودة. تحتوي الاستجابة على عنوان صفحة الدفع المستضافة، حيث يدفع المشتري بالبطاقة مع ‎3-D Secure أو يختار الأداء نقدًا في وكالة. ينتقل مفتاح الواجهة في الترويسة 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-0421-paiement' \
  -d '{
    "amount": 250.00,
    "orderId": "ORD-2026-0421",
    "externalId": "commande-2026-0421",
    "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:

{
  "sessionId": "ps_5Kd0Rn",
  "checkoutUrl": "https://pay.chari.ma/checkout/ps_5Kd0Rn",
  "expiresAt": "2026-09-11T10:15:00Z"
}

وجّهوا المشتري إلى checkoutUrl، وهذا كل ما في الجزء المرئي. الجلسة لاستعمال واحد افتراضيًا، وتنتهي صلاحيتها بعد 72 ساعة من إنشائها إن لم تزوّدوها بـexpiresAt. أما عنوانا accept وdecline فيخدمان عودة المشتري إلى موقعكم؛ وليسا حجة — فالمشتري الذي يغلق تبويبه بعد الدفع لن يرى صفحة نجاحكم أبدًا، بينما المال وصل فعلًا. الويب هوك هو الحجة، وهو اللبنة التالية.

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

الويب هوك الموقَّع: التحقق في Node

لا تكتمل عملية الدفع لحظة استدعائكم لها: يمرّ المشتري ببنكه، ويصادق عبر ‎3-D Secure، ثم يعود — أو لا يعود. تصلكم النتيجة عبر الويب هوك، وهذا الإشعار هو مصدر الحقيقة الوحيد. كل تسليم يحمل ترويستين: X-CHARI-SIGNATURE، وهي HMAC-SHA256 بالنظام الست عشري بأحرف صغيرة محسوبة على السلسلة timestamp + "." + rawBody، وX-CHARI-TIMESTAMP، وهي الطابع الزمني بالميلي ثانية منذ epoch. وتتسامح الواجهة مع فارق ±5 دقائق بين هذا الطابع الزمني ووقت الاستلام.

const crypto = require('crypto');

function verify(rawBody, signature, timestamp, secret) {
  // Fenêtre anti-rejeu de ±5 minutes — l'horodatage est en millisecondes.
  if (Math.abs(Date.now() - Number(timestamp)) > 5 * 60 * 1000) return false;

  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${timestamp}.${rawBody}`)
    .digest('hex');

  // Une signature malformée doit répondre false — jamais jeter (500 → retentatives).
  if (!/^[0-9a-f]{64}$/i.test(signature)) return false;

  // Comparaison en temps constant — jamais `===`.
  return crypto.timingSafeEqual(Buffer.from(expected, 'hex'), Buffer.from(signature, 'hex'));
}

وهذا المسار الذي يستعملها، مع الاحتفاظ بالجسم خامًا — وهذا أكثر الأخطاء تكرارًا: إطار عمل يحلّل الـ JSON قبل التحقق، ثم كائن معاد التسلسل لم تعد بايتاته هي التي وُقِّعت.

app.post('/webhooks/charipay', express.raw({ type: '*/*' }), async (req, res) => {
  const raw = req.body.toString('utf8');            // le corps brut, avant tout parsing
  const ok = verify(
    raw,
    req.get('X-CHARI-SIGNATURE'),
    req.get('X-CHARI-TIMESTAMP'),
    process.env.CHARIPAY_WEBHOOK_SECRET
  );
  if (!ok) return res.status(401).end();

  const eventId = req.get('Chari-Event-Id');        // la clé de déduplication
  if (await db.events.exists(eventId)) return res.status(200).end();

  await db.events.insert({ eventId, payload: JSON.parse(raw) });
  await queue.push('handle-charipay-event', eventId);
  return res.status(200).end();                     // accusé, le reste suit
});

أربع قواعد تصنع أمان التحقق كله: احسبوا الـ HMAC على البايتات الخام قبل أي تحليل؛ وارفضوا الطوابع الزمنية البعيدة جدًا؛ وقارنوا في زمن ثابت؛ وأزيلوا التكرار على Chari-Event-Id، لا على Chari-Webhook-Id الذي يتغير مع كل محاولة تسليم. والسندبوكس والإنتاج توقّعان بسرّين مختلفين.

إن لم يردّ خادمكم بـ2xx، نعيد التسليم: بعد دقيقة، ثم 5 دقائق، ثم 30 دقيقة، ثم ساعة، ثم كل 6 ساعات، حتى 16 محاولة على مدى نحو 72 ساعة. وإن كان خادمكم في صيانة لمدة أطول، فسجل التسليمات في البوابة يعرض كل تسليم — عدد المحاولات، وآخر ردّ من خادمكم، والجسم الدقيق للحدث — ويتيح إعادة تشغيله بنقرة واحدة. الأحداث التي ستنتظرونها أكثر من غيرها: payment.succeeded، وpayment.failed (إن طلبتموه عند إنشاء الجلسة)، وللاستردادات refund.succeeded. ومقال في هذه المدوّنة يفصّل الأخطاء الخمسة الكلاسيكية والمعالجة في خمسة عشر سطرًا: إنجاح دمج الويب هوك.

Idempotency، في طبقتين

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

• `Idempotency-Key`، الترويسة التي ترسلونها على عمليات الإنشاء: إعادة نداء بالقيمة نفسها تعيد النتيجة الأولى بدل إنشاء نسخة مكررة. وهي الحماية من مهلة منتهية، أو اتصال مقطوع، أو طابور رسائل سلَّم مرتين.
• `externalId`، الحقل في الجسم: فريد لكل تاجر ولكل بيئة، ويجعل الإنشاء عملية يمكنكم إعادة إطلاقها دون الاحتفاظ بأي حالة وسيطة. أنشئوا جلسة مرتين بـexternalId نفسه فتعيد الواجهة الجلسة القائمة برمز 200 بدل 201 — والرمز يقول لكم بالضبط ما جرى.

ويمكن لـexternalId واحد أن يوجد مرة في السندبوكس ومرة في الإنتاج دون تعارض. اشتقّوا هذه المفاتيح من مرجع طلبكم — لا من سحب عشوائي أبدًا، فذلك تفويت للفكرة كلها. التفاصيل وأنماط المفاتيح الجيدة في لا تحصّلوا مرتين أبدًا — شرح Idempotency.

الاختبار والإنتاج: عنوان أساسي واحد، ومفتاحان

لا يوجد إلا عنوان أساسي واحد، https://api-psp.charipay.ma، في السندبوكس كما في الإنتاج: مفتاح الواجهة هو الذي يختار البيئة. المفتاح chari_sk_test_… يستهدف السندبوكس، والمفتاح chari_sk_live_… يستهدف الإنتاج. العناوين والحمولات ورموز الأخطاء متطابقة؛ ويوم الانتقال إلى الإنتاج تغيّرون المفتاح، وسرّ الويب هوك، ولا شيء غير ذلك.

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

في السندبوكس، تكفي بطاقة اختبار واحدة: 4918914107195005، بتاريخ انتهاء مستقبلي، و123 رمزًا لـCVV، و555 رمزًا لـ‎3-D Secure. وهي تطلق مسارًا حقيقيًا — صفحة الدفع، والمصادقة، والويب هوك — دون أي حركة مال.

رابط الدفع، للتحصيل بلا برمجة

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

الاستردادات والاشتراكات والمنتجات

• الاسترداد. POST /v1/refunds بمعرّف الدفعة — operationId أو externalId — وسبب، وrefundReference من اختياركم؛ بالكامل افتراضيًا، أو بمبلغ جزئي عبر refundAmount. تردّ الواجهة بـ202 ريثما تتم التسوية، ثم يصل refund.succeeded عبر الويب هوك. وإعادة refundReference نفسه تعيد الاسترداد القائم دون خصم مرتين.
• الاشتراكات. أنشئوا اشتراكًا باستحقاقاته؛ والاقتطاع الذي يفشل يُعاد بعد يوم، وبعد 3 أيام، وبعد 7 أيام، وكل مرحلة تصلكم عبر الويب هوك. وفي السندبوكس، توجد نقطة تفرض الاستحقاق القادم، مما يتيح إجراء سنة اشتراك في دقيقة والتحقق من فوترتكم قبل أن يعانيها زبون حقيقي.
• المنتجات والطلبات. كتالوج بسيط، بالطلبات مرتبطةً بكل منتج — مفيد حين ينحصر بيعكم في بضع مراجع ثابتة.

ما الذي يغيّره التحصيل محليًا

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

النقد في الوكالة

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

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

المال متاح في اللحظة، في حساب أداء بـRIB

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

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

السندبوكس ذاتية الخدمة، مجانية، وبلا حد زمني

لا تنتظرون أحدًا لتبدؤوا. يتم التسجيل عبر الإنترنت على portal-psp.charipay.ma/register؛ تفعّلون الحساب بالبريد الإلكتروني، وتختارون كلمة مرور، وتسجّلون الدخول، وتختارون شركتكم، وتطلبون رمز تأكيد، وتنشئون بأنفسكم مفتاح الاختبار، وتجرون أول نداء — ثماني خطوات تسردها مجموعة Postman بالترتيب، دون موعد ودون بريد إلى الدعم. السندبوكس مجانية وبلا حد زمني: تبقى بيئة القبول لديكم طويلًا بعد الانتقال إلى الإنتاج.

وهناك أيضًا ما يُنتظر من بوابة جادة وستجدونه في المكان نفسه: شهادة PCI DSS من المستوى الأول، وبيانات تُعالج في إطار القانون 09-08، وبوابة بعدة مستخدمين وأدوار — مالك، ومسيّر، وأمين صندوق، ومحاسب — وتصديرات CSV للمطابقة.

الأسئلة الشائعة

هل Stripe متاحة في المغرب؟

لا. القائمة الرسمية للبلدان المدعومة، على stripe.com/fr/global، لا تشمل المغرب. ولا تستطيع شركة مؤسَّسة في المغرب فتح حساب لديها لتحصيل مدفوعات زبنائها.

متى ستصبح Stripe متاحة في المغرب؟

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

هل شركة في الخارج حل لزبناء مغاربة؟

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

أقدّم خدمة SaaS بالاشتراك: كيف أحصّل في المغرب؟

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

شيفرتي مكتوبة لبوابة أجنبية: ما الذي يجب تغييره؟

أقل مما تظنون، لأن البنية المعمارية هي نفسها: إنشاء من جهة الخادم، وإعادة توجيه إلى صفحة مستضافة، وويب هوك موقَّع هو الحجة، ومفتاح Idempotency على عمليات الإنشاء. ما يتغير هو الأسماء: amount بالدرهم دون حقل عملة، وorderId، وexternalId، وconfig.customer، وconfig.urls؛ وترويسة المصادقة X-CHARI-PAY-API-KEY؛ وترويستا التوقيع X-CHARI-SIGNATURE وX-CHARI-TIMESTAMP بمخططهما timestamp + "." + rawBody؛ وإزالة التكرار على Chari-Event-Id. احسبوا جلسة عمل واحدة لجلسة الدفع والويب هوك، ثم اختبروا ببطاقة الاختبار. وتوثيق الواجهة البرمجية يعطي كل نقطة بأمثلتها بأربع لغات؛ ومجموعة Postman، وعقد OpenAPI، وحزمة لمساعد البرمجة قابلة للتنزيل في المكان نفسه.

كم يكلّف؟

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

كيف أتحقق من أن إدماجي يشتغل قبل الإنتاج؟

في السندبوكس، ببطاقة الاختبار 4918914107195005 (رمز CVV 123، ورمز ‎3-D Secure 555): تُجري المسار كاملًا — صفحة الدفع، والمصادقة، والويب هوك — دون حركة مال. أرسلوا حدث اختبار إلى نقطة الويب هوك لديكم، فالواجهة تقترحه على كل نقطة مصرَّح بها، واقرؤوا في سجل التسليمات بماذا ردّ خادمكم. واختبروا أيضًا دفعة مرفوضة، واستردادًا جزئيًا، وويب هوك يردّ عليه خادمكم بخطأ، لتروا إعادة المحاولة وهي تعمل.

ليس كل زبنائي يملكون بطاقة بنكية: ماذا أفعل؟

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

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

أنشئوا حساب السندبوكس على portal-psp.charipay.ma/register: تسجيل عبر الإنترنت، وتفعيل بالبريد الإلكتروني، ومفتاح اختبار تنشئونه بأنفسكم، دون موعد ودون التزام. ثم افتحوا توثيق الواجهة البرمجية — 12 وحدة، و62 نقطة، وأمثلة بـcurl وJavaScript وPython وPHP — وأجروا أول POST /v1/payment-sessions لكم ببطاقة الاختبار. وحين يصل payment.succeeded إلى خادمكم بتوقيع صحيح، تكونون قد أنجزتم الأساس: والانتقال إلى الإنتاج بعد ذلك يسعه تغيير مفتاح.