문제 해결

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

등록 및 액세스

통합 중에 다음과 같은 오류가 발생할 수 있습니다. 이 목록에서는 이러한 오류가 발생할 경우 도움이 되는 문제 해결 조언을 제공합니다.

이 판매자는 Google Pay를 사용할 수 없습니다.
Google Pay API에는 PRODUCTION 환경에 대해 PaymentsClient을 구성하는 사이트의 Google merchantId가 필요합니다. Google merchantId이 Google Pay 및 월렛 콘솔을 통해 하나 이상의 정규화된 도메인과 연결되어 있습니다. 자세한 내용은 반환된 오류 세부정보를 확인하세요.
이 판매자는 Google Pay API를 사용하기 위한 등록을 완료하지 않았습니다. 콘솔 (https://pay.google.com/business/console)로 이동하여 확인하세요.
Google Pay API에 웹사이트를 등록하는 절차를 완료하지 않았습니다. Google Pay 및 월렛 콘솔을 사용하여 등록하고 웹사이트의 Google Pay API 사용에 대한 검토를 요청하려면 프로덕션 액세스 요청을 검토하세요.
이 판매자 프로필에는 이 기능에 대한 액세스 권한이 없습니다.
Google에서 Google Pay API를 사용하도록 웹사이트를 구성하지 않았습니다. Google Pay 및 월렛 콘솔을 통해 웹사이트의 Google Pay API 사용에 대한 검토를 요청하려면 프로덕션 액세스 요청을 검토하세요.
이 Google Pay API 통합이 사용 중지되었습니다. 자세한 내용은 Google에 문의하세요 (https://developers.google.com/pay/api/faq#how-to-get-support).
Google에 문의하여 Google 계정에서 Google Pay API를 다시 사용 설정하는 데 필요한 단계를 자세히 알아보세요.
도메인 'example.com'이 이 API를 사용하도록 등록되어 있지 않습니다.
결제가 호스팅되는 도메인이 사용 중인 merchantId과 연결되어 있지 않습니다. merchantId 매개변수가 올바르고 도메인이 Google Pay 및 월렛 콘솔을 통해 등록되었는지 확인합니다.
Google Pay API는 보안 컨텍스트에서 호출해야 합니다.
Google Pay API는 보안 컨텍스트의 웹사이트에서만 사용할 수 있습니다. 자세한 내용은 보안 컨텍스트를 참고하세요.
이 판매자 프로필에 대한 키가 없습니다.
DIRECTtokenizationSpecification type 통합을 완료하려면 Google Pay 및 월렛 콘솔을 통해 공개 암호화 키를 Google에 등록해야 합니다.

merchantId

통합 중에 merchantId와 관련된 다음 오류가 발생할 수 있습니다. 이 목록에서는 이러한 오류가 발생할 경우 도움이 되는 문제 해결 조언을 제공합니다.

merchantId를 설정해야 합니다.
PaymentDataRequest 내의 merchantId 매개변수는 Google Pay 및 월렛 콘솔을 사용하여 제공된 값으로 설정해야 합니다. merchantId 파라미터는 PRODUCTION 환경에 맞게 구성된 PaymentsClient를 사용하는 경우에만 필요합니다. 통합 체크리스트를 검토하여 웹사이트의 Google Pay API 사용에 대한 검토를 요청하고 merchantId를 받으세요.
merchantId가 문자열이 아님
PaymentDataRequest 내부의 merchantId 매개변수는 항상 문자열이어야 합니다. API를 호출하기 전에 사용하는 merchantId 매개변수의 유형이 문자열인지 확인합니다.
merchantId가 등록되지 않았습니다.
PaymentDataRequest 내의 merchantId 매개변수는 Google Pay 및 월렛 콘솔을 통해 프로비저닝해야 합니다. 자세한 내용은 프로덕션 액세스 요청을 참고하세요.

게이트웨이 유효성

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

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

객체 유효성

통합 중에 객체 유효성과 관련된 다음 오류가 발생할 수 있습니다. 이 목록에서는 이러한 오류가 발생할 경우 도움이 되는 문제 해결 조언을 제공합니다.

Google Pay의 PaymentDataRequest가 유효한 JSON이 아님
loadPaymentData에 제공된 매개변수는 항상 유효한 PaymentDataRequest 객체여야 합니다.
transactionInfo를 설정해야 합니다.
PaymentDataRequest 내부의 transactionInfo 매개변수는 항상 유효한 TransactionInfo 객체여야 합니다.

직접 판매자

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

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

오류 객체

오류 객체는 클라이언트 자바스크립트 메소드의 거부된 프라미스에서 반환하는 객체입니다.

PaymentsError
이 객체에는 클라이언트 JavaScript 메서드에서 반환하는 오류에 대한 세부정보가 포함됩니다. 사용자에게 표시되는 대화상자에는 오류가 표시되지 않을 수 있습니다.
속성 유형 설명
statusCode 문자열 오류 유형을 설명하는 짧은 코드입니다.
statusMessage 문자열 발생한 오류와 가능한 해결 단계를 설명하는 메시지로 개발자에게 직접 표시됩니다.
일반적인 오류
이 객체는 모든 JavaScript 메서드에서 발생할 수 있는 오류를 표시합니다. 개발자 콘솔에서 추가 오류 메시지를 확인하세요.
상태 코드 설명
BUYER_ACCOUNT_ERROR 현재 Google 사용자는 결제 정보를 제공할 수 없습니다.
DEVELOPER_ERROR

전달된 매개변수의 형식이 잘못되었습니다. 구성한 모든 환경에 대한 오류 메시지가 브라우저 콘솔에 표시될 수 있습니다.
MERCHANT_ACCOUNT_ERROR

Google Pay API에 액세스하는 사이트에 적절한 권한이 없습니다. 구성이 잘못되었거나 요청에 잘못된 판매자 ID가 설정되었을 수 있습니다. 자세한 내용은 statusMessage 필드를 확인하세요. 문제가 계속되면 지원팀에 문의하세요.
INTERNAL_ERROR 일반적인 서버 오류입니다.

CardInfo

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

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

Google Pay 결제 버튼이 무기한 로드되는 이유는 무엇인가요?
onLoad 이벤트 리스너를 삭제하지 마세요. onLoad 이벤트 리스너를 삭제하면 Google Pay 결제 버튼이 무한정 로드될 수 있습니다.
Google Pay 결제 버튼을 클릭한 후 결제 메시지가 표시되지 않는 이유는 무엇인가요?
이벤트 리스너 콜백을 ButtonOptions.onClick 이벤트에 할당합니다.

오류 OR_BIBED_15개

통합 중에 OR_BIBED_15 오류가 발생할 수 있습니다. 이 목록은 이 오류가 발생할 경우 도움이 될 수 있는 문제 해결 조언을 제공합니다.

WebView 작업
Android 및 iOS 가이드에 따라 통합이 WebView와 호환되는지 확인합니다.
Cross-Origin-Opener-Policy HTTP 응답 헤더
Cross-Origin-Opener-Policy HTTP 응답 헤더가 same-origin로 설정된 경우 브라우저에서 사용자가 거래를 완료하는 데 필요한 팝업을 열지 못할 수 있습니다. 이러한 문제를 줄이려면 헤더 값을 same-origin-allow-popups로 변경해 보세요.
사용자의 클릭 이벤트와 loadPaymentData() 호출 간의 지연
Google Pay 버튼 (또는 유사한 결제 버튼)을 클릭한 후 loadPaymentData() 호출 전까지 지연이 발생하면 (예: setTimeout(), 추가 네트워크 호출 또는 유사한 장기 실행 로직) 브라우저의 팝업 차단 메커니즘이 트리거될 수 있습니다. 사용자의 클릭과 loadPaymentData() 호출 사이에 지연이 설정되지 않는 것이 좋습니다.