Pagos · Stablecoins · Infraestructura
Fivo
Una integración para aceptar stablecoins en nueve redes.
Fivo es infraestructura de pagos con stablecoins para comercios online: el cliente paga en USDC o EURC desde la red donde tiene fondos y el comercio cobra con una sola integración. Las wallets, la verificación en cadena y el movimiento entre redes quedan dentro del sistema.
- 9
- Redes mainnet
- USDC + EURC
- Stablecoins
- 3
- Vías de integración
- Testnet + Mainnet
- Entornos separados
El problema
Cobrar stablecoins no debería significar integrar una blockchain detrás de otra.
Aceptar USDC suena sencillo. Debajo hay redes distintas, contratos distintos, wallets, confirmaciones y estados de pago que nadie quiere mantener dentro de una tienda online.
- 01
Varias redes
Cada red tiene sus contratos de USDC, sus nodos RPC y sus tiempos de confirmación.
- 02
Compatibilidad token y red
EURC no existe en todas las redes: una cadena puede ser válida para un token y no para otro.
- 03
Interacción con la wallet
Conectar, comprobar saldos en cada red y firmar la transacción correcta desde el navegador.
- 04
Movimiento entre redes
Si el cliente tiene fondos en Polygon y el comercio cobra en Base, alguien tiene que mover el valor.
- 05
Confirmación y estado
Verificar en cadena que el pago llegó, por el importe correcto, y reflejarlo en un estado fiable.
- 06
Integración y operación
El desarrollador necesita una API; el comercio necesita ver, reembolsar, retirar y facturar.
contratos · RPC · wallets · confirmaciones · estados
Una integración por red, cada una con su propio ciclo de vida.
una integración
Las redes quedan detrás del sistema.
Fivo mueve la complejidad blockchain fuera de la integración del comercio.
Una integración
Una integración. Diferentes formas de cobrar.
Tres vías sobre la misma infraestructura: un botón que se incrusta en cualquier página, sesiones de checkout alojadas y una API REST con claves de comercio.
Botón incrustable
Un script y un elemento HTML. El botón abre el checkout de Fivo en un iframe a pantalla completa y el pago vuelve con su estado.
- Importe fijo o importe libre
- Lee el total del carrito desde la página (data-amount-from)
- Referencia, descripción y metadatos por pago
Producto
Importe fijo por artículo.
Donación
Importe libre elegido por el cliente.
Carrito
Total leído de la propia página.
Varios productos
Un botón por artículo en la misma página.
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>
<fivo-button
merchant-id="fivo_live_YOUR_ID"
amount="29.99"
currency="USDC"
data-reference="order_1042">
</fivo-button>
Botón de Fivo en el carrito de la tienda de demostración
Lo que ve el cliente
Un pago, de principio a fin.
El cliente no elige una blockchain: elige dónde tiene fondos. Fivo consulta sus saldos en todas las redes soportadas y le muestra solo las opciones válidas.
01
Conectar la wallet
El checkout se abre con el importe. El cliente conecta su wallet (MetaMask, WalletConnect, Coinbase Wallet y otras) y deja un email para el recibo.
Wallet conectada0x6753…Af6b
02
Elegir stablecoin y red
Fivo lee los saldos de USDC y EURC en cada red y marca si el pago será directo (misma red) o con puente.
03
Revisar importe y comisiones
Si la red del cliente no es la del comercio, el checkout desglosa producto, comisión de puente y gas antes de firmar.
04
Confirmar en la wallet
El cliente firma la aprobación y la transferencia desde su propia wallet. El pago sale directamente de ella.
FirmaAprobación + transferencia
05
Confirmación en cadena
Aprobación, quema, verificación y entrega: el progreso se muestra paso a paso hasta que los fondos llegan a la wallet del comercio.
06
Pago completado
El backend verifica la transacción en cadena y marca el pago como completado. El cliente ve el hash y el comercio recibe el evento.
Pantallas reales del checkout de Fivo en tema claro. Importe de prueba: 0,01 USDC, de Polygon a Base.
Cross-chain
El cliente paga desde su red. El comercio recibe donde necesita.
Cuando la red del cliente y la del comercio no coinciden, Fivo usa Circle Bridge Kit sobre CCTP v2 para mover USDC entre cadenas dentro del mismo pago. El comercio recibe el importe exacto en su wallet; el cliente asume la comisión de puente y el gas.
Red distinta para el cliente. Una integración para el comercio.
- Cliente
USDC · Polygon
Wallet del cliente
- Checkout de Fivo
Estimación y confirmación
Desglose de comisiones antes de firmar
- Capa cross-chain de Circle
Bridge Kit · CCTP v2
approve → burn → attestation → mint
- Comercio
USDC · Base
Wallet del comercio
- Backend de Fivo
Verificación en cadena
quema verificada → pago completado → webhook
Misma red
Si el cliente ya tiene USDC o EURC en la red del comercio, el pago es una transferencia directa: una confirmación y verificación del recibo en el backend.
EURC
EURC se acepta en Ethereum, Avalanche y Base, siempre en la misma red: no se mueve entre cadenas.
Pantalla real del checkout (entorno de pruebas): el cliente ve la ruta entre redes, las comisiones y cuánto ahorraría pagando desde la red del comercio.
Redes
Nueve redes mainnet. Una sola integración.
La lista de redes vive en la configuración del sistema, no en el código del comercio. USDC se acepta en todas; EURC en las redes donde Circle lo emite.
- 1Cross-chain: el cliente puede pagar en USDC desde cualquiera de las nueve redes; el comercio recibe en la suya.
- 2EURC se acepta solo en la misma red del comercio.
- 3Arc está disponible en el entorno de pruebas (testnet).
| Red | USDC | EURC | Cross-chain USDC |
|---|---|---|---|
| Ethereum | Sí | Sí | Sí |
| Polygon | Sí | No | Sí |
| Avalanche | Sí | Sí | Sí |
| Arbitrum | Sí | No | Sí |
| Base | Sí | Sí | Sí |
| Optimism | Sí | No | Sí |
| Linea | Sí | No | Sí |
| Unichain | Sí | No | Sí |
| Sonic | Sí | No | Sí |
Plataforma del comercio
El pago termina. La operación continúa.
El panel del comercio no es un visor de transacciones: gestiona wallets por red, retiros, reembolsos, facturas, webhooks y claves de API desde el mismo sitio.
Actualización en tiempo real- 1
Transacciones
Listado con filtros guardados, búsqueda, detalle de cada pago y exportación a Excel o PDF.
- 2
Wallets y saldos
Una wallet por red con saldos de USDC y EURC; retiros a la dirección del comercio protegidos con 2FA.
- 3
Reembolsos
Totales o parciales, en cadena, con recibo en PDF para el cliente.
- 4
Facturas
Una factura automática por cada retiro, numerada y en el idioma del país de facturación.
- 5
Webhooks
Alta de endpoints, prueba, regeneración del secreto y registro de entregas.
- 6
Claves de API
Claves live y test, mostradas una sola vez y almacenadas con hash.
Automatización operativa
Lo que ocurre después del pago también está resuelto.
Pago, reembolso y retiro son flujos completos: cada uno termina en un registro, una notificación y, cuando toca, un documento.
Pago
- Transacción en cadena
- Verificación del recibo
- payment.completed
- Webhook firmado y email al comercio
- Recibo al cliente
Reembolso
- Solicitud total o parcial, con 2FA
- Transacción en cadena desde la wallet del comercio
- refund.completed
- Recibo en PDF al cliente
Retiro
- Lote en cadena: importe al comercio, comisión del 0,5 % a Fivo
- Retiro completado
- Factura FIV-AAAA-NNNN en PDF
- Email con la factura
Escáner de intenciones de pago
Cada dos minutos revisa en cadena los pagos en la misma red que aún no se han confirmado.
Escáner de recuperación cross-chain
Cada cinco minutos busca acuñaciones de CCTP que no llegaron a registrarse y completa el pago.
Reintentos de webhooks
Tres reintentos con espera creciente y desactivación automática tras diez fallos seguidos.
Factura automática por retiro: comisión, IVA cuando aplica, contravalor en euros y referencia en cadena.
Infraestructura para desarrolladores
Construido para integrarse, no para obligarte a reconstruir tu producto.
La misma superficie que usa el checkout está disponible para el desarrollador: API REST, webhooks firmados, claves por entorno y documentación pública.
API REST
Pagos, reembolsos, wallets, facturas y webhooks bajo api.fivo.finance, autenticados con X-API-Key.
api.fivo.finance
Webhooks firmados
Cinco eventos de pago y reembolso, firma HMAC-SHA256 con marca de tiempo, reintentos y registro de entregas.
X-Fivo-Signature
Claves de API
Prefijos fivo_live_ y fivo_test_, visibles una sola vez y guardadas con hash.
fivo_live_ · fivo_test_
Documentación
Guía rápida, referencia de la API, webhooks, CCTP, facturación y entorno de pruebas.
fivo.finance/docs
event
payment.completed
- X-Fivo-Event: payment.completed
- X-Fivo-Timestamp: 1757152200
- X-Fivo-Signature: sha256=…
signature
HMAC-SHA256( timestamp . body )
Reintentos: 1 s · 5 s · 25 s
Endpoint del comercio
200 OK
- payment.completed
- payment.failed
- refund.created
- refund.completed
- refund.failed
Dos despliegues independientes: se integra y se prueba sin tocar fondos reales.
Construir
- test.fivo.financeapi-test.fivo.financecheckout-test.fivo.financeClaves fivo_test_ · sesiones cs_test_USDC de prueba desde el faucet de Circle
Salir a producción
- fivo.financeapi.fivo.financecheckout.fivo.financeClaves fivo_live_ · sesiones cs_live_Nueve redes mainnet
Seguridad
La seguridad no vive en una sola capa.
Cada capa del sistema tiene sus propios controles. Ninguno es un eslogan: están en el código.
- 01 · Usuario
Autenticación
- 2FA obligatorio en cada inicio de sesión: email, aplicación TOTP o SMS
- Sesiones cortas con renovación rotativa
- Aviso por email al entrar desde un dispositivo nuevo
- 02 · API
Claves y límites
- Claves de API con hash, visibles una sola vez
- Límite de peticiones por endpoint: inicio de sesión, retiros, pagos públicos
- Validación de esquemas y captcha en formularios públicos
- 03 · Eventos
Webhooks firmados
- Firma HMAC-SHA256 con marca de tiempo
- Protección contra SSRF y redirecciones en los endpoints del comercio
- Verificación de los webhooks de Circle con firma ECDSA
- 04 · Pagos
Verificación en cadena
- Lectura del recibo: contrato correcto, destinatario, remitente e importe
- Escáneres de recuperación para pagos no registrados
- Retiros y reembolsos con 2FA
- 05 · Sistema
Trazabilidad
- Registro de auditoría de retiros y reembolsos con IP, dispositivo y contexto 2FA
- Cabeceras CSP y HSTS
- Secretos TOTP cifrados con AES-256-GCM
Sin promesas de «nivel bancario»: controles concretos, verificables en la implementación.
Circle
Construido sobre infraestructura de Circle.
Fivo no reinventa las stablecoins ni los puentes: construye la capa de pagos para comercios sobre los raíles de Circle.
Fivo es un producto independiente. La membresía en Circle Alliance no implica propiedad, respaldo ni exclusividad por parte de Circle.
01
USDC y EURC
Las stablecoins emitidas por Circle, en las redes donde están disponibles.
02
Programmable Wallets
Wallets de comercio gestionadas por el sistema (developer-controlled, cuentas SCA), con Gas Station para retiros y reembolsos.
03
Bridge Kit y CCTP v2
Movimiento de USDC entre redes dentro del pago, con el Forwarding Service de Circle para la atestación y la acuñación.
04
Webhooks de Circle
Eventos de wallet verificados con la clave pública de Circle.
Ingeniería
Un producto financiero completo, no una integración aislada.
Fivo es el tipo de sistema que Nafureanu diseña y construye: varios componentes con responsabilidades claras, conectados por eventos y en producción.
- 01Pagos
Checkout y estados de pago
Widget en React, escaneo de saldos multi-red, sesiones alojadas y una máquina de estados desde pendiente hasta completado o fallido.
- 02Blockchain
Nueve redes y cross-chain
Configuración de redes y tokens por entorno, transferencias directas y puentes CCTP v2 con verificación del recibo.
- 03Backend
API y procesamiento de eventos
Node.js y Express en TypeScript, PostgreSQL con Prisma y workers periódicos para retiros, reembolsos y recuperación de pagos.
- 04Producto para comercios
Panel de operaciones
Next.js con actualización en tiempo real: transacciones, wallets, retiros, reembolsos, facturas, webhooks y claves.
- 05Automatización
Notificaciones, facturas y reembolsos
Emails transaccionales, facturas PDF en 22 idiomas con reglas de IVA de la UE y recibos de reembolso.
- 06Seguridad
Autenticación, firmas y auditoría
2FA obligatorio, claves con hash, webhooks firmados, límites de peticiones y registros de auditoría.
- 07Infraestructura
Despliegue y nodos
Frontends en Vercel, API y base de datos en Railway, RPC de Alchemy con nodos públicos de respaldo y almacenamiento de PDF en R2.
- 08Experiencia de desarrollador
Documentación y entorno de pruebas
Tres vías de integración, documentación pública y testnet independiente con prefijos de clave y sesión propios.
- TypeScriptReactNext.jsNode.jsExpressPostgreSQLPrismawagmi · viemCircle Programmable WalletsCircle Bridge KitCCTP v2AlchemyVercelRailway
El producto por dentro
Superficies reales del producto.
Capturas del checkout, del panel y de la tienda de demostración, todas en tema claro. Datos de prueba; ninguna información de comercios reales.
01 Checkout sobre la tienda
El botón abre el checkout de Fivo sobre la propia tienda: saldos por red, tipo de pago y el importe leído del carrito.
02 Conexión de la wallet
El checkout se abre con el importe y pide el email del recibo antes de conectar la wallet del cliente.
03 Pago completado sobre la tienda
El estado final del checkout: importe, transacción y entrega confirmadas sin salir de la tienda.
04 Pago cross-chain en curso
Aprobación, quema, verificación y entrega: el cliente ve cada paso hasta que llegan los fondos.
05 Factura automática
Generada tras cada retiro, con la comisión, el IVA aplicable y la referencia en cadena.
06 Panel del comercio
Saldos por wallet, ingresos en el tiempo y acceso a transacciones, facturas, reembolsos, webhooks y claves de API.
Siguiente paso
¿Tu producto necesita pagos, automatización o infraestructura que no existe todavía?
Diseñamos y construimos software alrededor del problema, desde la arquitectura hasta producción.
Servicios relacionadosIntegraciones y APIsSaaS y productos digitales