กรณีการใช้งานสําหรับหมายเลขอ้างอิง

ภาพรวม

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

Cash FOP ยังรองรับกรณีการใช้งานหมายเลขอ้างอิงด้วย ความแตกต่างที่สำคัญระหว่าง FOP ที่ใช้เทคโนโลยีโทเค็นและ FOP สำหรับเงินสดคือ FOP ที่ใช้เทคโนโลยีโทเค็นต้องมีการเชื่อมโยงและรองรับการคืนเงิน โดยรูปแบบการชำระเงินเงินสดไม่จำเป็นต้องมีการเชื่อมโยงและไม่รองรับการคืนเงิน เอกสารนี้จะอธิบายวิธีการทํางานของการผสานรวมสําหรับกรณีการใช้งานหมายเลขอ้างอิง

การผสานการทำงานในระดับสูงจะมีขั้นตอนดังต่อไปนี้

  1. ขั้นตอนการตรวจสอบสิทธิ์
  2. โฟลว์การเชื่อมโยง
  3. ขั้นตอนการซื้อ (เหมือนกับรูปแบบการชำระเงินสด)
  4. ขั้นตอนการคืนเงิน
  5. ขั้นตอนการส่งเงิน

ขั้นตอนการซื้อจะเหมือนกับขั้นตอนการซื้อแบบ Cash FOP

ตัวอย่างการผสานรวมที่ใช้การตรวจสอบสิทธิ์การเปลี่ยนเส้นทางเว็บ

ขั้นตอนการตรวจสอบสิทธิ์

API ที่ผู้ผสานรวมนำมาใช้: การตรวจสอบสิทธิ์ผ่านเว็บ

ขั้นตอนการเชื่อมโยง

API ที่ผู้ผสานรวมนำมาใช้: associateAccount ใน Payment Integrator Hosted Tokenized FOP API

ขั้นตอนการซื้อ

API ที่ใช้งานโดยผู้ผสานการทำงาน: generateReferenceNumber และ cancelReferenceNumber ใน Payment Integrator Hosted Tokenized FOP API

API ที่ Google ใช้งาน: referenceNumberPaidNotification ใน FOP API ที่ Google โฮสต์โดยใช้โทเค็น

ขั้นตอนการคืนเงิน

API ที่ผู้ผสานรวมนำมาใช้: refund ใน Payment Integrator Hosted Tokenized FOP API

ขั้นตอนการส่งเงิน

API ที่ใช้งานโดยผู้ผสานการทำงาน โปรดดู Payment Integrator Hosted Remittance API

API ที่ Google ใช้งาน: โปรดดู Google Hosted Remittance API

ขั้นตอนทั้งหมดทำงานร่วมกันอย่างไร

สร้างเครื่องมือ

ใน UI ของ Google ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าเว็บที่โฮสต์ของผู้ผสานการทำงานระบบเพื่อทำการตรวจสอบสิทธิ์ผ่านเว็บ หลังจากตรวจสอบสิทธิ์เรียบร้อยแล้ว ระบบจะเปลี่ยนเส้นทางผู้ใช้กลับไปที่ Google จากนั้น Google จะเรียก associateAccount requestId ใน authenticationResponse จะเป็น authenticationRequestId ของคำขอ associateAccount หลังจากเชื่อมโยงเรียบร้อยแล้ว Google จะจัดเก็บ googlePaymentToken(GPT) และข้อมูลเมตาอื่นๆ ไว้เป็นเครื่องมือสำหรับผู้ใช้

สร้างเครื่องมือ - ขั้นตอนการตรวจสอบสิทธิ์

ขั้นตอนการตรวจสอบสิทธิ์ผ่านเว็บ

สร้างเครื่องมือ - กระบวนการเชื่อมโยง

แผนภาพโฟลว์การเชื่อมโยง

สร้างหมายเลขอ้างอิง

เมื่อผู้ใช้ต้องการซื้อสินค้า/บริการด้วยเครื่องมือ Google จะเรียก generateReferenceNumber ด้วย GPT ระบบจะใช้ requestId ในส่วนหัวของคำขอ generateReferenceNumber เพื่อระบุธุรกรรมของ API ที่เกี่ยวข้อง

หมายเลขอ้างอิงการสร้างเงินสด

หมายเลขอ้างอิงการชำระเงิน

หลังจากที่ผู้ใช้ชำระเงินให้หมายเลขอ้างอิงแบบออฟไลน์แล้ว ผู้ผสานการทำงานจะเรียกใช้ referenceNumberPaidNotification requestId ในส่วนหัวของคำขอ generateReferenceNumber จะเป็นคำขอ generateReferenceNumberRequestId ของ referenceNumberPaidNotification

ขั้นตอนหมายเลขอ้างอิงการชำระเงิน

ยกเลิกธุรกรรม

หากผู้ใช้ตัดสินใจยกเลิกธุรกรรมก่อนชำระเงิน Google จะโทรหา cancelReferenceNumber requestId ในส่วนหัวของคำขอ generateReferenceNumber จะเป็น generateReferenceNumberRequestId ของคำขอ cancelReferenceNumber

คืนเงินสำหรับธุรกรรม

หลังจากชำระเงินให้หมายเลขอ้างอิงแล้ว หากผู้ใช้ต้องการขอเงินคืน Google จะโทรหาหมายเลข refund requestId ภายในส่วนหัวของคำขอ generateReferenceNumber จะเป็น transactionId ของคำขอคืนเงิน

ขั้นตอนการคืนเงิน

การโอนเงิน

ตามสัญญาแล้ว Google จะเรียกใช้ remittanceStatementNotification เพื่อแจ้งผู้รวมบริการเมื่อใบแจ้งยอดพร้อม จากนั้นผู้ผสานการทำงานจะเรียกใช้ Google Hosted Remittance API เพื่อทำการปรับยอด