VibeFox Vindi for PrestaShop

Visão geral

O VibeFox Vindi Gateway conecta o PrestaShop à API da Vindi para lojas do Brasil que vendem em Real (BRL). Os clientes pagam com cartão de crédito na página de fatura da Vindi, ou com boleto, PIX ou BolePix (boleto + PIX). Os dados do cartão nunca passam pelo seu site. No caso de boleto e PIX, o pedido fica em Awaiting Vindi payment, e o cliente recebe o link do boleto e os códigos PIX na página de confirmação do pedido, em Minha conta e no e-mail.

Ele é 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 pedido só é criado depois que a Vindi confirma o pagamento, então pagamentos abandonados não deixam pedidos sem pagamento. O módulo aceita apenas pagamentos únicos, em uma parcela. Não há assinaturas ou cobranças recorrentes, cartões salvos, parcelamento nem formulário de cartão no seu site, e não é possível reembolsar pagamentos de 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 de compra.

Campo CPF / CNPJ: solicitado na finalização de compra para boleto e PIX e validado pelos dígitos verificadores. Quando possível, ele é preenchido com os dados de endereço do cliente.

Pago somente quando a Vindi confirma: o pagamento só é aceito depois que o módulo lê a fatura pela API da Vindi e confere a moeda, o código do carrinho, o cliente na Vindi e o valor exato. Se algo não bater, o pedido fica em espera com uma nota.

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

Sem pagamentos duplicados: uma nova tentativa reutiliza a fatura pendente na Vindi ou a cancela antes. Quando um pedido não pago é cancelado na loja, a fatura dele na Vindi também é cancelada.

Produção e sandbox: chaves de API separadas. Cada pagamento guarda onde a sua fatura foi criada, então consultas e reembolsos sempre usam esse ambiente.

Reembolsos pela página do pedido: reembolsos totais e parciais de pagamentos com cartão e PIX no bloco Vindi payment, até o valor que a Vindi efetivamente cobrou. Um reembolso total coloca o pedido em Refunded.

Bloco da Vindi na página do pedido: as faturas do carrinho, o histórico de reembolsos e as notas do módulo.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior, moeda da loja: Real brasileiro (BRL). Uma conta na Vindi com chave de API (e uma conta de teste na Vindi sandbox para testes). Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).