Pagos

Después de la liberación del escrow, los fondos están ya no bloqueados y pertenecen al vendedor.

Los pagos son acciones financieras fuera de la cadena, gestionadas por Airtm.

Offer Hub no gestiona ni custodia fondos en esta etapa.

---

Objetivo

Permitir a los vendedores retirar sus ganancias utilizando métodos de pago locales familiares, sin exponer stablecoins o la mecánica de la blockchain.

---

Actores

• Vendedor

• Interfaz de OfferHub

• Backend de OfferHub

• Supabase (perfil y vinculación con Airtm)

• API de Airtm

• Rutas de pago locales

---

Precondiciones

• El escrow ha sido liberado

• El vendedor está vinculado a una cuenta Airtm

• El vendedor tiene un saldo disponible positivo

• La cuenta Airtm está activa y cumple con las normas

---

Flujo de pagos

1. El saldo del vendedor se actualiza

Después de la liberación del escrow:

Escrow → cuenta del vendedor

OfferHub:

• observa el evento de liberación,

• actualiza su vista de saldo derivada,

• marca los fondos como retirables.

Airtm permanece como la fuente de la verdad para los saldos.

---

2. El vendedor inicia el retiro

Vendedor → UI de OfferHub: Retirar fondos

El vendedor selecciona:

• método de pago (según lo soportado por Airtm)

• destino (banco, billetera, etc.)

• monto

---

3. OfferHub crea el pago mediante Airtm

OfferHub → API de Airtm:
  Crear pago

Airtm se encarga de:

• controles de cumplimiento

• ejecución a través de rutas locales

• confirmación del pago

OfferHub no mueve dinero por sí mismo.

---

4. Airtm confirma el pago

Airtm → Webhook de OfferHub:
  Pago completado

OfferHub:

• actualiza el estado de la UI,

• registra el evento de pago,

• cierra el ciclo financiero del pedido.

---

Postcondiciones

• El vendedor recibe los fondos a través de rutas locales

• El saldo del vendedor se reduce en consecuencia

• El pedido permanece cerrado

• Se dispone de una pista de auditoría completa

---

Resultados

• ✅ Vendedor pagado con éxito

• ✅ Estado del pago registrado

• ✅ Entrada de registro de auditoría creada

---

Escenarios de fallo

Pago fallido

• Airtm devuelve estado de fallo

• Vendedor notificado

• Se permite reintentar o usar un método alternativo

Saldo insuficiente

• Retiro bloqueado

• Se solicita al vendedor que ajuste el monto

---

Notas de seguridad y cumplimiento

• OfferHub nunca almacena datos bancarios

• OfferHub nunca ejecuta pagos directamente

• Todos los pagos están registrados y son trazables

---

Notas educativas

Por qué los pagos están separados de la liberación

• La liberación es aplicación en cadena

• Los pagos son movimiento de dinero fuera de la cadena

Separar estas preocupaciones:

• mejora la auditabilidad,

• reduce el riesgo,

• refleja los sistemas financieros reales.

---

Conclusión clave

Los escrows deciden quién recibe el pago. Los pagos deciden cómo reciben el dinero.

Offer Hub mantiene estas responsabilidades claramente separadas.

---