Thông tin tham khảo về khách hàng

com.google.android.gms.wallet documentation chứa tài liệu đầy đủ cho thư viện trên nhiều phiên bản của Google Pay API. Dưới đây là bản tóm tắt về các đối tượng và phương thức phù hợp nhất với phiên bản mới nhất của Google Pay API: phiên bản 2.0

Ví

Tạo PaymentsClient cho môi trường kiểm thử hoặc môi trường thực tế.

Ví dụ

mPaymentsClient = Wallet.getPaymentsClient(
  this,
  new Wallet.WalletOptions.Builder()
      .setEnvironment(WalletConstants.ENVIRONMENT_TEST)
      .build()
);

PaymentsClient

Một ứng dụng để tương tác với Google Pay API.

isReadyToPay(IsReadyToPayRequest)

Sử dụng phương thức isReadyToPay(IsReadyToPayRequest) để xác định khả năng của người dùng trong việc trả lại một hình thức thanh toán từ Google Pay API.

Nếu thiết bị hỗ trợ Google Pay và người dùng đã lưu phương thức thanh toán hoặc có thể thêm phương thức thanh toán, thì IsReadyToPay sẽ trả về true. Để xác định xem người dùng đã lưu phương thức thanh toán trong Google Pay hay chưa, hãy đặt IsReadyToPayRequest.existingPaymentMethodRequired thành true.

loadPaymentData(PaymentDataRequest)

Xuất hiện một bảng thanh toán của Google Pay cho phép chọn một phương thức thanh toán và các thông số được định cấu hình (không bắt buộc).

IsReadyToPayRequest

Tạo một đối tượng Java IsReadyToPayRequest phù hợp để dùng với PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

Tạo một đối tượng IsReadyToPayRequest Java từ một chuỗi có định dạng JSON. Hãy xem tham chiếu đối tượng IsReadyToPayRequest để biết cấu trúc dự kiến của chuỗi được định dạng JSON mà bạn cung cấp.

PaymentDataRequest

Tạo một đối tượng PaymentDataRequest Java phù hợp để sử dụng với PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

Tạo một đối tượng PaymentDataRequest Java từ một chuỗi có định dạng JSON. Hãy xem Tài liệu tham khảo về đối tượng PaymentDataRequest để biết cấu trúc dự kiến của chuỗi được định dạng JSON đã cung cấp.

PaymentData

Xử lý phản hồi ở định dạng JSON của Google Pay API để sử dụng trong ứng dụng của bạn.

toJson()

Xuất phản hồi của Google Pay API dưới dạng một chuỗi có định dạng JSON. Hãy xem Tài liệu tham khảo về đối tượng PaymentData để biết thêm thông tin về cấu trúc của đối tượng JSON.

PayButton

public void initialize(ButtonOption buttonOptions)

Phương thức tiện lợi được dùng để khởi động nút thanh toán Google Pay được tạo kiểu bằng thương hiệu Google Pay mới nhất.

Đối số

Tên Mô tả
buttonOptions Một đối tượng định cấu hình nút thanh toán Google Pay. Hãy xem ButtonOptions để biết các thuộc tính có thể định cấu hình.

Ví dụ: Khởi tạo nút thanh toán bằng các cấu hình tuỳ chỉnh:

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)

Phương thức tiện lợi này đặt chế độ hiển thị nút thanh toán.

Đối số

Tên Mô tả
View

View.VISIBLE đặt nút thanh toán ở chế độ hiển thị (mặc định).

View.GONE ẩn nút này khỏi người dùng.

Ví dụ:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

Phương thức này được gọi khi người dùng nhấp vào nút thanh toán Google Pay.

Đối số

Tên Mô tả
listener Một lệnh gọi lại trình nghe sự kiện để gọi khi một sự kiện nhấp chuột được gửi đến nút thanh toán Google Pay.

BasePaymentDataCallbacksService

Lớp dịch vụ cơ sở lưu trữ các lệnh gọi lại dữ liệu thanh toán do Dịch vụ Google Play khởi tạo trong quy trình PaymentsClient.loadPaymentData(PaymentDataRequest).

