개요
VibeFox Windcave Payment Gateway는 Windcave REST API를 사용하여 Windcave Hosted Payment Page를 통한 결제를 OpenCart 3와 OpenCart 4에 추가하는 확장 기능입니다. 고객은 마지막 체크아웃 단계에서 Confirm Order를 클릭하면 Windcave의 보안 페이지로 이동하여 카드 또는 귀하의 Windcave 계정에서 사용하도록 설정된 다른 방법으로 결제한 후 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 서버를 거치지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Windcave가 결제를 승인한 후에야 상태를 받습니다. 따라서 결제되지 않은 시도는 누락된 주문으로 남습니다.
이 확장 기능은 Windcave 가맹점 계정이 있고, 자체 사이트에 카드 입력 양식 없이 카드 결제를 받으려는 쇼핑몰에 적합하며, 금액을 즉시 청구하거나 승인만 받고 나중에 매입할 수 있는 선택지를 제공합니다. 정기 구독이나 반복 결제, 카드 저장, 사이트에 내장된 카드 입력 양식은 지원하지 않으며, 구형 PxPay 2.0 API와도 작동하지 않습니다.
주요 기능
Hosted Payment Page: 주문 통화로 주문 합계에 대한 Windcave 결제 세션이 생성되며, 각 통화의 올바른 소수점 자릿수가 적용됩니다(NZD 25.50, JPY 3000, KWD 1.250).
Windcave가 확인한 경우에만 결제 완료: 고객의 복귀와 Windcave 알림은 모두 Windcave REST API를 통해 서버에서 확인됩니다. 결제는 정확히 한 번만 적용되며, 하나의 장바구니는 한 번만 결제됩니다.
주문 확인: Windcave가 보고한 금액, 통화, 가맹점 참조 번호 및 거래 유형이 주문과 비교됩니다. 불일치하는 경우, 주문은 선택하신 검토 상태로 설정되고 메모가 남습니다.
Purchase 또는 Auth: 즉시 금액을 청구하거나, 지금 승인만 받고 나중에 주문 탭의 Capture Windcave payment로 매입할 수 있습니다.
주문 페이지에서 환불: 주문의 VibeFox Windcave Payment Gateway 탭에서 Windcave가 실제로 승인한 금액까지 전액 및 부분 환불을 할 수 있습니다. 매입되지 않은 승인에 대해 전액 환불을 하면 승인이 해제됩니다.
테스트 모드: 자체 인증 정보를 가진 Windcave UAT 테스트 환경이며, 운영 인증 정보와 나란히 저장됩니다. 환불과 매입은 항상 주문이 결제된 환경에서 이루어집니다.
이중 청구 방지: 새로운 결제 시도는 먼저 이전 시도를 확인하며, 이미 결제된 주문에 대해 승인된 두 번째 결제는 주문을 변경하지 않고 메모로 알려줍니다.
OpenCart 설정: 자체 주문 상태, 지역(Geo Zone), 최소 주문 금액, 정렬 순서. 키나 카드, 고객 데이터가 없는 로그.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드 파일에 두 버전용 패키지가 모두 들어 있습니다. UAT 테스트 환경 및/또는 운영 환경용 REST API 인증 정보(사용자 이름과 API 키)가 있는 Windcave 가맹점 계정. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 하나).