إضافة تفاصيل تكامل بوابة الدفع Ziina

برمجة تطوير البرمجيات برمجة قواعد البيانات برمجة مواقع برمجة تطوير البرمجيات برمجة قواعد البيانات برمجة مواقع

### 1. المهارات والخبرات المطلوبة يجب أن يتمتع المستقل بالمؤهلات التالية: • خبرة قوية في تكامل الـ API، وخاصة بوابات الدفع. • إتقان لغة **PHP** (نظرًا لأن AsfarTrip مبني على **CodeIgniter**). • خبرة في **مصادقة OAuth2** وإدارة **رموز الوصول (Access Tokens)**. • الإلمام بـ **RESTful APIs** و **Webhooks**. • معرفة بأفضل ممارسات **معالجة الدفع الآمنة**. • خبرة في التعامل مع **استجابات الأخطاء، وتسجيل العمليات، والتحقق من المعاملات**. • الإلمام بتعديلات الواجهة الأمامية عند الحاجة. --- ### 2. خطوات التكامل #### **الخطوة 1: إعداد بيانات اعتماد API** • الحصول على **مفاتيح API** من **Ziina** لكل من بيئة **Sandbox** و**Production**. • تهيئة **مصادقة API** باستخدام **OAuth2** القائم على الرموز. #### **الخطوة 2: تنفيذ عملية الدفع** 1. **إنشاء نية الدفع (Payment Intent)** • استخدام **API (POST /v1/payment-intents)** لإنشاء **Payment Intent**. • حفظ **معرّف Payment Intent** والبيانات المرتبطة به. 2. **إعادة توجيه العميل إلى صفحة الدفع في Ziina** • استخدام **رابط صفحة الدفع المستضافة** من **استجابة API** لتوجيه المستخدمين. 3. **التعامل مع Webhooks لتأكيد الدفع** • إعداد **Webhook Listener** لأحداث: - `payment_intent.succeeded` (نجاح الدفع) - `payment_intent.failed` (فشل الدفع) - `payment_intent.canceled` (إلغاء الدفع) • التأكد من **تسجيل المدفوعات الناجحة** بشكل صحيح. 4. **التحقق من حالة الدفع** • استخدام **API (GET /v1/payment-intents/(id))** للتحقق من حالة الدفع قبل المتابعة. #### **الخطوة 3: التكامل عبر وحدات AsfarTrip** • يجب أن تكون بوابة الدفع متاحة لـ **حجوزات الطيران، والفنادق، والتأمين، وخدمات النقل، والعطلات**. • دعم **المعاملات متعددة العملات**. • تنفيذ **التعامل مع الأخطاء** في حالات **فشل الدفع أو تعليقه**. #### **الخطوة 4: الاختبار والنشر** • تنفيذ **اختبار شامل في بيئة Sandbox** قبل النشر. • النشر في **بيئة UAT (Staging)** والتحقق من جميع المعاملات. • بعد التأكيد، يتم **نشر التكامل في بيئة الإنتاج (Production)**. --- ### 3. الجدول الزمني المتوقع (بحد أقصى 5 أيام) • **إعداد API والمصادقة:** يوم واحد. • **تنفيذ تدفق الدفع:** يومان. • **التكامل عبر جميع الوحدات:** يوم واحد. • **الاختبار والنشر:** يوم واحد. • **إجمالي الوقت المطلوب:** **5 أيام عمل**. --- ### 4. الوصول إلى النظام للمستقل • سيتطلب المستقل **الوصول إلى الخلفية (Backend) لمنصة AsfarTrip (CodeIgniter)**. • سيتم استخدام **مستودع Bitbucket** لتتبع التطوير. • سيتم توفير **بيانات اعتماد Ziina API (بيئة Sandbox)**. • يجب تكوين **نقاط نهاية Webhook بشكل صحيح**. • يحتاج المستقل إلى التنسيق مع **مطور الشركة** للحصول على **وصول مؤقت عند الحاجة**. --- ### 5. اعتبارات إضافية • التأكد من **الامتثال لمعايير PCI DSS** وأفضل ممارسات الأمان. • تنفيذ **تسجيل ومراقبة المعاملات** لضمان تتبع المدفوعات. • في حال واجه المستقل **مشاكل في انتهاء صلاحية رموز OAuth2**، يجب تنفيذ **آلية تجديد الرموز**. • في حالة فشل Webhooks، يجب **إعادة المحاولة تلقائيًا** لمنع فقدان البيانات.