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 ao Gateway de Pagamento:

Requisição Data Only


Environment

Method

Endpoint

Sandbox

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

Production

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

{
   "MerchantOrderId":"2017051002",
   "Customer":
   {
     (...)
   },
   "Payment":
   {
     (...)
     "Authenticate":false,
     "CreditCard":{
         "CardNumber":"4000000000001000",
         "Holder":"Nome do Portador",
         "ExpirationDate":"12/2021",
         "SecurityCode":"123",
         "Brand":"Mastercard",
         "SaveCard":"false"
     },
     "ExternalAuthentication":{
       "Eci":"4",
       "ReferenceID":"a24a5d87-b1a1-4aef-a37b-2f30b91274e6",
       "Xid":"Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
       "Version":"2.2.0",
       "dataonly":true
     }
   }
}

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

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.