VibeFox PayPal for WooCommerce — 도움말

요구 사항

WordPress: 6.0 이상.

WooCommerce: 7.0 이상, 설치 및 활성화되어 있어야 합니다. WooCommerce가 없으면 플러그인이 활성화되지 않습니다.

PHP: 8.0 이상.

HTTPS: 운영 환경에서 결제를 받으려면 사이트가 HTTPS를 사용해야 합니다.

PayPal 계정: PayPal Developer Dashboard에 REST API 앱이 있는 PayPal Business 계정. 앱의 Client ID와 Secret이 필요합니다. 샌드박스 앱과 운영 앱은 인증 정보가 다릅니다. 웹훅은 필요하지 않습니다. 플러그인은 고객이 체크아웃 페이지에 있는 동안 서버에서 각 결제를 확인합니다.

통화: PayPal이 지원하는 통화 중 하나: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD 또는 USD.

VibeFox 라이선스 키: vibefox.net에서 구입합니다. 키 하나는 도메인 하나에서 사용할 수 있습니다.

설치

1. WordPress에서 Plugins > Add New > Upload Plugin으로 이동하여 플러그인 ZIP 파일을 선택한 뒤 Install Now를 클릭합니다. FTP로 wcp_paypal_gateway 폴더를 /wp-content/plugins/에 업로드할 수도 있습니다.

2. Activate를 클릭합니다.

3. PayPal Developer Dashboard에서 REST API 앱(샌드박스 및/또는 운영)을 만들고 Client ID와 Secret을 복사합니다.

4. 설정을 엽니다: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage. 또는 플러그인 목록 페이지에서 플러그인 이름 아래의 Settings를 클릭합니다.

5. 페이지 상단의 라이선스 영역에 VibeFox 라이선스 키를 입력하고 Activate를 클릭합니다.

6. 사용할 모드의 인증 정보를 입력하고, Capture 또는 Authorize를 선택한 뒤, Enable/Disable을 켜고 저장합니다.

7. PayPal 샌드박스 구매자 계정으로 테스트한 다음, Sandbox mode의 선택을 해제하고 운영 인증 정보를 입력합니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Payments > PayPal (Smart Buttons). 결제 수단은 켜져 있지만 선택한 모드의 Client ID나 Secret이 비어 있거나, PayPal이 쇼핑몰 통화를 지원하지 않는 경우 페이지는 입력란 위에 경고를 표시합니다. 두 경우 모두 결제 수단은 체크아웃에서 숨겨집니다. 결제 수단 목록에서 PayPal은 샌드박스 모드일 때 Test mode 배지를 표시하며, 선택한 모드의 인증 정보를 입력하기 전까지 설정이 필요한 것으로 표시됩니다.

일반

Enable/Disable: Enable PayPal Gateway로 결제 수단을 켜거나 끕니다. 기본값: off.

Title: 체크아웃에서 고객에게 보이는 결제 수단 이름. 기본값: PayPal.

Description: 체크아웃에서 결제 수단 아래에 표시되는 텍스트. 기본값: Pay with your PayPal account or a card via PayPal.

API 인증 정보

PayPal Developer Dashboard에서 REST API 앱을 만들고 Client ID와 Secret을 복사합니다. 이 섹션에는 샌드박스 앱과 운영 앱으로 이동하는 링크가 있습니다. 선택한 모드의 입력란만 표시됩니다.

Sandbox mode: Enable sandbox (test) mode. 결제는 샌드박스 인증 정보로 PayPal 샌드박스에 전달되며, 실제 돈은 이동하지 않습니다. 기본값: on. 실제 결제를 받으려면 선택을 해제합니다.

Sandbox Client ID: 샌드박스 REST API 앱의 Client ID.

Sandbox Secret: 샌드박스 REST API 앱의 Secret.

Live Client ID: 운영 REST API 앱의 Client ID.

Live Secret: 운영 REST API 앱의 Secret.

결제

Payment action: 고객이 결제를 승인했을 때 일어나는 동작. 기본값: Capture.

고급

Debug log: Log API requests (errors are always logged). 항목은 WooCommerce > Status > Logs에 소스 wcp_paypal_gateway로 저장됩니다. 인증 정보와 구매자 데이터는 기록되지 않습니다. 기본값: off.

Delete data on uninstall: Delete the gateway settings when the plugin is deleted. 주문의 결제 데이터(주문에 저장된 PayPal ID)는 항상 보관됩니다. 기본값: off.

체크아웃

고객이 PayPal(기본값은 PayPal)을 선택하면 PayPal 버튼이 Place order 버튼을 대신합니다. 샌드박스 모드에서 체크아웃에는 샌드박스 모드: PayPal 샌드박스 구매자 계정으로 결제하십시오. 실제 금액은 청구되지 않습니다. 메시지가 표시됩니다. 버튼을 클릭하면 서버가 장바구니 합계(또는 Pay for order 페이지의 주문 합계)에 대한 PayPal 주문을 만듭니다. 금액은 항상 서버에서 계산되며, 브라우저에서 계산되지 않습니다.

