Carregamento de estornos

Send historical chargeback feedback to your anti-fraud providers through DEUNA.

Ask your DEUNA Technical Account Manager which environments, anti-fraud connections, file-delivery method, directories, and processing schedule are enabled for your merchant before sending production data. Not every dispute is evidence of fraud; include only the chargeback feedback agreed for the configured anti-fraud provider.

Como funcionam os estornos#

DEUNA enables you to upload received chargeback feedback by email or SFTP and forward it to the configured anti-fraud provider. This feedback can help the provider improve its risk models.

Without timely outcome feedback, an anti-fraud provider has less information with which to identify similar fraud patterns.

Melhore os resultados antifraude

Saiba como os estornos melhoram sua estratégia antifraude.

Corrige "falsos negativos"

A principal função do modelo é pontuar as transações.

When a chargeback represents confirmed fraud, it is a strong false-negative signal: the model treated the transaction as acceptable, but the later outcome showed that it was fraudulent.

By uploading agreed chargeback feedback, the provider can use those outcomes to identify patterns it previously missed.

Potencia o reconhecimento de padrões

O modelo antifraude analisa milhares de pontos de dados.

Ao receber um estorno, ele reavalia todos os dados associados à transação com falha:

1. Qual endereço de e-mail foi usado?
2. Qual impressão digital do dispositivo?
3. Qual foi o endereço de entrega?
4. Qual era a hora do dia?

O modelo agora pode encontrar padrões novos e ocultos. Por exemplo, pode descobrir que as transações de uma faixa de IP específica usando um novo e-mail e comprando bens digitais são subitamente muito mais arriscadas do que se pensava inicialmente.

Permite análise de link

Os fraudadores costumam reutilizar e-mails, dispositivos ou endereços de entrega.

Quando você carrega um estorno, o provedor vincula essa fraude a todos os pontos de dados da transação.

1. Antes: O dispositivo do fraudador (Device_XYZ) foi visto como seguro.
2. Depois: Você carrega um estorno para essa transação. Device_XYZ agora é sinalizado como de alto risco.
3. Resultado: Na próxima vez que qualquer transação vier de Device_XYZ.

The provider can use the new signal when evaluating later transactions associated with the same risk indicators. The resulting decision still depends on the provider's model and your configured risk policy.

Mantém o modelo atualizado

As táticas de fraude mudam constantemente. Os padrões que funcionaram para os fraudadores no mês passado serão diferentes no mês que vem.

Carregar estornos o mais próximo possível do tempo real é a única maneira de garantir que o modelo de aprendizado de máquina se adapte a essas novas táticas tão rápido quanto elas aparecem.

Resumindo, enviar estornos não é apenas uma tarefa administrativa; é o núcleo do processo de aprendizado de máquina.

É como você ensina ativamente o sistema para ficar mais inteligente e parar de perder seu dinheiro, e a DEUNA ajuda você nessa jornada.

Informações obrigatórias sobre estorno

As informações a seguir são necessárias por evento de estorno para fornecer feedback adequado aos provedores antifraude:

Opções de estorno

DEUNA offers two options depending on the merchant's requirements, timing, and environment:

• Envie os estornos em um arquivo CSV para chargebacks@deuna.com

  • Somente para transações de produção.

  • O nome do arquivo CSV deve estar no formato UUID-DDMMAA.csv

    • DEUNA merchant ID (UUID): 37e21ead-3951-4cbc-b075-9c635f4b8933
    • Data no DDMMAA: 051225
    • Exemplo:37e21ead-3951-4cbc-b075-9c635f4b8933-051225.csv

  • O formato dos dados deve ser o seguinte

    transaction_id	external_id	chargeback_identifier	chargeback_status	chargeback_reason_code	chargeback_case_id	merchant_chargeback_id	chargeback_amount	detalhe	chargeback_date
    a596f725-e22b-411f-ac51-c94b2386b39b	merchant_test_5	chargeback_test_5	aberto	0003	cbk_test_5	merchant_cbk_test_5	2000	Em processo judicial	30-10-2025T11:20:00Z
    d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9	merchant_test_6	chargeback_test_6	perdido	4837	cbk_test_6	merchant_cbk_test_6	550	Bens/Serviços não recebidos	30-10-2025T11:21:00Z

    
    
• Send chargebacks in JSON format through SFTP by following the guide below.
  • Para transações Sandbox e Produção.
  • Processing begins after the file is received. Confirm the expected schedule with your DEUNA Technical Account Manager.

Requisitos

Para concluir este processo, você precisa das seguintes informações:

• Seu Merchant ID (fornecido pela DEUNA)
• Seu Chave privada SSH para autenticação (explicado abaixo)
• O Arquivo JSON você deseja carregar

Carregar um arquivo SFTP#

Faça upload de estornos para nossos servidores SFTP.

1. Crie a chave SSH

Gere a chave do seu computador

1. Abra o aplicativo Terminal (Windows 10, Windows 11)

2. Execute o comando ssh-keygen -t rsa -b 4096

