ربط نظام إلكتروني ببوابة الدفع الحكومية

نحن بحاجة إلى مبرمج/خبير تكامل محترف للقيام بعملية الربط بين منصتنا الإلكترونية (البرنامج المحاسبي) وبوابة المدفوعات الحكومية عبر الـ API الخاصة بهم.

سنقوم بتزويدك بكافة الصلاحيات والبيانات الأولية فور ترسية المشروع، ونحتاج منك تنفيذ التكامل الكامل بدءًا من بيئة الاختبار (Sandbox/UAT) وصولاً إلى البيئة الإنتاجية (Live)، مع الالتزام بأعلى معايير الأمان.

بناءً على وثائق المطور الخاصة بالبوابة، تشمل عملية الربط المحاور التالية، والتي يجب أن تكون على دراية كاملة بها:

-آلية الدخول (Registration): التسجيل في بوابة المطورين يتم عن طريق الدعوة فقط (Invitation Only). سنقوم بتزويدك بالبريد الإلكتروني الخاص بك لتلقي دعوة الدخول إلى بيئة الاختبار.

-الاشتراطات الأمنية المسبقة (Whitelist): سيُطلب منا تزويد فريق البوابة بـ العنوان IP العام (Public IP) للخادم و رابط إعادة التوجيه (Callback URL) لإضافتهم إلى القائمة البيضاء. نطلب منك تحديد هذه المتطلبات من جانبنا للقيام بهذه الخطوة.

-إنشاء التطبيق واستخراج المفاتيح (Credentials):

بعد الدخول إلى البوابة، ستقوم بإنشاء تطبيق جديد (App) للحصول على زوج المفاتيح الأساسي: (Client-ID) و (Client-Secret).

-تنبيه أمان مهم جداً: يجب حفظ (Client-Secret) في مكان آمن، حيث لا يمكن استعادته أو عرضه لاحقاً (يمكن فقط إعادة تعيينه بالكامل، مما يؤثر على التطبيقات العاملة).

توليد التوكن (Token Generation):

سنقوم بتزويدك ببيانات اعتماد مستخدم تجريبية (بيئة اختبار) لمحاكاة دور المستخدم النهائي.

ستحتاج إلى كتابة كود (Backend) مسؤول عن توليد Token بشكل آمن باستخدام بيانات الاعتماد هذه مع الـ Client-ID و Secret، مع آلية لتحديث التوكن تلقائياً عند انتهاء صلاحيته.

الاشتراك في الخدمة (Subscription):

في بوابة المطورين، يجب تصفح المنتج والاشتراك في خطة المؤسسات (Enterprise Plan) والموافقة عليها لتفعيل استدعاء واجهات الدفع.

نقل الحل للإنتاج (Going Live):

بعد التأكد من نجاح جميع العمليات في بيئة الاختبار، سنقوم بتكرار نفس الخطوات السابقة (من 1 إلى 5) ولكن على البوابة الإنتاجية الرئيسية (Production) لإكمال التفعيل النهائي.

نطاق العمل المطلوب من المستقل:

-فهم متطلبات التكامل الخاصة بمنصتنا (دفع الفواتير، الاستعلام الفوري عن حالة الدفع، ومعالجة إشعارات الدفع الواردة Callbacks).

-كتابة الكود (Backend) بلغتنا البرمجية المحددة [يرجى ذكر لغتك هنا: مثلاً PHP / Laravel / C# / Node.js / Java] لربط المنصة بالـ API.

-تطبيق آلية توليد التوكن وإعادة استخدامه (Refresh Token) بشكل آلي دون تدخل يدوي.

-بناء نظام متكامل لإدارة الأخطاء (Error Handling) وعرض رسائل مناسبة للمستخدم في حالة فشل الدفع أو انقطاع الاتصال.

-توثيق الكود بشكل احترافي، وتزويدنا بملف (Postman Collection) يوضح جميع عمليات الـ API للرجوع إليه في المستقبل.

-الإشراف على مرحلة الاختبار (UAT) وتصحيح أي أخطاء تظهر، ثم ترحيل الحل ونشره في بيئة الإنتاج مع تكرار عملية التفعيل هناك تحت إشرافنا.