Method: asynchronousCapture

• คำขอ HTTP
• เนื้อหาคำขอ
  • การแสดง JSON
• เนื้อหาการตอบกลับ
  • การแสดง JSON
• UpiDetails
  • การแสดง JSON
• TokenizedInstrumentDetails
  • การแสดง JSON
• AsynchronousCaptureResultCode

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

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

หากปลายทางพบข้อผิดพลาดขณะประมวลผลคำขอ เนื้อหาการตอบกลับจากปลายทางนี้ควรเป็นประเภท ErrorResponse

ตัวอย่างคำขอมีลักษณะดังนี้

{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
    "requestTimestamp": "1502220196077"
  },
  "paymentIntegratorAccountId": "InvisiCashIN_INR",
  "upiDetails": {
      "vpa": "foo@icici"
  },
  "transactionDescription": "Google - Music",
  "currencyCode": "INR",
  "amount": "728000000"
}

ตัวอย่างคำตอบจะมีลักษณะดังนี้

{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "result": "ACKNOWLEDGED",
  "paymentIntegratorTransactionId": "aW50ZWdyYXRvciB0cmFuc2FjdGlvbiBpZA"
}

คำขอ HTTP

POST https://www.integratorhost.example.com/v1/asynchronousCapture

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{ "requestHeader": { object (RequestHeader) }, "paymentIntegratorAccountId": string, "transactionDescription": string, "currencyCode": string, "amount": string, // Union field fopDetails can be only one of the following: "upiDetails": { object (UpiDetails) }, "tokenizedInstrumentDetails": { object (TokenizedInstrumentDetails) } // End of list of possible types for union field fopDetails. }

ช่อง
requestHeader	object (RequestHeader) ต้องระบุ: ส่วนหัวทั่วไปสำหรับคำขอทั้งหมด
paymentIntegratorAccountId	string ต้องระบุ: ตัวระบุบัญชีผู้รวมการชำระเงินที่ระบุข้อจำกัดทางสัญญาเกี่ยวกับธุรกรรมนี้
transactionDescription	string ต้องระบุ: นี่คือคำอธิบายธุรกรรมที่ใส่ไว้ในใบแจ้งยอดของลูกค้าได้ แปลเป็น userLocale ที่พบใน requestHeader รูปแบบนี้สามารถเปลี่ยนแปลงได้โดยไม่มีการแจ้งให้ทราบ และต้องไม่ได้รับการแยกวิเคราะห์
currencyCode	string ต้องระบุ: รหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217
amount	string (Int64Value format) ต้องระบุ: จำนวนเงินที่ซื้อในหน่วยไมโครของหน่วยสกุลเงิน
ช่องการรวม fopDetails fopDetails ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
upiDetails	object (UpiDetails) ไม่บังคับ: รายละเอียดการชำระเงินสำหรับเครื่องมือของ UPI โดยเฉพาะ
tokenizedInstrumentDetails	object (TokenizedInstrumentDetails) ไม่บังคับ: รายละเอียดการชำระเงินสำหรับเครื่องมือที่แปลงข้อมูลเป็นโทเค็นโดยเฉพาะ

เนื้อหาการตอบกลับ

ออบเจ็กต์การตอบสนองสำหรับวิธีการจับภาพ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{ "responseHeader": { object (ResponseHeader) }, "paymentIntegratorTransactionId": string, "result": enum (AsynchronousCaptureResultCode) }

ช่อง
responseHeader	object (ResponseHeader) ต้องระบุ: ส่วนหัวทั่วไปของคำตอบทั้งหมด
paymentIntegratorTransactionId	string ต้องระบุ: ตัวระบุนี้ใช้สำหรับผู้รวมระบบโดยเฉพาะและสร้างขึ้นโดยผู้ผสานรวมระบบ ข้อมูลนี้เป็นตัวระบุที่ผู้รวมระบบรู้จักธุรกรรมนี้ ตัวระบุนี้จะรวมอยู่ในรายละเอียดการส่งเงินเพื่อความสะดวก
result	enum (AsynchronousCaptureResultCode) ต้องระบุ: ผลของการเรียกใช้การจับภาพแบบไม่พร้อมกัน

UpiDetails

รายละเอียดเกี่ยวกับบัญชี UPI ที่จะดึงข้อมูล

การแสดง JSON
{ "vpa": string }

ช่อง
vpa	string ต้องระบุ: ที่อยู่การชำระเงินเสมือน (VPA) ของผู้ใช้ที่ใช้สำหรับการโอนเงินโดยใช้โปรโตคอล UPI เช่น foo@icici

TokenizedInstrumentDetails

รายละเอียดเกี่ยวกับบัญชีที่จะดึงข้อมูล

การแสดง JSON
{ "googlePaymentToken": string }

ช่อง
googlePaymentToken	string ต้องระบุ: นี่คือโทเค็นที่ทั้ง 2 บริษัทจะใช้เพื่อระบุบัญชีสำหรับการซื้อระหว่างกัน

AsynchronousCaptureResultCode

รหัสผลลัพธ์สำหรับ asynchronousCapture

Enum
UNKNOWN_RESULT	โปรดอย่าตั้งค่าเริ่มต้นนี้
ACKNOWLEDGED	มีการส่งคำขอเพื่อรวบรวมข้อมูลแล้วและผู้ผสานรวมจะทำขั้นตอนเพิ่มเติมเพื่อระบุว่าการบันทึกสำเร็จหรือถูกปฏิเสธ เมื่อผู้ผสานรวมระบบทราบผลลัพธ์ของการบันทึกแล้ว ก็จะแจ้ง Google ถึงผลลัพธ์ด้วยการเรียกใช้ captureResultNotification API
ACCOUNT_CLOSED	ปิดบัญชีของผู้ใช้ที่ไว้กับผู้ผสานรวมระบบแล้ว การแสดงค่านี้จะทำให้เครื่องมือของผู้ใช้ปิดด้วย Google ระบบจะบังคับให้ผู้ใช้เพิ่มเครื่องมือใหม่โดยทำตามขั้นตอนการเชื่อมโยงอีกครั้ง
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER	มีการปิดบัญชีผู้ใช้ที่มีผู้รวมระบบแล้ว บัญชีที่ต้องสงสัยจะเข้าควบคุม การแสดงค่านี้จะทำให้เครื่องมือของผู้ใช้ปิดด้วย Google ระบบจะบังคับให้ผู้ใช้เพิ่มเครื่องมือใหม่โดยทำตามขั้นตอนการเชื่อมโยงอีกครั้ง
ACCOUNT_ON_HOLD	บัญชีถูกระงับ
ACCOUNT_CLOSED_FRAUD	บัญชีของผู้ใช้ที่ไว้กับผู้รวมระบบถูกปิดเนื่องจากการประพฤติมิชอบ การแสดงค่านี้จะทำให้เครื่องมือของผู้ใช้ปิดด้วย Google ระบบจะบังคับให้ผู้ใช้เพิ่มเครื่องมือใหม่โดยทำตามขั้นตอนการเชื่อมโยงอีกครั้ง