개요
VibeFox SimplePay Gateway는 헝가리 결제 서비스 SimplePay를 통한 카드 결제를 PrestaShop에 추가합니다. SimplePay v2 API에 연결됩니다. 결제 단계에서 고객은 SimplePay를 선택하고, SimplePay 결제 페이지로 이동하여 카드로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 SimplePay가 결제를 확인한 후에만 생성되므로, 중간에 취소된 결제로 인해 미결제 주문이 남지 않습니다.
HUF, EUR 또는 USD로 판매하고 SimplePay 가맹점 계정을 보유한 쇼핑몰에 적합합니다. 모듈은 일회성 카드 결제만 받습니다. 저장된 카드나 원클릭 결제, 구독 또는 정기 결제는 지원하지 않으며, 승인과 캡처를 분리하는 기능도 없습니다. SimplePay 가맹점 관리자에서 한 환불은 자동으로 동기화되지 않습니다.
주요 기능
통화별 계정 1개: HUF, EUR, USD용 MERCHANT 및 SECRET KEY, 운영 및 샌드박스. 결제 수단은 현재 모드에 계정이 있는 장바구니 통화에 대해서만 제공됩니다. HUF 금액은 정수 포린트로 전송됩니다.
SimplePay 확인 시에만 결제 완료: 주문은 서명된 SimplePay IPN을 받은 후, 또는 고객이 성공 결과와 함께 돌아왔을 때 서명된 상태 조회를 한 후에 생성됩니다. 고객이 단순히 돌아온 것만으로는 주문이 결제되지 않습니다.
서명된 요청: SimplePay로 보내는 모든 요청은 서명되며, SimplePay의 응답은 검증됩니다. 서명이 잘못된 IPN은 거부됩니다.
금액 및 통화 확인: 결제 시작 후 장바구니가 바뀌었다면, 주문은 결제 완료로 표시되지 않고 메모와 함께 SimplePay payment on hold 상태가 됩니다.
중복 처리 방지: 반복되거나 동시에 들어온 IPN과 복귀는 주문을 두 개 만들지 않습니다. 재시도마다 고유한 SimplePay 참조 번호가 부여되며, 이전 시도의 늦은 결제도 계속 인식됩니다.
주문 페이지에서 환불: 주문의 SimplePay payment 블록에서 전액 및 부분 환불이 가능하며, 항상 결제 당시의 가맹점 계정과 모드(샌드박스 또는 운영)로 처리됩니다. 전액 환불 시 주문은 Refunded 상태가 됩니다.
SimplePay가 요구하는 메시지: 주문 확인 페이지에 SimplePay 거래 ID를 표시하고, 체크아웃에서는 실패, 취소, 시간 초과된 결제에 대한 SimplePay 메시지를 표시합니다.
주문 페이지의 SimplePay 블록: 거래, 장바구니의 결제 시도 내역, 환불 내역과 메모를 보여줍니다. 키나 고객 데이터를 포함하지 않는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 판매하는 통화(HUF, EUR 또는 USD)의 SimplePay 가맹점 계정(MERCHANT 및 SECRET KEY). vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).