Subida de comentarios sobre devoluciones

Enviar los resultados históricos de devoluciones a través de DEUNA para que el proveedor anti-fraude configurado pueda aprender de los resultados confirmados. Este es un modelo de retroalimentación; no crea una disputa con el procesador, no presenta pruebas ni gestiona un caso de devolución activo. Utilice Gestión de Disputas para disputas activas.

Ciclo de vida de la retroalimentaciónPreguntar a Athia sobre esto#

Antes de empezarPreguntar a Athia sobre esto#

Confirme lo siguiente con su TAM:

• la conexión anti-fraude que consumirá la retroalimentación;
• si está habilitado el correo electrónico, SFTP o ambos;
• los entornos y tipos de transacción aceptados por cada canal;
• el nombre de host SFTP provisto, el puerto, el nombre de usuario, la huella digital del servidor y los directorios de la tienda;
• si se genera un archivo de resultado y cuánto tiempo normalmente tarda el procesamiento para su cuenta;
• los requisitos de cifrado, retención y escalamiento aprobados.

También necesita el ID de transacción de DEUNA para cada registro. No utilice un token de pedido, ID de transacción del procesador o ID de devolución del comerciante.

Esquema de registroPreguntar a Athia sobre esto#

Opción A: Envío de correo electrónico aprobadoPreguntar a Athia sobre esto#

Utilice esta opción únicamente cuando DEUNA haya aprobado un flujo de trabajo de correo electrónico para el entorno de destino.

1. Exportar un CSV con los nombres de los campos de la tabla de esquema.
2. Nombrar el archivo con su identificador de comerciante asignado y la fecha de acuerdo. Utilice marcadores de posición al automatizar, por ejemplo YOUR_MERCHANT_ID-DDMMYY.csv.
3. Validar todos los valores requeridos y asegurarse de que el CSV esté codificado de forma consistente.
4. Enviar solo al destinatario confirmado para su cuenta a través de una bandeja de entrada de correo electrónico de negocio aprobada.
5. Conserve la evidencia de entrega y conciliación requerida por su 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 es un marcador de posición. Reemplace con un ID de transacción real de su proceso de exportación protegido; no copie identificadores de ejemplo en producción.

Opción B: Entrega SFTP provisionadaPreguntar a Athia sobre esto#

Utilice SFTP solo después de que DEUNA haya creado la cuenta y proporcionado los valores de conexión esperados a través de un canal aprobado.

1. Crear una clave SSH dedicada

Generar una pareja de claves moderna en la máquina o entorno de trabajo que realiza la carga:

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

Proteger la clave privada con los controles requeridos para ese entorno. Comparta solo deuna_chargeback_upload.pub a través del canal de incorporación aprobado. Nunca pegue la clave privada en un ticket, chat, documentación, repositorio o aplicación de cliente.

2. Verificar el servidor provisionado

Antes de la primera conexión, compare la huella digital del host del servidor con el valor proporcionado por DEUNA. No acepte una clave inesperada solo para continuar.

sftp -i ./deuna_chargeback_upload YOUR_SFTP_USER@YOUR_SFTP_HOST

YOUR_SFTP_USER y YOUR_SFTP_HOST son marcadores de posición. Utilice los valores emitidos para el entorno previsto; sandbox y producción pueden tener cuentas y claves de host diferentes.

3. Crear el lote JSON

El cuerpo JSON contiene la versión del esquema y un 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"
    }
  ]
}

Utilice un nombre de archivo único YYYYMMDD_HHMMSS.json a menos que su contrato provisto especifique una convención diferente. Generar el nombre de archivo en UTC para que la correlación del lote sea inequívoca.

4. Cargar en el directorio de entrada asignado

Después de conectarse, cambie al directorio exacto que se proporciona para el entorno y cargue el archivo:

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

No construya un directorio a partir del ID del comerciante a menos que las instrucciones de configuración lo requieran explícitamente. Una transferencia exitosa put confirma la transferencia, no la aceptación del registro.

5. Conciliar el resultado

Si su cuenta produce archivos de resultados, obtenga el archivo del directorio de salida asignado y compárelo con el lote de entrada. El nombre del archivo y el esquema de respuesta pueden variar según el contrato de configuración; utilice los valores proporcionados durante la incorporación.

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

Clasifique cada registro como aceptado, rechazado o aún sin resolver. Corrija los registros rechazados antes de volver a enviar y evite la reproducción de resultados aceptados a menos que el soporte de DEUNA lo indique.

Validación e idempotenciaPreguntar a Athia sobre esto#

Valide el lote antes de transferirlo:

• version debe ser el valor 1.0 para las cargas JSON;
• records debe ser un array no vacío;
• cada transaction_id debe pertenecer al comerciante y al entorno deseados;
• cada chargeback_date debe ser una marca de tiempo ISO 8601 válida con zona horaria;
• cada importe debe ser un entero en unidades menores y utilizar la moneda de pago original;
• los valores y longitudes máximas deben coincidir con el esquema;
• el nombre del archivo debe ser único y no sobrescribir un lote anterior;
• el archivo no debe contener columnas o atributos fuera del contrato aprobado.

Mantenga un registro del lote del comerciante que contenga el checksum del archivo, la hora de creación, el entorno, la hora de transferencia y el resultado por registro. Esta evidencia le permite reintentar los datos rechazados sin volver a enviar todo el lote.

Resolución de problemasPreguntar a Athia sobre esto#

Al escalar, incluya el ID del comerciante, el entorno, el nombre de archivo, el checksum, la marca de tiempo de transferencia y el texto de error sanitizado. Nunca adjunte una clave privada, secreto del proveedor, datos de tarjeta sin enmascarar o una exportación de cliente sin enmascarar.

Lista de verificación de puesta en marchaPreguntar a Athia sobre esto#

1. DEUNA confirma el proveedor objetivo, el entorno, el canal de transferencia y los permisos de la cuenta.
2. La seguridad verifica la custodia de las claves, la validación del certificado, la lista de acceso, el cifrado, el acceso y la retención.
3. Una prueba en entorno de sandbox demuestra el manejo correcto de los registros aceptados y rechazados.
4. Las operaciones pueden correlacionar cada registro de entrada con su resultado de procesamiento.
5. La supervisión genera alertas sobre transferencias faltantes, registros rechazados y lotes sin resolver.
6. El manual de operaciones especifica el propietario y el canal de escalamiento aprobado.