جریان تغییر مسیر را شروع کنید

پرداخت های تغییر مسیر را می توان به دو روش مختلف آغاز کرد:

1. هنگامی که کاربر "Redirect Pay" را انتخاب می کند، به وب سایت ادغام کننده هدایت می شود تا فرم پرداخت (FOP) را برای استفاده انتخاب کند. در این صورت، noFopChosen در درخواست پر می شود. هنگامی که این اتفاق می افتد، یکپارچه ساز لیستی از صادرکنندگان موجود را به کاربر نمایش می دهد. هنگامی که کاربر یکی از این موارد را انتخاب کرد، کاربر برای تکمیل خرید به وب‌سایت/برنامه صادرکننده آن هدایت می‌شود.

2. کاربر یک FOP (صاحب کننده) را در جریان خرید انتخاب می کند. در این صورت، گوگل پارامتر issuerId را در درخواست پر می کند و کاربر را به یکپارچه هدایت می کند. وقتی یکپارچه‌کننده این را دریافت کرد، باید فوراً کاربر را به وب‌سایت/برنامه صادرکننده هدایت کند تا خرید را تکمیل کند.

توجه: یکپارچه کننده پرداخت و صادرکننده می توانند یک نهاد باشند.

در هر دو مورد فوق، گوگل کاربر را مستقیماً به وب‌سایت یکپارچه‌ساز هدایت می‌کند، بدون اینکه قبلاً تماس سرور به سرور از طرف Google انجام شود.

یکپارچه ساز باید یک پروتکل HTTPS را با استفاده از GET پیاده سازی کند. پارامترهای GET که در پارامترهای درخواست تغییر مسیر مشخص شده است، حاوی اطلاعاتی در مورد پرداخت تغییر مسیر درخواستی است.

ادغام کننده باید از طول URL 2048 کاراکتر پشتیبانی کند. این شامل طرح، میزبان، پورت، مسیر و پارامترها است. همه پارامترها قبل از کدگذاری URL با UTF-8 کدگذاری خواهند شد.

درخواست تغییر مسیر

در اینجا نمونه ای از URL است که کاربر به عنوان بخشی از جریان شروع تغییر مسیر (که به عنوان درخواست تغییر مسیر نیز شناخته می شود) به آن هدایت می شود:

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

مقدار رمزگشایی شده پارامتر callbackUrl در این مثال به صورت زیر است:

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

پارامتر redirectRequest قبل از کدگذاری base64url با استفاده از PGP یا JWE+JWS رمزگذاری و امضا می شود.

تغییر مسیر پارامترهای درخواست

درخواست HTTPS GET باید پارامترهای پرس و جو زیر را داشته باشد:

زمینه های
callbackUrl	string URL برای هدایت کاربر به آن هنگام تکمیل پرداخت. این مقدار دارای URL رمزگذاری شده است و حداکثر طول آن 512 کاراکتر است. این URL شامل requestId از redirectRequest رمزگذاری شده در پارامتر redirectRequestId GET می شود. فروشنده باید تأیید کند که redirectRequestId از callbackUrl و requestId از payload رمزگذاری شده یکسان هستند تا تأیید کند که هر دو مرتبط هستند.
redirectRequest	RedirectRequest مورد نیاز : RedirectRequest باید با استفاده از PGP یا JWE+JWS رمزگذاری و امضا شود. علاوه بر این، این مقدار باید به صورت web-safe base64 کدگذاری شود.