문제 해결

Android 문제 해결 가이드에서는 다음 주제와 관련된 문제와 질문을 다룹니다.

앱이 현재 테스트 환경 내에서 실행 중입니다.

사용자가 결제 세부정보 대화상자에서 결제 카드를 선택하면 다음 메시지가 표시될 수 있습니다.

앱이 현재 테스트 환경 내에서 실행 중입니다. 거래 금액이 실제로 청구되지는 않습니다.

이 오류는 앱이 ENVIRONMENT_TEST를 사용하고 실제 결제 사용자 인증 정보를 수신하지 않지만 요청된 경우 청구서 수신 주소, 청구서 수신 주소 전화번호, 배송지 주소, 이메일 주소를 포함한 개인 정보를 수신함을 나타냅니다.

요청이 실패했습니다

가장 일반적인 오류 메시지는 OR_BIBED_06입니다. 이 오류 메시지는 UI에도 다음과 같은 텍스트가 포함된 대화상자로 표시됩니다.

요청 실패
판매자의 Google Pay 통합에 문제가 있습니다. 판매자에게 문의하여 도움을 받거나 다른 방법으로 결제하세요.

이 오류에 대해 자세히 알아보려면 다음 단계를 따르세요.

  1. 컴퓨터에 Android 디버그 브리지 (adb)가 설치되어 있는지 확인합니다.
  2. 기기에서 USB 디버깅이 사용 설정되어 있는지 확인합니다. 자세한 내용은 앱 디버그를 참고하세요.
  3. Android 기기를 컴퓨터에 연결하거나 시뮬레이터를 시작합니다.
  4. 컴퓨터의 터미널 또는 명령 프롬프트에서 다음 명령어를 실행합니다.

    adb logcat -s WalletMerchantError

응답에 오류의 이유가 표시됩니다. 예를 들어 다음과 같이 표시될 수 있습니다.

02-26 17:41:28.133 14593 14593 W WalletMerchantError: Error in loadPaymentData: This
merchant profile does not have access to this feature.

문제를 해결하기 위해 취해야 하는 조치는 오류 메시지에 따라 다릅니다.

게이트웨이 유효성

통합 중에 게이트웨이 유효성과 관련된 다음 오류가 발생할 수 있습니다. 다음 목록은 이러한 오류가 발생할 경우 유용한 문제 해결 도움말을 제공합니다.

OR_BIBED_06 알 수 없는 게이트웨이 'yourgateway'
tokenizationSpecification에 지정한 gateway 속성 값은 현재 Google Pay API에서 지원되지 않습니다. 게이트웨이 식별자 및 gatewayMerchantId와 같은 관련 필드에 대한 자세한 내용은 게이트웨이에 문의하세요.
OR_BIBED_06 게이트웨이 'example'은 프로덕션 모드에서 사용할 수 없습니다.
예시 게이트웨이 속성 값은 테스트 목적으로만 사용되며 WalletConstants.ENVIRONMENT_PRODUCTION로 설정된 WalletOptions 환경 매개변수 값과 함께 사용할 수 없습니다. Google Pay API와 함께 사용해야 하는 gateway 매개변수에 관한 자세한 내용은 게이트웨이에 문의하세요.

등록 및 액세스

통합 중에 등록 및 액세스와 관련된 다음 오류가 발생할 수 있습니다. 다음 목록은 이러한 오류가 발생할 경우 유용한 문제 해결 도움말을 제공합니다.

