Coinbase Commerce en Shopify y WooCommerce

Puntos clave

Coinbase Commerce cobra 1 % por transacción sin suscripción mensual (fuente: Coinbase Commerce docs 2026), lo que la convierte en una de las pasarelas crypto más accesibles tanto para e-commerces principiantes como para los más experimentados.
Shopify supera las 4,6 millones de tiendas activas en el mundo en 2026 (fuente: BuiltWith) y ofrece una integración nativa con Coinbase Commerce a través de su sistema de proveedores de pago terceros — ya no se necesita un plugin externo.
WooCommerce posee el 36 % de la cuota de mercado global de e-commerce, equivalente a unos 6,5 millones de sitios activos (fuente: BuiltWith 2026), y sigue siendo la plataforma donde la integración con Coinbase Commerce ofrece mayor flexibilidad gracias al plugin oficial o a la API directa.
Los pagos con crypto a comercios aumentaron un 70 % entre 2023 y 2025 según Chainalysis, impulsados por la democratización de stablecoins como USDC y la reducción de comisiones en redes Layer 2 como Base.
Coinbase Commerce soporta más de 10 criptomonedas, incluyendo BTC, ETH, USDC y DOGE en las redes Base, Ethereum y Polygon (fuente: Coinbase 2026), con liquidación exclusivamente en crypto — la conversión a fiat se realiza a través de una cuenta Coinbase separada.

Coinbase Commerce en 2026: qué ha cambiado

Coinbase Commerce ya no es la misma herramienta que se lanzó en 2018. La versión actual, conocida informalmente como "Commerce 2.0", abandonó la antigua arquitectura de charges en favor de un sistema basado en los checkouts de Coinbase Onramp. En la práctica, el cliente escanea un código QR o hace clic en un enlace de pago, y la transacción se procesa a través de la red de Coinbase.

El cambio más relevante en 2026-2026 gira en torno a la red Base, el Layer 2 de Ethereum desarrollado por Coinbase. Los pagos en USDC sobre Base cuestan ahora unos pocos centavos de dólar en comisiones de red, frente a varios dólares en Ethereum mainnet. Para un e-commerce que vende productos de 30 o 50 USD, esta diferencia resulta decisiva.

Otra evolución importante: la entrada en vigor del reglamento MiCA en la Unión Europea ha clarificado el estatus de los proveedores de servicios sobre criptoactivos (CASP). Coinbase obtuvo su registro como CASP en varios países europeos, lo que otorga seguridad jurídica al uso de Coinbase Commerce por parte de comercios en la UE. En España, la CNMV supervisa a los proveedores de servicios de criptoactivos bajo el marco armonizado de MiCA. En Latinoamérica, aunque MiCA no aplica directamente, la tendencia regulatoria avanza — la CNBV en México y la CNV en Argentina están desarrollando marcos específicos para activos digitales.

En cuanto a competencia, Coinbase Commerce compite con BitPay, NOWPayments e incluso Stripe, que reintegró los pagos crypto vía USDC en 2024. Pero su posicionamiento sigue siendo diferenciado: 1 % de comisión todo incluido, sin suscripción, y una integración directa con el ecosistema Coinbase para la gestión de fondos.

Prerrequisitos antes de la instalación

Cuenta Coinbase Commerce y claves API

Antes de tocar Shopify o WooCommerce, necesitas una cuenta Coinbase Commerce activa. Desde 2025, Coinbase Commerce está vinculado a una cuenta Coinbase estándar — ya no existe una cuenta Commerce separada.

Crear una cuenta en commerce.coinbase.com
Vincular esa cuenta a una cuenta Coinbase verificada (identidad, dirección)
Generar una clave API en el panel de Coinbase Commerce, sección "Developer settings"
Anotar el Shared Secret para los webhooks — indispensable para la verificación de callbacks

La clave API de Coinbase Commerce permite a tu tienda crear charges (solicitudes de pago) y verificar su estado. El Shared Secret sirve para autenticar las notificaciones que Coinbase envía a tu servidor.

Verificación KYB y cumplimiento normativo

Para empresas que operan en la Unión Europea, Coinbase exige una verificación KYB (Know Your Business) desde la aplicación del reglamento MiCA. Los documentos requeridos incluyen:

