개요
VibeFox Satispay Gateway는 PrestaShop에 Satispay 결제를 추가합니다. 결제 단계에서 고객은 Satispay를 선택하고 Satispay 결제 페이지로 이동하여, 컴퓨터에서는 QR 코드를 스캔하거나 휴대폰의 Satispay 앱에서 결제를 확인한 뒤 쇼핑몰로 돌아옵니다. 주문은 모듈이 Satispay API에서 결제 내역을 읽고 상태, 금액, 통화를 확인한 후에야 생성되므로, 중간에 포기된 결제로 미결제 주문이 남지 않습니다.
API 키를 복사하지 않고 Satispay를 받고 싶은 유로(EUR) 판매 쇼핑몰에 적합합니다. 모듈은 Satispay Business Dashboard에서 발급한 일회용 활성화 코드로 연결됩니다. Satispay는 EUR만 청구하므로, 다른 통화의 장바구니에서는 이 결제 수단이 숨겨집니다. 모듈은 구독, 저장된 결제 수단, 사전 승인, 식권을 지원하지 않으며, Satispay Dashboard에서 한 환불은 PrestaShop에 기록되지 않습니다.
주요 기능
한 단계 연결: 활성화 코드를 붙여 넣고 저장하면 됩니다. 모듈이 자체 RSA 키 쌍을 생성하고 Satispay로 보내는 모든 요청에 서명합니다.
Satispay가 확인한 경우에만 결제 완료: Satispay의 콜백도, 고객의 복귀도 신뢰하지 않습니다. 결제 내역은 항상 Satispay API에서 다시 확인하며, 쇼핑몰이 해당 장바구니를 위해 생성한 결제여야 합니다.
금액 및 통화 확인: 결제 금액이 장바구니 총액과 일치하지 않으면, 주문은 결제 완료로 표시되지 않고 메모와 함께 Satispay payment on hold 상태가 됩니다.
중복 처리 방지: 반복되거나 동시에 들어온 콜백과 복귀 요청이 두 번째 주문을 만들거나 결제를 두 번 기록하는 일은 없습니다. 새 결제 시도는 이전의 대기 중인 Satispay 결제를 취소합니다.
포기된 결제 종료: 고객이 결제하지 않고 Satispay 페이지를 떠나면, Satispay에서 해당 결제가 취소되고 체크아웃에서 안내 메시지가 표시됩니다. 장바구니는 유지됩니다.
운영 및 샌드박스: 환경마다 별도의 키를 사용합니다. 각 결제는 자신의 환경을 기억하며, 콜백과 환불은 항상 그 환경을 사용합니다.
주문 페이지에서 환불: Satispay payment 블록에서 전액 및 부분 환불을 할 수 있으며, Satispay가 실제로 청구한 금액을 한도로 합니다. 전액 환불을 하면 주문이 Refunded 상태가 됩니다.
주문 페이지의 Satispay 블록: 결제, 장바구니의 모든 Satispay 결제, 환불 내역, 모듈 메모를 표시합니다. 로그에는 키나 고객 데이터가 포함되지 않으며, 오류는 항상 기록됩니다.
요구 사항
PrestaShop 8.0 ~ 9.x, OpenSSL 확장이 포함된 PHP 8.0 이상, EUR 결제. Satispay Business 계정과 Satispay Business Dashboard에서 발급받은 활성화 코드. 쇼핑몰이 인터넷에서 접근 가능해야 합니다. vibefox.net에서 구입한 VibeFox 라이선스 키(도메인당 키 하나).