Módulo payment_gateways — registro de pasarelas y libro de transacciones

Registro provider-agnóstico de pasarelas (stripe/redsys/paypal/manual/other) y libro unificado de transacciones y reembolsos: iniciar → succeeded/failed → reembolso total o parcial.

🔴 Aquí NO se cobra. No hay SDK de pago, ni llamada HTTP, ni webhooks: el módulo modela el ciclo de vida, no es una pasarela. «Succeeded» significa que alguien le contó al módulo que el proveedor lo confirmó. La conversación real con Stripe o Redsys ocurre fuera.

⚠️ No es payments. Aquel registra el dinero que SALE (pagos a proveedor); este, los cobros que entran por pasarela. Y una transacción aquí no está ligada a nada: ni venta, ni pedido, ni factura, ni cliente.

Module id: payment_gateways. Depende de: nada — y nada depende de él; no escucha eventos. Módulo híbrido: SQL + handler WASM (5 funciones). ❄️ Congelado: su doc de arquitectura vive en architecture/_frozen/modules/payment_gateways.md.

Documentación de usuario — docs/

Viaja dentro del módulo y se versiona con él: el asistente del hub (ADR-0282) la indexa por versión instalada y cita la de TU versión, no la de la última publicada. En inglés (idioma fuente).

Qué expone hoy

Navegación: erp-payment-gateways-gateways («Gateways»).

Layout

module.json                   # manifest (contrato técnico)
migrations/                   # esquema §2.5 + contador atómico por (hub_id, day)
queries/*.sql                 # lecturas declarativas; gateways_list.sql ENMASCARA los secretos
commands/*.sql                # escrituras declarativas (las `_` son intenciones del WASM)
schemas/*.json                # JSON Schemas de input (draft 2020-12)
handler/                      # WASM Tier 2 → dist/handler.wasm
ui/                           # Web Components (Lit/Ionic/OutfitKit)
docs/                         # documentación de usuario + corpus del asistente

Estado y trabajo abierto

Módulo congelado. Limitaciones documentadas en docs/limits.md: el host no pre-carga lecturas, así que todas las guardas de estado viven en el SQL interno y fallan como no-op de 0 filas (alternativa con error legible: triggers RAISE(ABORT) à la ADR-0018 — no adoptada aquí); transactions.summary calcula pero no puede devolver datos al caller; y el enmascarado es de lectura, no cifrado at-rest.

Doc de arquitectura: architecture/_frozen/modules/payment_gateways.md.