Autorização com autenticação
Confira os exemplos completos de requisição e resposta para cada meio de pagamento:
Após a conclusão da autenticação do portador do cartão, a loja deve submeter a transação ao processo de autorização, enviando os dados de autenticação no modelo de "autenticação externa" (nó ExternalAuthentication), tanto para 3DS Server interno quanto para 3DS Server externo.
Veja a seguir um exemplo de requisição de autorização à API E-commerce Cielo:
Requisição de autorização com o nó da autenticação
Confira a seguir o exemplo de uma autorização de cartão de crédito com o nó da autenticação.
| Environment | Method | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/1/sales |
| Production | post | https://api.cieloecommerce.cielo.com.br/1/sales |
{
"MerchantOrderId":"2017051002",
"Customer":
{
(...)
},
"Payment":
{
(...)
"Authenticate":true,
"ReturnUrl":"http://www.loja.com.br",
"CreditCard":{
"CardNumber":"4000000000001000",
"Holder":"Nome do Portador",
"ExpirationDate":"12/2021",
"SecurityCode":"123",
"Brand":"Visa",
"SaveCard":"false"
},
"ExternalAuthentication":{
"Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
"Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
"Eci":"5",
"Version":"2",
"ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
}
}
}
curl
--request POST "https://apisandbox.cieloecommerce.cielo.com.br/1/sales"
--header "Content-Type: application/json"
--header "MerchantId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
--header "MerchantKey: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
--data-binary
--verbose
{
"MerchantOrderId":"2017051002",
"Customer":
{
(...)
},
"Payment":
{
(...)
"Authenticate":true,
"ReturnUrl":"http://www.loja.com.br",
"CreditCard":{
"CardNumber":"4000000000001000",
"Holder":"Nome do Portador",
"ExpirationDate":"12/2021",
"SecurityCode":"123",
"Brand":"Visa",
"SaveCard":"false"
},
"ExternalAuthentication":{
"Cavv":"AAABB2gHA1B5EFNjWQcDAAAAAAB=",
"Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
"Eci":"5",
"Version":"2",
"ReferenceId":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
}
}
}
| Campo | Descrição | Tipo | Tamanho | Obrigatório |
|---|---|---|---|---|
Payment.Provider | Nome do provedor do meio de pagamento (Cielo30). | texto | 15 posições | Sim. |
Payment.Authenticate | Define se o comprador será direcionado ao emissor para autenticação do cartão. | booleano ("true" / "false") | - | Sim, caso a autenticação seja validada. |
Payment.ExternalAuthentication.Cavv | Assinatura retornada nos cenários de sucesso na autenticação. | texto | - | Sim, caso a autenticação seja validada. |
Payment.ExternalAuthentication.Xid | XID retornado no processo de autenticação. | texto | - | Sim, quando a versão do 3DS for "2" ou superior. |
Payment.ExternalAuthentication.Eci | Electronic Commerce Indicator retornado no processo de autenticação. | número | 1 posição | Sim. |
Payment.ExternalAuthentication.Version | Versão do 3DS aplicado no processo de autenticação. Valores possíveis: - Visa e Mastercard: "2.2.0" - Elo e Amex: "2.1.0" | alfanumérico | 5 posições. | Sim, quando a versão do 3DS for "2" ou superior. |
Payment.ExternalAuthentication.ReferenceID | RequestID retornado no processo de autenticação. | GUID | 36 posições | Sim, quando a versão do 3DS for "2" ou superior. |
A resposta irá seguir o padrão de uma resposta de transação de crédito ou débito. Confira os detalhes na Referência da API.
Updated 7 days ago