개요
VibeFox ECPay Payment Gateway는 대만의 결제 서비스인 ECPay(綠界)를 PrestaShop에 추가합니다. 결제 단계에서 고객은 ECPay를 선택한 뒤 ECPay가 호스팅하는 결제 페이지로 이동하여 신용카드, ATM 가상 계좌, 편의점 결제 코드 또는 편의점 바코드로 결제합니다. 카드 데이터는 쇼핑몰 사이트에 전달되지 않습니다. 주문은 ECPay가 서명된 알림으로 결제를 확인한 후에만 생성되므로, 중단된 결제로 인해 미결제 주문이 남지 않습니다.
이 모듈은 신대만달러(TWD)로 판매하는 대만 내 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 받습니다. PrestaShop에서의 환불(환불은 ECPay 백오피스에서 처리), 저장된 카드, 구독 또는 정기 결제, 할부, Apple Pay, 전자 세금계산서, 물류는 지원하지 않습니다.
주요 기능
네 가지 ECPay 결제 방법: 신용카드, ATM 가상 계좌, CVS 코드(편의점), 바코드. 여러 방법을 활성화하면 고객이 체크아웃 시 그중 하나를 선택합니다.
ECPay 확인 시에만 결제 완료: 주문은 이 쇼핑몰이 발급한 거래 번호에 대해 유효한 CheckMacValue 서명이 포함된 ECPay 서버 알림이 도착하고, 결제 금액이 장바구니와 일치할 때만 생성됩니다. 고객이 사이트로 돌아오는 것만으로는 주문이 생성되지 않습니다.
오프라인 결제 방법 안내: ATM, CVS, 바코드의 경우 주문은 Awaiting ECPay payment 상태로 대기하며, 계좌, 코드 또는 바코드와 결제 기한이 주문 확인 페이지와 고객의 주문 상세 정보에 표시됩니다.
안전한 재시도: 결제를 시도할 때마다 새로운 ECPay 거래 번호가 생성되므로, 결제 실패 또는 취소 후 재시도가 정상적으로 작동합니다. 이미 결제된 주문에 대한 두 번째 결제는 환불 대상으로 기록됩니다.
예상치 못한 문제 없음: 중복된 알림은 무시되고, ECPay 백오피스의 시뮬레이션 결제는 주문을 생성하지 않으며, 금액 불일치, 실운영 전환 후의 샌드박스 결제, 취소된 주문의 결제는 ECPay payment on hold로 이동합니다.
계정 없이 테스트: 테스트 모드는 ECPay의 공개 샌드박스 가맹점을 사용하므로, ECPay 키를 발급받기 전에도 테스트할 수 있습니다.
주문 페이지의 ECPay 블록: ECPay 거래 번호, 상태, 주문의 ECPay 메모와 함께 결제 시도 내역을 표시합니다. 키나 고객 데이터 없이 기록되는 선택적 로그이며, 오류는 항상 기록됩니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 쇼핑몰에 TWD 통화가 있어야 합니다. 실결제를 위한 ECPay 가맹점 계정(MerchantID, HashKey, HashIV). 80/443 포트로 인터넷에서 접근 가능한 쇼핑몰. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).