Mở rộng dịch vụ này trong ứng dụng của bạn và khai báo dịch vụ đó trong AndroidManifest.xml bằng quyền com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE và bộ lọc ý định cho com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS.

createPaymentDataCallbacks()

Trả về một phương thức triển khai BasePaymentDataCallbacks để xử lý các sự kiện gọi lại đến. Được gọi một lần cho mỗi sự kiện gọi lại.

BasePaymentDataCallbacks

Lớp cơ sở trừu tượng chứa các trình xử lý lệnh gọi lại dữ liệu thanh toán do người bán triển khai để hỗ trợ tính năng Cập nhật giá linh hoạt và Uỷ quyền thanh toán.

onPaymentDataChanged(intermediatePaymentData, onCompleteListener)

Phương thức này xử lý các thay đổi về dữ liệu thanh toán trong trang thanh toán, chẳng hạn như địa chỉ giao hàng và lựa chọn vận chuyển.

Đối số

Tên Loại Mô tả
intermediatePaymentData IntermediatePaymentData Một đối tượng chứa địa chỉ và lựa chọn vận chuyển đã chọn trong trang thanh toán. Để biết thông tin chi tiết, hãy xem IntermediatePaymentData.
onCompleteListener OnCompleteListener<PaymentDataRequestUpdate> Một trình nghe để phân giải bằng thông tin giao dịch, lựa chọn vận chuyển và lỗi dữ liệu thanh toán mới nhất. Truyền một thực thể PaymentDataRequestUpdate đến complete().

Ví dụ

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)

Phương thức này được gọi khi một khoản thanh toán được uỷ quyền trong bảng thanh toán.

Đối số

Tên Loại Mô tả
paymentData PaymentData Một đối tượng chứa dữ liệu người mua sắm được yêu cầu. Để biết thông tin chi tiết, hãy xem PaymentData.
onCompleteListener OnCompleteListener<PaymentAuthorizationResult> Một trình nghe để phân giải bằng kết quả uỷ quyền. Truyền một thực thể PaymentAuthorizationResult đến complete().

Ví dụ

override fun onPaymentAuthorized(
    paymentData: PaymentData,
    onCompleteListener: OnCompleteListener<PaymentAuthorizationResult>
) {
    val paymentAuthorizationResultJson = handlePaymentAuthorized(paymentData.toJson())
    val result = PaymentAuthorizationResult.fromJson(paymentAuthorizationResultJson.toString())
    onCompleteListener.complete(result)
}

IntermediatePaymentData

Xử lý dữ liệu lệnh gọi lại trung gian được truyền đến BasePaymentDataCallbacks.onPaymentDataChanged.

toJson()

Xuất dữ liệu yêu cầu gọi lại dưới dạng một chuỗi có định dạng JSON. Hãy xem tài liệu tham khảo về đối tượng IntermediatePaymentData để biết thêm thông tin về cấu trúc của đối tượng JSON.

getLastSavedState()

Trả về Bundle chứa trạng thái đã lưu trong lần lặp lại lệnh gọi lại trước đó.

PaymentDataRequestUpdate

Tạo một đối tượng Java PaymentDataRequestUpdate để trả về trong BasePaymentDataCallbacks.onPaymentDataChanged.

fromJson(java.lang.String)

Tạo một đối tượng PaymentDataRequestUpdate Java từ một chuỗi có định dạng JSON. Hãy xem Tài liệu tham khảo về đối tượng PaymentDataRequestUpdate để biết cấu trúc dự kiến của chuỗi được định dạng JSON mà bạn cung cấp.

withUpdatedSavedState(Bundle)

Đính kèm trạng thái Bundle đã cập nhật để duy trì giữa các lệnh gọi lại.

PaymentAuthorizationResult

Tạo một đối tượng Java PaymentAuthorizationResult để trả về trong BasePaymentDataCallbacks.onPaymentAuthorized.

fromJson(java.lang.String)

Tạo một đối tượng PaymentAuthorizationResult Java từ một chuỗi có định dạng JSON. Hãy xem Tài liệu tham khảo về đối tượng phản hồi PaymentAuthorizationResult để biết cấu trúc dự kiến của chuỗi được định dạng JSON đã cung cấp.