개요
VibeFox Barion Gateway는 헝가리 결제 업체 Barion을 통한 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Barion을 선택하고, 안전한 Barion 결제 페이지(Barion Smart Gateway)로 이동하여 Barion 상점에서 제공하는 방법(카드, Barion Wallet, Apple Pay 또는 Google Pay)으로 결제합니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 Barion이 결제를 확인한 후에만 생성되므로, 중간에 포기된 결제가 미결제 주문으로 남지 않습니다.
이 모듈은 HUF, EUR, USD 또는 CZK로 판매하고 Barion 상점이 있는 헝가리 및 인근 지역의 쇼핑몰에 적합합니다. 모듈은 즉시 결제만 처리합니다. 예약 결제, 지연 캡처 결제, 구독 또는 정기 결제, 저장된 카드, Barion Pixel은 지원하지 않습니다.
주요 기능
Barion 결제 페이지: 장바구니 통화로 장바구니 합계에 대해 Barion 결제가 시작되며, 상품, 배송비, 선물 포장, 세금이 목록에 표시됩니다. HUF 금액은 소수점 없이 전송됩니다.
Barion이 확인한 후에만 결제 처리: Barion 콜백은 서명되지 않으므로, 모듈은 콜백이나 고객의 반환 자체만으로는 신뢰하지 않습니다. 주문이 생성되거나 변경되기 전에 항상 POSKey를 사용해 Barion에 결제 상태를 확인합니다.
금액 및 통화 검증: Barion이 보고한 금액과 통화를 장바구니와 비교합니다. 불일치하면 주문이 메모와 함께 Barion payment on hold 상태가 됩니다.
중복 처리 방지: 반복된 콜백과 고객의 반환이 같은 순간에 발생하더라도 주문은 하나만 생성되고 결제는 한 번만 기록됩니다. 이미 결제된 주문에 두 번째 성공 결제가 들어오면 메모로 표시됩니다.
안전한 재시도: 시작된 모든 결제가 기록됩니다. 이전 시도의 뒤늦은 결제도 주문을 생성하며, 만료된 이전 시도는 주문을 취소하지 않습니다.
테스트 및 운영 모드: 모드마다 별도의 POSKey와 수취인 이메일을 사용합니다. 콜백과 환불은 항상 결제가 이루어진 모드를 사용합니다.
주문 페이지에서 환불: 주문의 Barion payment 블록에서 전액 또는 부분 환불이 가능합니다. 전액 환불 시 주문은 Refunded 상태가 됩니다.
원하는 주문 상태 선택: 결제 성공 후 Payment accepted 또는 Delivered로 설정할 수 있습니다. Barion에서 아직 처리 중인 결제는 Awaiting Barion payment 상태로 대기합니다. POSKey가 기록되지 않는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. POSKey와 Barion Wallet 이메일 주소가 있는 Barion 상점. 장바구니 통화는 HUF, EUR, USD 또는 CZK. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 1개).