Criar pagamento com cartão de débito

Cria transação com o meio de pagamento cartão de débito.

AmbienteMétodoEndpoint
Sandboxhttps://apisandbox.cieloecommerce.cielo.com.br/1/sales/
Produçãohttps://api.cieloecommerce.cielo.com.br/1/sales/

ℹ️

Saiba mais sobre essa funcionalidade na documentação.


Atenção

  • Transações de débito Mastercard com credenciais armazenadas: a bandeira Mastercard exige o envio do Indicador de Início da Transação para compras de cartão de crédito e débito que usam os dados armazenados de um cartão. O objetivo é indicar se a transação foi iniciada pelo comprador (Cardholder-Initiated Transaction - CIT) ou pela loja (Merchant-Initiated Transaction - MIT). Nesse cenário é obrigatório o envio do nó InitiatedTransactionIndicator com os parâmetros Category e SubCategory para transações Mastercard, dentro do nó Payment. Confira a lista de categorias na descrição do parâmetro Category e a tabela completa de subcategorias em Indicador de início da transação Mastercard;
  • Não é possível realizar uma transação com valor (Amount) = 0. Para verificar a validade de um cartão, use o Zero Auth.

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.DataOnly como true;
  • Para validar se a autenticação foi acatada na resposta da autorização, considere o ECI fora do nó Payment.ExternalAuthentication.

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.

PropriedadeDescriçãoTipoTamanho
AuthenticationUrlURL para qual o Lojista deve redirecionar o Cliente para o fluxo de débito.Texto56
TidId da transação na adquirente.Texto20
PaymentIdNúmero de identificação do pagamento. O PaymentId será usado em futuras operações como consulta e cancelamento.Guid36
ReturnUrlURL de retorno do lojista. URL para onde o lojista vai ser redirecionado no final do fluxo.Texto1024
StatusStatus da Transação. Veja a tabela completa de Status transacionalByte***
ReturnCodeCódigo de retorno da adquirência.Texto32
Payment.MerchantAdviceCodeCó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.Texto2
Payment.DebitCard.PaymentAccountReferenceO 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.Alfanumérico29
Language
Click Try It! to start a request and see the response here!