지원센터 - 개인 계정

PayPal 결제 링크 및 버튼 문제 해결 팁

오류가 발생했으며 웹사이트에 버튼이 표시되지 않습니다.

  1. 인터넷 연결이 작동하는지 확인합니다.
  2. 웹사이트의 다른 페이지를 방문하여 제대로 로드되는지 확인합니다.
  3. PayPal 버튼 페이지로 이동하여 다음을 확인합니다.
    * 버튼이 ‘저장된 버튼’ 아래에 표시되나요?
    * 편집을 선택하고 해당 버튼 코드가 웹사이트상의 코드와 일치하는지 확인합니다.
  4. 제품 페이지(버튼 코드를 붙여넣은 곳)를 마우스 오른쪽 버튼으로 클릭하고 검사를 클릭합니다. 콘솔 탭으로 이동합니다(상단에 표시됨). CSP 오류가 표시될 수 있습니다. 콘텐츠 보안 정책을 배포한 경우, 다음과 같은 CSP 오류가 표시될 수 있습니다(샘플 CSP 오류).

  • 콘텐츠 보안 정책 지시문 "default-src 'self'"를 위반하므로 'https://www.paypal.com/sdk/js**' 스크립트 로드가 거부되었습니다. 'script-src-elem'은 명시적으로 설정되지 않았으므로 'default-src'가 대신 사용됩니다.
  • 콘텐츠 보안 정책 지시문 "default-src 'self'"를 위반하므로 'https://www.paypal.com/**' 접속이 거부되었습니다. 'connect-src'는 명시적으로 설정되지 않았으므로 'default-src'가 대신 사용됩니다.
  • 콘텐츠 보안 정책 지시문 "script-src https://*.paypal.com"을 위반하므로 인라인 스크립트 실행이 거부되었습니다. 인라인 실행을 위해서는 'unsafe-inline' 키워드, 해시('sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=') 또는 nonce('nonce-...')가 필요합니다.
  • 콘텐츠 보안 정책 지시문 "default-src 'self'"를 위반하므로 이미지 'https://tracking.qa.paypal.com/webapps/tracking/ts?**' 로드가 거부되었습니다. 'img-src'는 명시적으로 설정되지 않았으므로 'default-src'가 대신 사용됩니다.
  • 콘텐츠 보안 정책 지시문 "default-src 'self'"를 위반하므로 'https://www.paypal.com/' 프레임 작업이 거부되었습니다. 'frame-src'는 명시적으로 설정되지 않았으므로 'default-src'가 대신 사용됩니다.

위의 오류를 해결하기 위해 아래 사항을 추가해 볼 수 있습니다.

옵션-1(HTML): CSP가 HTML 파일로 구성되어 있다면 아래 코드를 사용하여 CSP 코드를 바꿉니다.

<meta http-equiv="Content-Security-Policy" content="default-src 'self';
script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com;
style-src 'unsafe-inline' https://*.paypal.com; connect-src
https://*.paypal.com; frame-src https://*.paypal.com; img-src
https://*.paypal.com https://*.paypalobjects.com">

옵션-2(서버 측): CSP가 서버 측에 구성되어 있다면 아래의 코드를 사용하여 CSP 코드를 대체합니다.

Content-Security-Policy: script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com
Content-Security-Policy: style-src 'unsafe-inline' https://*.paypal.com
Content-Security-Policy: connect-src https://*.paypal.com
Content-Security-Policy: frame-src https://*.paypal.com
Content-Security-Policy: img-src https://*.paypal.com https://*.paypalobjects.com

상품 이름/가격/수량의 레이아웃/크기/색상은 어떻게 변경하나요?

PayPal 웹사이트에서 상품 이름/가격/수량의 레이아웃/크기/색상을 변경하는 방법은 다음과 같습니다.

  1. PayPal 버튼 페이지로 이동합니다.
  2. 저장된 버튼 옆에 있는 열기를 클릭하고 편집을 선택합니다.
  3. 버튼 맞춤 설정을 클릭하고 필요한 사항을 변경합니다.

제품 정보(이름, 금액 등)를 편집했습니다.

버튼 코드를 다시 복사/붙여넣기해야 하나요?

아니요, PayPal 서버에서 모든 정보를 가져옵니다. 계정에 변경 사항을 저장한 후에는 웹사이트의 복사/붙여넣기 버튼 ID를 업데이트할 필요가 없습니다. 

참고: 상품의 통화 코드를 변경하는 경우, 결제 버튼을 업데이트해야 합니다.

코드에 클라이언트 ID가 표시됩니다. 무슨 뜻인가요?

클라이언트 ID는 계정에 포함된 판매자 클라이언트 ID입니다. 편집하지 마세요. 버튼 코드에 제공된 대로 사용하세요.

여러 버튼을 추가했지만 웹 페이지에 표시되지 않습니다.

