Autorização com autenticação
Confira os exemplos completos de requisição e resposta para cada meio de pagamento:
Após a autenticação do emissor do cartão ser concluída, submete-se a transação ao processo de autorização, enviando os dados de autenticação no modelo de "autenticação externa" (nó ExternalAuthentication).
Este procedimento é válido também para estabelecimentos que realizaram a autenticação fora da Cielo (MPI Externo).
Veja abaixo um exemplo de envio de dados de autenticação da requisição de autorização da API Gateway de Pagamento, utilizando o método POST:
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.braspag.com.br/v2/sales/ |
| Production | post | https://api.braspag.com.br/v2/sales/ |
{
"MerchantOrderId":"2017051002",
"Customer":
{
(...)
},
"Payment":
{
(...)
"Provider":"Cielo30",
"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.2.0",
"ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
}
}
}
| Campo | Descrição | Tipo/Tamanho | Obrigatório |
|---|---|---|---|
Payment.Provider | Nome do provedor do meio de pagamento: Cielo30, Getnet ou Rede. | Texto / 15 | 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 | Este campo é obrigatório para transações que foram autenticadas pelo emissor ou pela bandeira e nas solicitações de autorizações com Data Only. |
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. | Numérico / 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 8 days ago