개요
VibeFox Kushki Payment는 에콰도르와 콜롬비아의 쇼핑몰을 위해 Kushki를 통한 신용카드 및 체크카드 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 체크아웃 페이지에 표시되지만 Kushki가 제공하는 호스팅 양식에 카드 정보를 입력합니다. 이 양식은 일회용 토큰을 반환하며, 쇼핑몰은 Kushki API를 통해 서버에서 이 토큰으로 결제합니다. 카드 번호는 쇼핑몰 사이트에 전달되지 않습니다. 주문은 Kushki가 결제를 승인한 후에만 생성되므로, 거절되거나 중단된 결제로 미결제 주문이 남지 않습니다.
USD 또는 COP로 결제를 받고, 카드 정보를 직접 다루지 않으면서 자체 체크아웃 페이지에 카드 양식을 제공하려는 쇼핑몰에 적합합니다. 이 모듈은 한 번에 완료되는 카드 결제만 지원합니다. 부분 환불, 저장된 카드, 구독, 현금 결제, 계좌이체(PSE), 체크카드 리디렉션 결제, 승인과 캡처의 분리는 지원하지 않습니다.
주요 기능
Kushki 호스팅 카드 양식: PrestaShop 체크아웃의 결제 단계에 표시되는 Kushki 카드 양식. 양식에서 선택한 할부(diferido)는 결제 요청에 함께 전달됩니다.
Kushki가 확인한 경우에만 결제 완료: Kushki가 티켓 번호와 함께 결제를 승인한 후에만 주문이 생성됩니다. Kushki가 보고한 금액이나 통화가 주문과 다르면 주문은 메모와 함께 Kushki payment on hold 상태가 됩니다.
세금은 IVA로 처리: 금액과 통화는 항상 장바구니에서 가져옵니다. 장바구니 세금은 IVA로 Kushki에 보고되며, 세금이 없는 항목은 별도로 보고됩니다.
서명된 웹훅: 선택 사항인 웹훅은 API 응답이 누락된 결제에 대해 주문을 생성하고, Kushki Console에서 이루어진 취소 및 환불에 대한 메모를 추가합니다. 유효한 서명이 없는 알림은 거부됩니다.
중복 결제 방지: 장바구니별 잠금 기능으로 더블 클릭이나 두 번째 탭에서 발생하는 중복 결제를 막으며, 반복되는 웹훅이 두 번째 주문을 생성하는 일은 없습니다.
테스트 및 실결제 모드: 모드마다 별도의 Merchant ID와 웹훅 서명을 사용합니다. 환불은 항상 결제가 이루어진 모드로 처리됩니다.
주문 페이지에서 전액 환불: 주문의 Kushki payment 블록은 Kushki가 결제한 전체 금액을 환불합니다. 주문은 Refunded 상태로 설정됩니다.
주문 페이지의 Kushki 블록: 티켓 번호, 참조 번호, 환경, 환불 내역, 주문의 Kushki 메모. 로그에는 Merchant ID, 카드 토큰, 고객 이메일이 포함되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 장바구니 통화는 USD 또는 COP. 테스트 및 운영용 Public·Private Merchant ID가 있는 Kushki 계정, 실결제를 위한 HTTPS. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).