Zonix Disputes And Refunds

Relación:

class Dispute extends Model
{
    public function order()
    {
        return $this->belongsTo(Order::class);
    }
}

3. Flujo de Disputa

1. Buyer crea disputa sobre una orden entregada o cancelada.
2. Admin revisa evidencia (mensajes, fotos, historial de estado).
3. Admin decide:
   - Reembolso total/parcial al Buyer.
   - Penalización al Commerce.
   - Sin acción (disputa rechazada).
4. Se actualiza Dispute y, si aplica, se registra Refund manual.

4. Reembolsos (Manual)

• Los reembolsos no se ejecutan automáticamente desde Zonix.
• Debe quedar registro del reembolso efectuado fuera del sistema (transferencia, reverso de pago, etc.).

Modelo sugerido refunds:

5. Penalizaciones por Cancelación

Reglas (ver README backend, sección penalizaciones):

• Comercio:
  • Puede cancelar en paid o processing con justificación.
  • Penalización si excede límite (ej. > 5 cancelaciones/30 días).
  • Puede aplicarse cancellation_penalty en la orden.
• Buyer:
  • Límite 5 minutos o hasta validación de pago.
  • Penalización de comportamiento (no necesariamente monetaria en MVP).

Campos en orders (ver zonix-order-lifecycle § 5):

$order->update([
    'status' => 'cancelled',
    'cancelled_by' => 'buyer|commerce|admin',
    'cancellation_reason' => 'Razón',
    'cancellation_penalty' => 0.00, // Penalidad si aplica
]);

6. Endpoints Sugeridos

GET    /api/buyer/disputes              → Ver mis disputas
POST   /api/buyer/disputes              → Crear disputa para una orden
GET    /api/admin/disputes              → Listar todas las disputas
GET    /api/admin/disputes/{id}         → Ver detalle
POST   /api/admin/disputes/{id}/resolve → Resolver (refund/penalty/close)

7. Reglas Importantes

1. Nunca cambiar retroactivamente estados de orden para “tapar” disputas; registrar resolución aparte.
2. Reembolsos y penalizaciones deben ser explícitos en campos dedicados.
3. Solo Admin puede resolver una disputa.
4. Buyer no puede abrir múltiples disputas simultáneas sobre la misma orden.

8. Cross-references

• Estados y cancelaciones: zonix-order-lifecycle § 3-5.
• Campos financieros: zonix-payments § 5-6.