تطوير بوابة دفع لربط نقاط شركة الاتصالات مع متجر ووكومرس عبر واجهة STC Loyalty API لمتجر مكيفات

نرغب في تطوير إضافة (Payment Gateway) مخصصة لمتجرنا المبني على ووكومرس، تُمكّن العملاء من الدفع باستخدام نقاط قطاف عبر خدمة الاستبدال (Redemption) فقط.

نطاق العمل:

إنشاء بوابة دفع ووكومرس باسم "الدفع بنقاط قطاف".

واجهة إدخال:

- رقم الجوال (MSISDN)

- زر "إرسال رمز قطاف (OTP)"

- حقل إدخال رمز التحقق (OTP)

- حقل المبلغ المراد استبداله (ريال سعودي – أرقام صحيحة فقط)

- ربط البوابة مع طبقة وسيطة (Backend) تتصل بـ STC Loyalty REST API عبر mTLS باستخدام الشهادات والاعتمادات الرسمية.

- تنفيذ التدفق التالي:

- طلب OTP عبر POST /redemption/otp.

- تنفيذ الاستبدال عبر POST /redemption/redeem.

- في حالة الفشل أو انتهاء المهلة (60 ثانية) تنفيذ PUT /redemption/reverse.

- التعامل مع رسائل الأخطاء والأكواد الموثقة (مثل OTP غير صحيح، رصيد غير كافٍ، حد شهري...).

- تسجيل (Logs) العمليات والربط مع معرف الطلب في ووكومرس عبر GlobalId.

المخرجات:

كود نظيف وقابل للتوسعة لإضافة ووكومرس.

API وسيط آمن مع دعم mTLS.

دليل إعداد/تشغيل مفصل.

اختبارات تكامل ناجحة (OTP → Redeem → Reverse).

الربط مع الموقع الفعلي والتشغيل

المهارات المطلوبة:

خبرة في تطوير إضافات ووكومرس (WooCommerce Payment Gateways).

إتقان PHP + WordPress.

خبرة في REST APIs و mTLS.

خبرة سابقة في بوابات الدفع أو أنظمة الولاء (ميزة إضافية).

مرفق وثائق الوصف من مزود الخدمة