Carga de devoluciones de cargo

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.

Cómo funcionan las devoluciones de cargo#

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.

Mejorar los resultados antifraude

Descubra cómo las devoluciones de cargo mejoran su estrategia antifraude.

Corrige "falsos negativos"

La tarea principal del modelo es calificar las transacciones.

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.

Reconocimiento de patrones de poderes

El modelo antifraude analiza miles de puntos de datos.

Cuando recibe una devolución de cargo, vuelve a evaluar todos los datos asociados con esa transacción fallida:

1. ¿Qué dirección de correo electrónico se utilizó?
2. ¿Qué huella digital del dispositivo?
3. ¿Cuál era la dirección de envío?
4. ¿Cuál era la hora del día?

El modelo ahora puede encontrar patrones nuevos y ocultos. Por ejemplo, podría descubrir que las transacciones desde un rango de IP específico utilizando un nuevo correo electrónico y comprando bienes digitales son de repente mucho más riesgosos de lo que pensaba originalmente.

Permite el análisis de enlaces

Los estafadores suelen reutilizar correos electrónicos, dispositivos o direcciones de envío.

Cuando carga una devolución de cargo, el proveedor vincula ese fraude a cada punto de datos de la transacción.

1. Antes: El dispositivo del estafador (Device_XYZ) se consideró seguro.
2. Después: Usted carga una devolución de cargo para esa transacción. Device_XYZ ahora está marcado como de alto riesgo.
3. Resultado: La próxima vez que cualquier transacción provenga 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.

Mantiene el modelo actualizado

Las tácticas de fraude cambian constantemente. Los patrones que funcionaron para los estafadores el mes pasado serán diferentes el próximo mes.

Cargar devoluciones de cargo lo más cerca posible del tiempo real es la única forma de garantizar que el modelo de aprendizaje automático se adapte a estas nuevas tácticas tan rápido como aparecen.

En resumen, cargar devoluciones de cargo no es sólo una tarea administrativa; es el núcleo del proceso de aprendizaje automático.

Así es como le enseñas activamente al sistema a ser más inteligente y dejar de perder tu dinero, y DEUNA te ayuda en este viaje.

Información de devolución de cargo requerida

Se requiere la siguiente información por evento de devolución de cargo para enviar información adecuada a los proveedores antifraude:

Opciones de devolución de cargo

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

• Envíe las devoluciones de cargo en un archivo CSV a chargebacks@deuna.com

  • Sólo para transacciones de Producción.

  • El nombre del archivo CSV debe tener el formato UUID-DDMMAA.csv

    • DEUNA merchant ID (UUID): 37e21ead-3951-4cbc-b075-9c635f4b8933
    • Fecha en DDMMAA: 051225
    • Ejemplo:37e21ead-3951-4cbc-b075-9c635f4b8933-051225.csv

  • El formato de los datos debe ser el siguiente.

    transaction_id	external_id	chargeback_identifier	chargeback_status	chargeback_reason_code	chargeback_case_id	merchant_chargeback_id	chargeback_amount	detalle	chargeback_date
    a596f725-e22b-411f-ac51-c94b2386b39b	merchant_test_5	chargeback_test_5	abierto	0003	cbk_test_5	merchant_cbk_test_5	2000	En proceso judicial	2025-10-30T11:20:00Z
    d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9	merchant_test_6	chargeback_test_6	perdido	4837	cbk_test_6	merchant_cbk_test_6	550	Bienes/Servicios no recibidos	2025-10-30T11:21:00Z

    
    
• Send chargebacks in JSON format through SFTP by following the guide below.
  • Para transacciones Sandbox y Producción.
  • Processing begins after the file is received. Confirm the expected schedule with your DEUNA Technical Account Manager.

Requisitos

Para completar este proceso, necesita la siguiente información:

• Su Merchant ID (proporcionado por DEUNA)
• Su clave privada SSH para autenticación (explicado a continuación)
• El archivo JSON quieres subir

Cargar un archivo SFTP#

Cargue devoluciones de cargo a nuestros servidores SFTP.

1. Cree la clave SSH

Genera la clave de tu computadora

1. Abra la aplicación Terminal (Windows 10, Windows 11)

2. Ejecute el comando ssh-keygen -t rsa -b 4096

3. Ingrese una clave de acceso (PIN numérico sugerido de 4 o 6 dígitos) cuando se le solicite la frase de contraseña y presione Entrar (Pista: no mostrará las teclas que está presionando)

4. Ingrese nuevamente su clave de acceso y presione Enter

5. Verá la confirmación de la clave como la siguiente imagen.

Ampliar

6. Obtén tu Clave SSH ingresando cat ~/.ssh/id_rsa.pub , recibirás una respuesta con la clave como en el siguiente ejemplo:

Ampliar

2. Registra la clave SSH en DEUNA

Register your computer key with DEUNA.

1. Copia tu clave SSH
2. Compártelo con tu TPM DEUNA: 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

Una vez registrada, la clave se almacenará en su computadora y no será necesario realizar más pasos con respecto a la generación y el registro de la clave.

3. Conéctese al servidor SFTP DEUNA

1. Abra la aplicación Terminal

2. Entorno de zona de pruebas

   1. Ingrese el siguiente comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io

3. Entorno de producción

   1. Ingrese el siguiente comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io

4. Recibirás la siguiente respuesta con la pregunta Are you sure you want to continue connecting (yes/no/[fingerprint])?:

Ampliar

