개요
VibeFox Flow Gateway는 칠레용 Flow.cl 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Flow를 선택하고 Flow 결제 페이지로 이동하여 쇼핑몰의 Flow 계정에서 활성화된 방법(Webpay, 신용카드 또는 체크카드, 계좌 이체, Servipag, Multicaja, Mach 등)으로 결제한 뒤 쇼핑몰로 돌아옵니다. 주문은 Flow가 결제를 확인한 후에만 생성됩니다.
칠레 페소(CLP) 또는 미국 달러(USD)로 판매하며 Flow 계정이 있는 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 받습니다. 저장된 카드, 구독, 정기 청구 또는 결제 링크는 지원하지 않으며, 특정 Flow 결제 방법을 미리 선택하지 않습니다(고객이 Flow 페이지에서 선택). Flow 대시보드에서 생성된 환불은 PrestaShop으로 가져오지 않습니다.
주요 기능
Flow 결제 페이지: 장바구니 통화로 장바구니 총액에 대한 결제를 생성하며, CLP는 정수 페소, USD는 소수점 이하 두 자리로 처리합니다. Flow 계정에서 별도로 설정할 필요가 없습니다.
Flow 확인 시에만 결제 완료: 모든 확인 알림과 고객 복귀는 Flow에 보내는 서명된 상태 요청으로 검증하며, 금액과 통화를 장바구니와 대조합니다. 불일치하면 주문이 Flow payment on hold 상태가 됩니다.
장바구니에 연결된 결제: 결제 시도마다 고유한 참조, 토큰 및 환경이 있으므로 다른 장바구니나 다른 쇼핑몰에 대한 결제로 이 장바구니를 결제할 수 없습니다.
중복 처리 방지: 확인 알림과 복귀가 반복되어도 두 번째 주문이 생성되지 않으며 결제가 두 번 기록되지 않습니다. 환불된 주문은 다시 열리지 않으며, 중복 결제는 표시됩니다.
현금 결제 쿠폰: 고객이 Servipag 또는 Multicaja 쿠폰을 생성하면 Flow가 결제를 확인할 때까지 주문은 Awaiting Flow payment 상태가 됩니다.
주문 페이지에서 환불: 주문의 Flow payment 블록에서 전액 및 부분 환불이 가능하며, Flow가 실제로 청구한 금액까지만 환불할 수 있습니다. Flow가 보고한 환불 상태 변경은 메모에 기록됩니다.
샌드박스 및 운영 환경: 모드별로 별도의 키를 사용합니다. 확인 알림과 환불은 항상 결제가 이루어진 환경을 사용합니다.
주문 페이지의 Flow 블록: 결제, 환불 내역 및 Flow 메모. 키나 고객 데이터가 없는 선택적 로그.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. API Key와 Secret Key가 있는 Flow 계정(테스트용 별도 샌드박스 계정 포함). 장바구니 통화는 CLP 또는 USD. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).