Disputas

Las disputas son un mecanismo explícito y dirigido por humanos en Offer Hub.

Existen para manejar casos donde:

• la entrega es disputada,

• la aprobación se retiene,

• se solicita la cancelación,

• o se debe revisar evidencia.

Offer Hub no se basa en temporizadores ni en arbitraje automatizado. En su lugar, las disputas son resueltas por la plataforma del mercado, actuando como servicio al cliente, con resultados aplicados por contratos escrow.

---

Objetivo

Permitir:

• compradores o vendedores presentar una disputa,

• la plataforma revisar la evidencia y decidir el resultado,

• el escrow hacer cumplir la resolución final (liberación o reembolso).

---

Actores

• Comprador

• Vendedor

• Interfaz de OfferHub

• Backend de OfferHub (Orquestador)

• Escrow de Trustless Work

• dApp de Trustless Work (Backoffice)

• Dirección del Resolver de Disputas (controlada por la plataforma)

---

Cuándo se puede presentar una disputa

Se puede iniciar una disputa en cualquier momento después de que el escrow esté financiado y antes de la liberación final.

Los escenarios típicos incluyen:

Disputas iniciadas por el comprador

• El producto nunca llegó

• El servicio no se entregó según lo acordado

• La evidencia de entrega es insuficiente

• El vendedor marcó la entrega prematuramente

Disputas iniciadas por el vendedor

• El comprador no responde

• El comprador se niega a aprobar a pesar de la entrega

• El vendedor quiere cancelar y reembolsar

• El vendedor tiene evidencia sólida de cumplimiento

Ambas partes tienen derecho a marcar la transacción, pero ninguna puede resolverla por sí misma.

---

Inicio de la disputa

1. Comprador o Vendedor presenta una disputa

Usuario → Interfaz de OfferHub: Presentar disputa

Esta acción:

• se inicia fuera de la cadena,

• registra la intención de disputar,

• todavía no mueve fondos.

OfferHub captura:

• quién presentó la disputa

• código de motivo

• evidencia opcional (mensajes, archivos, enlaces)

---

2. El escrow se marca como disputado

OfferHub → Trustless Work:
  Marcar el escrow como Disputado

Una vez disputado:

• el escrow queda congelado,

• no puede producirse una liberación o reembolso automáticamente,

• el control pasa al rol de Resolver de Disputas.

El estado del pedido se actualiza a Disputado.

---

Resolución de la plataforma (flujo de backoffice)

Decisión de diseño importante

Offer Hub no implementa su propio backoffice de disputas.

En su lugar, aprovecha la dApp existente de Trustless Work, que ya soporta:

• inspección de escrow,

• firma basada en roles,

• ejecución de liberaciones y reembolsos.

Esto evita la duplicación y garantiza un comportamiento consistente.

---

3. La plataforma inicia sesión en la dApp de Trustless Work

Un operador de la plataforma (servicio al cliente) inicia sesión en la dApp de Trustless Work usando la dirección del Resolver de Disputas / Firmante de Liberación asignada al escrow.

📌 Referencia:

• dApp de Trustless Work (Backoffice)

• Iniciar sesión usando la wallet del resolver configurada para el mercado

---

4. La plataforma revisa el caso

Usando:

• evidencia proporcionada por OfferHub (fuera de la cadena)

• estado del escrow en la cadena

• historial de transacciones

La plataforma decide uno de los siguientes resultados:

• Liberar fondos al vendedor

• Reembolsar fondos al comprador

---

5. La plataforma firma la resolución

dApp de Trustless Work → Escrow:
  Ejecutar Liberación O Reembolso

Esta acción:

• es firmado por la dirección del resolver/firmante de liberación de la plataforma,

• se aplica en cadena,

• es definitivo.

---

Estado posterior a la resolución

Después de la resolución:

• El escrow pasa a Liberado o Reembolsado

• El pedido pasa a Cerrado

• Los fondos se transfieren en consecuencia

• Existe una pista de auditoría completa (en cadena + fuera de la cadena)

---

Resultados

• ✅ Disputa registrada

• ✅ Escrow congelado durante la revisión

• ✅ Resolución aplicada en cadena

• ✅ Pedido cerrado con resultado final

---

Lo que ven los usuarios

Comprador

• Actualizaciones del estado de la disputa

• Resultado final (reembolso o no)

• Explicación clara por parte de la plataforma

Vendedor

• Actualizaciones del estado de la disputa

• Resultado final (pagado o reembolsado)

• Explicación de la decisión de la plataforma

---

Modelo de seguridad y confianza

• Compradores no pueden liberar fondos

• Vendedores no pueden liberar fondos

• Plataforma solo puede actuar dentro de las reglas del escrow

• Todas las acciones de resolución están firmadas y son auditables

---

Notas educativas

Por qué ambas partes pueden presentar disputas

Esto refleja los mercados reales:

• las disputas son señales, no decisiones,

• presentar una disputa no implica mala conducta,

• la resolución la maneja el servicio al cliente.