پرداخت های تغییر مسیر را می توان به دو روش مختلف آغاز کرد:
هنگامی که کاربر "Redirect Pay" را انتخاب می کند، به وب سایت ادغام کننده هدایت می شود تا فرم پرداخت (FOP) را برای استفاده انتخاب کند. در این صورت،
noFopChosen
در درخواست پر می شود. هنگامی که این اتفاق می افتد، یکپارچه ساز لیستی از صادرکنندگان موجود را به کاربر نمایش می دهد. هنگامی که کاربر یکی از این موارد را انتخاب کرد، کاربر برای تکمیل خرید به وبسایت/برنامه صادرکننده آن هدایت میشود.کاربر یک 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 شامل |
redirectRequest | RedirectRequest مورد نیاز : |