Como configurar Pix e cartão pela Vindi Pagamentos

A integração usa Vindi Pagamentos (Commerce) para vendas avulsas da loja. Uma credencial de Vindi Recorrência (Service) não substitui a credencial Commerce.

Configure a conta

1. Abra Formas de pagamento > Vindi.
2. Informe o token da conta Commerce e escolha o ambiente correspondente. O token será protegido e não será exibido novamente.
3. Escolha Pix e/ou cartão, confira o limite de parcelas e o valor mínimo da parcela.
4. Para cartão, confira o CEP de origem em Formas de envio. A plataforma envia esse CEP à Vindi com oito dígitos, usando o cadastro existente da loja.
5. Salve e teste a conexão. O teste simula parcelamento, sem criar cobrança.
6. Ative somente depois de conferir as permissões e condições da conta Vindi. A plataforma verifica a conexão antes de permitir a ativação; uma recusa mantém o cadastro desativado.

Recebimento por Pix

O comprador recebe QR Code e código copia e cola. O pedido só é aprovado depois de a plataforma consultar e confirmar o pagamento na Vindi. Retornar à loja ou informar que pagou não aprova o pedido.

Cartão no checkout seguro

O comprador abre o ambiente seguro da Vindi para informar o cartão e escolher as parcelas disponíveis. O Node não recebe número completo do cartão nem código de segurança. O limite é de até 12 parcelas, sujeito ao contrato e ao valor mínimo configurado.

Juros e parcelas sem juros são definidos na conta Vindi. O checkout hospedado não aceita uma tabela própria de juros enviada pela loja. Se o total cobrado for diferente do total previsto no pedido, o pagamento ficará em conferência. Não habilite cobrança adicional de juros ao comprador antes de validar esse cenário com o suporte.

O teste de conexão passou, mas o cartão deu erro

O teste de conexão simula parcelas; ele não cria o checkout do cartão. A abertura do checkout exige também um CEP de origem válido. Se o CEP estiver ausente ou inválido, a plataforma interrompe o envio antes de criar o pagamento. Confira o cadastro em Formas de envio e cálculo de frete.

Se o CEP estiver correto e o erro continuar, informe ao suporte o número do pedido e o horário da tentativa. Não envie token nem dados do cartão. Uma tentativa que já ficou inconclusiva precisa de conferência; corrigir o cadastro não autoriza uma nova cobrança automática.

Acompanhe o pedido

Pagamentos pendentes, recusados e cancelados são tratados conforme a consulta ao fornecedor. Notificações repetidas não devem gerar outra aprovação. Se uma tentativa tiver resultado inconclusivo, confira a situação antes de cobrar novamente.

Se a comunicação falhar ao abrir o pagamento por cartão, a plataforma tenta recuperar o link já criado na Vindi, conferindo o pedido e o valor. Essa recuperação não cria outro carrinho e não confirma o pagamento.

Estornos e contestações exigem conferência. A solicitação de estorno deve ser feita no painel Vindi; esta integração ainda não oferece esse comando no Node. Trocar a credencial de uma conta que já tem vínculo financeiro exige atendimento para preservar as transações anteriores.

Veja também como configurar formas de pagamento.

Estorno ou contestação antes da confirmação

Quando a consulta ao provedor identifica um estorno ou uma contestação, a plataforma mantém o pagamento em conferência para a conclusão do pedido, mesmo que a aprovação ainda não tenha chegado. Uma aprovação antiga recebida depois não remove esse bloqueio.

Se o pedido já tiver sido concluído, seu histórico e sua baixa de estoque são preservados. Confira a transação e trate o pedido com o suporte antes de realizar outra cobrança ou alterar o estoque. Veja também como acompanhar os pedidos.