Motor de Recorrência Vindi

Neste artigo, explicamos como a Vindi gerencia automaticamente a cadeia de transações recorrentes (BrandTID ou TransactionLinkID) para quem utiliza nosso motor nativo (Assinaturas Vindi). Essa automação garante a conformidade com as regras das bandeiras e aumenta as taxas de aprovação, sem exigir integrações complexas.

O que é o BrandTID e TransactionLinkID?

São códigos únicos gerados pelas bandeiras (como Visa, Mastercard e Elo) para rastrear o ciclo de vida das transações recorrentes. O fluxo é dividido em duas etapas:

CIT (Customer Initiated Transaction / Transação inciada pelo Pagador): É a 1ª transação, onde o cliente insere ativamente os dados do cartão. Aqui, o código original é gerado pela bandeira.

MIT (Merchant Initiated Transaction/ Transação inciada pelo Lojista/Motor Vindi): São as renovações automáticas renovações automáticas, geração de faturas avulsas com cartão armazenado (sem a presença do cliente). Nestas transações, é obrigatório enviar o código gerado na etapa CIT para comprovar que a cobrança faz parte de uma cadeia autorizada.

Como a Vindi gerencia o BrandTID e TransactionLinkID automaticamente?

Quando você confia a gestão das suas assinaturas ao nosso motor de recorrência, a Vindi assume a gestão de por toda a cadeia do BrandTID e TransactionLinkID, conforme as regras estabelecidas no mercado. Nós atuamos nos bastidores para garantir que o ciclo de vida do cartão esteja perfeitamente mapeado e adequado às exigências dos bancos emissores e adquirentes.

O fluxo automático funciona da seguinte maneira:

Coleta: O seu cliente realiza o cadastro e a primeira compra ou atualização do cartão ativamente. A Vindi processa a transação (CIT), e faz a coleta do BrandTID ou TransactionLinkID que é devolvido pela adquirente/bandeira e o armazena de forma segura e atrelada ao Perfil de Pagamento (Cartão de Crédito do Pagador) criptografado no nosso cofre.

Armazenamento Seguro: O BrandTID e TransactionLinkID ficam vinculados a um token seguro cartão do pagador em nosso banco de dados, onde os dígitos, expiração e demais informações não são expostos a nenhum sistema ou usuário, seguindo regras rídigas de acordo com PCI DSS (Payment Card Industry Data Security Standard/Padrão de Segurança de Dados da Indústria de Cartões de Pagamento).

Injeção nas Renovações: Quando o motor de recorrência gera a próxima fatura (seja no mês seguinte, no próximo semestre, etc.), ele identifica automaticamente que se trata de uma renovação (MIT), resgata o BrandTID ou TransactionLinkID original atrelado àquele cartão e o injeta na requisição de pagamento enviada à adquirente.

Atualização de Cartão de Crédito: Se o cliente precisar trocar o cartão vinculado à assinatura, esse processo é tratado como uma nova transação iniciada pelo cliente (CIT), pois envolve a inserção de novos dados. A Vindi capturará os novos identificadores (BrandTID e Transaction Link ID) e passará a utilizá-los nas próximas renovações (MIT).

Regras para a Gestão Automática

Para que a Vindi gerencie o BrandTID e o TransactionLinkID automaticamente, a sua operação deve utilizar as entidades nativas da nossa plataforma corretamente através de configurações solicitadas à nossas equipes. O mapeamento da cadeia transacional só funciona se as regras abaixo forem rigorosamente seguidas:

• Cadastro de Assinaturas: A recorrência deve ser gerida através da criação de uma Subscription vinculada a um Plan (Plano) e a um Customer (Cliente). É a existência da assinatura que informa ao motor que as renovações fazem parte de uma cadeia, possibilitando a injeção automática dos identificadores de recorrência.

• Uso de Perfis de Pagamento (Payment Profiles): O cartão do cliente deve ser salvo como um Perfil de Pagamento no cofre da Vindi. Com isso a Vindi classifica automaticamente os tipos de transação (CIT ou MIT) que ficam atrelados a estre perfil no momento da transação.