5. prensa yes y entrar
6. Se le preguntará lo siguiente: Enter passphrase for key 'C:\Users\Admin/.ssh/id_rsa’
7. Ingrese su clave de acceso y presione enter
8. Recibirás la confirmación Connected to [transfer-sftp.chargebacks.sandbox.deuna.io](http://transfer-sftp.chargebacks.sandbox.deuna.io/)

Ampliar

4. Cree un archivo JSON con las entradas de contracargo.

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. El cuerpo está compuesto por un campo llamado version con el valor constante 1.0, seguido de una matriz denominada records.

3. Cada objeto dentro de la matriz de registros contiene una entrada de contracargo, que debe tener la siguiente estructura:

4. Guarde el archivo con TIMESTAMP como nombre AAAAMMDD_HHMMSS.json. Ejemplo 20251104_193100.json
5. Store it in an easy-to-access folder, for example C:\Deuna_chargebacks\.

Ampliar

5. Pruebe la conexión SFTP

Enviar el archivo usando la conexión SFTP en el entorno Sandbox

1. Navegue al entorno Sandbox: cd /deuna-chargebacks-sbx

2. Ingrese el comando para cargar el archivo en el directorio del servidor SFTP para el entorno seleccionado: put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

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

4. Recibirás un mensaje con el progreso y resultados.

Ampliar

5. En caso de recibir el mensaje Couldn’t send packet: Broken pipe, debes volver a conectarte al SFTP con el comando sftp -i ~/.ssh/id_rsa [developer@transfer-sftp.chargebacks.sandbox.deuna.io](mailto:developer@transfer-sftp.chargebacks.sandbox.deuna.io) e ingrese su clave de acceso como frase de contraseña para la clave, y luego vuelva a intentar cargar el archivo comenzando desde el punto 1
6. Desconectar con el comando bye.

6. Ver el archivo de resultados de la prueba.

Si es necesario, puede descargar un archivo de resultados con los siguientes pasos:

1. Conéctese nuevamente al servidor SFTP con el comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io and enter your SSH key passphrase.
2. Navegue al entorno sandbox: cd /deuna-chargebacks-sbx
3. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
4. Ejemplo cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
5. Entrar get YYYYMMDD_HHMMSS_output.json, donde YYYYMMDD_HHMMSS es la marca de tiempo del archivo de devolución de cargo cargado anteriormente.
6. El archivo se descargará en la carpeta donde se encuentra el archivo de contracargo.
7. Ejemplo get 20251104_193100_output.json
8. De forma complementaria, también puedes agregar una ubicación específica para descargar el archivo: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

7. Envíe el archivo a Producción.

Envíe el archivo utilizando la conexión SFTP en el entorno de producción.

1. Ingrese el comando para cargar el archivo en el directorio del servidor SFTP para el entorno seleccionado put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

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

3. Recibirás un mensaje con el progreso y 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. Desconectar con el comando bye

8. Ver el archivo de resultados de producción.

Si es necesario, puede descargar un archivo de resultados:

1. Conéctese nuevamente al servidor SFTP con el 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. Ejemplo cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
4. Entrar get YYYYMMDD_HHMMSS_output.json, donde YYYYMMDD_HHMMSS es la marca de tiempo del archivo de devolución de cargo cargado anteriormente.
5. El archivo se descargará en la carpeta donde se encuentra el archivo de contracargo.
6. Ejemplo get 20251104_193100_output.json
7. De forma complementaria, también puedes agregar una ubicación específica para descargar el archivo: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

Resolución de problemas#

Learn how to troubleshoot common issues.

Conexión rechazada

Si tiene problemas con las conexiones, haga lo siguiente:

• Verifique que su clave privada tenga los permisos correctos: chmod 600 /path/to/private_key
• Asegúrese de estar utilizando el archivo de clave privada correcto
• Confirme que su dirección IP esté en la lista blanca (comuníquese con el soporte técnico si es necesario)

Permiso denegado

If you have permission problems, check the following:

• Verify you're using the correct Merchant ID
• Asegúrese de que su cuenta tenga permisos de carga para este directorio
• Póngase en contacto con el soporte si el problema persiste

El archivo ya existe

Si obtiene errores de archivo, haga lo siguiente

• Utilice una marca de tiempo única para cada carga
• Consulta el directorio con ls antes de subir

Archivo de resultados no encontrado

Si tiene problemas con la búsqueda de archivos, haga lo siguiente

• Permita tiempo suficiente para el procesamiento (tiempo de procesamiento típico: [especifique su SLA])
• Verify you're checking the correct outbound directory for your Merchant ID
• Asegúrese de que el nombre del archivo de entrada coincida exactamente (las marcas de tiempo deben coincidir)
• Póngase en contacto con el soporte si el archivo no aparece dentro del plazo esperado

No se puede descargar el archivo de resultados

Si tiene problemas con la descarga de archivos, haga lo siguiente

• Verifique que tenga permisos de lectura en el directorio saliente
• Compruebe que está utilizando el nombre de archivo exacto, incluido el _output.json sufijo
• Asegúrese de tener suficiente espacio en el disco local para la descarga

Soporte

Si tiene algún problema o tiene preguntas:

• Correo electrónico: support@deuna.io
• Incluya su ID de comerciante y una descripción del problema.

Mejores prácticas de seguridad

Tenga en cuenta las siguientes prácticas de seguridad:

• Mantenga su clave privada segura y nunca la comparta
• Utilice permisos de archivos sólidos en su clave privada (chmod 600)
• Cargue archivos solo durante las ventanas de procesamiento programadas
• Verifique el contenido del archivo antes de subirlo a producción