OR_BIBED_07 이 API에는 Google Play 서비스 라이브러리 버전 8.4 이상이 필요합니다.
앱을 실행하는 기기에서 Google Play 서비스가 최신 상태인지 확인합니다.
OR_BIBED_07 이 판매자 프로필에 대한 키가 없습니다.
DIRECT tokenizationSpecification type 통합을 완료하려면 Google Pay 및 월렛 콘솔을 사용하여 공개 암호화 키를 Google에 등록해야 합니다.
OR_BIBED_07 이 판매자 프로필에는 이 기능에 대한 액세스 권한이 없습니다.
Google Pay API에 앱을 등록하는 절차를 완료하지 않았습니다. 자세한 내용은 프로덕션 액세스 요청을 참고하세요.
OR_BIBED_10 Google Pay가 허용되지 않는 지역에 있는 판매자입니다.
이 지역에서는 Google Pay 서비스를 사용할 수 없습니다. 자세한 내용은 지원되는 국가 목록을 참고하세요
OR_BIBED_11 이 판매자는 Google Pay API 사용을 위한 등록을 완료하지 않았습니다. 콘솔 (https://pay.google.com/business/console)로 이동하여 확인하세요.
Google Pay API에 앱을 등록하는 절차를 완료하지 않았습니다. 자세한 내용은 프로덕션 액세스 요청을 참고하세요.
OR_BIBED_12 이 Google Pay API 통합이 사용 중지되었습니다. 자세한 내용은 Google에 문의하세요(https://developers.google.com/pay/api/faq#how-to-get-support).
Google에 문의하여 계정의 Google Pay API를 다시 사용 설정하는 데 필요한 단계를 자세히 알아보세요.
OR_BIBED_13 서명 키 지문{11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:11:22:33:44:55}이(가) 이 앱에 대해 Google에 등록된 것과 일치하지 않습니다.
APK가 올바른 서명 키로 서명된 경우에만 Google Pay API를 프로덕션 모드에서 사용할 수 있습니다. 자세한 내용은 앱 서명을 참고하세요.

직접 판매자

통합 중에 직접 판매자와 관련된 다음 오류가 발생할 수 있습니다. 다음 목록은 이러한 오류가 발생할 경우 유용한 문제 해결 도움말을 제공합니다.

서명 확인
merchantId이 잘못되면 서명 확인 오류가 발생할 수 있습니다.
Tink paymentmethodtoken 라이브러리를 사용하는 경우 TEST 환경에서 이 문제가 발생할 수 있습니다. 이 문제를 방지하려면
에서 YOUR_MERCHANT_ID로 설정하세요.
.recipientId("merchant:YOUR_MERCHANT_ID")
토큰을 복호화할 수 없음
Tink paymentmethodtoken 라이브러리를 사용하여 토큰을 복호화하는 경우 다음 사항에 유의하세요.
  • Google Pay API 응답 환경이 Tink 환경과 일치하는지 확인합니다. 예를 들어 Google Pay API 응답이 ENVIRONMENT_TEST에 의해 반환된 경우 Tink는 복호화를 위해 테스트 환경을 가리킵니다.
  • Google Pay API의 응답을 Tink에 전달하기 전에 수정하지 마세요. Google Pay API 응답에서 반환된 전체 토큰을 전달해야 합니다. 자세한 내용은 다음 참고사항을 참고하세요.
  • Google에 등록한 공개 키와 연결된 적절한 비공개 키가 있는지 확인합니다.
Windows에서 공개 키와 비공개 키 쌍 생성
Windows를 사용 중이고 OpenSSL을 사용하여 비공개 및 공개 키 생성에 설명된 단계를 따르려면 머신에 Cygwin을 설치해야 합니다. Linux 명령어를 실행하는 데 필요합니다.

Android WebView

OR_BIBED_15 이 앱이 WebView를 사용하기 때문에 Google Pay를 제대로 로드할 수 없습니다. 앱 개발자는 Google Pay가 Android WebView 내에서 작동하도록 사용 설정하려면 다음 안내를 따라야 합니다.
안내에 따라 Android WebView용 Google Pay API를 사용 설정합니다.

CardInfo

CardInfo 기능이란 무엇인가요?
Google Pay는 Google Pay 결제 버튼에 카드가 있음을 소비자에게 표시합니다. 이 버튼에는 카드 브랜드 네트워크와 카드의 마지막 4자리 숫자가 모두 표시됩니다.
내 구현에서 CardInfo 기능이 렌더링되지 않는 이유는 무엇인가요?

CardInfo 기능이 작동하려면 다음 조건이 필요합니다.