BrandTID

Motor Próprio de Recorrência

É quando o cliente/lojista opta por integrar sua solução com o Vindi Hub utilizando a fatura avulsa e aplicando seu próprio mecanismo de recorrência.

Como a transação é processada como uma fatura única, isso pode resultar em erros de transação e, consequentemente, na redução da taxa de aprovação.

Com o objetivo de adequar as transações avulsas no formato recorrência para clientes que desejam ter o motor de recorrência do seu próprio lado, resolvemos fazer algumas adequações para a bandeira observar a transação de faturas avulsas no formato de recorrência.

Requisitos para uso

1. O Cliente/Lojista deve controlar a periodicidade das assinaturas (motor de recorrência próprio);
2. O Cliente/Lojista precisa gerenciar as regras do BrandTid;
3. O Cliente/Lojista tem de estar trabalhando no formato de fatura avulsa;
4. O gateway obrigatoriamente deve estar configurado em “01 Etapa: Cobrança automática”;
5. A flag de recorrência obrigatoriamente habilitada como true para indicar que uma fatura avulsa, na verdade, é uma cobrança recorrente.

---

O que é o BrandTid?

O BrandTid é um campo único e dinâmico, recebido a cada resposta de transação, e é utilizado para identificar planos de recorrência.
Deve ser enviado para a bandeira a partir da segunda transação recorrente, e faz a correlação das transações subsequentes com a primeira.

• Enviado apenas quando há uma recorrência.
• O estabelecimento/lojista é responsável por armazenar o BrandTid retornado e enviá-lo em todas as transações subsequentes.

Os identificadores das bandeiras são importantes para garantir uma melhor taxa de aprovação, pois permitem relacionar a transação atual com uma transação anterior, facilitando o reconhecimento pelo emissor.

• Visa: uso obrigatório, especialmente em transações tokenizadas.
• Mastercard: o envio é necessário para relacionar corretamente as recorrências.
• Adquirentes que suportam: e.Rede, Cielo v3 e Stone (Mastercard e Visa). Em breve: Elo.

---

Regras de controle BrandTid

O BrandTid segue algumas regras obrigatórias. Caso não sejam cumpridas, a bandeira pode rejeitar a transação.

As seguintes situações reiniciam o BrandTid, sendo necessário iniciar um novo ciclo:

• Mudança de periodicidade
• Alteração no valor da cobrança
• Novo cartão utilizado na transação

---

IMPORTANTE

Na primeira transação, o BrandTid deve ser armazenado e utilizado nas transações subsequentes do ciclo de recorrência.

⚠️

ATENÇÃO:

A adquirente Cielo não retorna o BrandTid na primeira transação, apenas a partir do segundo ciclo de recorrência.

📝

OBSERVAÇÃO:

Caso a transação não siga as regras do BrandTid, há chance de rejeição pela Bandeira.

---

Exemplo: Endpoint, Chamadas e Retornos BrandTid

O endpoint continua sendo o mesmo do transacional.

• Documentação Vindi:
  https://vindi.github.io/api-docs/dist/#/bills/postV1Bill

• URL:
  http://app.vindi.com.br/api/v1/bills

Incluímos um novo parâmetro chamado brand_tid que deve ser enviado conforme as regras estabelecidas.

Exemplo de envio:

JSON

{
  "customer_id": 2,
  "installments": 1,
  "payment_method_code": "credit_card",
  "brand_tid": "MCS115934093896",
  "bill_items": [
    {
      "product_id": 1,
      "amount": 199
    }
  ],
  "payment_profile": {
    "token": "34800622-7d98-4195-aba8-4c34e1e074f6"
  }
}

 

Parte do retorno:

JSON

{
  "last_transaction": {
    "id": 16165434,
    "transaction_type": "charge",
    "status": "success",
    "amount": "10.0",
    "installments": 1,
    "gateway_message": "Aprovado",
    "gateway_response_code": null,
    "gateway_authorization": "34741081685039",
    "gateway_transaction_id": "20fca6c0-bc66-4313-9f25-fb529f91750f",
    "gateway_response_fields": {
      "stone_id_rcpt_tx_id": "34741081685039",
      "stone_id_issr_tx_id": "172537",
      "brand_tid": "172537"
    }
  }
}

 

Toda transação retorna um valor de BrandTid diferente, você deve salvar o novo BrandTid somente se ocorrer uma mudança de periodicidade da assinatura, valor da transação e/ou mudança de cartão.

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 da adquirente e bandeira.