고객은 PayPal 창에서 PayPal 계정 또는 PayPal이 제공하는 다른 결제 수단으로 결제를 승인합니다. 그러면 체크아웃에 PayPal 결제가 승인되었습니다. 주문을 완료하는 중…이 표시되고 주문이 제출됩니다. 서버는 PayPal 주문을 읽어 승인되었는지, 이 체크아웃에서 생성되었는지, 다른 주문에서 사용되지 않았는지, 금액과 통화가 주문과 일치하는지 확인합니다. 그 후에만 결제가 캡처(또는 승인)되고, 고객은 주문 접수 페이지로 이동합니다.

승인 후 장바구니 합계가 바뀌면 아무것도 캡처되지 않습니다. 고객에게는 PayPal에서 결제를 승인한 후 주문 금액이 변경되었습니다. 새 금액을 승인하려면 PayPal 버튼을 다시 클릭하십시오.가 표시됩니다. 체크아웃 항목이 누락된 경우 승인은 유지되며, 수정 후 고객이 Place order를 클릭하면 결제가 완료됩니다. PayPal이 결제를 거부하면 고객은 PayPal 버튼을 클릭하고 다른 결제 방법을 선택하라는 안내를 받습니다. 고객이 PayPal 창을 닫으면 체크아웃에 PayPal 결제를 취소했습니다.가 표시됩니다.

캡처 중에 PayPal이 응답하지 않으면 고객에게는 아직 PayPal 결제를 확인할 수 없습니다. 잠시 후 다시 시도하십시오. 이중으로 청구되지 않습니다.가 표시됩니다. 재시도는 같은 승인을 사용하며, PayPal이 이전 시도를 완료했다면 그 결제가 사용되고 새 승인은 캡처되지 않습니다.

이 결제 수단은 클래식 체크아웃, 체크아웃 블록, Pay for order 페이지에서 작동합니다. PayPal 스크립트는 자체 네임스페이스로 로드되므로 페이지의 다른 PayPal 플러그인과 충돌하지 않습니다. WooCommerce 고성능 주문 저장소(HPOS)와 호환됩니다.

이 플러그인에는 PayPal 웹훅, Pay Later 메시지, 카드 입력란, Venmo 설정, Apple Pay, Google Pay 또는 Fastlane, 저장된 결제 수단이나 구독, 상품 페이지 및 장바구니 페이지의 버튼이 없습니다. PayPal의 주소가 아니라 WooCommerce 체크아웃에 입력된 배송 주소가 사용됩니다.

주문 및 환불

Order statuses

Pending payment: 주문은 생성되었지만 결제가 아직 캡처되지 않았습니다. 예를 들어 PayPal에서 알 수 없는 응답을 받은 후입니다.

Processing: 캡처가 완료되었습니다. 다운로드 가능한 가상 상품만 포함된 주문은 WooCommerce 기본값인 완료 상태가 됩니다. 주문 메모에는 금액, PayPal 주문, 캡처가 표시됩니다. 거래 ID는 PayPal 캡처 ID이며, 주문 화면에서는 PayPal 계정의 결제(샌드박스 또는 운영)로 연결됩니다.

On hold: 결제가 승인되어 캡처를 기다리고 있습니다(결제 작업 Authorize). 또는 결제 검토 등으로 PayPal에서 캡처가 PENDING 상태입니다. 또는 결제된 금액이나 통화가 주문과 다릅니다. 또는 PayPal 응답에서 결제 정보를 읽을 수 없었습니다. 주문 메모에 이유가 설명되어 있습니다.

Failed: PayPal이 캡처 또는 승인을 거부했습니다.

Cancelled: Void PayPal authorization으로 승인이 무효화되었습니다.

주문 작업

주문을 열고 Order actions에서 작업을 선택한 다음 화살표를 클릭합니다.

환불

주문을 열고 Refund를 클릭한 다음 금액을 입력하고 Refund via PayPal을 클릭합니다(버튼에는 결제 수단의 제목이 표시됩니다). 전액 환불과 부분 환불을 지원합니다. 환불은 결제가 이루어진 PayPal 환경(샌드박스 또는 운영)으로 전송되므로, 해당 환경의 인증 정보가 설정되어 있어야 합니다. 환불 사유는 구매자용 메모로 PayPal에 전달됩니다. PayPal이 환불을 거부하면 WooCommerce에 오류가 표시되고 환불은 기록되지 않습니다. 성공한 환불은 PayPal 환불 ID와 상태와 함께 주문 메모에 추가되며, PENDING 상태의 환불은 나중에 PayPal이 완료합니다.

승인만 된 결제는 환불할 수 없습니다. 대신 Void PayPal authorization을 사용하십시오. PayPal 계정에서 이루어진 환불, 분쟁, 취소는 WooCommerce와 동기화되지 않습니다.

라이선스 키

