Identificadores da bandeira

O identificador da bandeira é um código de identificaçã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).

A loja solicita autorização da primeira transação ou validação do cartão (ZeroAuth);
A API E-Commerce Cielo envia solicitação para adquirente, bandeira e emissor;
A bandeira do cartão aprova a transação e retorna o IssuerTransactionId;
A API E-commerce Cielo retorna o IssuerTransactionId;
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;
Amex.

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"
         }
     }
   }
}

PROPRIEDADE	TIPO	TAMANHO	OBRIGATÓRIO	DESCRIÇÃO
`MerchantOrderId`	Texto	50	Sim	Número de identificação do pedido. Atenção: Os caracteres permitidos são apenas a-z, A-Z, 0-9. Não são permitidos caracteres especiais e espaços em branco.
`Payment.Type`	Texto	100	Sim	Tipo do meio de pagamento.
`Payment.Amount`	Número	15	Sim	Valor do pedido (ser enviado em centavos).
`Payment.Installments`	Número	2	Sim	Número de parcelas.
`Payment.Capture`	Booleano	—	Não (Default false)	Booleano que identifica que a autorização deve ser com captura automática (“true”) ou captura posterior (“false”).
`Payment.IssuerTransactionId`	Texto		Condicional	Identificador de autenticação do emissor para transações de crédito e débito recorrentes. Este campo deve ser enviado nas transações subsequentes da primeira transação no modelo de recorrência própria. Já no modelo de recorrência programada, a Cielo será a responsável por enviar o campo nas transações subsequentes.
`Payment.Recurrent`	Booleano		Não	Indica se a transação é do tipo recorrente (“true”) ou não (“false”). O valor “true” não originará uma nova recorrência, apenas permitirá a realização de uma transação sem a necessidade de envio do CVV. Authenticate deve ser “false” quando Recurrent é “true”.
`CreditCard.CardNumber`	Texto	19	Sim	Número do cartão do comprador.
`CreditCard.Holder`	Texto	25	Sim	Nome do comprador impresso no cartão. Não aceita caracteres especiais ou acentuação.
`CreditCard.ExpirationDate`	Texto	7	Sim	Data de validade impressa no cartão. Ex. MM/AAAA.
`CreditCard.SecurityCode`	Texto	4	Não	Código de segurança impresso no verso do cartão.
`CreditCard.SaveCard`	Booleano	—	Não (Default false)	Booleano que identifica se o cartão será salvo para gerar o CardToken.
`CreditCard.Brand`	Texto	10	Sim	Bandeira do cartão. Valores possíveis: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.
`CreditCard.CardOnFile.Usage`	Texto		Não	First se o cartão foi armazenado e é seu primeiro uso. Used se o cartão foi armazenado e ele já foi utilizado anteriormente em outra transação.
`CreditCard.CardOnFile.Reason`	Texto		Condicional	Indica o propósito de armazenamento de cartões, caso o campo "Usage" for "Used". Recurring - Compra recorrente programada (ex. assinaturas). Se for transação recorrente, usar `Payment.Recurrent` = true (recorrência própria) ou `Recurrent.Payment` = true (recorrência programada). Unscheduled - Compra recorrente sem agendamento (ex. aplicativos de serviços) Installments - Parcelamento através da recorrência. Saiba mais em Card On File