개요
VibeFox Quickpay Gateway는 결제 수단으로 Quickpay를 PrestaShop에 추가합니다. 고객은 Quickpay 결제 창으로 이동하여 카드, MobilePay 또는 Quickpay 계정에서 활성화된 다른 방법으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 사이트를 거치지 않습니다. 주문은 Quickpay가 서명된 콜백으로 결제를 확인한 후에만 생성되므로, 중단된 결제로 미결제 주문이 남지 않습니다.
이미 Quickpay 계정이 있는 덴마크 및 북유럽 쇼핑몰에 적합합니다. 결제를 즉시 캡처할지, 아니면 승인만 받아 두었다가 주문 페이지에서 나중에 캡처할지 선택할 수 있습니다. 이 모듈은 일회성 결제만 지원합니다. 구독, 카드 저장, 부분 캡처 기능이 없으며, 사이트에 별도의 MobilePay, Apple Pay, Klarna 버튼을 제공하지 않습니다.
주요 기능
Quickpay 결제 창: 장바구니 통화로 장바구니 총액에 대한 Quickpay 결제와 결제 링크가 생성되며, 통화마다 올바른 소수점 자릿수가 적용됩니다. 소수점이 없는 JPY와 ISK, 소수점 셋째 자리까지 쓰는 KWD와 BHD도 포함됩니다.
Quickpay가 확인한 경우에만 결제 완료: 서명된 Quickpay 콜백만 주문을 생성하며, 그 전에 금액과 통화가 장바구니와 비교됩니다. 차이가 있으면 주문은 메모와 함께 Quickpay payment on hold 상태가 됩니다. 콜백 URL은 모든 결제와 함께 전송되므로 Quickpay에서 따로 설정할 필요가 없습니다.
자동 또는 수동 캡처: 즉시 캡처하거나, 승인만 받은 뒤 배송 시 주문의 Quickpay 블록에서 Capture Quickpay payment를 클릭합니다.
이중 처리 방지: 반복되거나 늦게 도착한 콜백이 주문을 두 번 생성하거나, 취소 또는 환불된 주문을 다시 열지 않습니다. 새로운 결제 시도는 장바구니의 기존 Quickpay 결제를 재사용하므로, 이전 링크로 병렬 결제가 이루어질 수 없습니다.
주문 페이지에서 환불: 주문의 Quickpay 블록에서 Quickpay가 캡처한 금액과 통화로 전액 및 부분 환불이 가능합니다. Quickpay의 최종 결과는 메모에 추가되며, 전액 환불 시 주문이 Refunded 상태로 변경됩니다.
테스트 결제: 계정이 테스트 모드인 동안 Quickpay 테스트 카드를 허용합니다. 설정이 꺼져 있으면 테스트 결제로는 주문이 결제 완료로 표시되지 않습니다.
주문 페이지의 Quickpay 블록: 결제 ID, 상태, 장바구니의 모든 결제, 환불 내역 및 모듈 메모. 키나 고객 데이터 없이 오류를 항상 기록하는 로그가 있습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. API 사용자의 API 키와 계정의 개인 키가 있는 Quickpay 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).