إكمال عملية إعادة التوجيه

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

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

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

إعادة توجيه الرد

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

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE&paymentIntegratorAccountId=InvisiRedirectPaymentUSA_USD&redirectResponse=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVTUE9OU0VfUEFZTE9BRF9FWEFNUExFX1RIQVRfSVNfRU5DT0RFRF9XSVRIX2Jhc2U2NF9VUkwtU0FGRV9FTkNPRElORw==

إنّ القيمة التي تم فك ترميزها لعنوان URL للمَعلمة redirectRequestId في هذا المثال هي cmVxdWVzdDE. القيمة التي تم فك ترميزها لعنوان URL للمَعلمة paymentIntegratorAccountId في هذا المثال هي InvisiRedirectPaymentUSA_USD.

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

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

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

الحقول
redirectRequestId	string مطلوب: مبلغ requestId المُرسل في طلب الدفع الأصلي/الذي يتم بدء إعادة التوجيه إليه. ستتحقّق Google من تطابق هذه العملية مع requestId المُرسلة، وسيتعذّر إتمام عملية إعادة التوجيه لإكمال العملية في حال عدم التطابق.
paymentIntegratorAccountId	string مطلوب: هذا هو معرّف حساب تكامل الدفعات الذي يحدّد القيود التعاقدية بشأن هذه المعاملة.
redirectResponse	RedirectResponse مطلوب: يجب تشفير RedirectResponse وتوقيعه باستخدام PGP أو JWE+JWS. بالإضافة إلى ذلك، يجب أن تكون هذه القيمة بترميز base64 آمن على الويب.