개요
VibeFox Ozow Pay는 남아프리카 랜드(ZAR) 결제를 위해 Ozow 즉시 이체(Pay by Bank)를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Ozow를 선택하고, Ozow가 호스팅하는 결제 페이지로 이동하여 남아프리카 은행을 고른 뒤, 뱅킹 앱에서 결제를 승인하고 쇼핑몰로 돌아옵니다. Ozow는 쇼핑몰에도 직접 알림을 보내므로, 고객이 브라우저를 닫더라도 결제가 확인됩니다. 주문은 Ozow가 결제를 보고한 후에만 생성되므로, 중간에 포기된 결제가 미결제 주문을 남기지 않습니다.
카드 수수료 없이, 카드 입력 양식 없이 은행 결제를 받고 싶은 남아프리카 쇼핑몰에 적합합니다. 이 모듈은 ZAR 단건 결제만 받습니다. PrestaShop에서의 환불은 지원하지 않으며(환불은 Ozow 가맹점 대시보드에서 처리합니다), 구독, 저장된 은행 계정, 백오피스에서의 결제 링크 발송 기능도 없습니다.
주요 기능
Ozow 호스팅 결제 페이지: 고객은 Ozow 페이지에서 결제합니다. 장바구니 합계에 대한 결제 요청은 귀하의 Private Key(Ozow HashCheck, SHA-512)로 서명됩니다.
Ozow가 확인한 경우에만 결제 완료: Ozow 응답은 SHA-512 해시가 귀하의 Private Key로 검증되고, Site Code가 귀하의 것이며, 해당 장바구니의 이번 결제 시도에 속하는 경우에만 받아들여집니다.
선택적 API 확인: API Key를 입력하면, 성공한 모든 결제는 주문이 결제 완료로 표시되기 전에 Ozow GetTransaction API로도 확인됩니다.
금액 및 통화 확인: 결제된 금액(센트 단위)과 통화를 장바구니와 비교합니다. 불일치하면 메모와 함께 Ozow payment on hold 상태로 주문이 생성됩니다.
중복 처리 방지: 알림과 고객의 복귀는 장바구니별 잠금 아래에서 동일한 방식으로 처리되므로, 반복 요청이 두 번째 주문이나 중복 메모를 만들지 않습니다. 취소되었거나 환불된 주문은 다시 열리지 않습니다.
Test mode: 같은 Site Code와 키로 테스트 결제를 할 수 있습니다. 모듈이 실제 운영 중일 때 테스트 결제가 주문을 결제 완료로 만드는 일은 없습니다. 백오피스, 체크아웃, 주문 메시지에 경고가 표시됩니다.
취소된 결제: 취소되었거나 실패한 결제는 주문을 생성하지 않습니다. 고객은 같은 장바구니 상태로 체크아웃에 돌아가며, 다시 시도하라는 메시지를 봅니다.
주문 페이지의 Ozow 블록: 거래 참조, Ozow 거래 ID, 상태, 금액. 키, 해시 또는 고객 데이터를 포함하지 않는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 쇼핑몰 통화는 남아프리카 랜드(ZAR)여야 합니다. Site Code와 Private Key가 있는 Ozow 가맹점 계정(API Key는 선택 사항). vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 1개).