개요
VibeFox PayPal Gateway는 PrestaShop 체크아웃에 PayPal 스마트 결제 버튼을 추가합니다. 결제 단계에서 고객은 PayPal을 선택하고 PayPal 버튼을 클릭한 뒤, PayPal 창에서 PayPal 계정 또는 PayPal이 제공하는 다른 결제 수단으로 결제를 승인하면 쇼핑몰에서 주문이 완료됩니다. 서버는 PayPal 주문을 읽고 상태, 금액, 통화를 확인한 뒤에만 결제를 캡처하거나 승인합니다. 주문은 PayPal이 응답한 후에만 생성됩니다.
자체 PayPal REST API 앱으로 PayPal 결제를 받으려는 쇼핑몰에 적합합니다. 테스트는 샌드박스에서, 실제 결제는 운영 모드에서 진행합니다. 이 모듈에는 PayPal 웹훅이 없으므로 PayPal 계정에서 처리된 분쟁과 환불은 PrestaShop과 동기화되지 않습니다. Pay Later 메시지, 카드 입력란, Venmo, Apple Pay 또는 Google Pay, 저장된 결제 수단이나 구독은 지원하지 않으며, 상품 페이지와 장바구니 페이지에는 PayPal 버튼이 표시되지 않습니다.
주요 기능
서버 측 검증:돈을 받기 전에 PayPal 주문의 상태, 금액, 통화, 소유권을 확인합니다. 하나의 PayPal 결제는 하나의 장바구니에만 사용할 수 있습니다. 승인 후 장바구니 합계가 바뀌면 아무것도 캡처되지 않으며, 고객은 새 합계를 승인해야 합니다.
캡처 또는 승인:고객에게 즉시 청구하거나, 금액만 예약해 두었다가 나중에 주문 화면의 PayPal 블록에서 캡처하거나 무효화할 수 있습니다.
이중 청구 방지:캡처 요청은 멱등성을 갖습니다. 응답이 유실된 뒤 PayPal이 완료한 이전 시도는 새로 만드는 대신 사용되며, 장바구니별 잠금으로 중복 전송을 막습니다.
보류 중인 캡처:PayPal이 검토 중인 캡처는 주문을 Awaiting PayPal payment 상태로 둡니다. Check PayPal payment status를 실행하면 상태를 다시 읽습니다.
주문 화면에서 환불:PayPal 블록에서 전액 및 부분 환불을 처리할 수 있으며, PayPal이 실제로 청구한 금액까지만 가능합니다. 환불은 결제가 이루어진 PayPal 환경(샌드박스 또는 운영)으로 전송됩니다.
PayPal 통화 24종:PayPal의 요구에 따라 HUF, JPY, TWD 금액은 소수점 없이 전송됩니다. 지원되지 않는 통화에서는 결제 수단이 숨겨집니다.
주문 화면의 PayPal 블록:PayPal 계정으로 연결되는 링크가 있는 캡처, 환불 이력, 모듈 메모를 제공합니다. 직원은 주문을 편집할 권한만 있으면 됩니다. 인증 정보나 고객 데이터가 없는 선택적 로그를 사용할 수 있습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 샌드박스 및/또는 운영용 REST API 앱(Client ID와 Secret)이 있는 PayPal Business 계정. PayPal이 지원하는 쇼핑몰 통화. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 하나).