VibeFox Vindi for OpenCart

Visão geral

O VibeFox Vindi Gateway conecta o OpenCart 3 e o OpenCart 4 à API da Vindi para lojas do Brasil que vendem em reais (BRL). Os clientes pagam com cartão de crédito na página de cobrança da Vindi, ou com boleto, PIX ou BolePix (boleto + PIX). Os dados do cartão nunca passam pelo seu site. Para boleto e PIX, o pedido recebe imediatamente o seu status de aguardando, e o cliente obtém o link do boleto e os códigos PIX na página de sucesso, na conta dele e no e-mail do pedido.

É indicado para lojas brasileiras que já têm uma conta na Vindi e querem pagamentos avulsos sem criar um formulário de cartão. Nos pagamentos com cartão, o OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que a Vindi confirma o pagamento; por isso, as tentativas não pagas permanecem como pedidos ausentes. A extensão aceita pagamentos avulsos somente em parcela única. Ela não tem assinaturas nem cobranças recorrentes, cartões salvos, parcelamento nem formulário de cartão no seu site, e não consegue estornar pagamentos por boleto.

Principais recursos

Quatro formas de pagamento: cartão de crédito, boleto, PIX e BolePix. Você escolhe quais são oferecidas na finalização da compra.

Campo CPF / CNPJ: solicitado na finalização da compra para boleto e PIX, e validado pelos dígitos verificadores. É preenchido previamente com um campo personalizado CPF ou CNPJ do cliente, quando possível.

Pago somente quando a Vindi confirma: o pagamento só é aceito depois que a extensão consulta novamente a cobrança na API da Vindi e verifica a moeda, o código do pedido, o cliente na Vindi e o valor exato. Se houver divergência, o pedido vai para retenção, com uma nota.

Webhook protegido: a URL do webhook contém um token secreto, e cada notificação apenas dispara uma nova verificação pela API da Vindi.

Sem pagamentos duplicados: um carrinho é pago uma única vez. Uma nova tentativa reutiliza a cobrança pendente na Vindi ou a cancela antes. Quando você cancela um pedido não pago no OpenCart, a cobrança correspondente na Vindi também é cancelada.

Produção e sandbox: chaves de API separadas. Cada pagamento lembra onde a sua cobrança foi criada, por isso as verificações e os estornos sempre usam esse ambiente.

Estornos pela página do pedido: estornos totais e parciais de pagamentos com cartão e PIX na aba da extensão na página do pedido, até o valor que a Vindi de fato cobrou. Um estorno total define o seu status de estornado.

Condições do OpenCart: zona geográfica, total mínimo do pedido, ordem de exibição e os seus próprios status de pedido. O log não contém chaves nem dados de clientes.

Requisitos

OpenCart 3.0.x (testado na 3.0.5.0) ou OpenCart 4.0.2 e superior (testado na 4.1.0.3), PHP 8.0 ou superior. Um único download contém os pacotes para as duas versões. A moeda Real brasileiro (BRL) configurada na loja. Uma conta na Vindi com chave de API (e uma conta de sandbox da Vindi para testes). Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).