Upload de feedback de chargeback

Envie os resultados históricos de chargeback através da DEUNA para que o provedor anti-fraude configurado possa aprender com os resultados confirmados. Este é um modelo de feedback.; Não cria uma disputa com o processador, não submete evidências nem gerencia um caso de cobrança reversa ativo. Utilize Gestão de disputas para disputas ativas.

Ciclo de feedbackPerguntar à Athia sobre isto#

Antes de começarPerguntar à Athia sobre isto#

Confirme com seu TAM o seguinte:

• a conexão com o provedor de prevenção de fraude que consumirá o feedback;
• se o e-mail, SFTP ou ambos estão habilitados;
• os ambientes e os tipos de transação aceitos por cada canal;
• o nome de host SFTP, a porta, o nome de usuário, a impressão digital do servidor e os diretórios do comerciante;
• se um arquivo de resultado é gerado e quanto tempo o processamento normalmente leva para sua conta;
• os requisitos de criptografia, retenção e escalonamento aprovados.

Você também precisa do ID de transação da DEUNA para cada registro. Não substitua um token de pedido, ID de transação do processador ou ID de contestação do comerciante.

Esquema de registroPerguntar à Athia sobre isto#

Opção A: envio de e-mail aprovadoPerguntar à Athia sobre isto#

Use esta opção somente quando a DEUNA aprovou um fluxo de trabalho de e-mail para o ambiente de destino.

1. Exporte um CSV com os nomes dos campos na tabela de esquema.
2. Nomeie-o com o identificador do seu comerciante e a convenção de data acordada. Use marcadores ao automatizar, por exemplo YOUR_MERCHANT_ID-DDMMYY.csv.
3. Valide todos os valores obrigatórios e garanta que o CSV seja codificado de forma consistente.
4. Envie-o apenas para o destinatário confirmado para sua conta através de um e-mail corporativo aprovado.
5. Mantenha a evidência de entrega e reconciliação exigida pela sua política.

transaction_id,external_id,chargeback_identifier,chargeback_status,chargeback_reason_code,chargeback_case_id,merchant_chargeback_id,chargeback_amount,detail,chargeback_date
DEUNA_TRANSACTION_ID,MERCHANT_RECORD_ID,ACQUIRER_REFERENCE,open,REASON_CODE,PROVIDER_CASE_ID,MERCHANT_CASE_ID,2000,Confirmed fraud outcome,2026-10-30T11:20:00Z

DEUNA_TRANSACTION_ID é um marcador de espaço reservado. Substitua-o por um ID de transação real do seu processo de exportação protegido; não copie identificadores de exemplo para produção.

Opção B: entrega SFTP provisionadaPerguntar à Athia sobre isto#

Utilize SFTP somente após a DEUNA ter criado a conta e fornecido os valores de conexão esperados através de um canal aprovado.

1. Crie uma chave SSH dedicada

Gere um par de chaves moderno na máquina ou ambiente de trabalho confiável que realiza o upload:

ssh-keygen -t ed25519 -a 100 -f ./deuna_chargeback_upload

Proteja a chave privada com os controles necessários para aquele ambiente. Compartilhe apenas deuna_chargeback_upload.pub através do canal de integração aprovado. Nunca insira a chave privada em um ticket, chat, documentação, repositório ou aplicação do cliente.

2. Verifique o servidor provisionado

Antes da primeira conexão, compare a impressão digital do servidor com o valor fornecido pela DEUNA. Não aceite uma chave inesperada apenas para continuar.

sftp -i ./deuna_chargeback_upload YOUR_SFTP_USER@YOUR_SFTP_HOST

YOUR_SFTP_USER e YOUR_SFTP_HOST são marcadores de espaço reservado. Utilize os valores emitidos para o ambiente pretendido; sandbox e produção podem ter contas e chaves de host diferentes.

3. Crie o lote JSON

O corpo da mensagem JSON contém a versão do esquema e um records array:

{
  "version": "1.0",
  "records": [
    {
      "transaction_id": "DEUNA_TRANSACTION_ID",
      "external_id": "MERCHANT_RECORD_ID",
      "chargeback_identifier": "ACQUIRER_REFERENCE",
      "chargeback_status": "open",
      "chargeback_reason_code": "REASON_CODE",
      "chargeback_case_id": "PROVIDER_CASE_ID",
      "merchant_chargeback_id": "MERCHANT_CASE_ID",
      "chargeback_amount": 2000,
      "detail": "Confirmed fraud outcome",
      "chargeback_date": "2026-10-30T11:20:00Z"
    }
  ]
}

Utilize um nome de arquivo YYYYMMDD_HHMMSS.json único, a menos que o contrato fornecido especifique uma convenção diferente. Gere o nome do arquivo em UTC para garantir a correlação em lote.

4. Envie para o diretório de entrada designado

Após a conexão, altere para o diretório exato fornecido para o ambiente e envie o arquivo:

sftp> cd YOUR_ASSIGNED_INBOUND_DIRECTORY
sftp> put 20261030_112000.json
sftp> ls
sftp> bye

Não crie um diretório com base no ID do comerciante, a menos que as instruções fornecidas explicitamente o requeiram. Uma put confirma a transferência, não a aceitação do registro.

5. Verificar o resultado

Se sua conta gera arquivos de resultado, obtenha o arquivo do diretório de saída designado e compare-o com o lote de entrada. O nome do arquivo e o esquema de resposta podem variar de acordo com o contrato provisionado; utilize os valores fornecidos durante o onboarding.

sftp> cd YOUR_ASSIGNED_OUTBOUND_DIRECTORY
sftp> ls
sftp> get YOUR_RESULT_FILE.json
sftp> bye

Classifique cada registro como aceito, rejeitado ou ainda não resolvido. Corrija os registros rejeitados antes da resubmissão e evite repetir os resultados aceitos, a menos que o suporte da DEUNA o instrua a fazê-lo.

Validação e idempotênciaPerguntar à Athia sobre isto#

Valide o lote antes da transferência:

• version o valor suportado 1.0 para uploads JSON;
• records é um array não vazio;
• todos transaction_id pertence ao comerciante e ao ambiente pretendidos.
• todos chargeback_date é um timestamp válido no formato ISO 8601, incluindo informações de fuso horário;
• Cada valor é um número inteiro em unidades menores e utiliza a moeda original da transação.
• Os valores dos campos e os comprimentos máximos correspondem ao esquema;
• O nome do arquivo é único e não sobrescreve um lote anterior.
• O arquivo não contém colunas ou atributos que não estejam de acordo com o contrato aprovado.

Mantenha um registro no lado do comerciante contendo o checksum do arquivo, data de criação, ambiente, tempo de transferência e o resultado por registro. Essa evidência permite que você tente novamente os dados rejeitados sem reenviar todo o lote.

Solução de problemasPerguntar à Athia sobre isto#

Ao escalar, incluir o ID do comerciante, ambiente, nome do arquivo, checksum, timestamp da transferência e texto de erro sanitizado. Nunca anexar uma chave privada, segredo do provedor, dados de cartão brutos ou um exporte de cliente não anonimizado.

Lista de verificação de ativaçãoPerguntar à Athia sobre isto#

1. A DEUNA confirma o provedor de destino, ambiente, canal de transferência e permissões da conta.
2. A segurança verifica a posse da chave, validação do "host-key", "allowlisting", criptografia, acesso e retenção.
3. Um lote de teste comprova o tratamento de registros aceitos e rejeitados.
4. As operações podem correlacionar cada registro de entrada com seu resultado de processamento.
5. Monitoramento emite alertas sobre transferências ausentes, registros rejeitados e lotes não resolvidos.
6. O manual de operações define o proprietário e o canal de escalação aprovado.