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

https://apisandbox.braspag.com.br/v2/sales/

Production

https://api.braspag.com.br/v2/sales/

{  
   "MerchantOrderId":"2017051002",
   "Customer":
   {  
     (...)
   },
   "Payment":
   {  
     (...)
     "Provider":"Cielo30",
     "Authenticate":true,
     "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.

  • OXid não é retornado em todas as autenticações.
  • O envio é recomendado caso oXid tenha sido retornado no script.

Texto

Não

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.

  • OReferenceId não é retornado em todas as autenticações.
  • O envio é recomendado caso oReferenceId tenha sido retornado no script.

GUID / 36 posições

Condicional

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.