Escritura de constitución o documento mercantil equivalente vigente
Documento de identidad del representante legal
Justificante de domicilio de la sede social
Declaración de la actividad comercial

En España, los comercios deben estar inscritos en el registro de la CNMV para proveedores de servicios de criptoactivos. En Latinoamérica, los requisitos varían según la jurisdicción: en México, la Ley Fintech exige autorización de la CNBV para operar con activos virtuales; en Argentina, la CNV está en proceso de definir marcos específicos.

El plazo de validación varía entre 48 horas y dos semanas. Anticipa esta etapa — bloquea la activación de los pagos reales hasta que se complete.

Instalar Coinbase Commerce en Shopify

Activar el proveedor de pago nativo

Shopify ha integrado Coinbase Commerce en su lista de proveedores de pago alternativos. La instalación ya no requiere pasar por una app de terceros.

Desde el admin de Shopify, ir a Configuración > Pagos
En la sección "Métodos de pago alternativos", hacer clic en Agregar un método de pago
Buscar "Coinbase Commerce" en la lista de proveedores
Introducir la clave API generada en el panel de Coinbase Commerce
Seleccionar las criptomonedas que deseas aceptar (BTC, ETH, USDC, DOGE, etc.)
Guardar

La ventaja de esta integración nativa: los pedidos pagados con crypto aparecen en el mismo panel que los pedidos de Stripe o PayPal. El estado del pago se sincroniza automáticamente mediante webhooks.

Configurar los webhooks en Shopify

Los webhooks son el mecanismo mediante el cual Coinbase Commerce informa a tu tienda que un pago ha sido confirmado, ha expirado o ha fallado.

En el panel de Coinbase Commerce, ir a Settings > Webhooks
Agregar la URL del webhook de Shopify: sigue el formato https://tu-tienda.myshopify.com/services/coinbase-commerce/webhooks
Pegar el Shared Secret en el campo correspondiente del lado de Shopify
Probar la conexión con el botón "Send test webhook"

Si la prueba devuelve un código 200, la conexión funciona correctamente. Un código 4xx o 5xx indica un problema de firewall, de certificado SSL o de URL incorrecta.

Probar un pedido en modo sandbox

Coinbase Commerce no ofrece un modo sandbox como tal, a diferencia de Stripe. El método recomendado es el siguiente:

Crear un producto de prueba a 1 USD
Realizar un pedido real pagando en USDC sobre Base (comisiones de red inferiores a 0,01 USD)
Verificar que el webhook active correctamente la actualización del estado del pedido en Shopify
Proceder a un reembolso manual a través del panel de Coinbase si es necesario

Este paso es innegociable. Un webhook mal configurado significa pedidos marcados como "pendientes" indefinidamente, clientes frustrados y soporte innecesario.

Instalar Coinbase Commerce en WooCommerce

Plugin oficial vs integración API directa

Existen dos opciones para WooCommerce, y la elección depende de tu perfil técnico.

El plugin oficial de Coinbase Commerce (disponible en el directorio de WordPress) cubre el 90 % de los casos. Añade una pasarela de pago en WooCommerce, gestiona los webhooks automáticamente y no requiere una sola línea de código.

La integración API directa está orientada a desarrolladores que necesitan control total: checkout personalizado, gestión detallada de confirmaciones, integración con un ERP o un sistema de facturación a medida. Implica usar la API REST de Coinbase Commerce para crear charges, escuchar los eventos webhook y gestionar los estados manualmente.

Para la gran mayoría de los e-commerces, el plugin es suficiente. Recurre a la API solo si tienes una necesidad específica que el plugin no cubre — como la gestión de suscripciones recurrentes o un funnel de compra completamente personalizado.

Configuración en WordPress y WooCommerce paso a paso

1. Instalar el plugin

Desde el admin de WordPress: Plugins > Añadir nuevo > Buscar "Coinbase Commerce". Instalar y activar el plugin desarrollado por Coinbase, Inc. Verifica que tu versión de WooCommerce sea 8.0 o superior y que PHP esté en la versión 8.1 como mínimo.

2. Configurar la pasarela

Ir a WooCommerce > Ajustes > Pagos. La pasarela "Coinbase Commerce" aparecerá en la lista. Hacer clic en Gestionar y completar:

