개요
VibeFox Comgate Gateway는 PrestaShop에 Comgate를 통한 결제를 추가합니다. 결제 단계에서 고객이 Comgate를 선택하면 Comgate 결제 페이지로 이동하며, 쇼핑몰에서 Comgate 측으로 활성화된 수단(카드, Apple Pay 또는 Google Pay, 은행 버튼, 계좌이체)으로 결제합니다. 이후 고객은 쇼핑몰로 돌아옵니다. 카드 정보는 사이트를 거치지 않습니다. 주문은 Comgate가 결제를 확인한 후에만 생성되므로, 결제를 중간에 포기하더라도 미결제 주문이 남지 않습니다.
CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK 또는 SEK로 판매하며 Comgate 계정이 있는 체코 및 기타 유럽 쇼핑몰에 적합합니다. 이 모듈은 일회성 결제만 지원합니다. 정기 결제, 구독, 카드 저장 기능은 없으며, 임베디드 Comgate 결제 창이나 사이트 내 Apple Pay 및 Google Pay 버튼도 제공하지 않습니다. 또한 PrestaShop에서 사전 승인을 매입하거나 취소하지 않습니다.
주요 기능
Comgate 결제 페이지: 장바구니 합계 금액을 장바구니 통화로 백그라운드에서 결제로 생성하고, 고객을 Comgate로 리디렉션합니다. 모든 결제 수단, 카드만, 계좌이체만 중에서 선택할 수 있으며 결제 페이지의 언어도 지정할 수 있습니다.
Comgate가 확인한 경우에만 결제 완료: 백그라운드 알림이나 고객의 복귀만으로는 결제를 신뢰하지 않습니다. 모듈은 Comgate 상태 API에서 결제 정보를 다시 조회하고, 이 장바구니를 위해 생성한 거래만 인정합니다.
금액 및 통화 확인: 결제된 금액과 통화가 장바구니와 일치해야 합니다. 일치하지 않으면 주문이 메모와 함께 Comgate payment on hold 상태가 됩니다.
중복 처리 방지: 반복되거나 동시에 도착한 알림이나 복귀는 주문을 하나만 생성합니다. 재전송된 확인 정보가 환불된 주문을 다시 열지 않습니다.
안전한 재시도: 고객이 다시 결제하면 이전 시도를 먼저 확인하고, 아직 진행 중이라면 Comgate에서 취소합니다. 이미 결제된 주문에 대해 두 번째 결제가 들어오면, 중복 결제를 환불하라는 메모가 추가됩니다.
지연된 결제: 사전 승인된 주문이 취소된 후에 확인된 결제는, 메모와 함께 주문을 결제 완료 상태로 되돌립니다.
주문 페이지에서 환불: 주문의 Comgate payment 블록에서 전액 환불과 부분 환불을 할 수 있으며, 환불은 항상 원래 결제와 같은 모드(테스트 또는 운영)로 전송됩니다. 전액 환불을 하면 주문이 Refunded 상태가 됩니다.
주문 페이지의 Comgate 블록: 거래, 거래 상태, 환불 내역, 모듈 메모를 보여 줍니다. 비밀 키나 개인 정보를 기록하지 않는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. Comgate 고객 포털에서 가맹점 ID(Merchant ID)와 비밀 키(Secret)를 발급받고 알림 URL을 설정한 Comgate 계정. 인터넷에서 HTTPS로 접근할 수 있는 쇼핑몰. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 1개).