개요
VibeFox Hubtel Pay Gateway는 가나에서의 Hubtel 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객이 Hubtel을 선택하면 안전한 Hubtel Online Checkout 페이지로 이동하여 MTN MoMo, Telecel Cash, AirtelTigo Money, Visa 또는 Mastercard 카드 또는 GhQR로 결제한 후 쇼핑몰로 돌아옵니다. 주문은 Hubtel이 결제를 확인한 후에만 생성되므로, 결제를 중단한 경우 미결제 주문이 남지 않습니다.
가나 세디(GHS)로 판매하고 Hubtel 비즈니스 계정을 보유한 가나 쇼핑몰에 적합합니다. Hubtel의 Transaction Status API를 사용하려면 웹 서버의 IP 주소가 Hubtel에 의해 화이트리스트에 등록되어야 합니다. 또한 Hubtel에는 공개 테스트 환경이 없으므로 모든 결제는 실제 거래로 진행됩니다. 이 모듈은 PrestaShop을 통한 환불, 정기 구독, 카드 저장 및 쇼핑몰 내 결제 채널 선택을 지원하지 않습니다.
주요 기능
Hubtel 호스팅 결제 페이지: Hubtel 페이지에서의 Mobile Money 및 카드 결제. 고객이 해당 페이지에서 직접 결제 채널을 선택합니다.
Hubtel 확인 시에만 결제 완료 처리: Hubtel 콜백은 서명되지 않으므로 모듈은 콜백을 신뢰하지 않습니다. 인증된 Hubtel Transaction Status API를 조회하여, Hubtel이 정확한 GHS 장바구니 총액에 대해 "Paid"로 보고한 경우에만 주문을 결제 완료 상태로 생성합니다.
금액 확인: 금액이 다르면 쇼핑몰 관리자를 위한 메모와 함께 주문을 Hubtel payment on hold 상태로 전환합니다.
Hubtel 측 설정 불필요: 콜백 URL은 모든 결제와 함께 전송됩니다.
유실된 콜백 보호: 고객이 쇼핑몰로 돌아올 때 결제를 확인하고, cron URL을 통해 백그라운드 재확인이 실행되며, 쇼핑몰 관리자는 주문 페이지에서 Check Hubtel payment status를 클릭할 수도 있습니다.
이중 처리 방지: 모든 결제 시도에는 고유한 참조 번호가 부여됩니다. 반복된 콜백으로 주문이 두 번 생성되거나 취소 또는 환불된 주문이 다시 열리지 않습니다. 이미 결제된 장바구니에 대해 두 번째 결제가 발생하면 환불 대상으로 표시됩니다.
Hubtel에서의 취소: 고객은 안내 메시지와 함께 체크아웃으로 돌아가 다시 결제를 시도할 수 있습니다. 장바구니는 유지됩니다.
주문 페이지의 Hubtel 블록: 주문의 모든 결제 시도와 각 Hubtel 상태 및 거래 정보, 그리고 Hubtel 메모를 표시합니다. API 키나 고객 데이터를 포함하지 않는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, cURL 확장이 포함된 PHP 8.0 이상. API ID, API Key 및 가맹점 계정 번호(POS Sales ID)가 있는 Hubtel 비즈니스 계정과 Hubtel에 화이트리스트로 등록된 서버 IP. 쇼핑몰 통화는 가나 세디(GHS). 백그라운드 확인을 위해 서버 cron 설정을 권장합니다. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 1개).