개요
VibeFox Vindi Gateway는 브라질 레알(BRL)로 판매하는 브라질 쇼핑몰을 위해 OpenCart 3와 OpenCart 4를 Vindi API에 연결합니다. 고객은 Vindi 청구서 페이지에서 신용카드로 결제하거나, boleto, PIX 또는 BolePix(boleto + PIX)로 결제할 수 있습니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. boleto와 PIX의 경우 주문은 즉시 설정하신 대기 상태가 되고, 고객은 성공 페이지, 계정, 주문 이메일에서 boleto 링크와 PIX 코드를 받습니다.
이미 Vindi 계정이 있고 카드 양식을 직접 만들지 않고 일회성 결제를 받고 싶은 브라질 쇼핑몰에 적합합니다. 카드 결제의 경우 결제 전에 OpenCart가 주문을 생성하지만, 주문은 Vindi가 결제를 확인한 후에야 상태를 받습니다. 따라서 결제되지 않은 시도는 누락된 주문으로 남습니다. 이 확장 기능은 단일 할부(1회 납부)의 일회성 결제만 받습니다. 구독이나 정기 청구, 저장된 카드, 할부(parcelamento), 쇼핑몰의 카드 양식은 지원하지 않으며, boleto 결제는 환불할 수 없습니다.
주요 기능
네 가지 결제 수단: 신용카드, boleto, PIX, BolePix. 체크아웃에서 제공할 수단을 선택할 수 있습니다.
CPF / CNPJ 필드: boleto와 PIX의 경우 체크아웃에서 요청하며 검증 숫자로 확인합니다. 가능하면 고객의 CPF 또는 CNPJ 사용자 지정 필드에서 미리 채워집니다.
Vindi가 확인한 경우에만 결제 완료: 확장 기능이 Vindi API에서 청구서를 다시 읽고 통화, 주문 코드, Vindi 고객, 정확한 금액을 확인한 후에만 결제를 받아들입니다. 불일치하면 주문은 메모와 함께 보류 상태가 됩니다.
보호된 웹훅: 웹훅 URL에는 비밀 토큰이 포함되며, 각 알림은 Vindi API를 통한 새로운 확인만 트리거합니다.
이중 결제 방지: 하나의 장바구니는 한 번만 결제됩니다. 새 시도는 대기 중인 Vindi 청구서를 재사용하거나 먼저 취소합니다. OpenCart에서 미결제 주문을 취소하면 해당 Vindi 청구서도 취소됩니다.
실서비스 및 샌드박스: API 키가 분리되어 있습니다. 각 결제는 청구서가 생성된 환경을 기억하므로, 확인과 환불은 항상 해당 환경을 사용합니다.
주문 페이지에서 환불: 주문 페이지의 확장 기능 탭에서 카드 및 PIX 결제의 전액 및 부분 환불이 가능합니다. 환불 금액은 Vindi가 실제로 청구한 금액까지입니다. 전액 환불을 하면 주문이 설정된 환불됨 상태가 됩니다.
OpenCart 조건: 지역(Geo Zone), 최소 주문 합계, 정렬 순서, 자체 주문 상태. 로그에는 키나 고객 데이터가 포함되지 않습니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드 파일에 두 버전용 패키지가 모두 들어 있습니다. 쇼핑몰에 브라질 레알(BRL) 통화가 설정되어 있어야 합니다. API 키가 있는 Vindi 계정(테스트용 Vindi 샌드박스 계정 포함). vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).