API de Pagos para Rentals

Documentación de integración de pagos para plataformas de alquiler vacacional que operan con EPN (Ecopaynet) como pasarela de cobro y Payphone para dispersión de fondos a propietarios.

Arquitectura

Cliente (PMS) → PayHub API → EPN (cobro) → Payphone (dispersión a propietarios)

Flujo de pago completo

1. Programar pagos (POST /schedule) — asocia N cobros futuros a una reserva.

2. Ejecución automática — AWS EventBridge ejecuta cada cobro en la fecha programada.

3. Cobro vía EPN — se ejecuta la operación Sale con token de tarjeta.

4. Dispersión Payphone — si el cobro es exitoso, PayHub encola las dispersiones:

   • Pagos Masivos: transferencias entre cuentas Payphone (Business/Personal).

   • Payouts: transferencias a cuentas bancarias Ecuador.

5. Batch diario — las dispersiones se ejecutan en lote cada día.

Autenticación

Todos los endpoints (excepto webhooks) requieren un token JWT Bearer:

Authorization: Bearer <access_token>

Los tokens se obtienen en /auth/token y no expiran.

Códigos de error

Código	Significado
400	Datos inválidos o faltantes
401	Token JWT ausente o inválido
402	Pago rechazado por la pasarela
404	Recurso no encontrado
409	Conflicto (schedule ya ejecutado, etc.)
502	Error en pasarela externa (EPN)