개요
VibeFox Conekta Gateway는 Conekta(멕시코)를 통한 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Conekta를 선택하고, Conekta가 호스팅하는 안전한 결제 페이지로 이동하여 신용카드 또는 체크카드, OXXO 등 매장에서의 현금 결제, SPEI 계좌이체, BNPL 중 귀하가 허용한 결제 방식으로 결제합니다. 그 후 고객은 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트에 전달되지 않습니다. 주문은 Conekta가 결제를 확인하거나 OXXO 또는 SPEI 결제 참조 번호를 발급한 후에만 생성되므로, 중단된 결제로 인해 미결제 주문이 남지 않습니다.
MXN 또는 USD로 판매하며 하나의 Conekta 계정으로 카드와 현금 결제를 한 가지 결제 방식으로 받고 싶은 멕시코 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 지원합니다. 결제 페이지에 카드 입력 양식이 없으며, 저장된 카드, 구독, 사전 승인 및 캡처, 월 할부(MSI)를 지원하지 않습니다. Conekta 대시보드에서 진행한 환불이나 차지백은 주문에 메모로만 표시되며 자동으로 기록되지 않습니다.
주요 기능
Conekta 호스팅 결제 페이지: 장바구니 금액에 대해 장바구니 통화로 Conekta 주문이 생성됩니다. 현금, SPEI, BNPL은 MXN 장바구니에만 제공되며, USD 장바구니는 카드만 사용할 수 있습니다.
Conekta 확인 시에만 결제 완료: 웹훅과 고객의 복귀는 모두 Private Key로 Conekta API에서 주문 정보를 읽는 작업만 시작합니다. 알림이나 복귀 URL의 어떤 내용도 신뢰하지 않습니다.
금액 및 통화 확인: 센트 단위 금액과 통화를 장바구니와 대조합니다. 차이가 있거나, 쇼핑몰이 운영 모드인 동안 테스트 모드 결제가 들어오면 주문은 검토를 위해 Conekta payment on hold 상태가 됩니다.
OXXO 및 SPEI: 고객이 결제 참조 번호를 받으면 주문은 Awaiting Conekta payment 상태로 생성되고, Conekta가 결제를 알리면 Payment accepted 상태가 됩니다.
중복 처리 방지: 반복되거나 동시에 도착한 알림은 두 번째 주문을 만들거나 결제를 두 번 기록하지 않습니다. 열려 있는 Conekta 결제 페이지는 새 페이지를 만들기 전에 재사용되거나 취소되므로, 오래된 링크로 두 번 결제되는 일이 없습니다.
테스트 모드와 운영 모드: 모드별로 별도의 Private Key를 사용하며, 결제 페이지에는 TEST MODE 안내가 표시됩니다. 환불과 알림은 항상 결제가 이루어진 모드의 키를 사용합니다.
주문 페이지에서 환불: 주문의 Conekta payment 블록에서 전액 및 부분 환불이 가능하며, Conekta가 실제로 청구한 금액까지만 환불할 수 있습니다. 전액 환불 시 주문은 Refunded 상태가 됩니다.
주문 페이지의 Conekta 블록: Conekta 주문, 청구, 상태, 금액, 환불 내역, 모듈 메모를 표시합니다. API 키나 고객 연락처 정보를 기록하지 않는 선택 사항 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 장바구니 통화는 MXN 또는 USD입니다. 테스트 및 운영 Private Key가 있는 Conekta 계정과 Conekta 대시보드의 웹훅. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).