Contabilização por Bandeira de Cartão (Link de Pagamento Vindi)

Introdução

Por padrão, toda baixa via Link de Pagamento Vindi gera o título/Contas a Receber (CR) usando um ID do Cartão fixo, configurado no Contrato Bancário — sem distinguir a bandeira do cartão utilizado pelo cliente final. Isso faz com que Visa, Mastercard, Elo etc. sejam contabilizadas no mesmo cartão/conta contábil.

A funcionalidade de Contabilização por Bandeira de Cartão permite vincular cada bandeira a um cartão SAP diferente, por Contrato Bancário. Assim, no momento da baixa, o BankPlus identifica a bandeira retornada pela Vindi e contabiliza o CR no cartão/conta contábil correspondente.

Esta configuração é opcional: contratos que não a utilizam seguem funcionando no fluxo padrão (cartão único).

ATENÇÃO
Para melhor visualização das imagens, clique sobre elas.

IMPORTANTE — Pré-requisitos
Antes de configurar a contabilização por bandeira, garanta que:

1. O Contrato Bancário de Link de Pagamento Vindi já esteja cadastrado e funcional (ver artigo base linkado no rodapé).
2. Os cartões que serão vinculados às bandeiras estejam cadastrados no SAP Business One (tabela nativa OCRC / CRC1).

Caminho de acesso:

BankPlus → Cobrança → Configurações → Contrato Bancário

Selecione o contrato de Link de Pagamento Vindi, clique em Editar, acesse a aba Arquivo → API e clique no botão Bandeiras.

Passo a passo da configuração:

1. Abrir a janela Bandeira → Cartão

Ao clicar em Bandeiras, abre-se a janela Bandeira → Cartão, com as colunas Bandeira e Cartão.

2. Carregar / incluir as bandeiras

As bandeiras podem ser adicionadas de duas formas, combináveis:

• Carregar do Banco — traz as bandeiras a partir do banco/conta configurada.
• Inclusão manual — adicione bandeiras diretamente na grid, linha a linha.

Importante: 
"Na inclusão manual, o nome da bandeira deve corresponder exatamente ao código retornado pela Vindi (ex.: visa, mastercard, elo, em minúsculas). Prefira o Carregar do Banco para evitar divergência."

3. Vincular o cartão SAP a cada bandeira

Para cada linha (bandeira), selecione na coluna Cartão o cartão SAP correspondente. É esse vínculo que direciona a contabilização — cada bandeira passa a ser baixada no cartão escolhido.

OBSERVAÇÃO
O valor 0 na coluna Cartão indica bandeira ainda sem cartão vinculado. Nenhuma linha deve permanecer com 0, caso contrário a baixa daquela bandeira será abortada.

Exemplo de preenchimento:

4. Salvar

Confirme na janela Bandeira → Cartão e conclua o cadastro do contrato em Atualizar.

🟦 OBSERVAÇÃO — Parâmetros API
Na janela Parâmetros API do mesmo contrato, além dos parâmetros já existentes (ID DO WEBHOOK, ID DO CARTAO, METODO DE PAGAMENTO, CODIGO DO PRODUTO, TELEFONE CELULAR), passa a aceitar o parâmetro ID DO METODO DE PAGAMENTO CARTAO. 

Comportamento na baixa

A bandeira é lida do campo payment_company.code retornado pela Vindi, presente em dois fluxos com formatos diferentes:

Com base na bandeira recebida, a baixa segue uma de três regras:

1. Bandeira configurada → o CR é baixado/contabilizado no cartão vinculado àquela bandeira.
2. Bandeira não configurada, havendo outras bandeiras cadastradas → a baixa é abortada: o título fica em vermelho na grid de Títulos Bancários, um evento de erro é gravado no Histórico do Título, e o Nº Contas a Receber permanece = 0.
3. Nenhuma bandeira cadastrada (grid Bandeira → Cartão vazia) → o contrato segue o fluxo padrão (ID do Cartão fixo), sem bloqueio.

IMPORTANTE
A regra 3 é o que garante retrocompatibilidade: contratos sem nenhuma bandeira configurada não são afetados e continuam baixando normalmente pelo cartão único. O bloqueio (regra 2) só ocorre quando existem bandeiras cadastradas e a bandeira recebida não está entre elas.

Histórico do Título com o evento de erro de bandeira sem cartão configurado:

Exemplo de mensagem de erro que poderá ser observada no Histórico:

"Não há cartão configurado para a bandeira [visa] no contrato bancário [10005 - Link Pagamento VINDI]. Cadastre a configuração…"

DICA
Para o cadastro completo do Contrato Bancário de Link de Pagamento Vindi (abas Arquivo de Licença, Geral, Boleto, Arquivo/API, Contabilização e Ações de Remessa), acesse o artigo: BankPlus | Contrato Bancário - Link de Pagamento Vindi

Resultado

Com a configuração ativa e as bandeiras vinculadas, cada pagamento é contabilizado no cartão/conta contábil correto conforme a bandeira retornada pela Vindi. Bandeiras sem cartão vinculado têm a baixa bloqueada e sinalizada, evitando contabilização indevida.