Cria uma transação usando um cartão tokenizado anteriormente
| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/1/sales/ |
| Produção | post | https://api.cieloecommerce.cielo.com.br/1/sales/ |
Saiba mais sobre essa funcionalidade na documentação.
Essa é uma transação de cartão de crédito, mas no lugar de enviar os dados do cartão aberto, é possível criar a transação informando um CardToken criado previamente.
TLID Mastercard
O Transaction Link Identifier (TLID), enviado e retornado no campo TransactionLinkId, é um identificador único gerado pela bandeira Mastercard durante uma transação CIT, usado para vincular as transações MIT relacionadas. O TLID vale para a resposta do Zero Auth (apenas resposta) e para as transações de crédito, débito e recorrência própria.
Na Mastercard, envie IssuerTransactionId e TransactionLinkId juntos nas transações MIT: os dois parâmetros são obrigatórios.
| Fase | Descrição |
|---|---|
| Fase 1 | Vigente. O campo TransactionLinkId está disponível na resposta da validação de cartão por Zero Auth, criação de pagamento com cartão de crédito, criação de pagamento com cartão de débito e na consulta por PaymentId. |
| Fase 2 | Envio obrigatório do TransactionLinkId no request (MIT) a partir de 23/10/2026. |
Recorrência programada: nas transações seguintes, os campos
IssuerTransactionIdeTransactionLinkIdsão enviados automaticamente.
O TransactionLinkId enviado no request deve ter exatamente 22 caracteres (A-Z, a-z, 0-9, hífen e sublinhado). Se o valor estiver fora desse formato, a Cielo o ignora, sem retornar erro. Quando a Cielo envia o TLID à bandeira, a resposta traz também o SentTransactionLinkId, com o valor enviado. O request do Zero Auth não aceita o campo.
Saiba mais em Identificadores de bandeira.
Resposta da transação de cartão de crédito usando cartão tokenizado
A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na criação de um pagamento com cartão de crédito tokenizado.
| Propriedade | Descrição | Tipo | Tamanho |
|---|---|---|---|
ProofOfSale | Número da autorização, idêntico ao NSU. | string | 6 |
Tid | Identificador da transação na adquirente. | string | 20 |
AuthorizationCode | Código de autorização. | string | 6 |
PaymentId | Número de identificação do pagamento. O PaymentId será usado em futuras operações como consulta, captura e cancelamento. | GUID | 36 |
Status | Status da Transação. Veja a tabela completa de Status transacional | byte | |
ReturnCode | Código de retorno. | string | 32 |
ReturnMessage | Mensagem de retorno. | string | 512 |
Payment.MerchantAdviceCode | Código de retorno da bandeira que define período para retentativa. Válido somente para bandeira Mastercard. Saiba mais Programa de retentativa das bandeiras para Mastercard | string | 2 |
TryAutomaticCancellation | Retorna como "true" se a Garantia de Cancelamento estiver habilitada e ocorrer algum erro durante a autorização (status Não Finalizada - "0"). | boolean | |
Payment.CreditCard.PaymentAccountReference | O PAR (Payment Account Reference) é o número que associa diferentes tokens a um mesmo cartão. Será retornado pelas bandeiras Master e Visa e repassado para os clientes do e-commerce Cielo. Caso a bandeira não envie a informação o campo não será retornado. | string | 29 |
Payment.IssuerTransactionId | Identificador da transação gerado pela bandeira e retornado na resposta da transação CIT. Armazene o valor para enviá-lo nas transações MIT seguintes: o envio é obrigatório, para todas as bandeiras, em transações recorrentes, incrementais e reautorizadas. Consulte mais informações em Identificadores de bandeira. | string | 30 |
Payment.TransactionLinkId | Identificador único (TLID) gerado pela Mastercard e retornado na resposta, usado para vincular a transação CIT às transações MIT seguintes. Na Mastercard, envie o Formato: 22 caracteres alfanuméricos (A-Z, a-z), com diferenciação entre maiúsculas e minúsculas e podem incluir hífens (-) e sublinhados (_). | string | 22 |