개요
VibeFox Pesapal Pay Gateway는 OpenCart 3 및 OpenCart 4에 Pesapal 결제를 추가합니다. 이 확장 기능은 Pesapal API 3.0에 연결됩니다. 마지막 결제 단계에서 고객이 Confirm Order를 클릭하면 Pesapal 결제 페이지로 이동하며, 고객이 있는 국가에서 Pesapal이 제공하는 M-Pesa, Airtel Money, MTN, 카드, 계좌 이체 또는 기타 방법으로 결제합니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Pesapal이 결제를 확인한 후에야 상태를 받습니다. 따라서 결제되지 않은 시도는 누락 주문으로 남습니다.
KES, UGX, TZS, ZMW, RWF 또는 USD로 판매하고 Pesapal 가맹점 계정을 보유한 케냐, 우간다, 탄자니아, 르완다, 잠비아, 말라위, 짐바브웨의 쇼핑몰에 적합합니다. consumer key와 consumer secret만 있으면 됩니다. 이 확장 기능은 주문 페이지에서 환불하는 기능이 없고(환불은 Pesapal 대시보드에서 진행), 카드 저장, 구독이나 정기 결제, 자체 사이트의 결제 양식, 통화 환전을 지원하지 않습니다.
주요 기능
Pesapal이 확인한 경우에만 결제 완료: Pesapal의 알림과 고객의 복귀 요청에는 결제 데이터가 포함되지 않으므로 이 확장 기능은 이를 신뢰하지 않습니다. 매번 인증된 서버 간 요청으로 Pesapal에 거래 상태를 조회합니다. 그 후 OpenCart가 평소와 같이 주문 이메일을 발송합니다.
금액 및 통화 확인: Pesapal이 Completed를 보고하고, 결제된 금액과 통화가 주문과 일치할 때만 주문이 결제 완료로 표시됩니다. 불일치하면 주문은 메모가 달린 검토 상태로 이동합니다.
IPN 자동 설정: 알림 URL은 첫 결제 시 샌드박스와 운영 환경에 대해 각각 Pesapal에 등록됩니다. Pesapal 대시보드에서 따로 설정할 것은 없습니다.
중복 처리 방지: 반복된 알림이나 고객의 복귀와 함께 도착한 알림이 결제를 두 번 반영하는 일은 없습니다. 취소되거나 환불된 주문은 다시 열리지 않으며, 이미 결제된 주문이나 장바구니에 대한 두 번째 결제는 환불 대상으로 표시됩니다.
모든 시도 기록: 같은 장바구니의 이전 Pesapal 페이지(예: 두 번째 브라우저 탭)에서 이루어진 결제도 계속 인식되며, 새 시도는 먼저 이전 시도를 확인합니다.
샌드박스 및 운영 모드: 모드별로 별도의 키를 사용합니다. 결제는 항상 시작된 모드에서 확인됩니다.
나만의 주문 상태: 결제 완료 주문, 검토 중인 결제, 취소된 주문, 취소된 결제에 대해 OpenCart 상태를 선택할 수 있습니다. Pesapal이 취소된 것으로 보고한 결제는 결제 완료 주문을 Refunded로 설정합니다.
주문 페이지의 Pesapal 탭: 추적 ID, 가맹점 참조 번호, 모드, Pesapal 상태, 결제 방법, 확인 코드, 모든 결제 시도 및 메모. OpenCart의 지역 존, 최소 합계, 정렬 순서. 키, 토큰, 고객 데이터를 포함하지 않는 선택적 로그.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드 파일에 두 버전의 패키지가 모두 포함되어 있습니다. consumer key와 consumer secret이 있는 Pesapal 가맹점 계정(샌드박스 및/또는 운영). 결제 알림을 받으려면 쇼핑몰이 인터넷에서 접근 가능해야 합니다. 주문 통화: KES, UGX, TZS, ZMW, RWF 또는 USD. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).
