개요
VibeFox MultiSafepay Gateway는 MultiSafepay의 호스팅 결제 페이지를 하나의 결제 수단으로 PrestaShop에 추가합니다. 결제 단계에서 고객은 MultiSafepay를 선택하고 MultiSafepay 페이지로 이동하여, MultiSafepay 계정에서 활성화된 결제 수단(iDEAL, 카드, Bancontact, PayPal 등)으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 MultiSafepay가 결제를 확인한 후에만 생성되므로, 결제를 중단한 경우 미결제 주문이 남지 않습니다.
하나의 MultiSafepay 계정으로 여러 유럽 결제 수단을 제공하려는 쇼핑몰에 적합합니다. 이 모듈은 일회성 결제만 지원합니다. MultiSafepay의 결제 수단마다 별도의 PrestaShop 결제 수단이 있지 않으며, 내장 카드 입력 양식이나 Apple Pay, Google Pay 간편 결제 버튼도 없습니다. 구독과 저장된 카드도 지원하지 않으며, PrestaShop에서 매입(capture)이나 취소를 할 수 없습니다. 장바구니 데이터는 전송되지 않으므로, 이를 필요로 하는 후불 결제 수단은 제공되지 않습니다.
주요 기능
MultiSafepay 결제 페이지: 장바구니 금액을 장바구니 통화로 결제합니다. JPY, KRW 등 소수점이 없는 통화도 포함됩니다. MultiSafepay가 받지 않는 통화에서는 이 결제 수단이 표시되지 않습니다.
MultiSafepay가 확인한 경우에만 결제 완료: 주문을 생성하기 전에, 모든 알림과 고객의 복귀를 API 키를 사용해 MultiSafepay API로 확인합니다. MultiSafepay에서 따로 설정할 것은 없습니다. 알림 주소는 모든 결제에 포함되어 전송됩니다.
금액 및 통화 확인: MultiSafepay가 확인한 금액과 통화를 장바구니와 비교합니다. 일치하지 않으면 주문이 메모와 함께 MultiSafepay payment on hold 상태가 됩니다.
중복 처리 방지: 반복된 알림으로 두 번째 주문이 생성되거나 결제가 두 번 기록되지 않습니다. 열려 있는 결제 페이지는 재사용되고, 오래된 결제 페이지는 취소되며, 같은 장바구니에 대한 중복 결제는 환불 대상으로 표시됩니다.
테스트 모드와 실서비스 모드: API 키가 각각 분리되어 있습니다. 각 결제는 자신의 환경을 기억하므로, 모드를 전환한 후에도 상태 확인과 환불이 계속 작동합니다. 테스트 결제가 실서비스 모드의 주문을 결제 완료로 만드는 일은 없습니다.
주문 페이지에서 환불: 주문의 MultiSafepay payment 블록에서 전액 및 부분 환불이 가능하며, MultiSafepay가 실제로 청구한 금액까지 환불할 수 있습니다. 전액 환불을 하면 주문이 Refunded 상태가 됩니다.
명확한 상태: 결제 후에는 Payment accepted 또는 Delivered가 됩니다. 미정산 및 승인(예약)된 결제는 MultiSafepay payment on hold 상태로 대기합니다. 차지백은 주문을 보류 상태로 만듭니다.
주문 페이지의 MultiSafepay 블록: 결제, 결제 수단과 상태, 환불 내역, 주문의 MultiSafepay 메모를 표시합니다. API 키나 고객 데이터를 포함하지 않는 로그를 기록합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 웹사이트용 API 키(테스트 및/또는 실서비스)가 있는 MultiSafepay 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).