API เติมเงินเว็บ

ผู้รวมต้องใช้งานโฮสต์เว็บเพื่อเปลี่ยนเส้นทางผู้ใช้เพื่อวัตถุประสงค์ในการเติมเงิน การเติมเงินนี้มีวิธีการแตกต่างกัน แต่มีจุดประสงค์เช่นเดียวกับการเติมเงินโดยการเติมเงินของ Android โฮสต์เว็บนี้ต้องมีเว็บไซต์ที่เหมาะกับอุปกรณ์เคลื่อนที่

โฮสต์เว็บต้องกำหนดคำขอเว็บบนอุปกรณ์เคลื่อนที่เทียบกับคำขอเว็บบนเดสก์ท็อปตามค่าส่วนหัว User Agent หน้าที่แสดงในคำขอเว็บบนอุปกรณ์เคลื่อนที่ต้องเหมาะกับอุปกรณ์เคลื่อนที่ทั้งบน Android และ iOS นอกจากค่าส่วนหัว User Agent แล้ว ไคลเอ็นต์จะไม่ให้คำแนะนำอื่นเกี่ยวกับสภาพแวดล้อมที่ผู้ใช้รายนี้ส่งคำขอ (เดสก์ท็อปหรือเว็บ)

เซิร์ฟเวอร์ต้องใช้โปรโตคอล HTTPS โดยใช้ GET ผู้ผสานการทำงานเป็นผู้กำหนดเส้นทางและโฮสต์ ผู้ผสานการทำงานต้องรองรับ URL ที่มีความยาว 2,048 อักขระ ซึ่งรวมถึงสคีม โฮสต์ พอร์ต เส้นทาง และพารามิเตอร์

พารามิเตอร์ทั้งหมดจะได้รับการเข้ารหัส UTF-8 ก่อนที่จะเข้ารหัส URL

ส่งคำขอ

เมื่อร้องขอ Google จะให้พารามิเตอร์ต่อไปนี้เป็นพารามิเตอร์ของ URL

ช่อง
gspMajorVersion	int หมายเลขเวอร์ชันหลักสำหรับคำขอนี้
gspTopUpRequest	TopUpRedirectRequest คำขอเติมเงิน
gspAssociationId	string มีตัวระบุที่ผู้ผสานการทำงานใช้เพื่อค้นหาข้อมูลเข้าสู่ระบบสำหรับบัญชีที่ผู้ใช้กำลังเติมเงิน นี่คือรหัสการเชื่อมโยงที่ส่งระหว่างการลิงก์บัญชีใน AssociateAccountRequest
gspCallbackUrl	string URL ที่จะเปลี่ยนเส้นทางผู้ใช้ไปเพื่อดำเนินการขั้นตอนการเติมเงินใน Google ให้เสร็จสิ้น ค่านี้มีการเข้ารหัส URL

คำตอบ

เมื่อการเติมเงินเสร็จสมบูรณ์แล้ว ต้องเปลี่ยนเส้นทางผู้ใช้ไปยัง gspCallbackUrl โดยใช้ HTTPS GET URL นี้ต้องมีพารามิเตอร์การค้นหาต่อไปนี้

ช่อง
gspResult	int 100 เติมเงินสำเร็จแล้ว 201 ผู้ใช้ยกเลิกการโฟลว์ด้วยตนเองและควรล้มเลิกกระบวนการดังกล่าว 202 การเติมเงินล้มเหลวด้วยเหตุผลที่ร้ายแรงและควรล้มเลิกการไหล
redirectRequestId	string ต้องระบุ: requestId ที่ส่งในคำขอการชำระเงินครั้งแรก/ที่เริ่มเปลี่ยนเส้นทาง Google จะยืนยันว่ารายการนี้ตรงกับ requestId ที่ส่ง และขั้นตอนการเปลี่ยนเส้นทางที่สมบูรณ์จะล้มเหลวหากไม่ตรงกัน
gspTopUpResponse	RedirectResponse ต้องระบุ: TopUpRedirectResponse ควรเข้ารหัสและลงนามด้วย PGP หรือ JWE+JWS นอกจากนี้ ค่านี้ควรมีการเข้ารหัส base64 แบบปลอดภัยสำหรับเว็บ