post https://apisandbox.cieloecommerce.cielo.com.br/1/sales/
Cria solicitação de autorização para transação de cartão de crédito.
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
Os retornos de autorização estão sujeitos a inserção de novos campos advindos das bandeiras/emissores.
Faça sua integração de forma a prever este tipo de comportamento utilizando adequadamente as técnicas de serialização e deserialização de objetos.
A captura da transação da crédito pode ser automática ou posterior.
- Para captura automática, envie o campo
Payment.Capture
na requisição como “true”;- Para captura posterior, envie o campo como "false" e, posteriormente, faça a requisição de captura.
Atenção
- Não é possível realizar uma transação com valor (
Amount
) 0. Para verificar a validade de um cartão, use o Zero Auth; - Transações de crédito 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 o exemplo do nó e a lista de categorias e subcategorias em Indicador de início da transação Mastercard; - O campo
Payment.ServiceTaxAmount
é exclusivo para empresas aéreas, onde permite que as companhias aéreas cobrem a taxa de embarque separadamente do valor da passagem aérea; - O número de identificação do pedido (
MerchantOrderId
) não sofre alteração ao longo do fluxo transacional. Contudo, um novo número pode ser gerado para o pedido e utilizado durante a transação. Esse número só será diferente se:- o
MerchantOrderID
enviado estiver fora das especificações descritas no campo; - o
MerchantOrderID
enviado já foi utilizado nas últimas 24 horas.
- o
- Para fins de conciliação, use o
TransactionId
(TID).
Autenticação 3DS nas transações de cartão de crédito
- Se a sua loja tem integração com o protocolo 3DS para autenticação do portador do cartão, 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
.