동일한 웹페이지의 여러 버튼은 다음 시나리오에서 작동하지 않습니다.

  • 동일한 웹페이지에서 동일한 버튼 ID를 여러 번 복사/붙여넣기하면 첫 번째 버튼만 표시됩니다. 동일한 버튼 ID를 여러 번 반복할 수 없습니다.
  • 동일한 웹페이지에서 다른 통화로 서로 다른 버튼 ID를 복사/붙여넣기하면 첫 번째 버튼만 표시됩니다. 동일한 웹페이지의 버튼에 외국 통화를 추가할 수 없습니다.
  • 서로 다른 버튼 ID를 복사/붙여넣기했는데 처리 속도가 느려진다면, 클라이언트 ID가 있는 스크립트 태그가 한 번만 추가되었는지 확인하세요. 스크립트 줄은 다음과 같습니다.

    • <script src="https://www.paypal.com/sdk/js?client-id=XYZ&components=hosted-buttons&enable-funding=venmo&currency=USD"></script> 

프리미어 PayPal 계정이 있는데 결제 링크와 버튼이

옵션으로 표시되지 않습니다.

이 기능은 비즈니스 PayPal 계정에서만 사용할 수 있습니다. 이 기능을 사용하려면 업그레이드하거나 비즈니스 계정을 생성하세요.

PayPal Sandbox에서 이 환경을 테스트하려면 어떻게 해야 하나요?

결제 링크와 버튼은 Sandbox에서 테스트할 수 있습니다.

제 고객이 일부 결제수단이 표시되지 않는다고 문의했습니다.

PayPal, Pay Later, Venmo 등의 결제수단은 각 고객의 국가 자격 요건에 따라 표시 여부가 좌우됩니다.

신용/직불카드 인라인 확장이 웹사이트에서 완전히 표시되지

않습니다.

상위 컨테이너 너비와 높이가 인라인 확장을 수용하도록 설정되어 있는지 확인하세요. 자세한 내용은 호스팅 플랫폼 문서/지원을 참조하세요.

결제 링크와 버튼이 IPN(즉시 결제 알림)을 지원하나요?

네. IPN을 설정하고 사용하려면 다음 단계를 따르세요.

PayPal에서 IPN 설정을 찾는 방법은 다음과 같습니다.

  1. 계정 설정으로 이동합니다.
  2. 알림을 선택하고 즉시 결제 알림을 선택합니다.
  3. 링크 업데이트를 클릭합니다.

IPN 설정을 사용 설정하는 방법은 다음과 같습니다.

  1. IPN 핸들러 URL을 추가하고 IPN 메시지 수신(활성화됨)을 선택합니다.
  2. 저장을 클릭합니다.

서버 코드에서 IPN 처리:

  • 결제 링크와 버튼 트랜잭션이 완료될 때마다 PayPal IPN이 2단계에서 구성한 알림 URL을 호출합니다.

IPN 기록에 액세스:

참조

소개: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/

서버 코드에 올바른 IPN URL을 사용해야 함

다양한 언어 샘플 GitHub - paypal/ipn-code-samples

고객을 리디렉션 페이지로 보내면 PayPal은 구매에 관해

어떤 정보를 보내나요? 결제 링크와 버튼으로 결제 데이터 전송을 할 수 있나요?

지원되는 변수는 무엇인가요?

예, 여기에 서술되어 있는 바와 같이 PayPal은 결제 데이터 전송 변수를 지원합니다. 결제 링크 및 버튼을 구성하는 중에 자동 돌아가기 설정을 켜면 결제 데이터 전송이 이루어집니다. 

판매자가 버튼 코드나 결제 링크에 로캘을 수동으로 추가한 경우

결제 링크와 버튼으로 결제 시 해당 로캘이 지원되나요?

기본적으로, 결제 링크와 버튼은 고객의 브라우저 기본설정을 이용해 버튼 코드와 결제 링크 경험을 표시합니다.

판매자가 결제 링크와 버튼 코드에 대해서만 이런 설정을 재정의하려면 쿼리 매개변수로 “locale.x=fr_FR and country.x=”를 덧붙이면 됩니다. 지원되는 로케일 코드 목록은 여기에서 확인할 수 있습니다. 판매자가 구성 중에 입력한 모든 텍스트는 변환되지 않습니다.

예: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=ja_JP&country.x=JP

예: 

<script src="……..¤cy=USD&locale.x=ja_JP&country.x=JP"></script> 

결제 링크와 버튼 코드에 속하는 라벨 중 몇 개를

숨길 수 있나요?

웹사이트에 다른 시각적 설정이 있을 수도 있지만, PayPal에서 제공하는 버튼 코드를 숨기지 않는 것이 좋습니다. 

웹사이트에서 이 코드를 숨기더라도 거래 처리 방식은 변경되지 않습니다. 거래에서는 여전히 호스팅된 버튼 ID 구성을 사용합니다. 

