개요
VibeFox Culqi Payment는 페루의 결제 서비스 Culqi를 OpenCart 3 및 OpenCart 4에 추가합니다. 마지막 결제 단계에서 고객이 Confirm Order를 클릭하면, 쇼핑몰을 떠나지 않고 Culqi Checkout 팝업에서 카드 또는 Yape로 결제합니다. 카드 정보는 Culqi 창에 입력되며 쇼핑몰 서버에 전달되지 않습니다. 이후 서버가 Culqi Charges API로 결제 요청을 만듭니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Culqi가 결제 승인을 확인한 후에야 상태를 얻습니다. 따라서 거절되거나 중단된 결제는 상태가 없는 주문으로 남습니다.
페루에서 페루 솔(PEN) 또는 미국 달러(USD)로 판매하고 Culqi 계정을 보유한 쇼핑몰에 적합합니다. 이 확장 프로그램은 카드와 Yape를 통한 일회성 결제만 처리합니다. 은행 앱, 에이전트, 전자 지갑 또는 Cuotéalo, 저장된 카드, 정기 결제 또는 할부, Culqi 웹훅, 별도의 승인 및 캡처는 지원하지 않습니다.
주요 기능
Culqi Checkout 팝업: 결제 확인 단계의 창에서 카드(Visa, Mastercard, American Express, Diners Club)를 표시하며, 선택 사항으로 Yape도 표시합니다.
3-D Secure: 은행이 요구하면 Culqi 3-D Secure가 자동으로 열리고, 인증 후 결제가 완료됩니다.
Culqi가 확인한 경우에만 결제 완료: Culqi가 결제 성공을 응답한 후에 주문 상태가 설정되며, 청구된 금액과 통화를 주문과 비교합니다. 불일치하면 주문은 메모가 달린 검토 상태가 됩니다. 이후 OpenCart가 일반적인 주문 이메일을 발송합니다.
이중 결제 방지: 이미 Culqi 결제가 있는 주문은 더블 클릭, 두 번째 탭, 재시도 후에도 다시 결제되지 않습니다.
명확한 거절 안내: 고객은 Culqi의 메시지를 확인하고 같은 단계에서 다른 카드를 시도할 수 있습니다. 주문 메모와 로그에 거절 코드가 남습니다.
테스트 모드와 라이브 모드: 모드별로 공개 키와 비밀 키가 따로 있습니다. 환불은 항상 결제가 이루어진 모드의 키를 사용합니다.
주문 페이지에서 환불: 주문의 VibeFox Culqi Payment 탭에서 전액 또는 부분 환불을 할 수 있으며, Culqi가 실제로 청구한 금액까지 가능합니다. 전액 환불은 Refunded 상태를 설정합니다.
OpenCart 조건 및 안전한 설정: 지역 구역, 최소 주문 금액, 정렬 순서, 사용자 지정 주문 상태. 잘못된 접두사의 키는 거부되며, 저장된 비밀 키는 다시 표시되지 않습니다. 키, 카드 데이터, 고객 정보를 포함하지 않는 선택 사항의 로그를 제공합니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드 파일에 두 버전용 패키지가 모두 들어 있습니다. 활성화된 쇼핑몰 통화 PEN 또는 USD. 공개 API 키와 비밀 API 키가 있는 Culqi 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 하나).