3. Digite uma senha (PIN numérico sugerido de 4 ou 6 dígitos) quando solicitada a senha e pressione Enter (Dica: não mostrará as teclas que você está pressionando)

4. Digite novamente sua senha e pressione Enter

5. Você verá a confirmação da chave como na imagem a seguir

Ampliar

6. Obtenha sua chave SSH digitando cat ~/.ssh/id_rsa.pub , você receberá uma resposta com a chave como no exemplo a seguir:

Ampliar

2. Registre a chave SSH no DEUNA

Register your computer key with DEUNA.

1. Copie sua chave SSH
2. Compartilhe com seu DEUNA TPM: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC8YDqXwxnvJkXOK5Dne0Fzcmt/f5MlD5WpcICgJxVtOYYGP1M+zn+Z2e3EHcssxblOPykFmBax/WBtVbcgtxUxMypTUMqsKtUtbg9D9DSMIKPbk7+BpQpG1dAx/SPmK7v/Zq0tUdw5np8z3KFnyH7q1Bw4NFd9jk48/CqOftEJn28lprJRus8/K8Jy+3S2vyTl2g8YuVHYvznl59aVKKCtm//D79OjPKKsdN3upCN6mo8FTCf0Ku+KS/F6kCIXn/gwKtRNuMwffJq+g7/qaMmo3FGBiaw9DCTbL5D+INgvAlbfpruqOa7GsmPreq7371+Om5BsQz2I79WvJtbPwrv+YrbOm2FVaaeKg4LKs8uqlcgs/DXaRBNtdQLQVGND37dvxVNc6ZsFagdQF+OKRxPc5MsIwDZH1Fd6m9qAN/Vxgfl8a5gg57ovkd2yJC40Blmn1nRAFxTdVceV+9c0a6qG7RTMyli9se8PzSS4Ckk/IL5TBzzNyimDYYtQWZ7INPNiFxRUKBTAeqwI+5Xava2hWHA35WmPh+5kl/J9gS3noALSBe/DT4ie9IXP68r7Ril2vPkvY8ONIc2usTsyIRmVCIss3Ww7ekMYwfpx/D8lroWoqC8Go6eI5lMCKYXkkzz0nsWwASTVG8jhbDWs7sebxzX5EmWup3Rf/0fokJfN9w== admin@DESKTOP-T7IE9FG

Uma vez registrada, a chave será armazenada em seu computador e nenhuma etapa adicional será necessária em relação à geração e registro da chave.

3. Conecte-se ao servidor DEUNA SFTP

1. Abra o aplicativo Terminal

2. Ambiente sandbox

   1. Digite o seguinte comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io

3. Ambiente de Produção

   1. Digite o seguinte comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io

4. Você receberá a seguinte resposta com a pergunta Are you sure you want to continue connecting (yes/no/[fingerprint])?:

Ampliar

