개요
VibeFox PayFast Pay Gateway는 남아프리카공화국 랜드(ZAR) 결제를 위해 PayFast를 PrestaShop에 추가합니다. 결제 단계에서 고객이 PayFast를 선택하면 서명된 결제 양식과 함께 PayFast의 안전한 결제 페이지로 이동하며, 카드, Instant EFT 또는 PayFast 계정의 다른 결제 수단으로 결제합니다. 이후 PayFast는 서버 간 알림(ITN)으로 쇼핑몰에 결제를 확인합니다. 주문은 이 알림이 모든 검사를 통과한 후에만 생성되므로, 결제를 완료하지 않은 경우 미결제 주문이 남지 않습니다.
자체 사이트에 카드 양식을 두지 않고 PayFast의 호스팅 결제 페이지를 사용하려는 남아프리카 쇼핑몰에 적합합니다. 이 모듈은 ZAR 단건 결제만 받습니다. 주문 페이지에서의 환불은 지원하지 않으며(환불은 PayFast 대시보드에서 진행), 구독, 저장된 카드, 분할 결제도 지원하지 않습니다.
주요 기능
서명된 결제 양식: 결제 양식은 PayFast의 공식 알고리즘에 따라 패스프레이즈로 서명됩니다.
검증된 알림: 모든 ITN은 서명, 가맹점 계정, 결제 시도의 토큰, PayFast와의 서버 간 확인, 그리고 라이브 모드에서는 PayFast 서버에서 보낸 알림인지 여부를 검사합니다.
금액 확인: 결제된 금액을 센트 단위로 장바구니 합계와 비교하며, 장바구니는 ZAR이어야 합니다. 불일치하면 메모와 함께 PayFast payment on hold 상태로 주문이 생성됩니다.
중복 처리 방지: 반복된 알림이 두 번째 주문을 만들거나 결제를 두 번 기록하지 않습니다. 늦게 도착한 실패 또는 대기 알림은 결제 완료된 주문을 낮추지 않으며, 취소된 주문에 대한 결제는 검토를 위해 표시됩니다.
라이브 및 샌드박스: 모드별로 별도의 자격 증명을 사용합니다. 각 알림은 결제를 시작한 모드의 자격 증명으로 검사하며, 쇼핑몰이 라이브 상태인 동안에는 샌드박스 결제가 주문을 결제 완료 처리하지 않습니다.
사용할 수 없을 때 숨김: 자격 증명이 없는 경우, 장바구니 통화가 ZAR이 아닌 경우, 또는 합계가 PayFast 최소 금액인 R5.00 미만인 경우.
PayFast에서 설정할 것 없음: 알림 URL은 모든 결제와 함께 전송되며 설정 페이지에도 표시됩니다.
주문 페이지의 PayFast 블록: 결제 참조 번호, PayFast 결제 ID, 모드, 총액·수수료·순액, 모듈 메모. 선택 사항인 디버그 로그.
요구 사항
PrestaShop 8.0~9.x, PHP 8.0 이상. 쇼핑몰 통화로 남아프리카공화국 랜드(ZAR). 가맹점 ID(Merchant ID), 가맹점 키(Merchant Key), 패스프레이즈가 있는 PayFast 계정과 테스트용 샌드박스 자격 증명. 인터넷에서 접근 가능한 사이트. vibefox.net에서 구매한 VibeFox 라이선스 키(도메인당 키 하나).