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

com.google.android.gms.wallet documentation chứa tài liệu đầy đủ về thư viện trên nhiều phiên bản của Google Pay API. Dưới đây là thông tin 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 API Google Pay: phiên bản 2.0

Ví

Tạo PaymentsClient cho môi trường thử nghiệm 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 khách để tương tác với API Google Pay.

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ả về một phương 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)

Hiển thị trang thanh toán Google Pay cho phép chọn phương thức thanh toán và các tham 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 để sử dụng với PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

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

PaymentDataRequest

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

fromJson(java.lang.String)

Tạo đối tượng Java PaymentDataRequest 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 định dạng JSON được 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 API Google Pay dưới dạng 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 này được dùng để khởi chạy nút thanh toán Google Pay theo kiểu mới nhất của thương hiệu Google Pay.

Đố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 động nút thanh toán bằng 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 đượ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 Lệnh gọi lại trình nghe sự kiện để gọi khi 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 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 sắp tới. Đượ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 trình xử lý 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 động 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à phương thức vận chuyển.

Đối số

xin chào
Tên Loại Mô tả
intermediatePaymentData IntermediatePaymentData Một đối tượng chứa địa chỉ và phương thức 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> Trình nghe để giải quyết 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 đã cập 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> Trình nghe để giải quyết 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 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 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 đối tượng Java PaymentDataRequestUpdate từ chuỗi có định dạng JSON. 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 cung cấp ở định dạng JSON.

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 đối tượng Java PaymentAuthorizationResult 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 cung cấp ở định dạng JSON.