Autorização com autenticação

ℹ️
Confira os exemplos completos de requisição e resposta para cada meio de pagamento:

Criar pagamento com cartão de crédito;

Criar pagamento com cartão de débito.

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.

ℹ️Confira os exemplos completos de requisição e resposta para cada meio de pagamento:

Requisição de autorização com o nó da autenticação

ℹ️
Confira os exemplos completos de requisição e resposta para cada meio de pagamento: