개요
VibeFox Windcave Payment Gateway는 Windcave REST API를 사용하여 Windcave Hosted Payment Page를 통한 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Windcave를 선택하고, 안전한 Windcave 페이지로 이동하여 카드 또는 Windcave 계정에서 활성화된 다른 방법으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않으며, 주문은 Windcave가 결제를 확인한 후에만 생성됩니다.
자체 사이트에 카드 양식을 두지 않고 카드 결제를 받고 싶은 Windcave 가맹점 계정 보유 쇼핑몰에 적합합니다. 결제 금액을 즉시 청구하거나, 승인만 받아 두었다가 나중에 캡처할 수 있습니다. 이 모듈은 구독이나 정기 결제, 저장된 카드, 사이트에 내장된 카드 양식을 지원하지 않으며, 이전 버전인 PxPay 2.0 API와는 호환되지 않습니다.
주요 기능
Hosted Payment Page: 장바구니 합계 금액에 대해 장바구니 통화로 Windcave 결제 세션을 생성하며, 통화마다 올바른 소수점 자릿수를 사용합니다(예: NZD 25.50, JPY 3000, KWD 1.250).
Windcave가 확인한 경우에만 결제 완료: 고객의 복귀와 Windcave 알림은 모두 Windcave REST API를 통해 서버에서 확인됩니다. 결제는 한 번만 적용됩니다.
주문 검증: Windcave가 보고한 금액, 통화, 가맹점 참조 번호, 거래 유형을 장바구니와 대조합니다. 불일치가 있으면 주문은 메모와 함께 Windcave payment on hold 상태가 됩니다.
Purchase 또는 Auth: 금액을 즉시 청구하거나, 지금 승인한 뒤 나중에 주문의 Windcave 블록에 있는 Capture Windcave payment로 캡처할 수 있습니다.
주문 페이지에서 환불: 주문의 Windcave 블록에서 전액 및 부분 환불이 가능합니다. 환불 금액은 Windcave가 실제로 승인한 금액을 넘을 수 없습니다. 캡처되지 않은 승인에 대해 전액 환불하면 승인이 해제됩니다.
테스트 모드: Windcave UAT 테스트 환경을 사용합니다. 전용 자격 증명은 운영 자격 증명과 함께 저장됩니다. 환불과 캡처는 항상 주문이 결제된 환경으로 처리됩니다.
이중 청구 방지: 새 결제 시도는 먼저 이전 결제를 확인합니다. 이미 결제된 주문에 대해 두 번째 승인 결제가 들어오면 주문을 변경하지 않고 주문 메모에 기록합니다.
주문 페이지의 Windcave 블록: 거래, 카드, 캡처, 환불, 장바구니의 세션 및 메모를 표시합니다. 로그에는 키, 카드 정보, 고객 정보가 기록되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. UAT 테스트 환경 및/또는 운영 환경용 REST API 자격 증명(사용자 이름과 API 키)이 있는 Windcave 가맹점 계정. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 하나).