개요
VibeFox Kushki Payment는 에콰도르와 콜롬비아의 쇼핑몰을 위해 Kushki를 통한 카드 결제를 OpenCart 3 및 OpenCart 4에 추가합니다. Confirm Order 단계에서 고객은 결제 페이지 안에 표시되지만 Kushki가 제공하는 호스팅 카드 양식에 카드 정보를 입력합니다. 이 양식은 일회용 토큰을 반환하며, 쇼핑몰은 Kushki API를 통해 서버에서 해당 토큰으로 결제를 청구합니다. 카드 번호는 쇼핑몰 사이트에 전달되지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Kushki가 청구를 승인한 후에야 상태를 받습니다. 따라서 거절되거나 중단된 결제는 상태가 없는 주문(missing orders)으로 남습니다.
USD 또는 COP로 결제를 받고, 카드 정보를 직접 다루지 않고 자체 결제 페이지에서 카드 양식을 제공하려는 쇼핑몰에 적합합니다. 이 확장 프로그램은 한 단계 결제만 지원합니다. 부분 환불, 카드 저장, 구독, 현금 또는 계좌이체(PSE) 결제, 리디렉션을 사용하는 체크카드 결제, 승인과 매입의 분리는 지원하지 않습니다.
주요 기능
Kushki 호스팅 카드 양식: OpenCart 결제 페이지의 Confirm Order 단계에 표시되는 Kushki의 카드 양식입니다. 고객이 양식 안의 결제 버튼을 누르는 즉시 결제가 전송됩니다. 양식에서 선택한 할부(diferido)는 청구에 전달됩니다.
Kushki가 확인한 경우에만 결제 완료: 주문 상태는 Kushki가 티켓 번호와 함께 청구를 승인한 후에만 설정됩니다. Kushki가 보고한 금액이나 통화가 다르면 주문은 메모가 첨부된 검토 상태가 됩니다. 이후 OpenCart는 일반적인 주문 이메일을 발송합니다.
IVA로서의 세금: 금액과 통화는 주문에서 가져옵니다. 주문 세금은 IVA로 Kushki에 보고되며, 세금이 없는 항목은 별도로 보고됩니다.
서명된 웹훅: 선택 사항인 웹훅은 API 응답이 유실된 결제를 확인하고, Kushki Console에서 이루어진 무효화(void) 및 환불에 대한 메모를 추가합니다. 유효한 서명이 없는 알림은 거부됩니다.
이중 청구 방지: 장바구니별 잠금으로 더블 클릭이나 두 번째 탭에서 발생하는 이중 청구를 막으며, 이미 결제된 장바구니는 다시 청구되지 않습니다. 반복되는 웹훅이 같은 결제를 두 번 적용하는 일도 없습니다.
테스트 모드와 실서비스 모드: 모드별로 별도의 Merchant ID와 웹훅 서명을 사용합니다. 환불은 항상 결제가 이루어진 모드로 처리됩니다.
주문 페이지에서 전액 환불: 주문의 VibeFox Kushki Payment 탭에서 Kushki가 청구한 금액 전체를 환불할 수 있으며, 티켓 번호, 참조 번호, 환불 내역, Kushki 메모를 확인할 수 있습니다.
자체 주문 상태와 OpenCart 조건: 결제 완료 주문, 검토 중인 결제, 실패한 결제, 취소된 주문, 환불된 주문에 대해 OpenCart 상태를 선택할 수 있습니다. 지역(Geo Zone), 최소 주문 금액, 정렬 순서를 설정합니다. 로그에는 Merchant ID, 카드 토큰, 고객 이메일이 포함되지 않습니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드에 두 버전용 패키지가 모두 들어 있습니다.주문 통화는 USD 또는 COP여야 합니다. 테스트 및 실서비스용 공개(Public) 및 비공개(Private) Merchant ID가 있는 Kushki 계정. 실결제에는 HTTPS가 필요합니다. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 1개).