Clave API: la generada en el dashboard de Coinbase Commerce
Shared Secret: para la verificación de los webhooks
Título visible: por ejemplo, "Pagar con Bitcoin, ETH o USDC"
Descripción: un texto breve que explique el proceso al cliente

3. Configurar HTTPS

Coinbase Commerce exige conexión HTTPS. Si tu sitio WordPress todavía no tiene SSL, instala un certificado a través de Let's Encrypt (gratuito) o tu proveedor de hosting. Sin HTTPS, los webhooks serán rechazados sistemáticamente.

4. Verificar los permalinks

Los webhooks de WooCommerce dependen de la estructura de permalinks. Ve a Ajustes > Enlaces permanentes y asegúrate de no estar en modo "Simple". El modo "Nombre de la entrada" o cualquier estructura personalizada funciona correctamente.

Configurar los webhooks en WooCommerce

El plugin crea automáticamente un endpoint de webhook en la dirección: https://tu-sitio.com/?wc-api=coinbase_commerce

Copiar esta URL
Añadirla en el panel de Coinbase Commerce en Settings > Webhooks
Introducir el Shared Secret correspondiente
Enviar un test webhook desde Coinbase Commerce
Verificar en los logs de WooCommerce (WooCommerce > Estado > Registros) que el webhook fue recibido y procesado

Si utilizas un plugin de caché (WP Rocket, LiteSpeed Cache, W3 Total Cache), excluye la URL del webhook del caché. Un webhook en caché devuelve una respuesta obsoleta y Coinbase Commerce considerará la entrega como fallida.

Probar el checkout crypto de principio a fin

Mismo enfoque que en Shopify, adaptado a WooCommerce:

Crear un producto de prueba "Pago crypto test" a 1 USD
Añadir al carrito, completar el pedido, seleccionar "Coinbase Commerce"
El cliente es redirigido a la página de pago de Coinbase — verificar que el monto y la moneda sean correctos
Pagar en USDC sobre Base para minimizar las comisiones
Tras la confirmación on-chain (unos segundos en Base), verificar que el pedido pase a estado "Procesando" o "Completado" en WooCommerce
Comprobar en el panel de Coinbase Commerce: el pago debe aparecer con el hash de la transacción

Gestionar la recepción de pagos

Liquidación en crypto vs conversión fiat automática

Coinbase Commerce realiza la liquidación exclusivamente en criptomoneda. Cuando un cliente paga en BTC, recibes BTC. Cuando paga en USDC, recibes USDC.

Para convertir a moneda fiat, hay dos opciones:

Manual: transferir los fondos a tu cuenta Coinbase, convertir a USD (o EUR si operas en España), y luego enviar a tu cuenta bancaria mediante transferencia. Plazo estimado: 1-3 días hábiles.
Semiautomática: configurar reglas de conversión automática en Coinbase. Cada pago recibido se convierte de inmediato en USD o EUR al tipo de cambio del mercado. Coinbase aplica un spread de 0,5 % a 1,5 % adicional a la comisión de Commerce.

Si prefieres una liquidación fiat directa sin pasar por Coinbase manualmente, BitPay o Stripe (USDC) ofrecen esta funcionalidad de forma nativa. Es una limitación real de Coinbase Commerce frente a sus competidores.

Contabilidad e impuestos sobre pagos en crypto

Un pago recibido en criptomonedas debe contabilizarse en la moneda local al tipo de cambio del día de la transacción. Tanto en España como en la mayoría de países de Latinoamérica, las autoridades fiscales no distinguen entre un pago con tarjeta y un pago en Bitcoin a efectos del IVA (o su equivalente local): el impuesto se aplica de la misma manera.

Puntos clave de vigilancia:

Tipo de cambio: utilizar la cotización en el momento exacto de la transacción (Coinbase Commerce proporciona este dato en los detalles de cada charge)
Asientos contables: el pago crypto constituye un activo digital en el balance. La conversión posterior a fiat puede generar una ganancia o pérdida patrimonial sujeta a tributación
Facturas: indicar el importe en la moneda local (USD, EUR, MXN, ARS, etc.), no en crypto, conforme a las normas de facturación de cada jurisdicción

En España, las ganancias derivadas de criptoactivos tributan en el IRPF como ganancias patrimoniales, y los holdings en exchanges extranjeros deben declararse mediante el modelo 721 cuando superen los 50.000 EUR. En México, los ingresos por activos virtuales se declaran ante el SAT. En Argentina, aplica el impuesto a las ganancias según las resoluciones vigentes de la AFIP.

