Referência

Data Only

O que é Data Only?

Data Only é um fluxo de transação no qual o comerciante pode compartilhar dados com o emissor via protocolo 3DS para influenciar aprovações em transações com as bandeiras Visa e Mastercard, garantindo uma experiência sem fricções (desafios) para o portador do cartão.


Benfícios do Data Only


Aproveita a Implementação Existente do EMV 3DS

O Data Only funciona perfeitamente com a configuração atual do EMV 3DS, eliminando a necessidade de mudanças significativas ou esforços adicionais de integração.

Garante uma Experiência Sem Fricções para o Portador do Cartão

Ao evitar uma autenticação completa 3DS, o processo permanece fluido e sem interrupções para o portador do cartão, melhorando a experiência do usuário.

Reduz a Latência

Comparado a um ciclo completo de autenticação 3DS, o Data Only reduz significativamente o tempo de processamento, permitindo transações mais rápidas.

Aprimora as Mensagens de Autorização

Ao compartilhar dados adicionais com o emissor, melhora a tomada de decisões, aumenta as taxas de aprovação e minimiza recusas falsas, resultando em melhores resultados gerais para as transações.


Como utilizar o Data Only nas nossas APIs?

Para realizar uma transação com Data Only é necessário enviar o objeto dataOnly com todos os dados obrigatórios seguido pelo parâmetro challengecom o valor DATA_ONLY.


ℹ️

Bandeiras aceitas

O Data Only é válido para as bandeiras Mastercard e Visa.

⚠️

Atenção

Nas transações Data Only o risco de chargeback por fraude permanece com a loja.


Exemplo do objeto Data Only

 "dataOnly":{
      "ipAddress":"10.0.0.1",
      "onFailure":"CONTINUE",
      "challenge":"DATA_ONLY",
      "successUrl":"https://meusite.com",
      "userAgent":"Mozilla",
      "device":{
         "screenWidth":500,
         "javaEnabled":true,
         "deviceFingerprint":"",
         "screenHeight":500,
         "timeZoneOffset":3,
         "deviceType3ds":"BROWSER",
         "language":"BR",
         "colorDepth":1
      },
      "embedded":true,
      "failureUrl":"https://meusite.com",
      "billing":{
         "address":{
            "zipCode":"88137084",
            "lineTwo":"Sala 101",
            "streetNumber":"38",
            "city":"Palhoça",
            "street":"Rua Jair Hamms",
            "neighborhood":"Pedra Branca",
            "state":"SC"
         },
         "phone":{
            "country":"BRAZIL",
            "number":"998881234",
            "areaCode":"11"
         },
         "email":"[email protected]"
      }
   }

Objeto dataOnly

CampoTipoDescriçãoExemploObrigatório
ipAddressstringEndereço IP (apenas IPV4) do dispositivo.10.0.0.1Sim
onFailurestringAção a ser tomada em caso de falha.CONTINUESim
challengestringTipo de desafio utilizado.DATA_ONLYSim
successUrlstring (URL)URL de redirecionamento em caso de sucesso.https://meusite.comSim
userAgentstringIdentificação do agente de usuário (navegador ou dispositivo).MozillaSim
deviceobjectInformações sobre o dispositivo.Ver subcampos abaixoSim
embeddedbooleanIndica se a integração é embutida.trueSim
failureUrlstring (URL)URL de redirecionamento em caso de falha.https://meusite.comSim
billingobjectInformações de cobrança.Ver subcampos abaixoSim

Subcampos de device

CampoTipoDescriçãoExemploObrigatório
screenWidthnumberLargura da tela em pixels.500Sim
javaEnabledbooleanIndica se o Java está habilitado no dispositivo.trueSim
deviceFingerprintstringImpressão digital do dispositivo.""Não
screenHeightnumberAltura da tela em pixels.500Sim
timeZoneOffsetnumberDiferença do fuso horário em relação a UTC.3Sim
deviceType3dsstringTipo de dispositivo utilizado.BROWSERSim
languagestringIdioma configurado no dispositivo.BRSim
colorDepthnumberProfundidade de cores da tela.1Sim

Subcampos de billing

