Autorização para transações Data Only
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 no modelo Data Only (com o campo bpmpi_auth_notifyonly
como "true"), 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.
Para as bandeiras Visa e Mastercard, é obrigatório usar a versão 2.2 do protocolo 3DS para autenticação DataOnly.
Veja a seguir um exemplo de requisição de autorização à API E-commerce Cielo.
Requisição Data Only
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":false,
"ReturnUrl":"http://www.loja.com.br",
"CreditCard":{
"CardNumber":"4000000000001000",
"Holder":"Nome do Portador",
"ExpirationDate":"12/2030",
"SecurityCode":"123",
"Brand":"Mastercard",
"SaveCard":"false"
},
"ExternalAuthentication":{
"Eci":"4",
"ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6",
"Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
"Version":"2.2.0",
"dataonly":true
}
}
}
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":false,
"ReturnUrl":"http://www.loja.com.br",
"CreditCard":{
"CardNumber":"4000000000001000",
"Holder":"Nome do Portador",
"ExpirationDate":"12/2030",
"SecurityCode":"123",
"Brand":"Mastercard",
"SaveCard":"false"
},
"ExternalAuthentication":{
"Eci":"4",
"ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6",
"Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
"Version":"2.2.0",
"dataonly":true
}
}
}
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.
Campo | Descrição | Tipo | Tamanho | Obrigatório |
---|---|---|---|---|
Payment.Authenticate | Define se o comprador será direcionado ao emissor para autenticação do cartão. | booleano ("true" / "false") | - | Sim. No caso de transação Data Only, é obrigatório enviar como "false". |
Payment.ExternalAuthentication.Eci | E-Commerce Indicator retornado no processo de autenticação. | número | 1 posição | Sim. |
Payment.ExternalAuthentication.ReferenceId | RequestID retornado no processo de autenticação. | GUID | 36 posições | Sim. |
Payment.ExternalAuthentication.DataOnly | Define se é uma transação Data Only. | booleano ("true" / "false") | - | Sim. No caso de transação Data Only, é obrigatório enviar como "true". |
Payment.ExternalAuthentication.Cavv | Assinatura retornada nos cenários de sucesso na autenticação. | texto | - | Sim, caso a autenticação seja validada. |
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" | texto | 5 | Sim |
Updated 29 days ago