개요
VibeFox Yoco Pay Gateway는 Yoco Checkout API를 통해 남아프리카 랜드(ZAR)로 카드 결제와 Instant EFT를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Yoco를 선택하고, Yoco가 호스팅하는 결제 페이지로 이동해 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 귀하의 사이트를 거치지 않으며, 중단된 결제는 미결제 주문을 남기지 않습니다.
ZAR로 판매하고 온라인 결제가 가능한 Yoco 계정을 보유한 남아프리카 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 받습니다. 저장된 카드, 구독, 사이트 내 카드 입력 양식, 별도의 승인 및 캡처는 지원하지 않습니다. ZAR에서만 작동하며, 최소 주문 금액은 R2.00입니다.
주요 기능
Yoco 호스팅 체크아웃: 장바구니 합계 금액(센트 단위)에 대한 Yoco 체크아웃이 생성됩니다. 더블클릭이나 시간 초과 후 다시 요청하면 두 번째 체크아웃이 아니라 같은 체크아웃을 받습니다.
Yoco가 확인한 경우에만 결제 완료: 고객이 돌아올 때와 서명된 웹훅이 도착할 때 모듈이 Yoco에 체크아웃 상태를 조회합니다. Yoco가 체크아웃 완료를 보고한 경우에만 주문이 생성됩니다.
웹훅 자동 설정: 비밀 키를 저장하면 모듈이 해당 모드의 웹훅 URL을 Yoco에 등록하고 서명 시크릿을 저장합니다. 유효한 서명이 없는 웹훅은 거부됩니다.
금액 및 통화 확인: 금액이나 통화가 다른 결제는 주문을 메모와 함께 Yoco payment on hold 상태로 둡니다. 취소되었거나 환불된 주문에 대한 결제는 주문을 다시 열지 않습니다.
중복 처리 방지: 웹훅과 고객의 복귀가 동시에 도착하면 차례로 처리됩니다. 장바구니 하나, 주문 하나, 기록된 결제 하나.
주문 페이지에서 환불: 주문의 Yoco payment 블록에서 전액 및 부분 환불이 가능하며, Yoco가 청구한 금액과 결제가 이루어진 모드의 키로 처리됩니다. Yoco 포털에서 진행한 환불은 자동으로 기록됩니다.
테스트 및 라이브 모드: 모드별로 별도의 비밀 키와 웹훅 시크릿을 사용합니다. 접두사가 잘못된 키는 저장되지 않습니다.
주문 페이지의 Yoco 블록: 결제, 장바구니의 모든 결제 시도, 환불 내역, 모듈 메모. 키와 이메일 주소가 마스킹된 로그.
요구 사항
PrestaShop 8.0~9.x, PHP 8.0 이상. 쇼핑몰 통화는 남아프리카 랜드(ZAR)입니다. 온라인 결제가 가능한 Yoco 계정과 그 비밀 키. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).