개요
VibeFox HyperPay Payment Gateway는 HyperPay의 COPYandPAY 위젯을 통한 카드 결제를 WooCommerce에 추가합니다. 주문 후 고객은 주문 결제 페이지에서 HyperPay 결제 위젯을 보고, 그곳에서 VISA, Mastercard, mada, American Express, STC Pay 또는 Apple Pay로 결제합니다. 카드 정보는 HyperPay 위젯에만 입력되며 쇼핑몰 서버에는 전달되지 않습니다.
HyperPay 가맹점 계정을 보유한 사우디아라비아, 아랍에미리트, 요르단, 바레인, 오만, 카타르, 이집트 및 기타 MENA 시장의 쇼핑몰에 적합합니다. 이 플러그인은 WooCommerce에서의 환불이나 무효화(HyperPay 대시보드에서 처리), 카드 저장, 구독, Apple Pay 도메인 인증, 브랜드별 개별 Entity ID, Tabby·Tamara 등 후불결제(buy now, pay later) 방식은 지원하지 않습니다.
주요 기능
HyperPay 위젯: 주문 결제 페이지의 COPYandPAY 위젯이며, Subresource Integrity로 로드되고 쇼핑몰 언어로 표시됩니다. 표시할 브랜드는 직접 선택합니다.
HyperPay 확인 시에만 결제 완료: 고객이 돌아왔을 때의 서버 간 상태 조회와, 브라우저가 닫힌 경우의 암호화된 웹훅(AES-256-GCM)으로 확인합니다. 반환 URL만으로는 주문이 결제 완료로 표시되지 않습니다.
주문과 대조 확인: 결제는 해당 주문의 HyperPay 결제 세션에 속해야 하며, 금액과 통화가 주문과 일치해야 합니다. 일치하지 않으면 주문은 메모와 함께 보류 상태가 됩니다.
이중 처리 방지: 각 결과는 한 번만 적용됩니다. 중복 웹훅이나 페이지 새로고침은 메모, 이메일, 재고 변경을 추가하지 않습니다. 중복 결제, 취소 후 결제, 역분개(reversal)는 주문에 기록됩니다.
즉시 청구 또는 사전 승인: 즉시 청구하거나, 금액을 예약해 두고 나중에 주문 작업 Capture HyperPay payment로 캡처합니다.
테스트와 운영: 모드별로 별도의 Access Token, Entity ID, 웹훅 키를 사용합니다. 결제, 캡처, 웹훅은 항상 결제 세션이 생성된 모드로 처리됩니다.
명확한 메시지: 거절되었거나 완료되지 않았거나 확인되지 않은 결제는 주문 결제 페이지에서 고객에게 설명됩니다.
최신 WooCommerce 지원: 클래식 체크아웃, 장바구니 및 체크아웃 블록, 주문 결제 페이지, HPOS를 지원합니다. 카드 정보, 키, 고객 데이터를 제외하고 로그를 기록합니다. 아랍어 번역 포함.
요구 사항
WordPress 6.0 이상, WooCommerce 8.0 이상, PHP 8.0 이상. Access Token과 Entity ID(테스트 및 운영)가 있는 HyperPay 가맹점 계정, 그리고 복호화 키가 있는 결제 웹훅. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).