• Configuração de Captura em método de pagamento / gateway: O gateway obrigatoriamente deve estar configurado em “01 Etapa: Cobrança automática” - Cobrança (Purchase) (Regra exigida pelas Bandeiras). Essas informações são fornecidas à nossa equipe de Vindi no processo de setup inicial de sua operação na plataforma.

  Exemplos para conferência e como acessar essa informação:

  • Acessar a plataforma > Configurações>Gateways

    

• Acessar a plataforma > Configurações>Métodos de Pagamento>Cartão de Crédito

  

• Sinalização de Recorrência: A flag de recorrência deve estar obrigatoriamente habilitada como sim dentro das configurações do gateway (Regra exigida pelas bandeiras). Essas informações são fornecidas à nossa equipe de Vindi no processo de seu início de operação na plataforma, com a confirmação do tipo de sua operação.

• Regra de Parcelamento: O parcelamento de faturas/cobranças com intervalo definido no plano deverá ser igual a 1 a cada fatura gerada (Regra exigida pelas bandeiras).

Regras reinicialização e controle de BrandTid e TransactionLinkID

O BrandTid e TransactionLinkID seguem algumas regras obrigatórias de revisão.

As seguintes situações reiniciam o BrandTid/TransactionLinkID, reiniciando um novo ciclo de coleta automática pela Vindi:

• Mudança de periodicidade (exemplo - nova assinatura de mensal para semestral);
• Alteração no valor da cobrança;
• Novo cartão utilizado na transação (exemplo - quando após uma rejeição o cliente altera ativamente o cartão da assinatura);

Exemplos de retorno - Retornos BrandTid/TrasactionLinkID

• Documentação Pública Vindi:
  https://vindi.github.io/api-docs/dist/#/

Incluímos um novo parâmetro chamado brand_tid oque deve ser enviado conforme as regras estabelecidas que retornam dentro das entidades charges, bills e transactions, assim como em webhooks de charge_rejected, bill_paid, charge_refunded. Conforme a sua adquirente contratada.

Exemplo parcial do retorno Cielo:

"last_transaction": {
      "id": 987958754,
      "transaction_type": "charge",
      "status": "success",
      "amount": "5.55",
      "installments": 1,
      "gateway_message": "Transacao capturada com sucesso",
      "gateway_response_code": null,
      "gateway_authorization": "6b50fbe4-a39e-4f17-a208-aaed08031weg",
      "gateway_transaction_id": "19c7dd53-65d8-4c71-b372-99b481d8c87a",
      "gateway_response_fields": {
        "tid": "28559795305MV97HGA2B",
        "authorization_code": "437213",
        "proof_of_sale": "042861",
        "payment_id": "6b50fbe4-a39e-4f17-a208-aaed08031weg",
        "issuer_transaction_id": "YTV0I6",
        "brand_tid": "YTV0I6",
        "transaction_link_id": "KHI3FCRFQ9aVIR6LPbyGFT"
      }

Exemplo parcial do retorno Rede:

"last_transaction": {
      "id": 987958754,
      "transaction_type": "charge",
      "status": "success",
      "amount": "5.55",
      "installments": 1,
      "gateway_message": "Transacao capturada com sucesso",
      "gateway_response_code": null,
      "gateway_authorization": "6b50fbe4-a39e-4f17-a208-aaed08031weg",
      "gateway_transaction_id": "19c7dd53-65d8-4c71-b372-99b481d8c87a",
      "gateway_response_fields": {
        "tid": "28559795305MV97HGA2B",
        "authorization_code": "437213",
        "proof_of_sale": "042861",
        "payment_id": "6b50fbe4-a39e-4f17-a208-aaed08031weg",
        "issuer_transaction_id": "YTV0I6",
        "brand_tid": "YTV0I6",
        "transaction_link_id": "KHI3FCRFQ9aVIR6LPbyGFT"
      }

Toda transação retorna um valor de BrandTid/TransactionLinkID diferente, e a Vindi altera esse dado somente se ocorrer uma mudança conforme as listadas acima.

Toda primeira transação com um novo cartão será feita com o CVV, às demais transações recorrentes de um cartão já cadastrado será enviado sem o uso do CVV em conformidade com as regras de PCI Compliance e das adquirentes e bandeiras.

Possui dúvidas? Acione nosso canal de atendimento via Chat na Plataforma para obter informações ou solicitar alterações.