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

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

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

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

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

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