개요
VibeFox Hubtel Pay Gateway는 가나의 Hubtel 결제를 OpenCart 3 및 OpenCart 4에 추가합니다. 고객은 마지막 체크아웃 단계에서 Confirm Order를 클릭하고, 안전한 Hubtel Online Checkout 페이지로 이동하여 MTN MoMo, Telecel Cash, AirtelTigo Money, Visa 또는 Mastercard 카드, 또는 GhQR로 결제한 뒤 쇼핑몰로 돌아옵니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Hubtel이 결제를 확인한 후에야 상태를 받습니다. 따라서 결제되지 않은 시도는 누락된 주문으로 남습니다.
가나 세디(GHS)로 판매하고 Hubtel 비즈니스 계정을 보유한 가나의 쇼핑몰에 적합합니다. Hubtel은 Transaction Status API에 대해 웹 서버의 IP 주소를 허용 목록에 등록해야 합니다. Hubtel에는 공개 테스트 환경이 없으므로 모든 결제는 실제 결제입니다. 이 확장 기능은 OpenCart에서의 환불, 구독, 저장된 카드, 쇼핑몰 내 결제 채널 선택을 지원하지 않습니다.
주요 기능
호스팅된 Hubtel 결제 페이지: Hubtel 페이지에서 모바일 머니 및 카드 결제를 진행합니다. 고객은 그곳에서 결제 채널을 선택합니다.
Hubtel이 확인한 경우에만 결제 완료: Hubtel 콜백에는 서명이 없으므로 이 확장 기능은 콜백을 절대 신뢰하지 않습니다. 인증된 Hubtel Transaction Status API를 조회하고, Hubtel이 GHS 기준 정확한 주문 금액에 대해 Paid라고 보고한 경우에만 주문을 결제 완료로 표시합니다. 그 후 OpenCart는 평소와 같은 주문 이메일을 보냅니다.
금액 확인: 금액이 다르면 주문은 선택한 검토 상태로 옮겨지고 메모가 추가됩니다.
Hubtel에서 설정할 것 없음: 콜백 URL은 모든 결제와 함께 전송됩니다.
누락된 콜백 대비: 고객이 돌아올 때 결제를 확인하고, cron URL이 백그라운드에서 재확인을 실행하며, 주문 페이지에서 Check Hubtel payment status를 클릭할 수도 있습니다.
중복 처리 방지: 모든 결제 시도에는 고유한 참조 번호가 있습니다. 반복되는 콜백이 같은 결제를 두 번 적용하거나 취소된 주문을 다시 열지 않습니다. 새 시도 전에, 같은 장바구니의 이전 미확인 시도가 Hubtel을 통해 확인되며, 이미 결제된 주문에 대한 두 번째 결제는 환불 대상으로 표시됩니다.
주문 페이지의 Hubtel 탭: 주문의 모든 결제 시도를 Hubtel 상태 및 거래와 함께 표시하고, Hubtel 메모도 함께 보여줍니다.
OpenCart 조건: 지역, 최소 주문 금액, 정렬 순서, 그리고 사용자 지정 주문 상태. API 키나 고객 데이터가 없는 선택적 로그.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), cURL 확장 기능이 포함된 PHP 8.0 이상. 하나의 다운로드에 두 버전용 패키지가 모두 들어 있습니다. API ID, API Key, 가맹점 계정 번호(POS Sales ID)가 있는 Hubtel 비즈니스 계정, 그리고 Hubtel에 허용 목록으로 등록된 서버 IP 주소. 주문 통화는 가나 세디(GHS). 백그라운드 점검을 위해 서버 cron을 권장합니다. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 하나).
