개요
VibeFox Peach Payments Pay Gateway는 PrestaShop에 Peach Payments 카드 결제를 추가합니다. Peach Payments Card API(COPYandPAY)에 연결됩니다. 결제 단계에서 고객은 카드 결제를 선택하고, 쇼핑몰의 결제 페이지에 있는 Peach Payments 결제 양식에 카드 정보를 입력합니다. 카드 데이터는 Peach Payments 양식에 입력되며 쇼핑몰 서버에 전달되지 않습니다. Visa, Mastercard, American Express, Diners Club을 지원합니다. 주문은 Peach Payments가 결제를 확인한 후에만 생성되므로, 중간에 멈춘 결제가 미결제 주문을 남기지 않습니다.
남아프리카 공화국, 케냐, 모리셔스에서 ZAR, KES 또는 MUR로 판매하며 Peach Payments 계정을 보유한 쇼핑몰에 적합합니다. 이 모듈은 PrestaShop 주문 페이지에서의 환불(Peach Payments 대시보드에서 환불), 저장된 카드, 구독, 사전 승인 및 캡처, EFT, BNPL, QR 등 카드 이외의 결제 수단을 지원하지 않습니다.
주요 기능
Peach Payments 확인 시에만 결제 완료: 브라우저 리디렉션만으로는 결제 완료 주문이 생성되지 않습니다. 고객이 돌아오면 쇼핑몰은 서버 간 통신으로 Peach Payments API에서 이 장바구니의 체크아웃 결과를 조회합니다.
암호화된 웹훅: Peach Payments Card 웹훅(AES-256-GCM)은 고객이 돌아오기 전에 브라우저를 닫아도 결제를 확인합니다. 장바구니가 처리 중이면 웹훅에 임시 오류를 응답하고 Peach Payments가 재전송합니다.
금액 및 통화 확인: 모든 결제를 장바구니와 대조합니다. 일치하지 않으면 결제 완료로 표시하는 대신, 메모와 함께 Peach Payments payment on hold 상태로 설정합니다.
중복 처리 방지: 반복 웹훅, 페이지 새로고침, 고객 복귀와 동시에 도착한 웹훅은 두 번째 주문을 만들지 않으며 결제를 두 번 기록하지 않습니다. 결제 완료된 주문에 대한 두 번째 결제는 환불 대상으로 표시됩니다.
테스트 및 운영 모드: Peach Payments 샌드박스와 운영 계정에 각각 별도의 Entity ID, Access Token, 웹훅 키를 사용합니다. 결제는 항상 시작된 모드에서 확인합니다.
대시보드 작업을 메모로 기록: Peach Payments 대시보드에서 수행한 환불, 취소, 차지백은 웹훅에 의해 주문 메모에 추가됩니다.
카드 브랜드: 결제 양식에 표시할 브랜드를 선택합니다. 양식 스크립트는 Subresource Integrity 해시와 함께 로드됩니다.
쇼핑몰 주문 페이지의 Peach Payments 블록: 결제 ID, 체크아웃 ID, 금액, 결과 및 모듈 메모를 표시합니다. 카드 데이터, 키, 고객 데이터를 포함하지 않는 로그를 선택적으로 사용할 수 있습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, OpenSSL 확장이 포함된 PHP 8.0 이상. Card API Entity ID와 Access Token(테스트 및/또는 운영)이 있는 Peach Payments 계정과 웹훅 사용을 위한 Peach Payments 웹훅 복호화 키가 필요합니다. 장바구니 통화: ZAR, KES 또는 MUR. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).