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