Inglés
Alemán
Español
Francés
Turco
Volver a Guías
Integrar pagos cripto: playbook 2026 para e-commerce y SaaS en España
Integrar pagos en cripto en 2026 ya no es un proyecto de ingeniería a medida. Para la mayoría de comercios españoles es una instalación de plugin o una integración de cuatro endpoints. La parte dura es tesorería, conciliación y cumplimiento, no el cableado.
Este playbook cubre las tres rutas realistas (checkout alojado, plugin, API directa), los flujos de webhook y devolución, los datos que necesita la contabilidad y los errores que matan el lanzamiento. Escrito para el equipo técnico y el product owner, no para el vendedor.
Impulse su negocio aceptando pagos criptográficos
Qué significa integrar pagos en cripto
Conectar su checkout con un proveedor que acepta activos digitales, confirma la transacción on-chain y devuelve al negocio los ingresos (en euros o stablecoin) con metadatos suficientes para que contabilidad los concilie. El cliente ve un botón de pago adicional. Su equipo ve un apunte contable idéntico al de tarjeta o SEPA.
La integración hace cuatro cosas: crea una factura en el proveedor, muestra al comprador el importe en token y la dirección, vigila la cadena y, cuando confirma, notifica por webhook al sistema de pedidos. Lo demás es operación: IVA, devoluciones, soporte, exportación contable.
Comisión típica
0,5 - 1 %
Frente a 2,9 % + 0,30 EUR de tarjeta.
Ruta más rápida
Horas
Plugins para Shopify, WooCommerce, PrestaShop y Magento, en una tarde.
Endpoints API
4
Crear factura, consultar estado, webhook, devolución.
Tres rutas de integración
Checkout alojado
Redirección o modal a la página del proveedor. Lanzamiento más rápido, mínimo desarrollo.
- En 1-2 días
- Sin alcance PCI en cripto
- Control UX limitado
Plugin de plataforma
App oficial en Shopify, WooCommerce, PrestaShop o Magento. Conecta API keys, elige activos y listo.
- Instalación en una tarde
- UX nativa
- Evoluciona con la plataforma
API directa
Integración REST desde su backend. Control total de UX y datos.
- 1-3 semanas de dev
- Soberanía UX y datos
- Usted gestiona el uptime
La API en 4 endpoints
| Endpoint | Propósito | Campos clave |
|---|---|---|
| POST /invoices | Crear factura cripto para un pedido. | order_id, fiat_amount, fiat_currency, callback_url, customer_email |
| GET /invoices/:id | Consultar estado (conciliación o fallback UI). | status (new, pending, paid, expired, invalid) |
| POST /webhooks | Recibir cambios de estado en tiempo casi real. | event_type, invoice_id, tx_hash, paid_at, final_amount |
| POST /refunds | Devolver tokens al cliente. | invoice_id, amount, destination_address, reason |
Disciplina de webhooks
- Verifique siempre la firma. HMAC con el secret compartido. Rechace lo no firmado.
- Trate los webhooks como idempotentes. El proveedor reintentará. Deduplique por event_id.
- Responda rápido. 2xx en menos de 5 segundos. El trabajo pesado, asincrono.
- Polling de respaldo. Un job de "comprobar estado" para pedidos sin webhook dentro de la ventana esperada.
Devoluciones, contracargos y atención al cliente
Conciliación y contabilidad
- Guarde el TxID. Asocia el hash blockchain al pedido.
- Contabilice al EUR equivalente. Al tipo fijado por el proveedor al emitir la factura.
- Conciliación diaria. Totales de liquidación vs pedidos menos comisiones.
- Exporte a su ERP. A3, Sage, Holded, Contasol, Xero, QuickBooks leen CSV o API.
- Trazabilidad de coste. Si mantiene stablecoins o cripto nativa en balance, guarde por lote.
Checklist de lanzamiento
Técnico
- Webhooks verificados e idempotentes
- Flujo de devolución probado
- Polling de respaldo activo
- TxID guardado por pedido
Finanzas
- Cuenta de liquidación conectada
- Exportación al ERP validada
- Conciliación diaria en verde
- Política de coste firmada
Atención al cliente
- Macros para "¿dónde está mi pedido?"
- Política de devolución publicada
- Artículo con búsqueda por TxID
- Formación en "sin contracargos"
Cumplimiento
- KYB del proveedor cerrado
- Screening de sanciones confirmado
- Ruta Travel Rule documentada
- Páginas de devoluciones actualizadas
Integre con GatewayCrypto
Una integración que se adapta a su stack.
GatewayCrypto publica plugins oficiales para las principales plataformas y una REST API para todo lo demás. En horas sobre Shopify o WooCommerce, en una semana con integración a medida.
- Plugins oficiales. Shopify, WooCommerce, PrestaShop, Magento, Medusa, Saleor, OpenCart.
- API REST completa. Facturas, devoluciones, webhooks, exportes, reporting. Firmada, versionada, documentada.
- Paridad sandbox-producción. Pruebe flujos reales sin dinero real.
- SDK para cada stack. Node.js, Python, PHP, Ruby, Go, Java y checkout alojado.
- Ingeniero de soporte dedicado en Slack o Teams durante el rollout.
Impulse su negocio aceptando pagos criptográficos
Comenzar
Preguntas frecuentes
Instalar el plugin de su plataforma, configurar credenciales, ejecutar un pedido de prueba y activar. En Shopify, WooCommerce y PrestaShop suele ser tarea de una tarde. API directa en 1 a 3 semanas.
No si usa una plataforma con plugin click-to-install. Sí para API directa o stacks a medida. Incluso así, la parte del código es pequeña: la mayor parte es tesorería y conciliación.
Sí. El proveedor auto-convierte la cripto recibida a la moneda elegida y paga por SEPA o SEPA Instant. Su balance no toca cripto si no lo desea.
Menos: la factura queda pendiente hasta completar o expira. Más: la mayoría de proveedores acredita al cliente el excedente o lo devuelve. Pregunte la política y documéntela para soporte.
Llamando al endpoint de refund con invoice_id, importe y dirección del cliente. Es una transacción saliente nueva, no un contracargo. Decida si devuelve "misma cripto" o "mismo valor fiat".
Empiece con BTC, ETH, USDT en Tron y USDC en Base o Arbitrum. Cubre la mayor parte del volumen mercantil en 2026. Añada Solana u otras L2 según demanda real.
No en flujos hosted o plugin. La parte cripto no tiene alcance PCI. Los flujos tarjeta fiat-a-cripto siguen teniendo obligación PCI en el tramo fiat, que asume el proveedor.