고객 입력이 필요 없는 버튼 유형을 사용하는 경우라면 버튼 주위의 특정 텍스트나 모든 텍스트를 숨길 수 있습니다. 예를 들어 고객이 수량을 선택해야 하거나 복수 항목 선택 목록을 선택해야 하는데 그러한 입력 요소를 숨긴 경우, 거래가 실패합니다. 

상품 가격을 숨기는 방법 예시:

버튼 코드 아래에 이 스크립트를 추가하고 <HostedButton_ID>를 실제 버튼 id로 대체합니다.

<style>  

#paypal-form-fields-container-{<HostedButton_ID>}

#price-label { 

display: none !important;  

}  

}  

</style> 

상품 가격을 숨기는 것과 마찬가지로 다른 텍스트에도 같은 작업을 할 수 있습니다.

  • desc-label(제품 이름의 경우)
  • price-label(가격의 경우)

여러 항목을 숨기고자 하는 경우, 다음과 같이 구분된 ID를 사용합니다.

style> #paypal-container-

{ #paypal-form-fields-container-

{ #price-label,  #desc-label { display: none !important; }} }

버튼 주변의 모든 텍스트를 숨기고자 하는 경우, 버튼 유형이 고객의 선택이나 입력이 필요 없는 유형이어야 한다는 점에 유의하세요.

<style>

#paypal-container-<HostedButton_ID>

{

                #paypal-form-fields-container-<HostedButton_ID>

                {

                                display: none !important;

                }

}

</style>

결제 링크와 버튼을 재정의하여 ‘설정의

배송’을 사용할 수 있나요?

결제 링크와 버튼을 통해 결제하면 계정 설정에서 지정한 배송 일괄 재정의(배송 설정에서는 다음과 같은 설정으로 알려져 있음)가 적용되지 않습니다.

image

버튼의 통화를 변경했는데 웹사이트에 업데이트된 내용이 표시되지

않습니다.

버튼의 통화를 이미 웹사이트에 붙여넣은 이후 통화를 변경하는 경우, 웹사이트에 버튼 코드를 다시 한번 복사해 붙여넣어야 합니다. 

“배송 주소 수집 안 함”을 선택할 때 “설정의 배송 사용”과 “설정의 세금

사용”을 선택할 수 없습니다.

설정의 배송 및 세금은 고객 배송지 우편번호 및/또는 국가에 따라 다릅니다. “배송 주소 수집 안 함”을 선택하면 설정에서 고객의 배송 주소를 받아 배송료와 세금을 계산할 수 없게 됩니다. “배송료”와 “세율” 드롭다운에서 다른 옵션을 사용하는 것이 좋습니다.

결제 링크와 버튼이 웹훅을 지원하나요?

네. 웹훅을 활성화하는 방법은 다음과 같습니다.

  1. 판매자 계정 자격증명을 사용해 Developer 대시보드에 로그인합니다.
  2. 활성화로 전환합니다.
  3.  앱 및 자격증명을 클릭합니다.
  4. 스크롤을 내려 웹훅 관리를 선택합니다.
  5. 이제 활성 항목에 웹훅 URL을 추가할 수 있습니다. Sandbox용 웹훅을 추가하고자 하는 경우, 이 페이지를 유지한 채 오른쪽 상단에서 활성에서 Sandbox로 전환합니다.
  6. 웹훅 콜백 URL을 추가하고, 모든 이벤트 또는 결제 이벤트를 선택하세요. PayPal은 선택된 이벤트 발생 시, 사용자의 NVP 또는 SOAP API 구현 호출에 따라 웹훅 정보를 위한 PayPal NVP/SOAP API를 통해 알려드립니다.

샘플 웹훅 응답:

"id": "WH-12D11567VE3425924-2G120938U32719946", 
 "event_version": "1.0", 
 "create_time": "2024-09-14T15:55:58.043Z", 
 "resource_type": "capture", 
 "resource_version": "2.0", 
 "event_type": "PAYMENT.CAPTURE.COMPLETED", 
 "summary": "Payment completed for $ 128.88 USD", 
 "resource": { 
 "supplementary_data": { 
 "related_ids": { 
 "order_id": "8LM68409BR5528307" 
 } 
 ], 
 "id": "7KK30254642170736", 
 "status": "COMPLETED" 

관련 주제

PayPal이 도울 수 있는 다양한 방법

분쟁해결센터

거래 및 계정 관련 문제 해결

세금 센터

여기에서 1099-K 및 기타 세금 정보를 확인하세요.

비즈니스 지원

PayPal 제품 사용에 대해 도움을 받으세요.

메시지 센터

PayPal 메시지 보내기, 받기 및 보기

사용자가 쿠키 사용에 동의하면 PayPal은 쿠키를 사용하여 사용자의 경험을 개선하고 맞춤설정하며 사용자가 다른 사이트를 방문할 때 파트너사에서 개인 맞춤형 PayPal 광고를 표시할 수 있도록 합니다. 쿠키 관리 및 자세히 알아보기