Un contador o asesor fiscal familiarizado con activos digitales resulta prácticamente indispensable cuando el volumen supera unas pocas transacciones mensuales. Herramientas como Cryptio o Bitwave pueden automatizar la conciliación contable entre Coinbase Commerce y tu software de contabilidad.

Optimizar la tasa de conversión en el checkout

Reducir el abandono de carrito en pagos crypto

El pago con criptomonedas sufre una tasa de abandono más alta que la tarjeta bancaria. Las causas principales: tiempos de confirmación en blockchain, complejidad percibida e incertidumbre sobre las comisiones de red.

Algunas estrategias concretas:

Priorizar pagos en Base o Polygon: confirmación en segundos, comisiones despreciables. Destaca estas redes en la interfaz de checkout.
Indicar claramente el tiempo estimado: "Pago confirmado en menos de 30 segundos en la red Base" tranquiliza al cliente.
Ofrecer USDC como primera opción: sin volatilidad, sin sorpresas de monto entre el momento del clic y la confirmación.
Temporizador visible: Coinbase Commerce otorga 60 minutos para completar un pago. Muestra esta cuenta regresiva para generar urgencia.

Mostrar las criptos aceptadas en las fichas de producto

Un badge de "Bitcoin aceptado" o "Paga con crypto" en las fichas de producto y la página de inicio atrae a una clientela específica. Según un estudio de PYMNTS/BitPay de 2024, el 40 % de los clientes crypto afirman elegir un comercio sobre otro en función de si acepta criptomonedas.

En Shopify, puedes añadir un badge mediante el personalizador de temas o una app de badges. En WooCommerce, basta con un shortcode o un widget en la barra lateral. Coinbase Commerce proporciona recursos gráficos (logos de las criptos aceptadas) descargables desde el dashboard.

Problemas frecuentes y soluciones

Pago marcado como pending: qué hacer

Un pago "pending" significa que la transacción fue detectada en la blockchain pero no ha alcanzado el número de confirmaciones requerido. En Bitcoin, Coinbase Commerce exige 3 confirmaciones (aproximadamente 30 minutos). En Ethereum mainnet, 12 confirmaciones. En Base, unos pocos segundos suelen ser suficientes.

Acciones a tomar:

Verificar el hash de la transacción en un explorador blockchain (Blockchair para BTC, Etherscan para ETH, Basescan para Base)
Si la transacción está confirmada pero el estado sigue como "pending" en tu tienda, el webhook probablemente falló — relánzalo manualmente desde el dashboard de Coinbase Commerce
Si la transacción está realmente en espera (mempool congestionado en Bitcoin), ten paciencia. No marques el pedido como pagado manualmente antes de que se confirme

Conflictos de plugins habituales en WooCommerce

Los conflictos de plugins son la primera causa de mal funcionamiento de Coinbase Commerce en WooCommerce. Los culpables habituales:

Plugins de caché (WP Rocket, LiteSpeed Cache): cachean los endpoints de webhook. Solución: excluir /?wc-api=coinbase_commerce del caché.
Plugins de seguridad (Wordfence, Sucuri): bloquean las peticiones POST entrantes de Coinbase Commerce. Solución: añadir las IPs de Coinbase a la lista blanca en las reglas del firewall.
Plugins de redirección HTTPS: pueden interferir con los callbacks. Solución: verificar que el sitio fuerza HTTPS en todas partes, sin bucles de redirección.
WooCommerce Subscriptions: el plugin estándar de Coinbase Commerce no gestiona suscripciones recurrentes. Para pagos recurrentes, es necesario usar la API con un desarrollo custom, o utilizar un protocolo de streaming como Superfluid.

Ante la duda, desactiva todos los plugins excepto WooCommerce y Coinbase Commerce, haz pruebas y luego reactiva uno por uno para aislar el conflicto.

Shopify vs WooCommerce: qué integración elegir

La elección no depende de Coinbase Commerce en sí — la herramienta funciona bien en ambas plataformas. Depende de tu contexto técnico y comercial.

Shopify es la opción ideal si quieres una instalación en 10 minutos sin tocar código, con hosting gestionado y mantenimiento cero del lado del servidor. La desventaja: menor personalización del funnel de pago, y Shopify cobra su propia comisión además del 1 % de Coinbase Commerce si no usas Shopify Payments como pasarela principal.

