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

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

View.VISIBLE ตั้งค่าปุ่มการชำระเงินให้มองเห็นได้ (ค่าเริ่มต้น)

View.GONE จะซ่อนปุ่มจากผู้ใช้

ตัวอย่าง

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