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) é um identificador único gerado pela bandeira Mastercard durante uma transação, utilizado para estabelecer a continuidade entre transações relacionadas.
| Fase | Descrição |
|---|---|
| Fase 1 | Em breve disponibilizaremos o campo TransactionLinkId 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 a partir de 23/10/2026 (MIT). |
Saiba mais em Indicadores de bandeira.
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; deve ser enviado para referenciar a transação original/anterior em operações relacionadas, como em recorrências. Consulte mais informações em Identificadores da bandeira para adquirente Cielo. | string | 30 |
| 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 |