이 플러그인은 vibefox.net에서 발급받은 VibeFox 라이선스 키로 작동합니다. 라이선스 영역은 WooCommerce > Settings > Payments > PayPal (Smart Buttons) 상단에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭합니다. 이 영역에는 라이선스 만료일, 도메인 등 상태가 표시됩니다. Check now로 상태를 다시 확인하고, Change key로 다른 키를 입력하고, Remove key로 이 사이트에서 키를 제거합니다. Manage licenses and domains in your account 링크는 vibefox.net 계정을 엽니다.

키 하나는 도메인 하나에서 사용할 수 있습니다. 사이트에서 키를 제거해도 도메인 슬롯은 해제되지 않습니다. vibefox.net 계정에서 슬롯을 해제하십시오.

활성 키가 없으면 PayPal은 체크아웃에서 고객에게 표시되지 않습니다. 그래도 결제가 시작되면 고객에게 This payment method is not available. Please choose another one.가 표시됩니다. 로그인한 쇼핑몰 관리자에게는 (unlicensed — visible to admins only) 표시와 함께 결제 수단이 계속 보이므로, 키를 구매하기 전에 플러그인을 설정하고 테스트할 수 있습니다. 플러그인 목록 페이지와 WooCommerce 페이지에 알림이 표시됩니다. 기존 주문에는 영향이 없습니다. 환불과 주문 작업은 계속 작동합니다.

라이선스가 만료되어도 플러그인은 계속 작동하지만, 업데이트와 지원에는 갱신이 필요합니다. 상태는 백그라운드에서 자동으로 다시 확인됩니다.

문제 해결

체크아웃에 PayPal이 나타나지 않음:라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 선택한 모드의 Client ID와 Secret이 입력되어 있는지, 쇼핑몰 통화를 PayPal이 지원하는지, 장바구니 합계가 0보다 큰지 확인하십시오. 인증 정보나 통화가 문제인 경우 설정 페이지에 경고가 표시됩니다. www.paypal.com을 차단하는 브라우저 확장 프로그램도 버튼을 숨깁니다.

결제는 되었지만 주문이 결제 대기 상태로 남아 있음:플러그인에는 웹훅이 없으므로 결제는 체크아웃 중에만 확인됩니다. 이는 캡처 중에 PayPal이 응답하지 않았을 때 발생합니다. 주문 메모를 확인하고, PayPal 계정에서 결제를 확인한 뒤 주문을 수동으로 완료하거나, 고객이 다시 시도하도록 하십시오. 재시도로 이중 청구되는 일은 없습니다.

PayPal을 지금 사용할 수 없음:인증 정보가 잘못되었거나 다른 모드의 인증 정보입니다. 올바른 앱의 Client ID와 Secret을 다시 복사하십시오.

PayPal 승인을 이 체크아웃과 연결할 수 없음:세션이 만료되는 등의 이유로 이 체크아웃 세션에서 PayPal 주문이 생성되지 않았습니다. 고객이 PayPal 버튼을 다시 클릭해야 합니다.

결제 후 주문이 보류 상태임:주문 메모를 읽어 보십시오. 결제가 승인되었다면 Capture PayPal payment로 캡처하십시오. 캡처가 PayPal에서 PENDING 상태라면 나중에 Check PayPal payment status를 사용하십시오. 결제된 금액이나 통화가 주문과 일치하지 않았을 수도 있습니다.

승인 캡처가 실패함:승인이 29일보다 오래되었거나 이미 무효화되었을 수 있습니다. 주문 메모에 PayPal 오류가 표시됩니다.

환불이 실패함:주문에 PayPal 캡처가 없거나(승인만 있음), 결제가 이루어진 환경의 인증 정보가 없습니다. 개발자는 wc_plg_supported_currencies 필터로 통화 목록을 변경할 수 있습니다.

라이선스 영역에 오류가 표시됨:영역에 표시된 메시지를 따르십시오. 예를 들어 키가 다른 도메인에서 이미 사용 중이라면 vibefox.net 계정에서 슬롯을 해제하고 Check now를 클릭하십시오. 사이트 주소가 바뀌었다면 Check now를 클릭하여 새 도메인에서 키를 활성화하십시오. 라이선스 서버에 연결할 수 없으면 플러그인은 마지막으로 확인된 상태로 계속 작동합니다.

제거

플러그인을 비활성화해도 모든 데이터는 유지됩니다. 제거하려면 Plugins 페이지에서 비활성화한 다음 삭제하십시오. 이 플러그인의 라이선스 키와 라이선스 상태는 항상 삭제됩니다. 게이트웨이 설정과 캐시된 PayPal 액세스 토큰은 Delete data on uninstall이 켜져 있을 때만 삭제됩니다. 그렇지 않으면 나중에 다시 설치할 때를 위해 남겨집니다. 기존 주문은 결제 메모, 거래 ID, PayPal ID를 유지합니다.

PayPal은 각 소유자의 상표입니다. 이 플러그인은 PayPal과 제휴하거나 PayPal의 승인을 받지 않았습니다.