5. Pressione yes e entre
6. Você será questionado sobre o seguinte: Enter passphrase for key 'C:\Users\Admin/.ssh/id_rsa’
7. Digite sua senha e pressione Enter
8. Você receberá a confirmação Connected to [transfer-sftp.chargebacks.sandbox.deuna.io](http://transfer-sftp.chargebacks.sandbox.deuna.io/)

Ampliar

4. Crie um arquivo JSON com as entradas de estorno

1. The JSON file must have the following structure (example for two entries):

   JSONCopiar

   {
   "version" : "1.0",
   "records" : [
           {
               "transaction_id": "a596f725-e22b-411f-ac51-c94b2386b39b", 
               "external_id" : "merchant_test_5",
               "chargeback_identifier":"chargeback_test_5",
               "chargeback_status": "open" ,
               "chargeback_reason_code": "0003", 
               "chargeback_case_id": "cbk_test_5", 
               "merchant_chargeback_id": "merchant_cbk_test_5",
               "chargeback_amount": 2000, 
               "detail": "En proceso judicial",
               "chargeback_date": "2025-10-30T11:20:00Z"
           },
           {
               "transaction_id": "d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9", 
               "external_id" : "merchant_test_6",
               "chargeback_identifier":"chargeback_test_6",
               "chargeback_status": "lost",
               "chargeback_reason_code": "4837", 
               "chargeback_case_id": "cbk_test_6", 
               "merchant_chargeback_id": "merchant_cbk_test_6",
               "chargeback_amount": 550, 
               "detail": "Goods/Services not received",
               "chargeback_date": "2025-10-30T11:21:00Z"
           }
       ]
   }

2. O corpo é composto por um campo denominado version com o valor constante 1.0, seguido por uma matriz chamada records.

3. Cada objeto dentro do array records contém uma entrada de estorno, que deve ter a seguinte estrutura:

4. Salve o arquivo com um TIMESTAMP como nome YYYYMMDD_HHMMSS.json. Exemplo 20251104_193100.json
5. Store it in an easy-to-access folder, for example C:\Deuna_chargebacks\.

Ampliar

5. Teste a conexão SFTP

Envie o arquivo usando a conexão SFTP no ambiente Sandbox

1. Navegue até o ambiente Sandbox: cd /deuna-chargebacks-sbx

2. Insira o comando para fazer upload do arquivo no diretório do servidor SFTP para o ambiente selecionado: put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

3. Exemplo: put C:\Deuna_chargebacks\20251104_193100.json inbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57

4. Você receberá uma mensagem com o progresso e resultados

Ampliar

5. Caso você receba a mensagem Couldn’t send packet: Broken pipe, você deve se reconectar ao SFTP com o comando sftp -i ~/.ssh/id_rsa [developer@transfer-sftp.chargebacks.sandbox.deuna.io](mailto:developer@transfer-sftp.chargebacks.sandbox.deuna.io) e insira sua chave de acesso como a senha da chave e tente novamente fazer upload do arquivo começando do ponto 1
6. Desconecte-se com o comando bye.

6. Veja o arquivo de resultados do teste

Se necessário, você pode baixar um arquivo de resultados seguindo as seguintes etapas:

1. Conecte-se novamente ao servidor SFTP com o comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io and enter your SSH key passphrase.
2. Navegue até o ambiente sandbox: cd /deuna-chargebacks-sbx
3. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
4. Exemplo cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
5. Entrar get YYYYMMDD_HHMMSS_output.json, onde YYYYMMDD_HHMMSS é o carimbo de data/hora do arquivo de estorno enviado anteriormente.
6. O arquivo será baixado para a pasta onde o arquivo do estorno está localizado
7. Exemplo get 20251104_193100_output.json
8. Complementarmente, você também pode adicionar um local específico para baixar o arquivo: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

7. Envie o arquivo para Produção

Envie o arquivo usando a conexão SFTP em ambiente de produção

1. Digite o comando para fazer upload do arquivo no diretório do servidor SFTP para o ambiente selecionado put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

2. Exemplo: put C:\Deuna_chargebacks\20251104_193100.json inbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57

3. Você receberá uma mensagem com o progresso e resultados

Ampliar

1. If you receive Couldn’t send packet: Broken pipe, reconnect with sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io, enter your SSH key passphrase, and retry the upload from step 1.

2. Desconecte-se com o comando bye

8. Veja o arquivo de resultados de produção

Se necessário, você pode baixar um arquivo de resultados:

1. Conecte-se novamente ao servidor SFTP com o comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io and enter your SSH key passphrase.
2. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
3. Exemplo cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
4. Entrar get YYYYMMDD_HHMMSS_output.json, onde YYYYMMDD_HHMMSS é o carimbo de data/hora do arquivo de estorno enviado anteriormente.
5. O arquivo será baixado para a pasta onde o arquivo do estorno está localizado
6. Exemplo get 20251104_193100_output.json
7. Complementarmente, você também pode adicionar um local específico para baixar o arquivo: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

Solução de problemas#

Learn how to troubleshoot common issues.

Conexão recusada

Se você tiver problemas com conexões, faça o seguinte:

• Verifique se sua chave privada tem as permissões corretas: chmod 600 /path/to/private_key
• Verifique se você está usando o arquivo de chave privada correto
• Confirme se seu endereço IP está na lista de permissões (entre em contato com o suporte, se necessário)

Permissão negada

If you have permission problems, check the following:

• Verify you're using the correct Merchant ID
• Certifique-se de que sua conta tenha permissões de upload para este diretório
• Entre em contato com o suporte se o problema persistir

O arquivo já existe

Se você receber erros de arquivo, faça o seguinte

• Use um carimbo de data/hora exclusivo para cada upload
• Verifique o diretório com ls antes de enviar

Arquivo de resultado não encontrado

Se você tiver problemas com a localização de arquivos, faça o seguinte

• Reserve tempo suficiente para processamento (tempo de processamento típico: [especifique seu SLA])
• Verify you're checking the correct outbound directory for your Merchant ID
• Certifique-se de que o nome do arquivo de entrada corresponda exatamente (os carimbos de data e hora devem corresponder)
• Entre em contato com o suporte se o arquivo não aparecer dentro do prazo esperado

Não é possível baixar o arquivo de resultado

Se você tiver problemas com downloads de arquivos, faça o seguinte

• Verifique se você tem permissões de leitura no diretório de saída
• Verifique se você está usando o nome exato do arquivo, incluindo o _output.json sufixo
• Garanta espaço em disco local suficiente para o download

Suporte

Se você encontrar algum problema ou tiver dúvidas:

• E-mail: support@deuna.io
• Inclua seu ID de comerciante e uma descrição do problema

Melhores práticas de segurança

Tenha em mente as seguintes práticas de segurança:

• Mantenha sua chave privada segura e nunca a compartilhe
• Use permissões de arquivo fortes em sua chave privada (chmod 600)
• Faça upload de arquivos apenas durante as janelas de processamento agendadas
• Verifique o conteúdo do arquivo antes de enviá-lo para produção