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

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

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

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

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

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

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

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

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