Identificadores da bandeira para adquirente Cielo

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 (VerifyCard).

A loja solicita autorização da primeira transação ou validação do cartão (VerifyCard);
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 VerifyCard) 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 VerifyCard pelo número do cartão.

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