بدء مسار إعادة التوجيه

يمكن بدء إعادة توجيه الدفعات بطريقتين مختلفتين:

1. عندما يختار المستخدم "إعادة توجيه الدفعة"، ستتم إعادة توجيهه إلى الموقع الإلكتروني للشركة المتكاملة لاختيار طريقة الدفع (FOP) المطلوب استخدامها. في هذه الحالة، ستتم تعبئة noFopChosen في الطلب. عند حدوث ذلك، ستعرض الشركة المتعهّدة للمستخدم قائمة بجهات الإصدار المتاحة. بمجرد أن يختار المستخدم أحد ذلك، ستتم إعادة توجيه المستخدم إلى موقع/تطبيق جهة الإصدار لإكمال عملية الشراء.

2. سيختار المستخدم وسيلة الدفع (FOP) أثناء مسار الشراء. في هذه الحالة، ستعمل Google على تعبئة المَعلمة issuerId في الطلب وإعادة توجيه المستخدم إلى مسؤول عملية الدمج. عندما تتلقّى جهة الدمج هذه المعلومات، يجب أن تعيد توجيه المستخدم على الفور إلى الموقع الإلكتروني أو التطبيق الخاص بالجهة المُصدِرة لإتمام عملية الشراء.

ملاحظة: يمكن أن تكون الشركة المسؤولة عن عملية تكامل الدفعات وجهة الإصدار هما الكيان نفسه.

وفي كلتا الحالتين أعلاه، ستعيد Google توجيه المستخدم مباشرةً إلى الموقع الإلكتروني الخاص بالجهة المسؤولة عن عملية الدمج بدون أي اتصال سابق من خادم إلى خادم من Google.

يجب أن تنفّذ الشركة التكاملية بروتوكول HTTPS باستخدام GET. وستحتوي معلَمات GET، الموضحة في معلَمات طلبات إعادة التوجيه، على معلومات حول الدفعة المطلوبة لإعادة التوجيه.

يجب أن تتيح وحدة الدمج طول عناوين URL التي تبلغ 2,048 حرفًا. يتضمن ذلك المخطط والمضيف والمنفذ والمسار والمعلمات. سيتم ترميز كل المعلمات بترميز UTF-8 قبل ترميزها في عنوان URL.

إعادة توجيه الطلب

في ما يلي مثال على عنوان URL الذي ستتم إعادة توجيه المستخدم إليه كجزء من مسار "بدء إعادة التوجيه" (المعروف أيضًا باسم طلب إعادة التوجيه):

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

في ما يلي القيمة التي تم فك ترميزها لعنوان URL للمَعلمة callbackUrl في هذا المثال:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

يتم تشفير المعلَمة redirectRequest وتوقيعها باستخدام PGP أو JWE+JWS قبل ترميزها باستخدام base64url.

معلَمات طلبات إعادة التوجيه

يجب أن يحتوي طلب HTTPS GET على معلَمات طلب البحث التالية:

الحقول
callbackUrl	string عنوان URL لإعادة توجيه المستخدم إليه عند إتمام عملية الدفع. هذه القيمة مرمّزة في عنوان URL والحدّ الأقصى لطولها هو 512 حرفًا. سيتضمّن عنوان URL هذا requestId من قيمة redirectRequest المشفّرة في معلَمة GET redirectRequestId. على المورّد التحقق من تطابق البيانات بين redirectRequestId الواردة في callbackUrl وrequestId من الحمولة المشفّرة للتأكّد من أنّهما مرتبطان.
redirectRequest	RedirectRequest مطلوب: يجب تشفير RedirectRequest وتوقيعه باستخدام PGP أو JWE+JWS. بالإضافة إلى ذلك، يجب أن تكون هذه القيمة بترميز base64 آمن على الويب.