개요
VibeFox Stripe Gateway는 Stripe Checkout을 통한 카드 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객이 Stripe를 선택하면 Stripe가 호스팅하는 결제 페이지로 이동하여 신용카드 또는 체크카드로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 Stripe가 결제를 확인한 후에만 생성되므로, 중단된 결제로 인해 미결제 주문이 남지 않습니다.
자체 사이트에 카드 양식을 만들지 않고 Stripe 계정으로 카드를 받고 싶은 쇼핑몰에 적합합니다. 이 모듈은 카드 일회성 결제만 지원합니다. 저장된 카드, 구독, 사이트 내 카드 양식, 사이트의 Apple Pay 또는 Google Pay 버튼, 승인과 매입의 분리는 지원하지 않습니다.
주요 기능
Stripe Checkout: 장바구니 금액에 대해 장바구니 통화로 결제 세션이 생성됩니다. JPY, KRW처럼 소수점이 없는 통화와 KWD, BHD처럼 소수점 셋째 자리까지 쓰는 통화도 포함됩니다.
Stripe가 확인한 경우에만 결제 완료: 주문은 서명된 Stripe 웹훅을 받은 후, 또는 고객이 쇼핑몰로 돌아올 때 서버 측에서 결제를 확인한 후에 생성됩니다. 웹훅이 누락되어도 결제된 주문이 사라지지 않습니다.
금액 및 통화 확인: Stripe가 보고한 금액과 통화를 장바구니와 비교합니다. 일치하지 않으면 주문이 메모와 함께 Stripe payment on hold 상태가 됩니다.
이중 처리 방지: 반복 전송되는 웹훅과 복귀로 두 번째 주문이 만들어지거나 결제가 두 번 기록되지 않습니다. 새 결제 시도는 이전 Stripe 세션을 닫으므로, 고객이 같은 장바구니를 두 번 결제할 수 없습니다.
테스트 모드와 라이브 모드: 모드별로 별도의 비밀 키와 웹훅 시크릿을 사용합니다. 테스트 결제가 실제 결제를 확인하는 일은 없으며, 환불은 항상 결제가 이루어진 모드로 처리됩니다.
주문 페이지에서 환불: 주문의 Stripe payment 블록에서 전액 및 부분 환불이 가능합니다. 전액 환불 시 주문은 Refunded 상태가 됩니다. Stripe Dashboard에서 진행된 환불은 주문에 메모로 기록됩니다.
원하는 주문 상태 선택: 결제 성공 후 수동 검토를 위해 Payment accepted, Delivered 또는 Stripe payment on hold 중에서 선택할 수 있습니다.
주문 페이지의 Stripe 블록: Stripe Dashboard 링크가 있는 결제 정보, 환불 이력과 메모. 키나 고객 데이터를 포함하지 않는 선택형 로그를 사용할 수 있습니다.
요구 사항
PrestaShop 8.0~9.x, PHP 8.0 이상. 비밀 API 키와 웹훅 엔드포인트가 있는 Stripe 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).