post https://apisandbox.cieloecommerce.cielo.com.br/1/sales/
Cria transação com o meio de pagamento cartão de débito.
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.
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âmetrosCategory
eSubCategory
para transações Mastercard, dentro do nóPayment
. Confira a lista de categorias na descrição do parâmetroCategory
e a tabela completa desubcategorias 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.
Propriedade | Descrição | Tipo | Tamanho |
---|---|---|---|
AuthenticationUrl | URL para qual o Lojista deve redirecionar o Cliente para o fluxo de débito. | Texto | 56 |
Tid | Id da transação na adquirente. | Texto | 20 |
PaymentId | Número de identificação do pagamento. O PaymentId será usado em futuras operações como consulta e cancelamento. | Guid | 36 |
ReturnUrl | URL de retorno do lojista. URL para onde o lojista vai ser redirecionado no final do fluxo. | Texto | 1024 |
Status | Status da Transação. Veja a tabela completa de Status transacional | Byte | *** |
ReturnCode | Código de retorno da adquirência. | Texto | 32 |
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. | Texto | 2 |
Payment.DebitCard.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. | Alfanumérico | 29 |