نظرة عامة
يبدأ مسار عملية إعادة التوجيه الكاملة بعد اكتمال عملية بدء إعادة التوجيه ويجري المستخدم عملية الدفع في واجهة الويب الخاصة بجهة الإصدار. الغرض من عملية إعادة التوجيه المكتملة هو:
- أبلِغ Google والجهة المسؤولة عن دمج الدفعات بأنّ عملية الدفع تمّت بنجاح.
- أعِد توجيه المستخدم مجددًا إلى Google من خلال مسؤول عملية الدمج.
آلية عمل التدفق
يمكن أن ترسل شركة الدمج معلومات الدفع المكتملة إلى Google بثلاث طرق مختلفة.
- تعيد الشركة إتمام عملية الدمج توجيه المستخدم إلى Google وتضيف معلومات الدفع إلى الردّ على إعادة التوجيه.
- بعد إكمال عملية الدمج، ترسل الشركة طلب بروتوكول HTTPS إلى نقطة النهاية RedirectPaymentCompleteNotification من Google.
- ترسل Google طلب بروتوكول HTTPS إلى نقطة نهاية GetRedirectPaymentStatus في عملية الدمج، وتردّ الشركة على تفاصيل الدفع.
إكمال عملية إعادة التوجيه
يوضّح مخطّط التسلسل التالي التفاعل بين متصفّح المستخدم وGoogle وجهة عملية الدمج وجهة الإصدار:
فيما يلي قائمة الكائنات في الرسم التخطيطي أعلاه:
- المستخدم: هو الشخص الذي أكمل عملية دفع.
- واجهة مستخدم Google: واجهة الويب أو التطبيق من Google التي بدأ العميل إجراء الدفع من خلالها.
- خادم Google: الخادم الخلفي في Google الذي يحصل على تفاصيل الدفع المكتملة، ويوفر السلع أو الخدمات المشتراة للمستخدم.
- الجهة المتعهّدة للدفع: الشركة المتعهّدة للدفعات التي تعمل كوسيط بين Google وجهة الإصدار.
- جهة الإصدار: جهة الإصدار التي أجرى المستخدم عملية الدفع عليها.
ونفترض أنّ المستخدم قد أتمّ للتو إجراء عملية دفع على الموقع الإلكتروني الخاص بجهة الإصدار، ما يؤدي إلى بدء مسار عملية إعادة التوجيه الكاملة.
- يُكمل المستخدم عملية الدفع في بوابة جهة الإصدار.
- تنشئ جهة الإصدار عنوان URL لإعادة التوجيه يشير إلى جهة الدمج مع معلومات حول الدفعة المكتملة.
- تُعيد جهة الإصدار توجيه المستخدم إلى الخادم الخلفية لشركة تكامل الدفع.
- تنشئ الشركة المختصة بدمج الدفعات ردًّا على عملية إعادة التوجيه باستخدام معلومات من عملية إعادة التوجيه التي تستخدمها جهة الإصدار.
- تعمل الشركة المسؤولة عن دمج الدفعات على إعادة توجيه المستخدم إلى Google.
- ترسِل الشركة المسؤولة عن عملية تكامل عمليات الدفع RedirectPaymentCompleteNotification إلى Google. وتُستخدم هذه العملية في حال تعذُّر إعادة التوجيه بعد إكمال المستخدم لعملية الدفع.
- إذا لم تتلقَّ Google ردًّا على إعادة التوجيه أو RedirectPaymentCompleteNotification، سترسل Google مكالمة GetRedirectPaymentStatus إلى الجهة المعنيّة بدمج الدفعات، من المفترض أن الردّ يتضمّن معلومات حالة الدفع.
- تعالج Google معلومات الدفع لتقديم السلع أو الخدمات التي تم شراؤها إلى المستخدم.
إعادة توجيه إشعار إكمال الدفع
كما هو موضّح في الرسم البياني أعلاه، تطلب Google من الشركات المتعهّدة إرسال RedirectPaymentCompleteNotification إلى Google عندما تقرر الشركة المتعهّدة أنّها قد تم قبولها أو رفضها. ويمكن إرسال هذا الإشعار إلى Google قبل أو بعد إعادة توجيه المستخدم إلى Google.
إذا اكتشفت شركة الدمج إتمام عملية إعادة التوجيه (مقبولة أو مرفوضة) بعد عدة أيام من حدوث إعادة التوجيه أولاً، على الشركة التي تُجري عملية الدمج إرسال RedirectPaymentCompleteNotification إلى Google. تساعد هذه الإشعارات في تعديل الحالة النهائية للدفعة وهي مطلوبة لمعالجة التسوية بشكل صحيح.
أفضل الممارسات والاعتبارات الأخرى
تدابير السلامة
سيتضمن عنوان URL لاستجابة إعادة التوجيه حقل redirectRequestId غير مشفّر وكائن RedirectResponse مشفّر بالقيمة نفسها. سيتحقّق محرّك بحث Google من تطابق هاتَين القيمتَين مع حقل requestId الذي تم إرساله في طلب إعادة التوجيه.