O Data Only é uma funcionalidade essencial para garantir a conformidade com as exigências das bandeiras de cartões nas transações online. Ao implementar essa solução, você estará evitando tarifas adicionais e garantindo que suas operações estejam em total conformidade com as novas regras de segurança e autenticação, além disso existe um potencial ganho na conversão.O que é Data Only?#
O Data Only é uma implementação não obrigatória para transações online, tanto no crédito quanto no débito, que requer a inclusão de novos campos técnicos nas transações. Esses campos são necessários para fornecer informações detalhadas sobre o dispositivo e o ambiente de compra do cliente.Por que é importante implementar o Data Only?#
A implementação do Data Only é crucial para evitar a aplicação de tarifas adicionais de 0,029% por transação não autenticada. Essa taxa será aplicada a partir de 30 de setembro de 2024, para clientes que não estiverem em conformidade com as exigências.Observações sobre os campos obrigatórios:#
Você precisará garantir que seu sistema esteja configurado para enviar os seguintes campos obrigatórios para o DataOnly. Segue algumas observações que devem ser adotadas quando enviar as informações referentes a esses campos:challenge_type: Enviar o valor fixo “DATA_ONLY”
ip_address: Endereço IP (origem do envio). Data Only não aceita formato IPV6, somente IPV4. Nesses casos de IPV6, devem preencher no formato especificado um valor default estático IPV4, por exemplo: 10.0.0.1.
on_failure: Enviar o valor fixo “continue”
device: Informações obrigatórias no momento da compra.
device/color_depth: Enviar o valor fixo "24"
device/type: Enviar o valor fixo "BROWSER"
device/java_enabled: Enviar o valor fixo "false"
device/language: Idioma do navegador.
device/screen_height: Altura da tela em pixels.Pode ser recuperado usando esse comando no checkout:var browserScreenHeight = window.innerHeight || document.documentElement.clientHeight || document.body.clientHeight
device/screen_width: Largura da tela em pixels.Pode ser recuperado usando esse comando no checkout:var browserScreenWidth = window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth
device/time_zone_off_set: Diferença de horário entre UTC e a hora local.
billing/postal_code: CEP do cliente. DataOnly só aceita CEP nacional. Em casos de CEP estrangeiro, o marketplace deve criar um valor default, ou seja, enviar um valor fixo do marketplace no campo.
| Nome | Tipo | Tamanho | Obrigatório | Descrição |
|---|
| challenge_type | challenge_type | 9 | Não | Enviar o valor fixo “DATA_ONLY” |
| ip_address | Alfanumérico | 15 | Sim | Endereço IP |
| user_agent | Alfanumérico | 255 | Não | Identificador do browser utilizado pelo comprador no momento da compra. |
| on_failure | Alfanumérico | 8 | Sim | Enviar o valor fixo “continue” |
| device | device | | Sim | Dados referentes ao device utilizado no momento da compra. |
| device/color_depth | Numérico | 2 | Sim | Enviar o valor fixo “24”. |
| device/type | Alfanumérico | 20 | Sim | Enviar o valor fixo “BROWSER”. |
| device/java_enabled | Boolean | | Sim | Enviar o valor fixo “false”. |
| device/language | Alfanumérico | 10 | Sim | Idioma do navegador no formato IETF BCP47, contendo entre 1 e 8 caracteres. |
| device/screen_height | Numérico | 6 | Sim | A altura total da tela do cliente em pixels. O valor é aquele retornado pela propriedade screen.height. |
| device/screen_width | Numérico | 6 | Sim | A largura total da tela do cliente em pixels. O valor é aquele retornado pela propriedade screen.width. |
| device/time_zone_offset | Numérico | 6 | Sim | Diferença de horário, em horas, entre o UTC e a hora local do navegador do titular do cartão. |
| billing | billing | | Não | Dados referentes ao portador do cartão |
| billing/address | Alfanumérico | 128 | Não | Endereço |
| billing/city | Alfanumérico | 64 | Não | Cidade |
| billing/postal_code | Alfanumérico | 8 | Sim | CEP |
| billing/state | Alfanumérico | 64 | Não | Estado |
| billing/country | Alfanumérico | 64 | Não | País |
| billing/email_address | Alfanumérico | 128 | Não | E-mail |
| billing/phone_number | Numérico | 32 | Não | Telefone |
Prazo para Adequação#
A Partir do dia 30 de agosto você pode começar a homologar o desenvolvimento em ambiente produtivo, com o objetivo de validar essas mudanças em seu sistema.Como podemos ajudar?#
Nosso time está à disposição para oferecer suporte técnico especializado, orientações para a atualização do sistema e para a realização dos testes necessários. O suporte estará disponível de segunda a sexta-feira, das 09h às 19h, exceto feriados nacionais. Durante o período de testes, nossa equipe de integração fornecerá todo o suporte necessário.Suporte Técnico#
Para qualquer dúvida ou necessidade de suporte, você pode entrar em contato conosco através do nosso formulário de suporte.Realização de Testes#
A ativação do Data Only será feita por transação, sem a necessidade de ajustes manuais. Basta enviar o campo de Challenge_Type em cada transação, e todos os campos do Data Only serão exigidos. Caso contrário, as transações seguirão o fluxo normal, sujeito à tarifa adicional.Conclusão#
Implementar o Data Only é fundamental para a conformidade de suas operações e para evitar custos extras. Certifique-se de adequar seu sistema dentro do prazo e conte com nosso suporte para uma transição tranquila. Modificado em 2025-06-04 19:39:00
