개요
VibeFox KOMOJU Payment는 PrestaShop에 KOMOJU 결제를 추가합니다. 결제 단계에서 고객은 KOMOJU를 선택하고, KOMOJU가 호스팅하는 결제 페이지로 이동하여 그곳에서 신용카드 또는 체크카드, 편의점 결제(konbini), PayPay, 은행 송금 등 현지 결제 방식을 선택합니다. 제공 방식은 쇼핑몰의 KOMOJU 계정과 장바구니 통화에 따라 달라집니다. 카드 데이터는 쇼핑몰 사이트를 거치지 않습니다. 주문은 KOMOJU가 결제를 확인한 후에만 생성되므로, 중단된 결제로 미결제 주문이 남지 않습니다.
KOMOJU 가맹점 계정으로 현지 결제 방식을 제공하려는 일본, 아시아, 유럽의 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 받습니다. PrestaShop에는 사이트 내 카드 양식, 저장된 카드, 정기 구독 또는 수동 캡처 기능이 없습니다.
주요 기능
KOMOJU 호스팅 페이지: 장바구니 총액과 장바구니 통화로 결제 세션을 만듭니다. JPY, KRW, VND는 소수점 없이 전송합니다. KOMOJU가 지원하는 20개 통화에서만 제공됩니다.
KOMOJU 확인 시에만 결제 완료: 쇼핑몰의 웹훅 비밀 토큰으로 서명된 웹훅을 받은 후, 또는 고객이 돌아왔을 때 KOMOJU API에서 결제 세션을 조회한 후에 주문이 생성됩니다. 고객의 복귀만으로는 주문이 결제되지 않습니다.
금액 및 통화 확인: 불일치하면 주문은 메모와 함께 KOMOJU payment on hold 상태가 됩니다. KOMOJU가 다른 통화로 변환한 결제는 결제 세션으로 확인합니다.
편의점 결제 및 은행 송금: 납부 전표가 발급되면 주문은 Awaiting KOMOJU payment 상태로 대기하고, 고객이 결제하면 Payment accepted가 됩니다. 전표가 만료되면 주문이 취소됩니다.
중복 처리 방지: 반복되거나 동시에 도착하는 웹훅과 복귀 요청은 결제를 한 번만 확정합니다. 새 시도는 열린 세션을 재사용하며, 이전 세션의 결제도 계속 인식됩니다.
테스트 및 운영 모드: 비밀 키와 웹훅 비밀 토큰을 별도로 설정합니다. 각 결제는 자신의 모드를 기억하므로, 모드를 전환한 후에도 환불과 상태 확인에 올바른 키를 사용합니다.
주문 페이지에서 환불: KOMOJU payment 블록에서 전액 및 부분 환불이 가능하며, KOMOJU가 실제로 청구한 금액까지 환불할 수 있습니다. 전액 환불 시 주문은 Refunded 상태가 됩니다. KOMOJU 대시보드에서 실행한 환불은 자동으로 기록됩니다.
주문 페이지의 KOMOJU 블록: KOMOJU 대시보드 링크가 있는 결제 정보, 환불 내역, 모듈 메모. 로그에는 키나 고객 데이터가 포함되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 비밀 키와 웹훅 비밀 토큰이 있는 KOMOJU 가맹점 계정. vibefox.net의 VibeFox 라이선스 키(도메인 하나당 키 하나).