Identificadores da bandeira

O identificador da bandeira é um código de autenticação para transações recorrentes ou com credenciais armazenadas retornado na resposta da autorização ou na resposta da validação do cartão (Zero Auth).

1. A loja solicita autorização da primeira transação ou validação do cartão (ZeroAuth);
2. A API E-Commerce Cielo envia solicitação para adquirente, bandeira e emissor;
3. A bandeira do cartão aprova a transação e retorna o IssuerTransactionId;
4. A API E-commerce Cielo retorna o IssuerTransactionId;
5. A loja envia o IssuerTransactionId da primeira transação ou da transação subsequente.

Por que usar?

Os identificadores das bandeiras são importantes para garantir uma melhor taxa de aprovação, pois uma vez que a transação atual é relacionada com uma transação anterior, o emissor consegue identificar que já houve uma transação iniciada pelo portador.

Esse identificador retornado na transação mais recente deve ser informado nas transações subsequentes.

Bandeiras suportadas:

• Mastercard;
• Visa;
• Elo.

Exemplo de retorno do identificador da bandeira

O identificador da bandeira é retornado no parâmetro IssuerTransactionId na resposta de uma validação de cartão (mais detalhes em Zero Auth) ou também na resposta da primeira transação iniciada pelo portador, dentro do nó Payment.

Atenção: O valor do parâmetro IssuerTransactionId pode ser alterado em uma nova autorização ou em uma nova validação de cartão, ou seja, o emissor pode devolver um novo valor dentro do parâmetro IssuerTransactionId a cada requisição.

Para ver os exemplos de requisições completas, vá para Criando uma transação de crédito ou Validando um cartão com Zero Auth.

A seguir, veja o exemplo de uma resposta da transação de cartão de crédito retornando o IssuerTransactionId:

{  
   "MerchantOrderId":"2014111701",
   "Payment":{  
     "Type":"CreditCard",
     "Amount":15700,
     "Capture":true,
     "Recurrent":"true",
     "IssuerTransactionId": "580027442382078",
     "Installments" 1,
     "CreditCard":{  
         "CardNumber":"1234123412341231",
         "Holder":"Teste Holder",
         "ExpirationDate":"12/2030",
         "SaveCard":"false",
         "Brand":"Visa",
         "CardOnFile":{
            "Usage": "Used",
            "Reason":"Recurring"
         }
     }
   }
}