개요
VibeFox Pesapal Pay Gateway는 PrestaShop에 Pesapal 결제를 추가합니다. Pesapal API 3.0에 연결합니다. 결제 단계에서 고객은 Pesapal을 선택하고 Pesapal 결제 페이지로 이동하여 M-Pesa, Airtel Money, MTN, 카드, 은행 또는 고객의 국가에서 Pesapal이 제공하는 다른 방법으로 결제합니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 Pesapal이 결제를 확인한 후에만 생성되므로, 중단된 결제로 인해 미결제 주문이 남지 않습니다.
KES, UGX, TZS, ZMW, RWF 또는 USD로 판매하고 Pesapal 가맹점 계정이 있는 케냐, 우간다, 탄자니아, 르완다, 잠비아, 말라위, 짐바브웨의 쇼핑몰에 적합합니다. 필요한 것은 소비자 키와 소비자 시크릿뿐입니다. 이 모듈은 주문 페이지에서의 환불(Pesapal 대시보드에서 환불), 저장된 카드, 구독 또는 정기 결제, 자체 사이트의 결제 양식, 통화 변환을 지원하지 않습니다.
주요 기능
Pesapal이 확인한 경우에만 결제 완료: Pesapal 알림과 고객의 복귀 요청에는 결제 데이터가 포함되지 않으므로 모듈은 이를 신뢰하지 않습니다. 매번 인증된 서버 간 요청으로 Pesapal에 거래 상태를 조회합니다.
금액 및 통화 확인: Pesapal이 결제 완료를 보고하고, 결제된 금액과 통화가 장바구니와 일치하는 경우에만 주문이 결제 완료로 표시됩니다. 불일치하면 주문이 메모와 함께 Pesapal payment on hold 상태가 됩니다.
자동 IPN 설정: 첫 결제 시 알림 URL이 Pesapal에 등록되며, 샌드박스와 운영 환경에 각각 등록됩니다. Pesapal 대시보드에서 따로 설정할 필요가 없습니다.
중복 처리 방지: 반복된 알림이나 고객의 복귀와 동시에 도착한 알림으로 두 번째 주문이 생성되지 않습니다. 취소되거나 환불된 주문은 다시 열리지 않으며, 이미 결제된 주문에 대한 두 번째 결제는 환불 대상으로 표시됩니다.
모든 시도 기록: 같은 장바구니의 이전 Pesapal 페이지(예: 브라우저의 두 번째 탭)에서 이루어진 결제도 인식됩니다.
샌드박스 및 운영 모드: 모드마다 별도의 키를 사용합니다. 결제는 항상 시작된 모드에서 확인됩니다.
결제 취소: Pesapal이 결제가 취소되었다고 보고하면, 결제 완료된 주문은 Refunded 상태로 변경됩니다.
주문 페이지의 Pesapal 결제 블록: 추적 ID, 가맹점 참조 번호, 모드, Pesapal 상태, 결제 방법, 확인 코드, 모든 결제 시도 및 메모를 표시합니다. 키, 토큰, 고객 데이터가 없는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 소비자 키와 소비자 시크릿이 있는 Pesapal 가맹점 계정(샌드박스 및/또는 운영). 결제 알림을 받으려면 쇼핑몰이 인터넷에서 접근 가능해야 합니다. 장바구니 통화: KES, UGX, TZS, ZMW, RWF 또는 USD. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 하나).