개요
VibeFox HyperPay Payment Gateway는 HyperPay COPYandPAY 위젯을 통한 카드 결제를 OpenCart 3과 OpenCart 4에 추가합니다. 고객이 Confirm Order를 클릭하면 쇼핑몰의 결제 페이지에 HyperPay 위젯이 표시되며, 고객은 그곳에서 VISA, Mastercard, mada, American Express, STC Pay 또는 Apple Pay로 결제합니다. 카드 정보는 HyperPay 위젯에서만 입력되며 쇼핑몰 서버를 거치지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 HyperPay가 결제를 확인한 후에야 상태를 받습니다. 따라서 중단되었거나 거절된 결제는 누락된 주문으로 남습니다.
HyperPay 가맹점 계정을 보유한 사우디아라비아, 아랍에미리트, 요르단, 바레인, 오만, 카타르, 이집트 및 기타 MENA 시장의 쇼핑몰에 적합합니다. 이 확장 프로그램은 OpenCart에서의 환불이나 무효화(HyperPay 대시보드에서 처리), 카드 저장, 구독, Apple Pay 도메인 인증, 브랜드별 별도 법인, 후불 결제(buy now, pay later) 방식을 지원하지 않습니다.
주요 기능
HyperPay 위젯: 결제 페이지의 COPYandPAY 위젯으로, Subresource Integrity를 사용해 로드되며 HyperPay가 지원하는 경우 고객의 언어로 표시됩니다. 표시할 카드 브랜드를 선택할 수 있습니다.
HyperPay가 확인한 경우에만 결제 완료: 고객이 돌아올 때 서버 간 상태 조회로, 브라우저를 닫은 경우에는 암호화된 웹훅(AES-256-GCM)으로 확인합니다. 반환 URL만으로는 주문이 결제 완료로 표시되지 않습니다. 이후 OpenCart가 일반적인 주문 이메일을 발송합니다.
주문과 대조 확인: 결제는 해당 주문 자체의 체크아웃 중 하나에 속해야 하며, 금액과 통화가 일치해야 합니다. 불일치하면 주문은 메모가 포함된 검토 상태가 됩니다.
중복 처리 방지: 각 결과는 한 번만 적용됩니다. 반복된 웹훅이나 페이지 새로고침으로 결제가 두 번 처리되지 않으며, 다른 주문으로 이미 결제된 장바구니에는 다시 청구되지 않습니다. 중복 결제, 취소 후 결제, 결제 취소는 주문에 기록됩니다.
즉시 청구 또는 사전 승인: 즉시 청구하거나 금액을 예약해 두었다가 나중에 주문 페이지의 탭에서 Capture payment로 캡처할 수 있습니다.
테스트 및 실서비스: 모드별로 별도의 Access Token, Entity ID, 웹훅 키를 사용합니다. 상태 조회, 캡처, 웹훅은 항상 체크아웃이 생성된 모드를 사용합니다.
자체 주문 상태: 결제 완료, 승인됨, 대기 중, 보류 중, 취소됨, 환불됨 결제에 대해 사용할 OpenCart 상태를 선택할 수 있습니다.
OpenCart 조건: 지역(Geo Zone), 최소 주문 금액, 정렬 순서. 카드 정보, 키 또는 고객 데이터 없이 로그를 기록합니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), OpenSSL 확장을 포함한 PHP 8.0 이상. 다운로드 파일에는 두 버전용 패키지가 들어 있습니다. Access Token과 Entity ID(테스트 및 실서비스)가 있는 HyperPay 가맹점 계정과 복호화 키가 있는 결제 웹훅. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 하나).