CampoTipoDescriçãoExemploObrigatório
addressobjectInformações do endereço.Ver subcampos abaixoSim
phoneobjectInformações do telefone.Ver subcampos abaixoSim
emailstringE-mail do cliente.[email protected]Sim
Subcampos de address
CampoTipoDescriçãoExemploObrigatório
zipCodestringCódigo postal.88137084Sim
lineTwostringComplemento do endereço.Sala 101Não
streetNumberstringNúmero da rua.38Sim
citystringCidade.PalhoçaSim
streetstringNome da rua.Rua Jair HammsSim
neighborhoodstringBairro.Pedra BrancaSim
statestringEstado.SCSim
Subcampos de phone
CampoTipoDescriçãoExemploObrigatório
countrystringPaís do telefone.BRAZILSim
numberstringNúmero do telefone.998881234Sim
areaCodestringCódigo de área.11Sim

Exemplo: Data Only na API de Pedido

{
   "orderReference":"ORDER-0001",
   "customer":{
      "birthdate":"1992-02-29",
      "document":"07462640031",
      "name":"Joe Smith"
   },
   "notificationUrl":"https://ecommerce.bempaggo.io/events/order001",
   "amount":150000,
   "payments":[
      {
         "amount":150000,
         "installments":10,
         "dataOnly":{
            "ipAddress":"10.0.0.1",
            "onFailure":"CONTINUE",
            "challenge":"DATA_ONLY",
            "successUrl":"https://meusite.com",
            "userAgent":"Mozilla",
            "device":{
               "screenWidth":500,
               "javaEnabled":true,
               "deviceFingerprint":"",
               "screenHeight":500,
               "timeZoneOffset":3,
               "deviceType3ds":"BROWSER",
               "language":"BR",
               "colorDepth":1
            },
            "embedded":true,
            "failureUrl":"https://meusite.com",
            "billing":{
               "address":{
                  "zipCode":"88137084",
                  "lineTwo":"Sala 101",
                  "streetNumber":"38",
                  "city":"Palhoça",
                  "street":"Rua Jair Hamms",
                  "neighborhood":"Pedra Branca",
                  "state":"SC"
               },
               "phone":{
                  "country":"BRAZIL",
                  "number":"988881234",
                  "areaCode":"11"
               },
               "email":"[email protected]"
            }
         },
         "paymentMethod":"CREDIT_CARD",
         "cardToken":{
            "cvv":"123",
            "token":"785aaf66dca447f9ae6d884564f7f10c7db6eb1bd5ce4923b0c2a7bbfb52b441"
         }
      }
   ]
}


Exemplo: Data Only na API de Cobrança

{
   "customer":{
      "birthdate":"1992-02-29",
      "document":"99634291066",
      "name":"Joe Smith"
   },
   "installments":1,
   "yourReferenceId":"1732302802932",
   "value":1035,
   "card":{
      "cvv":"123",
      "holder":{
         "document":"99634291066",
         "name":"Joe Smith"
      },
      "expiration":{
         "month":"01",
         "year":"2028"
      },
      "brand":"MASTERCARD",
      "cardNumber":"5448280000000007"
   },
   "dataOnly":{
      "ipAddress":"10.0.0.1",
      "onFailure":"CONTINUE",
      "challenge":"DATA_ONLY",
      "successUrl":"https://meusite.com",
      "userAgent":"Mozilla",
      "device":{
         "screenWidth":500,
         "javaEnabled":true,
         "deviceFingerprint":"",
         "screenHeight":500,
         "timeZoneOffset":3,
         "deviceType3ds":"BROWSER",
         "language":"BR",
         "colorDepth":1
      },
      "embedded":true,
      "failureUrl":"https://meusite.com",
      "billing":{
         "address":{
            "zipCode":"88137084",
            "lineTwo":"Sala 101",
            "streetNumber":"38",
            "city":"Palhoça",
            "street":"Rua Jair Hamms",
            "neighborhood":"Pedra Branca",
            "state":"SC"
         },
         "phone":{
            "country":"BRAZIL",
            "number":"998881234",
            "areaCode":"11"
         },
         "email":"[email protected]"
      }
   }
}