ขั้นตอนการผสานรวมของผู้ออกบัตรสำหรับตั๋ว Motics ใน Google Wallet

เอกสารนี้จะกล่าวถึงขั้นตอนที่ผู้ให้บริการขนส่งมวลชน (PTO) และผู้รวบรวมระบบของพวกเขา ซึ่งหลังจากนี้จะเรียกว่าผู้ให้บริการ ซึ่งต้องดำเนินการเพื่อติดตั้งใช้งาน Motics ใน Google Wallet

1. ข้อกำหนดเบื้องต้นให้เสร็จสมบูรณ์

  • ลงนามในข้อตกลงไม่เปิดเผยความลับ (NDA) กับ Google แบบฟอร์มคลิกเพื่อยอมรับออนไลน์นี้มีการแชร์โดยทีมพัฒนาธุรกิจของ Google (BD)
  • ผสานรวมกับ Google Wallet API มาตรฐานสำหรับคิวอาร์โค้ด
    • ผู้ออกบัตรใช้ Google Wallet API เพื่อจัดสรรบัตรและเพิ่มบัตรลงในแอป Google Wallet ของผู้ใช้ อ่านเอกสารคิวอาร์โค้ดสำหรับขนส่งสาธารณะ และดำเนินการตามข้อกำหนดเบื้องต้นที่จำเป็นในการผสานรวมกับ API
  • ลงทะเบียนกับบริการ VDV eTicket เพื่อรับ ownerId (orgId) และรายละเอียด PKI ที่เกี่ยวข้องซึ่งจำเป็นสำหรับ Motics

2. การใช้งานทางเทคนิค

ขั้นตอนที่ 2 มีรายละเอียดการติดตั้งใช้งานทางเทคนิคหลัก ซึ่งควรพัฒนาไปพร้อมๆ กัน

อัปเกรดการใช้งาน Google Wallet API

หน้ารายละเอียดทางเทคนิคจะแสดงเมธอดและพารามิเตอร์ที่ผู้ออกบัตรจำเป็นต้องใช้และอัปเดตสำหรับการผสานรวม Motics กล่าวอย่างเจาะจงคือ ผู้ออกบัตรจำเป็นต้องเรียกใช้เมธอด Google Wallet API ต่อไปนี้ด้วยพารามิเตอร์เพิ่มเติมที่เกี่ยวข้องกับ Motics

ใช้ปลายทางการเปิดใช้งาน

เซิร์ฟเวอร์ Google จะเรียกปลายทางการเปิดใช้งานที่ผู้ออกบัตรเป็นผู้โฮสต์ ซึ่งจะทริกเกอร์การสร้างข้อมูลการให้สิทธิ์แบบคงที่ (sigSTB) บนเซิร์ฟเวอร์ของผู้ออกบัตร โปรดดูรายละเอียดในส่วนปลายทางการเปิดใช้งาน

เพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดี ผู้ใช้ควรย้ายตั๋ว Motics จากอุปกรณ์หนึ่งไปอีกเครื่องหนึ่งได้โดยที่ผู้ออกบัตรกำหนดข้อจำกัดไว้ โดยผู้ออกบัตรต้องใช้ขั้นตอนการย้ายและยกเลิกการลิงก์

ส่งอีเมลยืนยันในการบันทึกตั๋ว

Google กำหนดให้ผู้ออกบัตรส่งอีเมลยืนยันไปยังผู้ใช้เมื่อผู้ใช้บันทึกตั๋ว Motics ไปยัง Google Wallet อีเมลยืนยันควรมีข้อมูลต่อไปนี้ (เป็นอย่างน้อย)

  • ลิงก์ที่มีประโยชน์สำหรับให้ผู้ใช้จัดการตั๋ว (การสมัครใช้บริการ)
  • วิธีติดต่อฝ่ายสนับสนุนลูกค้าของผู้ออกบัตร

3. ทำการทดสอบการผสานรวมแบบต้นทางถึงปลายทางใน STAGING

สร้างการทดสอบ Google Wallet transitClass สำหรับใช้ในการพัฒนา และเมื่อการผสานรวมเสร็จสมบูรณ์แล้ว จะต้องมีการตรวจสอบและทดสอบโซลูชันตั้งแต่ต้นจนจบโดยใช้การพัฒนานี้ transitClass ใน transitObject:Insert ให้ตั้งค่า cert_environment เป็น STAGING กรณีการใช้งานทั้งหมดควรได้รับการทดสอบอย่างสมบูรณ์และกรอบการทดสอบทั้งหมดต้องให้ผลลัพธ์ที่ประสบความสำเร็จ

4. ทำการทดสอบจากต้นทางถึงปลายทางใน PRODUCTION

เมื่อทดสอบโซลูชันโดยใช้สภาพแวดล้อม STAGING สำเร็จแล้ว ให้สร้าง transitClass เวอร์ชันที่ใช้งานจริงใหม่ ครั้งนี้ตั้งค่า cert_environment เป็น PRODUCTIONเมื่อแทรก transitObject ทำตามกรอบการทดสอบและวิธีการทั้งหมดให้เสร็จในส่วนการทดสอบ

5. ทำตามกระบวนการเปิดตัวและรับการอนุมัติ

ก่อนเปิดตัวหรือเริ่มโปรแกรมนำร่องสาธารณะ การอนุมัติการเปิดตัวโดยสมบูรณ์ต้องได้รับอนุญาตจาก Google การอนุมัติจะขึ้นอยู่กับผลลัพธ์ของระยะการทดสอบต่างๆ รวมทั้งปัจจัยอื่นๆ เช่น (แต่ไม่จำกัดเพียง) สิ่งต่อไปนี้ที่ต้องได้รับการตรวจสอบและอนุมัติจาก Google

  • ขอบเขตการเปิดตัวและแผนโดยรวม
    • ในกรณีของการนำร่อง แผนการเปิดตัวต้องมีเกณฑ์การออกและลำดับเวลาที่ชัดเจนเพื่อการเปิดตัวเต็มรูปแบบ
  • กิจกรรมการตลาดที่วางแผนไว้
  • เปิดการสื่อสาร
  • วันที่เผยแพร่
  • ลำดับเวลาของวันเปิดตัวและกระบวนการส่งต่อและการติดต่อ
  • กระบวนการสนับสนุนผู้ใช้ปลายทาง