com.google.android.gms.wallet 문서에는 여러 버전의 Google Pay API에 관한 라이브러리의 전체 문서가 포함되어 있습니다. 다음은 Google Pay API의 최신 버전인 버전 2.0에 가장 적합한 객체 및 메서드를 요약한 것입니다.
월렛
테스트 또는 프로덕션 환경의 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
PaymentsClient.isReadyToPay()와 함께 사용하기에 적합한 IsReadyToPayRequest Java 객체를 빌드합니다.
fromJson(java.lang.String)
JSON 형식 문자열에서 IsReadyToPayRequest Java 객체를 만듭니다. 제공된 JSON 형식 문자열의 예상 구조는 IsReadyToPayRequest 객체 참조를 확인하세요.
PaymentDataRequest
PaymentsClient.loadPaymentData와 함께 사용하기에 적합한 PaymentDataRequest Java 객체를 빌드합니다.
fromJson(java.lang.String)
JSON 형식 문자열에서 PaymentDataRequest 자바 객체를 만듭니다. 제공된 JSON 형식 문자열의 예상 구조는 PaymentDataRequest 객체 참조를 참고하세요.
PaymentData
앱에서 사용할 수 있도록 Google Pay API JSON 형식 응답을 처리합니다.
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 |
클릭 이벤트가 Google Pay 결제 버튼에 전달될 때 호출할 이벤트 리스너 콜백입니다. |
BasePaymentDataCallbacksService
PaymentsClient.loadPaymentData(PaymentDataRequest) 흐름 내에서 Google Play 서비스에 의해 시작된 결제 데이터 콜백을 호스팅하는 기본 서비스 클래스입니다.
애플리케이션에서 이 서비스를 확장하고 com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE 권한 및 com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS의 인텐트 필터를 사용하여 AndroidManifest.xml에서 선언합니다.
createPaymentDataCallbacks()
수신 콜백 이벤트를 처리하는 BasePaymentDataCallbacks 구현을 반환합니다. 콜백 이벤트당 한 번 호출됩니다.
BasePaymentDataCallbacks
동적 가격 업데이트 및 결제 승인을 지원하기 위해 판매자가 구현한 결제 데이터 콜백 핸들러가 포함된 추상 기본 클래스입니다.
onPaymentDataChanged(intermediatePaymentData, onCompleteListener)
이 메서드는 결제 명세서에서 배송지 주소 및 배송 옵션과 같은 결제 데이터 변경사항을 처리합니다.
인수
안녕하세요| 이름 | 유형 | 설명 |
|---|---|---|
intermediatePaymentData |
IntermediatePaymentData |
결제 명세서에서 선택한 주소와 배송 옵션을 포함하는 객체입니다. 자세한 내용은 IntermediatePaymentData를 참고하세요. |
onCompleteListener |
OnCompleteListener<PaymentDataRequestUpdate> |
업데이트된 거래 정보, 배송 옵션, 결제 데이터 오류를 해결하는 리스너입니다. 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> |
승인 결과로 해결할 리스너입니다. 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
BasePaymentDataCallbacks.onPaymentDataChanged에 전달된 중간 콜백 데이터를 처리합니다.
toJson()
콜백 요청 데이터를 JSON 형식의 문자열로 출력합니다. JSON 객체의 구조에 관한 자세한 내용은 IntermediatePaymentData 객체 참조를 참고하세요.
getLastSavedState()
이전 콜백 반복 중에 저장된 상태가 포함된 Bundle를 반환합니다.
PaymentDataRequestUpdate
BasePaymentDataCallbacks.onPaymentDataChanged에서 반환할 PaymentDataRequestUpdate 자바 객체를 빌드합니다.
fromJson(java.lang.String)
JSON 형식 문자열에서 PaymentDataRequestUpdate 자바 객체를 만듭니다. 제공된 JSON 형식 문자열의 예상 구조는 PaymentDataRequestUpdate 객체 참조를 참고하세요.
withUpdatedSavedState(Bundle)
콜백 호출 간에 유지되도록 업데이트된 상태 Bundle를 연결합니다.
PaymentAuthorizationResult
BasePaymentDataCallbacks.onPaymentAuthorized에서 반환할 PaymentAuthorizationResult 자바 객체를 빌드합니다.
fromJson(java.lang.String)
JSON 형식 문자열에서 PaymentAuthorizationResult 자바 객체를 만듭니다. 제공된 JSON 형식 문자열의 예상 구조는 PaymentAuthorizationResult 응답 객체 참조를 참고하세요.