WooCommerce encaja si necesitas control total, un checkout personalizado, integración con ERP, o si prefieres no depender de una plataforma SaaS propietaria. La desventaja: tú gestionas el hosting, las actualizaciones de WordPress, la seguridad SSL y los conflictos de plugins.

En cuanto a la fiabilidad de los webhooks, Shopify lleva ventaja: infraestructura gestionada, sin plugins de caché que configurar, sin firewalls que ajustar. En WooCommerce, cada proveedor de hosting tiene sus particularidades y los webhooks son la principal fuente de problemas.

Para un comercio que empieza a aceptar pagos crypto y quiere probar sin fricción, Shopify es la opción pragmática. Para un comercio técnico que ya vende en WooCommerce, migrar a Shopify solo por Coinbase Commerce no tiene sentido — el plugin de WooCommerce cumple perfectamente.

Preguntas frecuentes

¿Coinbase Commerce funciona con todos los temas de Shopify o se necesita uno específico?

Coinbase Commerce funciona con todos los temas de Shopify sin excepción. La integración pasa por el sistema nativo de proveedores de pago de Shopify, que es independiente del tema. El cliente es redirigido a una página de pago alojada por Coinbase, por lo que no es necesaria ninguna modificación de template.

¿Cómo recibir los pagos de Coinbase Commerce directamente en dólares o euros en mi cuenta bancaria?

Coinbase Commerce no ofrece liquidación fiat directa. Para recibir USD o EUR, debes transferir las criptos recibidas a tu cuenta Coinbase, convertirlas a la moneda deseada y luego enviarlas a tu banco mediante transferencia. Puedes configurar conversiones automáticas en Coinbase para reducir la operativa manual. Si la liquidación fiat nativa es un criterio decisivo, BitPay o Stripe ofrecen esta funcionalidad.

¿Debo declarar el IVA de manera diferente si acepto pagos en Bitcoin en WooCommerce?

No. El IVA (o impuesto equivalente en cada país) se aplica exactamente igual que con un pago tradicional. El monto de la transacción debe registrarse en moneda local al tipo de cambio del día, y el IVA se calcula sobre ese importe. La única particularidad está en la contabilización del criptoactivo recibido y la posible ganancia o pérdida patrimonial al convertirlo posteriormente a fiat.

¿Coinbase Commerce es compatible con WooCommerce Subscriptions?

El plugin oficial de Coinbase Commerce para WooCommerce no gestiona pagos recurrentes automáticos. Las criptomonedas funcionan en modo "push" (el cliente inicia cada pago), a diferencia de los débitos bancarios. Para suscripciones, se requiere una integración custom mediante la API de Coinbase Commerce que envíe una solicitud de pago en cada vencimiento, o el uso de un protocolo especializado como Superfluid para streaming de pagos en USDC.

¿Es legal usar Coinbase Commerce como comercio en España o Latinoamérica en 2026?

Sí. Coinbase obtuvo su registro como CASP (Crypto-Asset Service Provider) bajo el reglamento MiCA, lo que cubre sus actividades en toda la Unión Europea, España incluida. La CNMV supervisa a los proveedores de servicios de criptoactivos que operan en territorio español. En Latinoamérica, la situación varía según el país: en México la operación con activos virtuales está regulada por la Ley Fintech; en Argentina y Colombia, los marcos normativos están en desarrollo pero no prohíben la aceptación de pagos en crypto. Los comercios deben cumplir con sus obligaciones fiscales y contables locales relacionadas con la recepción de pagos en activos digitales.

¿Cuál es la diferencia entre el plugin de Coinbase Commerce para WooCommerce y la integración por API?

El plugin oficial se instala en unos clics, gestiona los webhooks automáticamente y añade Coinbase Commerce como método de pago estándar en WooCommerce. La integración API directa requiere desarrollo: creas las charges mediante llamadas REST, escuchas los webhooks con tu propio endpoint y gestionas los estados de pedido manualmente. La API ofrece mayor control (checkout custom, lógica de negocio específica, integración ERP) pero exige conocimientos técnicos sólidos y un mantenimiento continuo.

Coinbase Commerce: Tutorial Shopify y WooCommerce (2026)