com.google.android.gms.wallet documentation มีเอกสารประกอบฉบับเต็มสำหรับไลบรารีใน Google Pay API หลายเวอร์ชัน ด้านล่างนี้เป็นข้อมูลสรุปของออบเจ็กต์และเมธอดที่ใช้ได้มากที่สุดกับ Google Pay API เวอร์ชันล่าสุด ซึ่งก็คือเวอร์ชัน 2.0
Wallet
สร้าง PaymentsClient สำหรับสภาพแวดล้อมการทดสอบหรือสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์
ตัวอย่าง
mPaymentsClient = Wallet.getPaymentsClient( this, new Wallet.WalletOptions.Builder() .setEnvironment(WalletConstants.ENVIRONMENT_TEST) .build() );
PaymentsClient
ไคลเอ็นต์สําหรับการโต้ตอบกับ Google Pay API
isReadyToPay(IsReadyToPayRequest)
ใช้เมธอด isReadyToPay(IsReadyToPayRequest) เพื่อพิจารณาความสามารถของผู้ใช้ในการแสดงผลรูปแบบการชำระเงินจาก Google Pay API
หากอุปกรณ์รองรับ Google Pay และผู้ใช้ได้บันทึกวิธีการชำระเงินไว้แล้วหรือเพิ่มวิธีการชำระเงินได้ IsReadyToPay จะแสดงผลเป็น true หากต้องการตรวจสอบว่าผู้ใช้บันทึกวิธีการชำระเงินใน Google Pay ไว้แล้วหรือไม่ ให้ตั้งค่า IsReadyToPayRequest.existingPaymentMethodRequired เป็น true
loadPaymentData(PaymentDataRequest)
แสดงชีตการชำระเงินของ Google Pay ซึ่งช่วยให้เลือกวิธีการชำระเงินและพารามิเตอร์ที่กำหนดค่าได้ (ไม่บังคับ)
IsReadyToPayRequest
สร้างออบเจ็กต์ Java IsReadyToPayRequest ที่เหมาะสำหรับใช้กับ PaymentsClient.isReadyToPay()
fromJson(java.lang.String)
สร้างออบเจ็กต์ Java IsReadyToPayRequest จากสตริงที่จัดรูปแบบ JSON ดูโครงสร้างที่คาดหวังของสตริงที่จัดรูปแบบ JSON ที่ระบุได้ที่ข้อมูลอ้างอิงออบเจ็กต์ IsReadyToPayRequest
PaymentDataRequest
สร้างออบเจ็กต์ Java PaymentDataRequest ที่เหมาะสำหรับใช้กับ PaymentsClient.loadPaymentData
fromJson(java.lang.String)
สร้างออบเจ็กต์ Java PaymentDataRequest จากสตริงที่จัดรูปแบบ JSON ดูโครงสร้างที่คาดไว้ของสตริงที่จัดรูปแบบ JSON ที่ระบุได้ในข้อมูลอ้างอิงออบเจ็กต์ PaymentDataRequest
PaymentData
จัดการการตอบกลับในรูปแบบ JSON ของ Google Pay API เพื่อใช้ในแอป
toJson()
แสดงผลการตอบกลับจาก Google Pay API เป็นสตริงที่จัดรูปแบบ JSON ดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้างของออบเจ็กต์ JSON ได้ที่ข้อมูลอ้างอิงออบเจ็กต์ PaymentData
PayButton
public void initialize(ButtonOption buttonOptions)
ระบบจะใช้วิธีการที่สะดวกเพื่อเริ่มต้นปุ่มการชำระเงินด้วย Google Pay ที่มีสไตล์ตามการสร้างแบรนด์ Google Pay ล่าสุด
อาร์กิวเมนต์
| ชื่อ | คำอธิบาย |
|---|---|
buttonOptions |
ออบเจ็กต์ที่กำหนดค่าปุ่มการชำระเงินด้วย Google Pay ดูพร็อพเพอร์ตี้ที่กำหนดค่าได้ที่ ButtonOptions |
ตัวอย่าง: เริ่มต้นปุ่มการชำระเงินด้วยการกำหนดค่าที่กำหนดเอง
PayButton googlePayPaymentButton = layoutBinding.googlePayPaymentButton; JSONArray paymentMethods = new JSONArray().put(getBaseCardPaymentMethod()); googlePayPaymentButton.initialize( ButtonOptions.newBuilder() .setButtonTheme(ButtonConstants.ButtonTheme.DARK) .setButtonType(ButtonConstants.ButtonType.BUY) .setCornerRadius(100) .setAllowedPaymentMethods(paymentMethods.toString()) .build() );
public void setVisibility(View view)
เมธอดอำนวยความสะดวกจะตั้งค่าระดับการเข้าถึงปุ่มการชำระเงิน
อาร์กิวเมนต์
| ชื่อ | คำอธิบาย |
|---|---|
View |
|
ตัวอย่าง
payButton.setVisibility(View.VISIBLE);
public void setOnClickListener(View.OnClickListener listener)
ระบบจะเรียกใช้เมธอดเมื่อผู้ใช้คลิกปุ่มการชำระเงินด้วย Google Pay
อาร์กิวเมนต์
| ชื่อ | คำอธิบาย |
|---|---|
listener |
Callback ของ Listener เหตุการณ์ที่จะเรียกใช้เมื่อมีการส่งกิจกรรมการคลิกไปยังปุ่มการชำระเงินด้วย Google Pay |
BasePaymentDataCallbacksService
คลาสบริการพื้นฐานที่โฮสต์ Callback ข้อมูลการชำระเงินซึ่งเริ่มต้นโดยบริการ Google Play ภายในขั้นตอน PaymentsClient.loadPaymentData(PaymentDataRequest)
ขยายบริการนี้ในแอปพลิเคชันของคุณและประกาศใน AndroidManifest.xml ด้วยสิทธิ์ com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE และตัวกรอง Intent สำหรับ com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS
createPaymentDataCallbacks()
แสดงผลการใช้งาน BasePaymentDataCallbacks เพื่อจัดการเหตุการณ์ Callback ขาเข้า เรียกใช้ 1 ครั้งต่อเหตุการณ์ Callback
BasePaymentDataCallbacks
คลาสพื้นฐานแบบนามธรรมที่มี Callback Handler ของข้อมูลการชำระเงินที่ผู้ขายใช้เพื่อรองรับการอัปเดตราคาแบบไดนามิกและการให้สิทธิ์การชำระเงิน
onPaymentDataChanged(intermediatePaymentData, onCompleteListener)
เมธอดนี้จะจัดการการเปลี่ยนแปลงข้อมูลการชำระเงินในชีตการชำระเงิน เช่น ที่อยู่สำหรับจัดส่งและตัวเลือกการจัดส่ง
อาร์กิวเมนต์
สวัสดี| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
intermediatePaymentData |
IntermediatePaymentData |
ออบเจ็กต์ที่มีที่อยู่และตัวเลือกการจัดส่งที่เลือกในแผ่นงานการชำระเงิน โปรดดูรายละเอียดที่หัวข้อ IntermediatePaymentData |
onCompleteListener |
OnCompleteListener<PaymentDataRequestUpdate> |
Listener ที่จะแก้ไขด้วยข้อมูลธุรกรรม ตัวเลือกการจัดส่ง และข้อผิดพลาดเกี่ยวกับข้อมูลการชำระเงินที่อัปเดตแล้ว ส่งอินสแตนซ์ PaymentDataRequestUpdate ไปยัง complete() |
ตัวอย่าง
override fun onPaymentDataChanged( intermediatePaymentData: IntermediatePaymentData, onCompleteListener: OnCompleteListener<PaymentDataRequestUpdate> ) { val paymentDataRequestUpdateJson = handlePaymentDataChanged(intermediatePaymentData.toJson()) val update = PaymentDataRequestUpdate.fromJson(paymentDataRequestUpdateJson.toString()) onCompleteListener.complete(update) }
onPaymentAuthorized(paymentData, onCompleteListener)
ระบบจะเรียกใช้เมธอดนี้เมื่อมีการอนุมัติการชำระเงินในชีตการชำระเงิน
อาร์กิวเมนต์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
paymentData |
PaymentData |
ออบเจ็กต์ที่มีข้อมูลผู้เลือกซื้อที่ขอ โปรดดูรายละเอียดที่หัวข้อ PaymentData |
onCompleteListener |
OnCompleteListener<PaymentAuthorizationResult> |
Listener ที่จะแก้ไขด้วยผลการให้สิทธิ์ ส่งอินสแตนซ์ PaymentAuthorizationResult ไปยัง complete() |
ตัวอย่าง
override fun onPaymentAuthorized( paymentData: PaymentData, onCompleteListener: OnCompleteListener<PaymentAuthorizationResult> ) { val paymentAuthorizationResultJson = handlePaymentAuthorized(paymentData.toJson()) val result = PaymentAuthorizationResult.fromJson(paymentAuthorizationResultJson.toString()) onCompleteListener.complete(result) }
IntermediatePaymentData
จัดการข้อมูล Callback ระดับกลางที่ส่งไปยัง BasePaymentDataCallbacks.onPaymentDataChanged
toJson()
แสดงผลข้อมูลคำขอ Callback เป็นสตริงที่จัดรูปแบบ JSON ดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้างของออบเจ็กต์ JSON ได้ที่ข้อมูลอ้างอิงออบเจ็กต์ IntermediatePaymentData
getLastSavedState()
แสดงผล Bundle ที่มีสถานะที่บันทึกไว้ระหว่างการทำซ้ำ Callback ก่อนหน้า
PaymentDataRequestUpdate
สร้างออบเจ็กต์ Java PaymentDataRequestUpdate เพื่อแสดงผลใน BasePaymentDataCallbacks.onPaymentDataChanged
fromJson(java.lang.String)
สร้างออบเจ็กต์ Java PaymentDataRequestUpdate จากสตริงที่จัดรูปแบบ JSON ดูโครงสร้างที่คาดไว้ของสตริงที่จัดรูปแบบ JSON ที่ระบุได้ในข้อมูลอ้างอิงออบเจ็กต์ PaymentDataRequestUpdate
withUpdatedSavedState(Bundle)
แนบสถานะ Bundle ที่อัปเดตแล้วเพื่อคงอยู่ระหว่างการเรียกใช้ Callback
PaymentAuthorizationResult
สร้างออบเจ็กต์ Java PaymentAuthorizationResult เพื่อแสดงผลใน BasePaymentDataCallbacks.onPaymentAuthorized
fromJson(java.lang.String)
สร้างออบเจ็กต์ Java PaymentAuthorizationResult จากสตริงที่จัดรูปแบบ JSON ดูโครงสร้างที่คาดไว้ของสตริงที่จัดรูปแบบ JSON ที่ระบุได้ในข้อมูลอ้างอิงออบเจ็กต์การตอบกลับ PaymentAuthorizationResult