دمج الدفع عبر SATIM

المشكلة

تبني منتجًا للسوق الجزائرية وتحتاج قبول مدفوعات البطاقات (CIB وEdahabia). SATIM هي البوابة الوحيدة. لكن دمجها مؤلم.

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

وقبل كل هذا، تحتاج اعتماد SATIM، وهي عملية تستغرق أسابيع وتتطلب امتثالًا تقنيًا محددًا.

ما أفعله

أتعامل مع دمج SATIM الكامل: من الاعتماد إلى النشر في بيئة الإنتاج.

ما تحصل عليه:

• تدفق دفع كامل: البدء، التأكيد، الاسترجاع
• دعم بطاقات CIB وEdahabia
• دمج آمن من حيث الأنماط مع اكتشاف الأخطاء وقت الترجمة
• إدارة آمنة لبيانات الاعتماد (بدون أسرار في عناوين URL أو السجلات)
• معالجة Webhook لتأكيدات الدفع
• دعم التجار المتعددين إذا كنت تشغل أعمالًا متعددة
• وضع اختبار للتطوير، ووضع إنتاج للإطلاق

ما بنيته بالفعل:

كتبت حزمة SDK مفتوحة المصدر بـ TypeScript لـ SATIM (@bakissation/satim على npm) وإضافة خادم Fastify. هذه هي الأدوات التي أستخدمها في كل دمج: مجرّبة، آمنة من حيث الأنماط، ومُصانة.

كيف أعمل

1. التقييم. أراجع مكدسك التقني ومتطلبات الدفع
2. الاعتماد. إذا لم يكن لديك اعتماد SATIM بعد، أرشدك خلال العملية
3. الدمج. أنفذ تدفق الدفع في تطبيقك
4. الاختبار. اختبار شامل من طرف إلى طرف في بيئة SATIM التجريبية
5. الإطلاق. نشر في بيئة الإنتاج مع المراقبة

الوقت النموذجي: أسبوع إلى أسبوعين.

إثبات العمل

• حزمة SDK لمدفوعات SATIM-TS. حزمة SDK بـ TypeScript بنيتها وأتحتها مصدريًا لدمج SATIM. قلّصت وقت الدمج من ساعات إلى دقائق. منشورة على npm مع أمان أنماط كامل والتحقق بـ Zod ومعالجة آمنة لبيانات الاعتماد.

• إضافة Fastify-SATIM. إضافة Fastify تتعامل مع مسارات دفع SATIM والتحقق وربط الأخطاء. تدعم التجار المتعددين. قلّصت مئات الأسطر من الكود المتكرر إلى تسجيل إضافة واحدة.

لمن هذا

• الشركات الناشئة الجزائرية التي تبني منتجات تجارة إلكترونية أو SaaS
• الشركات الدولية التي تدخل السوق الجزائرية
• الأعمال القائمة التي تضيف المدفوعات عبر الإنترنت إلى عملياتها