المشكلة
لا يأتي Shopify بوسائل الدفع والتوصيل التي يستعملها المتسوّق الجزائري. أغلب الزبائن يريدون الدفع عند الاستلام. وآخرون يريدون الدفع عبر الإنترنت ببطاقة CIB أو Edahabia. ويتم التوصيل عبر شركات محلية مثل Yalidine، إلى المنزل أو إلى مكتب الاستلام.
للدفع عند الاستلام كلفته. الطرود التي لم يؤكدها أحد ترجع، والطرد المُرجَع يُدفع ثمنه مرتين. لذلك تتصل المتاجر بكل زبون قبل الشحن. وهذه المكالمة تعيش عادةً في دفتر أو في محادثة، بعيداً عن الطلب.
كانت Cosmekarn، وهي متجر جزائري لمستحضرات التجميل على Shopify، تحتاج كل ذلك في مسار واحد.
ماذا بنينا
Foxmayn Shopify Pay (FSP) برمجية وسيطة للدفع والشحن لمتاجر Shopify في الجزائر. لها ثلاثة أجزاء.
- خلفية تتولى الدفع والشحن والطلبات لعدة تجار.
- لوحة إدارة فيها التجار والمعاملات والشحن والمطابقة المالية.
- تطبيق Shopify باسم "Foxmayn Pay" مدمج في لوحة إدارة Shopify، مع امتداد مخصص لصفحة الدفع.
ويدعم:
- الدفع عند الاستلام.
- الدفع بالبطاقة عبر الإنترنت من خلال Chargily (CIB وEdahabia).
- توصيل Yalidine، إلى المنزل أو إلى مكتب الاستلام، إضافة إلى الشحنات اليدوية.
- تأكيد كل طلب بالدفع عند الاستلام من شخص، قبل إنشاء الطرد.
كيف يعمل
في الدفع بالبطاقة، تنشئ صفحة الدفع طلباً مسودة في Shopify وتحوّل الزبون إلى Chargily. وحين تؤكد Chargily الدفع، يُكمل FSP الطلب المسودة في Shopify. وفي الدفع عند الاستلام، ينتظر الطلب مكالمة التأكيد. لا ينشئ النظام طرداً لطلب بالدفع عند الاستلام حتى يؤكده شخص.
الخلفية مكتوبة بـ TypeScript على Node 24 مع Hono وDrizzle ORM فوق PostgreSQL. لا يحتفظ الخادم بأي حالة جلسة. صورة واحدة تشغّل الخادم وعاملاً مجدولاً، وPostgres خلفهما. لكل تاجر تطبيق Shopify مخصص خاص به، وتُشفَّر بيانات اعتماد كل تاجر بـ AES-256-GCM مع nonce مستقل لكل سجل. والتطبيق المدمج يستعمل React Router v7 وPrisma.
توجد البوابات وشركات التوصيل خلف سجلّات، ما يُبقي كل بوابة وكل شركة توصيل في وحدة مستقلة.
أين وصل
FSP في الخدمة لدى Cosmekarn ويستقبل طلبات حقيقية. التاجر نشط منذ 26 يوليو 2026، ومزوّد Yalidine مفعّل ويزامن بياناته له.
بحلول أكتوبر 2026، كان FSP قد نقل آلاف الطلبات من صفحة الدفع إلى Shopify، أغلبها بالدفع عند الاستلام والباقي بالبطاقة عبر Chargily. وCosmekarn هي أول تاجر في الخدمة.
الدفع المباشر عبر SATIM وCIB مسجَّل في الشيفرة، لكنه غير مقبول في الخدمة. تمرّ مدفوعات البطاقات عبر Chargily.
ماذا تعلّمنا
اختبروا قبل الإطلاق، ودقّقوا. للخلفية مئات الاختبارات الآلية، منها اختبارات شاملة مع محاكاة للخدمات الخارجية. وقبل الإطلاق أجرينا تدقيقاً أمنياً كاملاً للشيفرة وأصلحنا ملاحظاته الحرجة والعالية، قبل أن يعتمد مال حقيقي عليها.
أبقوا الإنسان في الحلقة. مكالمة التأكيد قاعدة عمل. ووضعها داخل النظام، قبل خطوة الطرد، هو ما يجعل أتمتة الباقي آمنة.
الخطوة التالية
مزيد من شركات التوصيل، ومزيد من متاجر Shopify الجزائرية. إن كان لديكم متجر Shopify في الجزائر، فاطلعوا على منتجاتنا الجزائرية الأخرى أو اقرؤوا عن Foxmayn Track، نظامنا لتتبّع وصولات التسليم، وهو أيضاً في الخدمة لدى Cosmekarn.