เริ่มขั้นตอนการเปลี่ยนเส้นทาง

การชำระเงินเปลี่ยนเส้นทางสามารถเริ่มต้นได้ 2 วิธี ดังนี้

1. เมื่อผู้ใช้เลือก "เปลี่ยนเส้นทางการชำระเงิน" ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังเว็บไซต์ของผู้รวมบริการเพื่อให้เลือกรูปแบบการชำระเงิน (FOP) ที่จะใช้ ในกรณีนี้ ระบบจะป้อนข้อมูล noFopChosen ในคำขอ ในกรณีนี้ ผู้ผสานการทำงานระบบจะแสดงรายชื่อผู้ออกบัตรที่พร้อมให้บริการแก่ผู้ใช้ เมื่อผู้ใช้เลือกหนึ่งในรายการเหล่านี้แล้ว ระบบจะส่งต่อผู้ใช้รายนั้นไปยังเว็บไซต์/แอปของผู้ออกบัตรเพื่อทำการซื้อให้เสร็จสมบูรณ์

2. ผู้ใช้จะเลือกรูปแบบการชำระเงิน (ผู้ออกบัตร) ในระหว่างขั้นตอนการซื้อ ในกรณีนี้ Google จะป้อนข้อมูลพารามิเตอร์ issuerId ในคำขอและเปลี่ยนเส้นทางผู้ใช้ไปยังผู้ผสานการทำงาน เมื่อผู้ผสานการทำงานได้รับข้อมูลนี้ ควรจะเปลี่ยนเส้นทางผู้ใช้ไปยังเว็บไซต์/แอปของผู้ออกบัตรโดยทันทีเพื่อทำการซื้อให้เสร็จสมบูรณ์

หมายเหตุ: ผู้รวมการชำระเงินและผู้ออกบัตรอาจเป็นบุคคลเดียวกัน

ในทั้ง 2 กรณีข้างต้น 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

ค่าที่ถอดรหัส URL ของพารามิเตอร์ callbackUrl ในตัวอย่างนี้คือ

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 จากเพย์โหลดที่เข้ารหัสเหมือนกันหรือไม่เพื่อยืนยันว่าทั้ง 2 รายการเกี่ยวข้องกัน
redirectRequest	RedirectRequest ต้องระบุ: RedirectRequest ควรเข้ารหัสและลงนามด้วย PGP หรือ JWE+JWS นอกจากนี้ ค่านี้ควรเข้ารหัสแบบ base64 ที่ปลอดภัยบนเว็บ