بررسی اجمالی
جریان کامل تغییر مسیر پس از تکمیل جریان شروع تغییر مسیر و کاربر پرداختی را در رابط وب صادرکننده انجام می‌دهد. هدف از جریان تغییر مسیر کامل این است که:
- به Google و یکپارچه‌ساز پرداخت اطلاع دهید که پرداخت با موفقیت انجام شد.
- کاربر را از طریق یکپارچه ساز به Google هدایت کنید.
جریان چگونه کار می کند
سه راه مختلف برای ادغام کننده وجود دارد تا اطلاعات پرداخت تکمیل شده را به Google منتقل کند.
- یکپارچه‌کننده کاربر را به Google هدایت می‌کند و اطلاعات پرداخت را به پاسخ تغییر مسیر اضافه می‌کند.
- یکپارچه‌کننده پس از تکمیل پرداخت ، درخواست HTTPS را به نقطه پایانی RedirectPaymentCompleteNotification Google ارسال می‌کند.
- Google یک درخواست HTTPS را به نقطه پایانی GetRedirectPaymentStatus ادغام‌کننده ارسال می‌کند و ادغام‌کننده با جزئیات پرداخت پاسخ می‌دهد.
جریان تغییر مسیر را کامل کنید
نمودار توالی زیر تعامل بین مرورگر کاربر، گوگل، ادغام کننده و صادرکننده را نشان می دهد:
در اینجا لیستی از اشیاء در نمودار بالا آمده است:
- کاربر : این شخصی است که پرداخت را انجام داده است.
- Google UI : رابط وب یا برنامه Google، جایی که مشتری پرداخت را آغاز کرده است.
- Google Server : سرور پشتیبان در Google که جزئیات پرداخت تکمیل شده را دریافت می کند و کالاها یا خدمات خریداری شده را در اختیار کاربر قرار می دهد.
- Payment Integrator : یکپارچه‌ساز پرداخت که به عنوان واسطه بین Google و صادرکننده عمل می‌کند.
- صادرکننده : صادرکننده ای که کاربر در آن پرداخت را انجام داده است.
ما فرض می‌کنیم که کاربر به‌تازگی پرداخت را در وب‌سایت صادرکننده به پایان رسانده است، که جریان تغییر مسیر کامل را آغاز می‌کند.
- کاربر پرداخت را در درگاه صادرکننده تکمیل می کند.
- صادرکننده یک URL تغییر مسیر با اطلاعات مربوط به پرداخت تکمیل شده به ادغام کننده اشاره می کند.
- صادرکننده کاربر را به سرور پشتیبان یکپارچه ساز پرداخت هدایت می کند.
- یکپارچه‌ساز پرداخت با استفاده از اطلاعات تغییر مسیر صادرکننده، یک پاسخ تغییر مسیر ایجاد می‌کند.
- یکپارچه‌ساز پرداخت، کاربر را به Google هدایت می‌کند.
- یکپارچه‌ساز پرداخت، RedirectPaymentCompleteNotification را به Google ارسال می‌کند. این در صورتی استفاده می شود که تغییر مسیر پس از تکمیل پرداخت توسط کاربر انجام نشود.
- اگر Google پاسخ ریدایرکت یا RedirectPaymentCompleteNotification دریافت نکرد، Google یک تماس GetRedirectPaymentStatus به یکپارچه‌ساز پرداخت ارسال می‌کند که باید با اطلاعات وضعیت پرداخت پاسخ دهد.
- Google اطلاعات پرداخت را پردازش می کند که کالاها یا خدمات خریداری شده را در اختیار کاربر قرار می دهد.
اطلاعیه کامل پرداخت تغییر مسیر
همانطور که در نمودار بالا نشان داده شده است، وقتی ادغام کننده تشخیص داد که پرداخت تغییر مسیر پذیرفته یا رد شده است، Google از یکپارچه‌سازها می‌خواهد که RedirectPaymentCompleteNotification را به Google ارسال کنند. این اعلان را می توان قبل یا بعد از هدایت مجدد کاربر به Google برای Google ارسال کرد.
اگر یک ادغام‌کننده از تکمیل (پذیرفته یا رد) پرداخت تغییر مسیر حتی چند روز پس از شروع تغییر مسیر مطلع شود، ادغام‌کننده همچنان باید RedirectPaymentCompleteNotification را به Google ارسال کند. این اعلان‌ها به به‌روزرسانی وضعیت نهایی پرداخت کمک می‌کنند و برای انجام صحیح تطبیق لازم هستند.
بهترین شیوه ها و ملاحظات دیگر
اقدامات ایمنی
URL پاسخ تغییر مسیر شامل یک قسمت redirectRequestId رمزگذاری نشده و یک شی RedirectResponse رمزگذاری شده با همان مقدار خواهد بود. Google تأیید می کند که هر دوی این مقادیر با فیلد requestId ارسال شده در درخواست تغییر مسیر مطابقت دارند.