Cria uma transação de débito
Ambiente | Método | Endpoint |
|---|---|---|
Sandbox | post |
|
Produção | post |
|
Saiba mais sobre essa funcionalidade na documentação.
Para o ambiente sandbox, use o valor "Simulado" no campo
Payment.Provider.
CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.
O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.
Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.
Autenticação 3DS nas transações de cartão de débito
- A autenticação 3DS é obrigatória para as transações de débito. Na transação de débito padrão (com autenticação), envie
Authenticate= "true"; - Informe os dados recebidos na saída do script no nó
Payment.ExternalAuthentication; - Em transações com autenticação 3DS Data Only, é necessário informar o parâmetro
ExternalAuthentication.DataOnlycomo true. - Para confirmar se a autenticação foi acatada na autorização, verifique o valor do ECI retornado em
Payment.Eci. A API replica o ECI informado pela loja no campoPayment.ExternalAuthentication. No entanto, o valor efetivamente utilizado pela bandeira na autorização é o que aparece emPayment.Eci.
ImportanteA validação e o retorno do campo
Payment.Eciocorrem apenas no ambiente de produção neste primeiro momento.
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 VerifyCard (apenas resposta) e para as transações de crédito, débito e recorrência.
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 VerifyCard, 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 VerifyCard não aceita o campo.
Saiba mais em Identificadores da bandeira para adquirente Cielo.
Resposta da transação de cartão de débito
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 débito.
Propriedade | Descrição | Tipo | Tamanho |
|---|---|---|---|
| Id da transação no provedor de meio de pagamento. | string | 40 |
| Número do comprovante de venda. | string | 20 |
| Indica qual número de pedido foi enviado à adquirente.
| GUID | |
| Código de autorização. | string | 300 |
| Campo identificador do pagamento. O | GUID | 36 |
| Data em que a transação foi recebida pela Cielo. | string | 19 |
| Código de retorno da API para indicar sucesso ou erro na operação. | string | 32 |
| Mensagem correspondente ao | string | 512 |
| Status da transação. Veja a lista completa de Status da Transação. | byte | 2 |
| Código retornado pelo provedor do meio de pagamento (adquirente ou emissor). | string | 32 |
| Mensagem retornada pelo provedor do meio de pagamento (adquirente ou emissor). | string | 512 |
| Código de retorno da bandeira que define período para retentativa. Válido para bandeira Mastercard. Saiba mais em Merchant Advice Code (MAC) – Mastercard. | string | 2 |
| Valor | string | 28 |
| Valor | string | 28 |
| Valor | integer | 1 |
| Versão do 3DS utilizado no processo de autenticação. | string | 1 |
| RequestID retornado no processo de autenticação. | GUID | 36 |
| 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 da bandeira para adquirente Cielo. | string | 30 |
| 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 |
| TLID que o estabelecimento enviou no request e que a Cielo repassou à bandeira. O campo só aparece quando a Cielo enviou o TLID. Consulte mais informações em Identificadores da bandeira para adquirente Cielo. | string | 22 |