การอ้างอิงไคลเอ็นต์

ข้อมูลอ้างอิงนี้อธิบายเมธอดของไคลเอ็นต์ JavaScript ที่ใช้ในการ ติดตั้งใช้งาน Google Pay API ในเว็บแอปพลิเคชัน

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

เริ่มต้นออบเจ็กต์ PaymentsClient คุณต้องเรียกใช้เครื่องมือสร้างนี้ก่อน เรียกใช้เมธอดสมาชิก

new PaymentsClient(paymentOptions)

อาร์กิวเมนต์

พร็อพเพอร์ตี้ คำอธิบาย
paymentOptions

ออบเจ็กต์ที่มีคู่คีย์-ค่าของข้อมูลการกำหนดค่า Google Pay API ดู PaymentOptions สำหรับพร็อพเพอร์ตี้ต่างๆ ที่กำหนดค่าได้

ตัวอย่าง: {environment:'PRODUCTION'}

การคืนสินค้า

ประเภท คำอธิบาย
google.payments.api.PaymentsClient ออบเจ็กต์ PaymentsClient

ส่ง

ประเภท คำอธิบาย
Error

ระบบไม่รองรับค่าพร็อพเพอร์ตี้ environment ที่ส่งผ่าน

เมธอดของออบเจ็กต์

createButton(options)

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

HTMLElement ที่สร้างขึ้นจะมี CSS และรูปภาพ SVG ที่แทรกแบบไดนามิก ซึ่งโฮสต์อยู่ใน CDN ของ Google

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

อาร์กิวเมนต์

ชื่อ คำอธิบาย
options

ออบเจ็กต์ที่มีคู่คีย์-ค่าสำหรับการกำหนดค่าปุ่ม ดู ButtonOptions สำหรับพร็อพเพอร์ตี้ที่กำหนดค่าได้

ตัวอย่าง: {onClick:onGooglePaymentButtonClicked}

การคืนสินค้า

ประเภท คำอธิบาย
HTMLElement ปุ่ม HTML <button> ภายในคอนเทนเนอร์เนื้อหาโฟลว์ทั่วไป เช่น <div>

ส่ง

ประเภท คำอธิบาย
Error

ไม่ได้ตั้งค่าพร็อพเพอร์ตี้ที่จำเป็น

isReadyToPay(isReadyToPayRequest)

ใช้เมธอด isReadyToPay(isReadyToPayRequest) เพื่อกำหนดความสามารถของผู้ใช้ ในการแสดงรูปแบบการชำระเงินจาก Google Pay API

หากเบราว์เซอร์รองรับ Google Pay เมธอด isReadyToPay จะแสดงผล true หากต้องการตรวจสอบว่าผู้ใช้เข้าสู่ระบบบัญชี Google หรือบันทึกวิธีการชำระเงินใน Google Pay ไว้แล้ว ให้ตั้งค่า IsReadyToPayRequest.existingPaymentMethodRequired เป็น true และตรวจสอบว่า paymentMethodPresent แสดงผล true ในสัญญาที่ได้รับการแก้ไขแล้ว ดูรายละเอียดเพิ่มเติมได้ที่ IsReadyToPayResponse

หาก PaymentsClient เริ่มต้นด้วยพร็อพเพอร์ตี้ environment เป็น TEST เมธอด paymentMethodPresent จะแสดงผล true เสมอ

อาร์กิวเมนต์

ชื่อ คำอธิบาย
isReadyToPayRequest ออบเจ็กต์ที่มีวิธีการชำระเงินที่ผู้ขายรองรับ ดูรายละเอียดเกี่ยวกับพร็อพเพอร์ตี้ต่างๆ ที่กำหนดค่าได้ที่ IsReadyToPayRequest

การคืนสินค้า

ประเภท คำอธิบาย
Promise

ได้รับการแก้ไขแล้ว: ออบเจ็กต์ที่มีข้อมูลเกี่ยวกับความสามารถของผู้ใช้ในการชำระเงิน ดูข้อมูลเพิ่มเติมได้ที่ IsReadyToPayResponse

ถูกปฏิเสธ: ออบเจ็กต์ข้อผิดพลาดที่มีข้อมูลเพิ่มเติมเกี่ยวกับสาเหตุของการ ปฏิเสธ ดูข้อมูลเพิ่มเติมได้ที่ PaymentsError.

ข้อผิดพลาด

statusCode คำอธิบาย
DEVELOPER_ERROR
  • ออบเจ็กต์ที่ส่งผ่าน IsReadyToPayRequest มีรูปแบบไม่ถูกต้อง ขาดพารามิเตอร์ที่จำเป็นขั้นต่ำเพื่อกำหนดความพร้อมของผู้ใช้ ในการชำระเงิน หรือมีพารามิเตอร์และ/หรือค่าไม่ถูกต้อง
  • คำขอเริ่มต้นจากบริบทความปลอดภัยที่ตัวแทนการชำระเงินหรือเบราว์เซอร์ เลือกที่จะไม่ดำเนินการ โดยส่วนใหญ่จะเป็นข้อผิดพลาดเกี่ยวกับบริบทเบราว์เซอร์ที่ไม่ปลอดภัย insecure browser context

