개요
VibeFox Conekta Gateway는 Conekta(멕시코)를 통한 결제를 OpenCart 3 및 OpenCart 4에 추가합니다. 마지막 주문 단계에서 고객이 Confirm Order를 클릭하면 Conekta의 안전한 호스팅 결제 페이지로 이동하여, 허용하신 방법에 따라 신용카드 또는 체크카드, OXXO 등 일부 매장에서의 현금 결제, SPEI 계좌이체, 또는 BNPL로 결제합니다. 그 후 고객은 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Conekta가 결제를 확인하거나 OXXO 또는 SPEI 결제 번호를 발급한 뒤에야 상태를 받습니다. 따라서 결제되지 않은 시도는 누락 주문으로 남습니다.
MXN 또는 USD로 판매하며 하나의 Conekta 계정으로 카드 결제와 현금 결제를 한 가지 결제 방법으로 제공하려는 멕시코 쇼핑몰에 적합합니다. 이 확장 프로그램은 일회성 결제만 지원합니다. 결제 페이지에 카드 입력 양식이 없으며, 저장된 카드, 구독, 사전 승인 후 캡처, 할부(MSI)는 지원하지 않습니다. Conekta 관리 패널에서 이루어진 환불이나 차지백은 주문에 메모로만 표시되며 자동으로 기록되지 않습니다.
주요 기능
Conekta 호스팅 결제 페이지: 주문 통화로 주문 금액에 대한 Conekta 주문을 생성하며, 상품, 할인, 세금, 배송비가 포함됩니다. 현금, SPEI, BNPL은 MXN 주문에 제공되며, USD 주문은 카드만 가능합니다.
Conekta가 확인한 경우에만 결제 완료: webhook과 고객의 복귀 모두 개인 키를 사용해 Conekta API에서 주문을 다시 읽어오는 작업만 트리거합니다. 알림이나 복귀 URL의 내용은 신뢰하지 않습니다. 그 후 OpenCart가 일반적인 주문 이메일을 발송합니다.
금액 및 통화 확인: 센트 단위 금액과 통화를 주문과 비교합니다. 차이가 있거나, 실 운영 중인 쇼핑몰에서 테스트 모드 결제가 수신되면, 주문은 검토를 위해 보류 상태로 전환됩니다.
OXXO 및 SPEI: 고객이 결제 번호를 받으면 주문은 결제 대기 상태가 되고, Conekta가 결제를 보고하면 결제 완료 상태로 전환됩니다.
이중 처리 방지: 반복되거나 동시에 도착한 알림으로 결제가 두 번 적용되는 일은 없습니다. 새로운 시도 전에 장바구니의 이전 Conekta 결제 세션은 재사용되거나, 이미 결제되었으면 확인되거나, 취소됩니다. 따라서 오래된 링크로 두 번 결제할 수 없습니다.
테스트 및 실 운영 모드: 각 모드마다 별도의 개인 키를 사용하며, 결제 페이지에 테스트 모드 안내가 표시됩니다. 알림과 환불은 결제가 이루어진 모드의 키를 항상 사용합니다.
주문 페이지에서의 환불: 주문의 VibeFox Conekta Gateway 탭에서 전액 또는 일부 환불이 가능하며, Conekta가 실제로 청구한 금액까지 환불할 수 있습니다. 전액 환불을 하면 Refunded 상태가 설정됩니다.
OpenCart 설정 연동: 사용자 정의 주문 상태, 지역(Geo Zone), 최소 주문 금액, 정렬 순서. API 키나 고객 연락처를 포함하지 않는 선택 사항인 로그.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트), PHP 8.0 이상. 하나의 다운로드 파일에 두 버전용 패키지가 모두 들어 있습니다. 결제 통화는 MXN 또는 USD. 테스트 및 운영용 개인 키가 있는 Conekta 계정과 Conekta 패널의 웹훅. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 하나).