إذا كنت تبني تطبيقاً أو موقع تجارة إلكترونية في الجزائر، يجب أن تدمج مدفوعات CIB والذهبية عبر بوابة SATIM. إنها أسوأ تكامل موثق في النظام التقني الجزائري بأكمله. هذا الدليل هو ما تمنينا لو كان لدينا عندما أجرينا أول تكامل SATIM في 2020.
CIB مقابل الذهبية — ما الفرق؟
CIB هي البطاقة البنكية (~8 مليون بطاقة). الذهبية هي بطاقة بريد الجزائر المدفوعة مسبقاً (~20 مليون بطاقة — الأكثر انتشاراً في الجزائر). إذا لم تدعم الذهبية، تستبعد 70% من العملاء المحتملين.
كلاهما يمر عبر SATIM. تدمج بوابة SATIM مرة واحدة، تتعامل مع الاثنين.
«إذا لم تدعم الذهبية، تستبعد 70% من العملاء المحتملين في الجزائر.»
هندسة التكامل — التدفق الكامل
تدفق SATIM القياسي هو تدفق إعادة توجيه في 5 خطوات.
حرج: لا تثق أبداً بإعادة التوجيه وحدها. استخدم دائماً callback من الخادم إلى الخادم (S2S) لتأكيد الدفع من جانب الخلفية.
الفخاخ الخمسة التي لا تذكرها الوثائق
فخ 1: sandbox SATIM غالباً معطل. اختبر في عطلة نهاية الأسبوع.
فخ 2: ليست كل رموز الخطأ موثقة. سجّل كل شيء.
فخ 3: callback S2S أحياناً يصل قبل إعادة توجيه العميل. استخدم حالة "في انتظار التأكيد" في قاعدة بياناتك.
فخ 4: CIB والذهبية لها حدود معاملات مختلفة. CIB: 200,000 دج. الذهبية: 100,000 دج.
فخ 5: شهادة SSL لنطاقك يجب أن تكون مثالية.
«لا تثق أبداً بإعادة التوجيه وحدها. callback من الخادم إلى الخادم إلزامي.»
المكدس التقني الموصى به
الخلفية: Node.js (NestJS) أو Python (Django/FastAPI). تجنب PHP للتكاملات الجديدة.
قاعدة البيانات: PostgreSQL مع جدول مخصص `payment_transactions`.
قائمة الانتظار: Redis/Bull للتحقق المؤجل.
الجدول الزمني والتكلفة الحقيقية
إذا كان لديك خلفية بالفعل: 3-6 أسابيع، 300K–800K دج.
من الصفر: 8-12 أسبوعاً، 1.5–3M دج.
رسوم SATIM: عمولة 1.5-2.5% لكل معاملة.