loadPaymentData(paymentDataRequest)

เมธอดนี้จะแสดงชีตการชำระเงิน Google Pay ที่อนุญาตให้เลือกวิธีการชำระเงิน และพารามิเตอร์ที่กำหนดค่าได้ (ไม่บังคับ)

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

อาร์กิวเมนต์

ชื่อ คำอธิบาย
paymentDataRequest ออบเจ็กต์ที่มีคู่คีย์-ค่าของการกำหนดค่า Google Pay API แบบเต็ม ดู PaymentDataRequest สำหรับพร็อพเพอร์ตี้ที่กำหนดค่าได้

การคืนสินค้า

ประเภท คำอธิบาย
Promise

ได้รับการแก้ไขแล้ว: ออบเจ็กต์ที่มีข้อมูลผู้เลือกซื้อที่ขอ ดูข้อมูลเพิ่มเติมได้ที่ PaymentData

ถูกปฏิเสธ: ออบเจ็กต์ที่มีรหัสข้อผิดพลาดและข้อมูลเพิ่มเติม เกี่ยวกับสาเหตุของการปฏิเสธ ดูข้อมูลเพิ่มเติมได้ที่ PaymentsError

ข้อผิดพลาด

statusCode คำอธิบาย
CANCELED
DEVELOPER_ERROR ออบเจ็กต์ PaymentDataRequest ที่ส่งผ่านมีรูปแบบไม่ถูกต้อง ขาดพารามิเตอร์ที่จำเป็นขั้นต่ำ หรือ มีพารามิเตอร์และ/หรือค่าไม่ถูกต้อง

prefetchPaymentData(paymentDataRequest)

ใช้เมธอดนี้เพื่อดึงข้อมูลการกำหนดค่า PaymentDataRequest ล่วงหน้าเพื่อลดเวลาในการดำเนินการ loadPaymentData เมื่อผู้ใช้โต้ตอบในภายหลัง ระบบจะไม่แสดงผลค่าใดๆ

การเพิ่มประสิทธิภาพการดึงข้อมูลล่วงหน้าพร้อมใช้งานใน Chrome สำหรับ Android

อาร์กิวเมนต์

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

Callback ข้อมูลการชำระเงิน

คุณส่งเครื่องจัดการ Callback ต่อไปนี้ไปยัง PaymentOptions.paymentDataCallbacks เพื่อรองรับการให้สิทธิ์การชำระเงินและการอัปเดตราคาแบบไดนามิกได้

onPaymentAuthorized(paymentData)

เมธอดนี้จะเรียกใช้เมื่อมีการให้สิทธิ์การชำระเงินในชีตการชำระเงิน

อาร์กิวเมนต์

ชื่อ คำอธิบาย
paymentData ออบเจ็กต์ที่มีข้อมูลผู้เลือกซื้อที่ขอ ดูรายละเอียดได้ที่ PaymentData

การคืนสินค้า

ประเภท คำอธิบาย
Promise

ได้รับการแก้ไขแล้ว: ออบเจ็กต์ที่มีข้อมูลเกี่ยวกับผลลัพธ์ของธุรกรรมการชำระเงิน ดูรายละเอียดได้ที่ ดู PaymentAuthorizationResult

ถูกปฏิเสธ: ออบเจ็กต์ข้อผิดพลาดที่มีจุดประสงค์และข้อความแสดงข้อผิดพลาดที่จะแสดงใน ชีตการชำระเงิน ดูรายละเอียดได้ที่ ดู PaymentDataError

onPaymentDataChanged(intermediatePaymentData)

เมธอดนี้จะจัดการการเปลี่ยนแปลงข้อมูลการชำระเงินในชีตการชำระเงิน เช่น ที่อยู่สำหรับจัดส่งและ ตัวเลือกการจัดส่ง

อาร์กิวเมนต์

ชื่อ คำอธิบาย
intermediatePaymentData ออบเจ็กต์ที่มีที่อยู่ที่เลือกและตัวเลือกการจัดส่งใน ชีตการชำระเงิน ดูรายละเอียดได้ที่ IntermediatePaymentData

การคืนสินค้า

ประเภท คำอธิบาย
Promise

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

ถูกปฏิเสธ: ออบเจ็กต์ข้อผิดพลาดที่มีจุดประสงค์และข้อความแสดงข้อผิดพลาดที่จะแสดงใน ชีตการชำระเงิน ดูรายละเอียดได้ที่ ดู PaymentDataError