เครื่องมือการชำระเงินของ Google Pay

ข้อมูลอ้างอิงนี้อิงตามสคีมาเครื่องมือการชำระเงินด้วยบัตร สำหรับออบเจ็กต์เครื่องมือการชำระเงินที่ตัวแฮนเดิลการชำระเงินของ Google Pay แสดงผลเมื่อ การชำระเงินเสร็จสมบูรณ์ภายในอาร์เรย์ payment.instruments

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	Always present?	คำอธิบาย
id	สตริง	ใช่	ตัวระบุที่ไม่ซ้ำกันสำหรับอินสแตนซ์ของเครื่องมือการชำระเงินนี้ ซึ่งแพลตฟอร์มเป็นผู้กำหนด
handler_id	สตริง	ใช่	ตัวระบุที่ไม่ซ้ำกันสำหรับอินสแตนซ์ตัวแฮนเดิลที่สร้างเครื่องมือนี้ ตรงกับฟิลด์ id ในการกำหนดค่าตัวแฮนเดิลการชำระเงิน
type	สตริง	ใช่	ประเภทของเครื่องมือการชำระเงิน เช่น card
selected	บูลีน	ไม่	ระบุว่าผู้ใช้เลือกเครื่องมือนี้หรือไม่
display	ออบเจ็กต์	ใช่	แสดงข้อมูลสำหรับเครื่องมือการชำระเงิน
display.brand	สตริง	ใช่	แบรนด์/เครือข่ายบัตร (เช่น "VISA")
display.last_digits	สตริง	ใช่	หมายเลขบัตรเครดิต 4 หลักสุดท้าย
display.description	สตริง	ไม่	คำอธิบายของการ์ดที่แสดงต่อผู้ใช้
display.card_art	สตริง	ไม่	URI ไปยังรูปภาพที่แสดงการ์ด
billing_address	ออบเจ็กต์	ไม่	ที่อยู่สำหรับการเรียกเก็บเงินที่เชื่อมโยงกับบัตร จะแสดงก็ต่อเมื่อตั้งค่า billing_address_required เป็น true ในการกำหนดค่า
billing_address.first_name	สตริง	ไม่	ชื่อจริงของผู้ติดต่อที่เชื่อมโยงกับที่อยู่
billing_address.last_name	สตริง	ไม่	นามสกุลของผู้ติดต่อที่เชื่อมโยงกับที่อยู่
billing_address.street_address	สตริง	ไม่	ที่อยู่
billing_address.extended_address	สตริง	ไม่	ส่วนขยายที่อยู่ (เช่น หมายเลขอพาร์ตเมนต์หรือห้องชุด)
billing_address.address_locality	สตริง	ไม่	สถานที่ตั้ง (เช่น เมือง)
billing_address.address_region	สตริง	ไม่	ภูมิภาค (เช่น รัฐหรือจังหวัด)
billing_address.postal_code	สตริง	ไม่	รหัสไปรษณีย์
billing_address.address_country	สตริง	ไม่	รหัสประเทศ (รูปแบบ ISO 3166-1 Alpha-2 ที่เป็นอักษร 2 ตัว)
billing_address.phone_number	สตริง	ไม่	หมายเลขโทรศัพท์ จะแสดงก็ต่อเมื่อตั้งค่า phone_number_required เป็น true ในการกำหนดค่า
credential	ออบเจ็กต์	ไม่	ข้อมูลการแปลงโทเค็นที่ปลอดภัยซึ่ง Google Pay ส่งคืน
credential.type	สตริง	ใช่	ประเภทการแปลงโทเค็น ตรงกับประเภทที่กำหนดค่า PAYMENT_GATEWAY: ใช้ในกรณีที่คุณประมวลผลการชำระเงินผ่านเกตเวย์ที่รองรับ DIRECT: ใช้ในกรณีที่คุณถอดรหัสข้อมูลเข้าสู่ระบบด้วยตนเอง
credential.token	สตริง	ใช่	โทเค็นข้อมูลเข้าสู่ระบบการชำระเงินที่เข้ารหัสเป็นสตริงที่แปลงเป็น JSON สำหรับ PAYMENT_GATEWAY จะมีเพย์โหลดที่เข้ารหัสเพื่อส่งไปยังเกตเวย์ สำหรับ DIRECT จะมีรายละเอียดบัตรที่เข้ารหัส (ต้องถอดรหัสโดยใช้คีย์ส่วนตัว) ดูรายละเอียดเกี่ยวกับรูปแบบและกระบวนการถอดรหัสได้ในคำแนะนำการเข้ารหัสข้อมูลการชำระเงิน