개요
VibeFox PayPal Gateway는 OpenCart 3 및 OpenCart 4 체크아웃에 PayPal 스마트 결제 버튼(PayPal Smart Payment Buttons)을 추가합니다. Confirm Order 단계에서 고객이 PayPal 버튼을 클릭하고, PayPal 창에서 PayPal 계정 또는 PayPal이 제공하는 다른 결제 수단으로 결제를 승인하면 쇼핑몰에서 주문이 완료됩니다. 서버는 PayPal 주문을 읽어 상태, 금액, 통화를 확인한 후에야 결제를 캡처하거나 승인합니다. OpenCart는 결제 전에 주문을 만들지만, 주문은 PayPal이 응답한 후에야 상태를 얻으므로 결제되지 않은 시도는 누락된 주문으로 남습니다.
자체 PayPal REST API 앱으로 PayPal 결제를 받으려는 쇼핑몰에 적합합니다. 테스트는 샌드박스에서, 실제 결제는 운영 모드에서 진행합니다. 이 확장 기능에는 PayPal 웹훅이 없으므로 PayPal 계정에서 이루어진 분쟁과 환불은 OpenCart와 동기화되지 않습니다. Pay Later 메시지, 카드 입력란, Venmo, Apple Pay, Google Pay, 저장된 결제 수단 또는 구독은 지원하지 않으며, 상품 페이지나 장바구니 페이지에는 PayPal 버튼이 표시되지 않습니다.
주요 기능
서버 측 검증: 어떤 금액도 청구되기 전에 PayPal 주문의 상태, 금액, 통화, 소유권을 확인합니다. 금액은 항상 서버에서 계산됩니다. 승인 후 주문 합계가 바뀌었다면 아무것도 캡처되지 않으며, 고객은 새 합계를 승인해야 합니다.
캡처 또는 승인: 고객에게 즉시 청구하거나, 금액만 예약해 두었다가 나중에 주문 탭에서 캡처하거나 무효화할 수 있습니다.
이중 청구 방지: 하나의 결제는 하나의 장바구니에만 적용되며, 캡처 요청은 멱등성을 가집니다. 응답이 유실된 뒤 PayPal이 완료한 이전 시도가 있으면 새 시도 대신 그 결제를 사용합니다. 장바구니 잠금으로 중복 제출도 막습니다.
대기 중인 캡처: PayPal 검토 중인 캡처는 귀사의 결제 대기 상태를 받습니다. Check PayPal payment status로 다시 확인할 수 있습니다.
주문 페이지에서 환불: 주문의 VibeFox PayPal Gateway 탭에서 전액 및 부분 환불을 할 수 있으며, PayPal이 실제로 청구한 금액까지 환불됩니다. 환불은 결제가 이루어진 PayPal 환경(샌드박스 또는 운영)으로 전송됩니다.
PayPal 24개 통화: HUF, JPY, TWD 금액은 PayPal의 요구에 따라 소수점 없이 전송됩니다. 지원되지 않는 통화에서는 결제 방법이 숨겨집니다.
자체 주문 상태: 결제 완료, 대기 중, 승인됨, 보류됨, 무효화됨, 환불됨, 실패한 결제 각각에 대해 OpenCart 상태를 선택할 수 있습니다.
OpenCart 조건: 지역 구역, 최소 주문 금액 및 정렬 순서. 인증 정보나 고객 데이터가 포함되지 않는 로그.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드에 두 버전용 패키지가 모두 포함됩니다. 샌드박스 및/또는 운영용 REST API 앱(Client ID와 Secret)이 있는 PayPal Business 계정. PayPal이 지원하는 쇼핑몰 통화. vibefox.net에서 구입한 VibeFox 라이선스 키(도메인당 키 하나).