Conectar su tienda Shopify a su propio BTCPay Server para el comercio en BTC
Share
Todo comerciante de Shopify conoce la historia: procesadores de pago que retienen su dinero como rehén, exigen números fiscales y acumulan comisiones. ¿Quiere aceptar Bitcoin? La mayoría de las integraciones solo recrean la misma pesadilla de custodia con una capa de pintura cripto. BTCPay Server es distinto. Es software libre que usted mismo ejecuta: los pagos van directo a su billetera, nadie le pide sus papeles y las únicas comisiones son las de la red Bitcoin. Esta guía paso a paso le muestra cómo poner en marcha BTCPay en AWS e integrarlo con Shopify en una tarde.
Para conectar su tienda Shopify a un BTCPay Server autoalojado (en AWS) y procesar pagos en Bitcoin al finalizar la compra, debe integrarlos con el plugin Shopify v2 de BTCPay.
Esta configuración permite a los clientes elegir Bitcoin como método de pago, completar el pedido en Shopify y luego pagar una factura de BTCPay en la página de «Gracias».
El proceso es el mismo tanto si ejecuta BTCPay localmente con Docker (para pruebas) como en AWS (por ejemplo EC2 en producción), pero su instancia de BTCPay debe ser accesible públicamente por HTTPS con un nombre de dominio: Shopify debe poder comunicarse con ella.
El despliegue oficial de BTCPay Server con Docker funciona perfectamente en AWS (por ejemplo, instale Docker en una instancia EC2 y siga el proceso de BTCPay).
Necesita acceso de administrador SSH root a su servidor BTCPay.
Requisitos previos
- Una cuenta de Shopify con una tienda activa (al menos el plan Basic).
- Una cuenta gratuita de Shopify Partner (regístrese en partners.shopify.com).
- Una tienda de BTCPay creada con una billetera configurada (por ejemplo para Bitcoin o la red Lightning).
- En AWS, configure los grupos de seguridad para los puertos 80/443, un dominio (por ejemplo mediante Route 53) y active HTTPS
- BTCPay gestiona el SSL automáticamente con Let's Encrypt si está configurado.
La receta de su comercio en BTC
Tener una tienda Shopify
- Por supuesto, tenga al menos una tienda Shopify con el plan Basic:

Registrarse como socio desarrollador de aplicaciones de Shopify
- Crear una cuenta de Shopify Partner:

- Vaya al panel de Shopify Partner (partners.shopify.com).
- Cree una nueva cuenta de socio
- Puede usar la identidad de su cuenta de tienda
- Indique la ubicación de su empresa
Crear la nueva aplicación de Shopify para el BTCPay Server
- Vaya a «App distribution» y luego a «View Dev Dashboard».

- Haga clic en «Create app» y luego en «Start from Dev Dashboard»

- Haga clic en Create app y dé un nombre a su aplicación de Shopify (por ejemplo «BTCPay Server»)

- Anote el Client ID y el Client Secret en la configuración de la aplicación.
- Estas credenciales protegen sus finanzas. Manténgalas en secreto.
- Vuelva al «dev dashboard» y seleccione su aplicación en «Apps»
- Haga clic en Version para poder editar la configuración
- En Scopes, elija «Request Access» y desplácese hacia abajo.

- En «API access requests», conceda «Allow network access in checkout and account UI extensions».
- Si recibe un error sobre el «checkout ui extension scope», complete su perfil de socio con su nombre y apellido.

- Abajo, haga clic en «Settings», desplácese, haga clic en «CLI Token» y luego en «Manage tokens».
- Genere un nuevo token (mantenga los valores por defecto)
- Cópielo en su bóveda de credenciales segura (LastPass u otra)
- Solo se muestra una vez

