개요
VibeFox IntaSend Pay Gateway는 케냐와 동아프리카의 쇼핑몰을 위해 IntaSend 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 IntaSend를 선택하고, IntaSend가 호스팅하는 체크아웃 페이지로 이동하여 M-Pesa, 카드 또는 IntaSend 계정에서 활성화된 다른 방법으로 결제한 뒤 쇼핑몰로 돌아옵니다. 주문은 IntaSend가 결제를 확인한 후에만 생성되므로, 중단된 결제로 미결제 주문이 남지 않습니다.
자체 사이트에 결제 양식 없이 IntaSend 계정으로 M-Pesa와 카드를 받고 싶은 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 받습니다. 환불은 쇼핑몰에서 IntaSend로 전송되지 않으며, 저장된 카드, 구독, 인라인(팝업) 결제 양식은 지원하지 않습니다.
주요 기능
IntaSend 호스팅 체크아웃: 장바구니 금액과 장바구니 통화로 체크아웃이 생성됩니다. 지원 통화: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF, XOF. UGX, XAF, XOF는 소수점 없이 전송됩니다.
IntaSend 확인 시에만 결제 완료: 쇼핑몰 서버가 비밀 키로 IntaSend Payment Status API를 조회한 후에만 주문이 생성됩니다. 브라우저나 웹훅 본문으로 전송된 내용은 신뢰하지 않습니다.
챌린지가 있는 웹훅: 고객이 브라우저를 닫았거나 M-Pesa 확인이 늦어져도 결제가 확인됩니다. 챌린지가 잘못된 웹훅은 거부됩니다.
금액 및 통화 확인: IntaSend가 보고한 금액과 통화를 장바구니와 비교합니다. 불일치하거나 부분 결제인 경우 메모와 함께 주문이 IntaSend payment on hold 상태가 됩니다.
이중 처리 없음: 고객의 복귀와 웹훅이 동시에 도착해도 결제는 한 번만 적용되므로, 같은 장바구니에 대해 두 번째 주문이 생기는 일은 없습니다. 이미 결제된 장바구니에 대한 두 번째 결제는 메모로 표시됩니다.
샌드박스 및 운영 모드: 모드별로 별도의 키 쌍을 사용합니다. 현재 모드의 키가 없거나 다른 모드의 키이면 결제 수단이 숨겨집니다. 이전 결제는 항상 결제가 이루어진 모드에서 확인됩니다.
명확한 메시지: 결제가 실패하거나 중단된 후 메시지가 표시되며, M-Pesa 확인이 진행 중인 동안에는 Check again 버튼이 있는 “확인 중” 페이지가 표시됩니다.
주문 페이지의 IntaSend 블록: 주문의 체크아웃 시도 내역과 처리된 IntaSend 인보이스를 보여줍니다. 키나 고객 데이터 없이 기록되는 로그.
요구 사항
PrestaShop 8.0 ~ 9.x, cURL을 포함한 PHP 8.0 이상. 공개(publishable) API 키와 비밀(secret) API 키가 있는 IntaSend 계정, 그리고 챌린지 문구가 있는 웹훅. 운영 결제에는 HTTPS가 필요합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).
