개요
VibeFox Vindi Gateway는 브라질 헤알(BRL)로 판매하는 브라질 쇼핑몰을 위해 WooCommerce를 Vindi API에 연결합니다. 고객은 Vindi 청구서 페이지에서 신용카드로 결제하거나, boleto, PIX 또는 BolePix(boleto + PIX)로 결제할 수 있습니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. boleto와 PIX의 경우 주문은 보류 상태가 되며, 고객은 주문 접수 페이지, 내 계정, 이메일에서 boleto 링크, PIX QR 코드, 복사·붙여넣기용 PIX 코드를 받습니다.
이미 Vindi 계정이 있고, 카드 양식을 직접 만들지 않고 일회성 결제를 받고 싶은 브라질 쇼핑몰에 적합합니다. 플러그인은 한 번에 결제하는 단일 결제만 처리합니다. 구독이나 정기 청구, 저장된 카드, 할부(parcelamento), 쇼핑몰 사이트의 카드 양식은 지원하지 않으며, boleto 결제는 환불할 수 없습니다.
주요 기능
4가지 결제 수단: 신용카드, boleto, PIX, BolePix. 체크아웃에서 제공할 결제 수단을 선택할 수 있습니다.
CPF / CNPJ 필드: boleto와 PIX의 경우 체크아웃에서 입력을 요청하며, 검증 번호로 확인합니다. 클래식 체크아웃과 체크아웃 블록 모두에서 동작합니다. Brazilian Market on WooCommerce가 활성화되어 있으면 해당 플러그인의 데이터를 사용합니다.
Vindi 확인 시에만 결제 완료: 플러그인이 Vindi API에서 청구서를 다시 읽고 주문 코드, Vindi 고객, 정확한 금액을 확인한 후에만 주문이 결제 완료로 표시됩니다. 일치하지 않으면 주문은 메모와 함께 보류 상태가 됩니다.
보호된 웹훅: 웹훅 URL에는 비밀 토큰이 포함되어 있으며, 각 알림은 Vindi API를 통한 재확인만 실행합니다.
이중 결제 방지: 새로운 결제 시도는 대기 중인 Vindi 청구서를 재사용하거나 먼저 취소합니다. 미결제 주문이 취소되면 해당 Vindi 청구서도 취소되며, 그 사이 청구서가 결제되었다면 주문이 대신 결제 완료로 표시됩니다.
운영 및 샌드박스: API 키가 따로 있습니다. 각 주문은 청구서가 생성된 환경을 기억하므로, 확인과 환불은 항상 해당 환경에서 이루어집니다.
환불: WooCommerce 주문 화면에서 카드 및 PIX 결제의 전액 및 부분 환불이 가능합니다.
최신 WooCommerce 지원: 클래식 체크아웃, 체크아웃 블록, Pay for order 페이지, HPOS. 영어와 브라질 포르투갈어를 지원합니다.
요구 사항
WordPress 6.0 이상, WooCommerce 8.0 이상, PHP 8.0 이상, 쇼핑몰 통화 브라질 헤알(BRL). API 키가 있는 Vindi 계정(테스트용 Vindi 샌드박스 계정 포함). vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).