Desplegar un BTCPay Server en un alojamiento público
Para ello usamos el muy sencillo AWS EC2. Usted puede elegir el alojamiento que se ajuste a sus habilidades y a su presupuesto.
BTCPay Server en AWS EC2 (t3.medium)
Vaya a la consola de AMI de AWS EC2 y elija una imagen Ubuntu 24.04.
El t3.medium (4 GB de RAM, 2 vCPU) es una buena opción para BTCPay Server: margen suficiente para Bitcoin y Lightning si lo desea.
Paso 1: lanzar la instancia EC2
Es vital no exponer el puerto 443 hasta haber creado su cuenta de usuario administrador. Si instala con el puerto 443 abierto, es probable que unos bots detecten su nuevo BTCPay Server antes de que usted se dé cuenta de que es público y creen una cuenta, sabiendo que la primera cuenta creada se convierte en la de administrador y puede negarle a usted el acceso de administrador. (¡Sí, de verdad!)
- Consola EC2 → Launch Instance
- Configure:
-
Name:
btcpay-server - AMI: Ubuntu 24.04 LTS
- Instance type: t3.medium
- Almacenamiento: 150 GB gp3 (holgado para un nodo podado + Lightning)
-
Security Group: permita la entrada de:
Puerto Origen Uso 22 Solo su IP SSH 80 0.0.0.0/0 HTTP (Let's Encrypt, redirige a HTTPS) 443 Solo su IP HTTPS 9735 Solo su IP Lightning (si usa LND)
-
Name:
- Cree o elija un par de claves y lance
- Elastic IP: vaya a EC2 → Elastic IPs → Allocate → Associate con su instancia
Paso 2: configurar el DNS (Route 53)
- Route 53 → Hosted zones → seleccione su dominio
-
Create record:
-
Record name:
btcpay(creabtcpay.yourdomain.com) - Record type: A
- Value: su Elastic IP
- TTL: 300
-
Record name:
- Haga clic en Create records
Instalar Docker y BTCPay Server en el servidor EC2
- Conéctese por SSH a su servidor
ssh -i ~/.ssh/SomeAwsKeypair2026.pem ubuntu@btcpay.yourdomain.com
# también es buen momento para instalar fail2ban (protección SSH)
# y configurar algo de espacio de intercambio para este sistema.
# practique una ciberseguridad prudente
sudo su -
export BTCPAY_HOST="btcpay.yourdomain.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="lnd"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="$BTCPAYGEN_ADDITIONAL_FRAGMENTS;opt-add-shopify"
export BTCPAYGEN_REVERSEPROXY="nginx"
cd /root
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
. ./btcpay-setup.sh -i
Facilitar el acceso desde su usuario Ubuntu
mv /root/btcpayserver-docker /opt/btcpayserver-docker
chown -R ubuntu:ubuntu /opt/btcpayserver-docker
ln -s /opt/btcpayserver-docker /root/btcpayserver-docker
usermod -aG docker ubuntu
exit
Verificar el despliegue inicial de BTCPay con Docker
- Conéctese por SSH a su servidor
ssh -i ~/.ssh/SomeAwsKeypair2026.pem ubuntu@btcpay.yourdomain.com
- Verifique con:
docker ps | grep shopify
(Debería ver un contenedor relacionado con Shopify en ejecución).
Crear el usuario administrador de su BTCPay Server
- Abra su navegador en https://btcpay.yourdomain.com
- Introduzca un nombre de usuario y una contraseña, y confirme la contraseña

- Su cuenta es ahora la cuenta de administrador (consulte las preguntas frecuentes para verificarlo y para impedir que otros visitantes creen una cuenta)
- Abra ahora el HTTPS a todas las IP en el grupo de seguridad de red de EC2.
Configurar y sincronizar su BTCPay Server como nodo
Su BTCPay Server es un nodo par de las redes mundiales Bitcoin y Lightning. Necesitará varios días para sincronizarse con la blockchain, que cambia constantemente. Mientras no esté sincronizado, no podrá buscar las transacciones que correspondan a los pagos de su tienda Shopify. La próxima semana será un buen momento para estudiar algo de literatura y guías en línea sobre el funcionamiento de la red Lightning y el papel que desempeñará su BTCPay Server.

Para consejos más completos sobre los primeros pasos con BTCPay Server (en inglés), consulte:
Crear una nueva tienda en BTCPay Server
Su tienda Shopify colaborará con una tienda de BTCPay Server para realizar el comercio en BTC. Ya tiene una tienda Shopify: cree ahora la tienda correspondiente en BTCPay Server.

- Dele un nombre parecido al de su tienda Shopify
- Acepte el USD como moneda
- Mantenga la fuente de precios recomendada, Kraken
- Haga clic en Create Store
Instalar el plugin Shopify v2 de BTCPay Server
Con la nueva tienda de BTCPay Server creada, puede añadir el plugin Shopify (v2) de BTCPay Server.
Inicie sesión y vuelva a la tienda de BTCPay Server que acaba de crear.

- En su panel de BTCPay, vaya a «Manage Plugins».
- Instale «BTCPay Server Shopify plugin v2» (de btcpayserver).

- Reinicie BTCPay cuando se le pida.
Configurar el plugin Shopify v2 en BTCPay Server
- Seleccione su tienda de BTCPay.
- Vaya a «Shopify v2» en la barra lateral.

- Introduzca el Client ID y el Client Secret del sitio de Shopify Partner y guarde.

- En «Deploy the app», introduzca el nombre de la aplicación y el CLI Token del sitio de Shopify Partner.
Haga clic en «Deploy App» y espere la confirmación en la salida de la consola.
Instalar la aplicación en su tienda Shopify
- En el portal de Shopify Partner, seleccione su aplicación, «Choose Distribution» y luego «Custom distribution»

- Introduzca la URL de su tienda (por ejemplo your-store.myshopify.com)

- Genere el enlace de instalación, cópielo y ábralo en un navegador.

- Inicie sesión en Shopify si es necesario y haga clic en «Install».

- Verifique el éxito (marca verde en la configuración del plugin de BTCPay).
Personalizar la página de «Gracias» de Shopify
- En la administración de Shopify: haga clic en Configuración, luego en Pago y allí en Personalizar.
- Cambie a la vista de la página de «Gracias» en la página del tema
- Haga clic en un icono para añadir un bloque
- Haga clic en el icono de Aplicaciones (barra lateral izquierda).
- Añada «BTCPay Checkout» haciendo clic en (+) y seleccionándolo (colóquelo cerca de la sección «Detalles del pedido»).
- Guarde.
Añadir un método de pago personalizado en Shopify
- Desde la administración de Shopify: haga clic en Configuración, luego en Pagos y luego en «Métodos de pago manuales».
- Haga clic en «+» > «Crear método de pago personalizado».
- Llámelo por ejemplo «Pay with Bitcoin (BTCPay Server)»
(el nombre debe contener «bitcoin», «btcpayserver», «btcpay server» o «btc»). - Opcionalmente añada detalles: «El botón ‘Completar pago’ para Bitcoin aparecerá en la página de Gracias».
- Haga clic en Activar.
Cómo lo viven los clientes
- Al pagar, eligen la opción personalizada de Bitcoin y completan el pedido.
- En la página de «Gracias», hacen clic en «Completar pago» para abrir la factura de BTCPay.

- El pago se confirma en BTCPay, lo que actualiza automáticamente el estado del pedido de Shopify.
Consejos para resolver problemas
- Asegúrese de que la URL de su BTCPay esté protegida con HTTPS y sea accesible públicamente (pruebe con curl o un navegador).
- En AWS: use una Elastic IP para tener una dirección fija; configure las reglas de entrada para HTTP, HTTPS, SSH y Lightning.
- Evite la antigua integración Shopify v1
- Si los pagos no se procesan, consulte los registros de BTCPay (docker logs) y verifique los permisos de la API.
- Para las actualizaciones, ejecute ./btcpay-update.sh en su servidor, genere un nuevo CLI Token y vuelva a desplegar la aplicación.
Esta integración de Shopify y BTCPay Server se basa en poseer e intercambiar bitcoin sin custodio: sin comisiones ni intermediarios más allá del coste de las transacciones en la red. Tampoco hay tutor que arregle los errores. Pruebe primero su integración y sus compras con importes pequeños.








