01
Payment intent
El comercio crea mediante la API una intención de pago asociada a la operación. Su ciclo de vida contempla creación idempotente, expiración y cancelación.
Proof of concept
EuroLedger XRPL
Proof of concept abierto y testnet-first para explorar pagos denominados en euros sobre XRP Ledger, desde la creación de una intención de pago hasta su detección, reconciliación y notificación al comercio.
01 / Resumen
El ledger como capa técnica de liquidación
EuroLedger XRPL explora cómo utilizar XRP Ledger como una capa técnica abierta de liquidación manteniendo la experiencia del comercio y del cliente centrada en importes denominados en euros. El proyecto cubre el ciclo completo necesario para validar la idea sobre XRPL testnet, incluyendo intents de pago, detección de transacciones, reconciliación, webhooks e integración con WooCommerce.
02 / Flujo de pago
Del checkout a la confirmación
02
Checkout
El gateway de WooCommerce integra EuroLedger en el proceso de compra y soporta tanto el checkout clásico como Checkout Blocks.
03
XRPL detection
Un worker observa XRPL testnet y relaciona los pagos detectados con sus intents mediante referencias y memos.
04
Merchant notification
Tras confirmar el pago, los eventos destinados al comercio se entregan mediante webhooks firmados con seguimiento de entrega y política de reintentos.
03 / Arquitectura
Arquitectura
El PoC separa checkout, API, detección en XRPL y entrega de eventos para poder validar cada parte del flujo de pago de forma independiente.
Backend API
FastAPI expone las operaciones del comercio y gestiona intents, autenticación mediante API keys, endpoints de webhook y estado del sistema.
PostgreSQL
El estado persistente de intents, comerciantes, entregas y operaciones relacionadas se mantiene fuera de la capa de ledger.
XRPL worker
Un worker independiente consulta XRP Ledger testnet y confirma las transacciones que corresponden a intents conocidos.
Expiration worker
El ciclo de vida de las intenciones incluye procesamiento independiente de expiraciones para evitar que operaciones pendientes permanezcan abiertas indefinidamente.
Webhook worker
La entrega al comercio se desacopla del procesamiento principal mediante una cola de eventos, webhooks firmados, reintentos y tracking de entregas.
WooCommerce gateway
Un plugin independiente conecta una tienda WooCommerce con la API y traduce las confirmaciones recibidas en cambios del estado del pedido.
04 / Operación
Operación y observabilidad
Observable PoC
El repositorio incluye métricas y ejemplos de observabilidad con Prometheus, Grafana y Alertmanager, además de workflows de n8n para enrutar alertas hacia Telegram.
Testnet-first
EuroLedger XRPL está deliberadamente limitado a desarrollo local y validación sobre XRPL testnet. No es infraestructura financiera de producción, un servicio de custodia, un emisor de stablecoins ni un servicio financiero regulado.
05 / Enlaces
