Qué es BTCPay Server
BTCPay Server es software gratuito para aceptar bitcoin como negocio, organización benéfica o profesional autónomo. Crea facturas y páginas de pago, hace funcionar una pantalla de punto de venta para el mostrador de una tienda y se integra en tiendas online. Los pagos llegan directamente a tu propia cartera. En palabras de su guía de usuario, "does not hold funds as a payment intermediary" [no guarda fondos como intermediario de pagos].
Es de código abierto con licencia MIT y lo ejecutas tú mismo. El proyecto dice que no es una empresa, y la BTCPay Server Foundation, que lo apoya, es una organización sin ánimo de lucro financiada con donaciones. BTCPay no cobra nada. Sus preguntas frecuentes dicen: "We do not charge you anything. However, to run it, you should host it." [No te cobramos nada. Pero para usarlo tienes que alojarlo]. Tus costes son el servidor y las comisiones normales de la red.
Esta guía se comprobó con la versión 2.4.7, publicada el 29 de octubre de 2026. Fue una versión de seguridad que corregía 85 hallazgos, y el proyecto recomienda encarecidamente actualizar, sobre todo en servidores compartidos por varios comerciantes.
Si solo quieres cobrar de vez en cuando, basta con una cartera normal. BTCPay es para cuando necesitas facturas vinculadas a pedidos, una caja, reembolsos y registros.
BTCPay Server ↗ · Versión 2.4.7 de BTCPay Server ↗
Dónde ejecutarlo
BTCPay necesita un nodo de Bitcoin y una máquina que permanezca conectada. Hay tres opciones habituales.
- Un servidor de alquiler. La instalación oficial usa Docker en un servidor de alquiler, con tu propio nombre de dominio para tener una dirección web segura. Las indicaciones del propio proyecto sitúan el mínimo imprescindible en 4 GB de memoria, 2 núcleos de procesador y 50 GB de almacenamiento SSD con un nodo podado, normalmente unos $20 al mes o menos. LunaNode ofrece una instalación con un clic por unos $10 al mes.
- Tu nodo en casa. BTCPay es una aplicación de Umbrel y Start9. La comunidad de BTCPay dice que no puede dar soporte a estas instalaciones. Umbrel advierte que las tiendas online como Shopify o WordPress no pueden llegar a un servidor doméstico salvo que configures un DNS dinámico.
- El servidor de otra persona. Algunas personas ejecutan BTCPay y dejan que otros abran tiendas en él. Lee las advertencias de más abajo antes de usar uno.
El nodo de Bitcoin tarda entre uno y cinco días en sincronizarse la primera vez. En cuanto el servidor esté en marcha, crea tu cuenta. La primera cuenta que se registra pasa a ser la administradora del servidor. Si otra persona se te adelantó, la documentación dice que empieces de nuevo con un servidor nuevo.
BTCPay: opciones de despliegue ↗ · Despliegue de BTCPay con Docker ↗
Usar el servidor de otra persona
Un alojamiento de terceros es barato y rápido, y la documentación de BTCPay es franca sobre lo que implica. Confías en el dueño del servidor.
- Un proveedor de alojamiento nunca necesita tu clave privada. La documentación dice que si un proveedor te pide una o la crea por ti, "be sure it's a scam" [ten por seguro que es una estafa].
- Conecta una cartera que ya tengas, mediante su clave pública, nunca una cartera caliente. Un proveedor deshonesto podría aun así ejecutar software modificado que cambie tu clave por la suya, de modo que los pagos futuros le lleguen a él. Comprueba con regularidad que los pagos llegan a tu propia cartera.
- El proveedor puede ver cómo usas tu tienda. Por defecto, las tiendas de un servidor compartido no pueden usar el nodo Lightning del servidor ni crear carteras calientes.
La documentación recomienda los alojamientos de terceros para hacer pruebas y aprender, no para pagos grandes o frecuentes.
BTCPay: alojamiento de terceros ↗
Crea una tienda
- Elige Create account y regístrate.
- En Create your first store, introduce un nombre en Name, una moneda para tus precios en Default currency y una fuente de precios en Preferred Price Source, el tipo de cambio que BTCPay usa para convertirlos. La fuente sugerida sirve para empezar. Elige Create Store.
- El panel muestra lo que queda por hacer: Set up a wallet y, si lo quieres, Set up a Lightning node.
Conecta una cartera
Elige Set up a wallet. BTCPay ofrece dos caminos.
Connect an existing wallet es el más seguro. BTCPay solo recibe la clave pública de tu cartera, que le permite crear una dirección nueva para cada factura pero no gastar. Las preguntas frecuentes del proyecto lo dicen así: "Even if your server gets hacked, your funds from the on-chain transactions are always safe." [Aunque hackeen tu servidor, tus fondos de las transacciones en cadena siempre están a salvo]. Las opciones de importación son:
- Connect hardware wallet, con la aplicación Vault de BTCPay en tu ordenador y el dispositivo conectado.
- Import wallet file, un archivo exportado desde una cartera como Sparrow.
- Enter extended public key, pegada a mano.
- Scan wallet QR code, que BTCPay indica para BlueWallet, Passport y otras.
- Enter wallet seed, marcada como Not recommended. Nunca escribas tus palabras de recuperación en un servidor.
Create a new wallet crea las claves en el servidor. Una Hot wallet guarda allí la clave privada, así que BTCPay puede gastar por ti, para reembolsos y pagos salientes, pero también puede hacerlo cualquiera con acceso de administrador al servidor. El propio consejo de BTCPay es "regularly withdraw funds to a different wallet" [retirar fondos con regularidad a otra cartera]. Una Watch-only wallet te muestra las palabras de recuperación una vez y borra la clave privada del servidor.
Cuando BTCPay pida un tipo de dirección, Segwit (Recommended) es adecuado para la mayoría de las tiendas.
Create a store to begin accepting payments.
The recommended price source gets chosen based on the default currency.
El límite de separación (gap limit). Tu aplicación de cartera mira un número fijo de direcciones sin usar por delante, normalmente 20. Cada factura usa una dirección nueva, así que después de 20 facturas sin pagar seguidas tu cartera puede dejar de ver los pagos nuevos, aunque BTCPay los registre. Si tu cartera tiene un ajuste de gap limit, súbelo. Los pagos no se pierden, solo quedan ocultos hasta que la cartera mire más allá.
Preguntas frecuentes de BTCPay: carteras y gap limit ↗ · BTCPay Vault ↗
Lightning
Lightning es opcional y está desactivado por defecto. En Connect to a Lightning node hay dos opciones.
- Use internal node ejecuta un nodo Lightning en el propio servidor de BTCPay. Es una cartera caliente en una máquina accesible desde internet. La documentación de BTCPay advierte: "Do not use more than you can afford to lose." [No uses más de lo que puedas permitirte perder]. Sus palabras de recuperación solo devuelven la parte en cadena, y los canales necesitan su propia copia de seguridad.
- Use custom node se conecta a un nodo Lightning que ejecutas en otro lugar. BTCPay es compatible con LND, Core Lightning, Phoenixd y Eclair. Las conexiones LNDhub ahora necesitan un plugin.
También puedes aceptar pagos Lightning sin un nodo propio, mediante plugins. Se explican más abajo.
BTCPay: opciones de Lightning ↗
Formas de cobrar
- Facturas. Payments, luego Invoices y luego Create Invoice, para un importe puntual en tu moneda.
- Point of Sale. Una caja para una tienda o un puesto, por ejemplo como lista de productos, como lista de productos con carrito o como teclado para escribir un importe.
- Solicitudes de pago. Una solicitud de pago es una página que envías a un cliente. Si lo permites, se puede pagar en partes, y cada pago usa el tipo de cambio del momento.
- Crowdfund. Una página de recaudación de fondos al estilo de Kickstarter, que se cobra directamente en tu cartera.
- Pay Button. Un botón para un sitio web. BTCPay advierte que "should only be used for tips and donations" [solo debe usarse para propinas y donaciones], porque el comprador puede cambiar los datos del pedido que envía.
- Suscripciones. Planes recurrentes que se cobran cada mes, cada trimestre, cada año o una sola vez de por vida. Bitcoin no tiene domiciliación bancaria, así que los clientes o bien pagan una factura en cada periodo tras un recordatorio, o bien recargan un saldo de crédito del que se descuentan las renovaciones.
- Lightning Address. Cuando Lightning está activado, la tienda puede tener direcciones del tipo name@yourserver, que cualquiera puede pagar desde una cartera Lightning.
- Pull Payments. Lo contrario de una factura. Fijas un importe y envías un enlace, y la persona lo reclama a la dirección que elija. BTCPay los usa para los reembolsos, y también sirven para pagos al personal o a colaboradores.
- Pago por NFC. La página de pago puede aceptar el toque de una tarjeta Lightning sin contacto, como una Boltcard.
Espera a que una factura muestre Settled antes de entregar la mercancía. Un cliente que paga desde un exchange a veces envía un poco menos, porque el exchange descuenta su propia comisión de retirada. BTCPay marca entonces la factura como pagada en parte.
Guía de usuario de BTCPay ↗ · BTCPay: Shopify V2 ↗
Tiendas online y plugins
Tiendas online. BTCPay se conecta con la mayoría del software de tiendas. WooCommerce usa un plugin de WordPress instalado en tu sitio web. Shopify usa la versión 2 de la integración de BTCPay, que funciona en tu servidor de BTCPay y necesita una cuenta de Shopify Partner. La versión original está retirada. La documentación de BTCPay también cubre Magento, PrestaShop, Odoo, Wix, Ghost, Zapier y otros, y hay una API para tus propios sistemas.
Los plugins añaden funciones al propio servidor. El Plugin Directory, en el menú Plugins de la parte superior derecha, incluía 57 para la versión 2.4.7. Algunos útiles:
- Lightning sin nodo propio. Strike y Blink reciben en una cuenta con esas empresas, que guardan el dinero por ti. Breez y Flint ejecutan una cartera Lightning ligera dentro de BTCPay, pero guardan sus palabras de recuperación en el servidor, donde el operador del servidor puede acceder a ellas. Flint además guarda el saldo en Spark, una red aparte cuya propia documentación dice que el dinero no está bajo tu custodia exclusiva. Arkade y Bark usan Ark, una forma más reciente de hacer pagos fuera de la cadena de bloques, y son software en fase inicial.
- Tu propio nodo. El plugin LSPS-1 compra un canal entrante a un proveedor de servicios Lightning, para que un nodo nuevo pueda recibir desde el primer momento.
- Nostr. El plugin Nostr da a la tienda una dirección Nostr, acepta zaps y puede recibir en una cartera que conectes con Nostr Wallet Connect, como Alby Hub.
- Repartir y retirar a dinero fiduciario. Prism reparte cada pago entre varios destinos, por ejemplo socios o una cartera de ahorro. Bringin reenvía una parte de lo que recibes a una cuenta en euros con Bringin.
- Dejar que los clientes paguen con otras monedas. SideShift, FixedFloat y Trocador añaden un servicio de cambio al pago. El cliente paga con otra moneda y tú recibes bitcoin. Cada servicio de cambio es un tercero con sus propias condiciones.
- Venta de entradas y venta en persona. TicketTailor y Satoshi Tickets venden entradas para eventos. Boltcards Extension programa tarjetas sin contacto que guardan un saldo Lightning. BTC Map añade tu tienda a un mapa de lugares que aceptan bitcoin.
- Otras monedas. Hay plugins para Monero, Zcash y USDt. El plugin de Monero advierte que usa una sola cartera para todas las tiendas del servidor, así que úsalo solo en un servidor que no compartas.
- Ecash. BTCNutServer acepta ecash Cashu. Su propia descripción dice que es una beta temprana que no ha sido auditada.
Solo el administrador del servidor puede instalar plugins, así que en el servidor de otra persona tienes lo que esa persona haya instalado. Los plugins se ejecutan dentro de BTCPay con acceso a sus datos. El propio aviso de BTCPay dice que "have not undergone review by the BTCPay Server team" [no han sido revisados por el equipo de BTCPay Server], y su documentación aconseja instalarlos solo de fuentes de confianza. Comprueba quién mantiene un plugin, mantenlo actualizado y haz antes una copia de seguridad del servidor.
Plugins are developed by third parties. They need to be updated and maintained regularly in addition to BTCPay Server. Use plugins at your own risk.
Documentación de BTCPay: plugins ↗ · Directorio de plugins de BTCPay ↗ · Documentación de BTCPay: WooCommerce ↗
Reembolsos y registros
En una factura, Issue Refund te permite reembolsar al tipo de cambio del momento en que pagó el cliente, al tipo de cambio de hoy, en tu propia moneda o por un importe personalizado. BTCPay te da entonces un enlace para enviar al cliente. El cliente introduce su propia dirección, y tú apruebas y envías el pago en Payments y luego Payouts.
Para tu contabilidad, Payments y luego Reporting exporta facturas, pagos, ventas, reembolsos y más como archivo de hoja de cálculo. La cartera también puede exportar las etiquetas de sus transacciones en el formato estándar BIP 329.
Seguridad y privacidad
- Activa el inicio de sesión en dos pasos. En Two-Factor Authentication, dentro de tu cuenta, puedes añadir una aplicación de autenticación o una llave de seguridad FIDO2. BTCPay también admite llaves de acceso (passkeys).
- Mantén el servidor actualizado. Sigue las nuevas versiones de BTCPay, como demuestra la 2.4.7.
- Mantén pequeñas las carteras calientes, si es que usas alguna.
- Instala solo los plugins que necesites y mantenlos actualizados junto con el servidor.
- Payjoin, que hace que los pagos sean más difíciles de rastrear, necesita una cartera caliente en BTCPay. La guía de Payjoin lo explica.
- Tor es opcional. Las preguntas frecuentes de BTCPay añaden que activarlo "doesn't make you anonymous at all" [no te hace anónimo en absoluto].
Cada factura usa una dirección nueva, lo que ayuda a la privacidad de tus clientes y a la tuya.
BTCPay: refuerzo de la seguridad ↗ · BTCPay: plugins ↗
Antes de aceptar pagos reales
- Registraste tú mismo la cuenta de administrador, justo después de la instalación.
- La tienda usa una cartera que controlas tú, conectada mediante su clave pública, y sus palabras de recuperación están en papel.
- Pagaste una factura de prueba y viste cómo llegaba a tu propia aplicación de cartera.
- El inicio de sesión en dos pasos está activado en todas las cuentas del servidor.
- El personal sabe que debe esperar a Settled.
- Sabes cómo emitir un reembolso.
- Alguien se encarga de comprobar las actualizaciones de BTCPay.
Fuentes y lecturas
Investigado el 18 de noviembre de 2026. El software y los servicios cambian: consulta la documentación actual antes de actuar.
- BTCPay Server ↗
- BTCPay Server: source code ↗
- BTCPay Server 2.4.7 release ↗
- BTCPay Server user guide (2.4.7) ↗
- BTCPay source: wallet setup options ↗
- BTCPay source: hot and watch-only wallets ↗
- BTCPay Docker deployment and hardware specs ↗
- BTCPay docs: deployment options ↗
- BTCPay docs: third-party hosting ↗
- BTCPay docs: wallet FAQ and gap limit ↗
- BTCPay docs: general FAQ ↗
- BTCPay docs: BTCPay Vault ↗
- BTCPay docs: Lightning ↗
- BTCPay docs: Shopify V2 ↗
- BTCPay docs: hardening ↗
- BTCPay docs: plugins ↗
- BTCPay Server Foundation ↗
- Umbrel: BTCPay Server app ↗
- BTCPay plugin directory ↗
- BTCPay docs: WooCommerce ↗
- BTCPay docs: subscriptions ↗
- BTCPay docs: pull payments ↗
- Flint plugin: trust model ↗
- Monero plugin ↗
- BTCNutServer (Cashu) plugin ↗
- Prism, Nostr, Bringin, SideShift and other plugins ↗
Umbrel: ejecuta un nodo y conecta tus carteras a él → · Start9: ejecuta un nodo y conecta tus carteras a él → · Sparrow: crea una cartera que puedas inspeccionar → · Payjoin → · Elige el sistema Lightning que puedas mantener → · Tu saldo es una colección de historias → · Alby Hub: tu propio nodo Lightning, conectado a tus aplicaciones →
