Utilizando Data Only
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.
Segue abaixo maiores informações sobre todos os campos Data Only:
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 | |
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
**É essencial que os Marketplaces realizem testes de chamada em produção a partir do dia 30 de agosto de 2024, para garantir que os novos campos sejam enviados corretamente durante as transações.
Ativação do Data Only
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.
Updated 2 months ago