كيف تقبل مدفوعات بريدي موب على موقعك وتؤكدها تلقائياً

كيف تعمل دفعة بريدي موب بالنسبة لمتجر

1. عند إتمام الطلب، يعرض موقعك حسابك في CCP (RIP) والمبلغ بالضبط.
2. يرسل العميل المال من تطبيق بريدي موب، فيمنحه بريدي موب رقم مرجع من 12 رقماً.
3. يُدخل العميل هذا المرجع في موقعك.
4. يتحقق خادمك من سجل بريدي موب الخاص بك، ويعلّم الطلب كمدفوع إذا وُجد التحويل.

استقبال التحويل مجاني بالنسبة لك؛ والعميل هو من يدفع رسوم بريدي موب (من 12 إلى 24 دج عن كل تحويل). المشكلة الوحيدة هي الخطوة 4: إذا أُنجزت يدوياً فهي بطيئة، ولقطات شاشة الوصولات يمكن تزويرها.

1. ثبّت الـ SDK

نواة WadieaPay هي الـ SDK مفتوح المصدر baridimob (رخصة MIT)، وهو متوفر لـ TypeScript/JavaScript و Python و Dart/Flutter بالوظائف والأسماء نفسها.

npm install baridimob        # Node.js 18+
pip install baridimob        # Python
flutter pub add baridimob    # Dart / Flutter

2. سجّل الدخول مرة واحدة

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

import { createBaridiMob, fileStorage } from 'baridimob';

const bm = createBaridiMob({ storage: fileStorage('./.baridimob/session.json') });

const result = await bm.auth.login({ login: 'your-login', password: 'your-password' });
if (result.state === 'otp_required') {
  await bm.auth.requestDeviceOtp();      // يُرسَل رمز SMS إلى هاتفك
  await bm.auth.confirmDevice('123456'); // الرمز الذي استلمته
}

3. تحقّق من الدفعة برقم المرجع والمبلغ

const check = await bm.payments.verifyPayment({
  refNum: '012345678901', // المرجع الذي قدّمه العميل
  amount: 2500,           // المبلغ المتوقع بالدينار (دج)
});

if (check.verified) {
  // تم استلام الدفعة: علّم الطلب كمدفوع
} else {
  console.log(check.reason); // not_found أو not_incoming أو amount_mismatch أو duplicate
}

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

4. حافظ على الأمان

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

حدود يجب معرفتها

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