A compact home server and connected network equipment, editorial illustration
LA GUÍA

BTCPay Server: cobra en bitcoin sin intermediarios

BTCPay Server es software gratuito y autoalojado para facturas, una caja de tienda, suscripciones y pagos en tiendas online, que se cobran directamente en tu propia cartera. Dónde ejecutarlo, cómo conectar una cartera de forma segura, Lightning, plugins, reembolsos y cómo mantener seguro el servidor.

Empezar a leer
11 min de lecturaEspañol
MODO DE LECTURA

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

  1. Elige Create account y regístrate.
  2. 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.
  3. 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 your first store

Create a store to begin accepting payments.

NameCorner Shop
Default currencyUSD
Preferred Price SourceRecommendation (Kraken) ▾

The recommended price source gets chosen based on the default currency.

Create Store
1 / 4
Ilustración de cómo crear una tienda y conectar una cartera, dibujada a partir del texto del propio BTCPay Server en la versión 2.4.7. No es una captura de pantalla. El diseño y los colores están simplificados. El nombre de la tienda y la fuente de precios son ejemplos.

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 ↗

  • 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.

Plugin DirectoryInstalled Plugins
Important notice about plugins
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.
NostrNIP5 addresses, Zap support, Nostr Wallet Connect Lightning support
PrismAutomated value splits for Bitcoin.
TicketTailorAllows you to integrate with TicketTailor.com to sell tickets for Bitcoin
1 / 3
Ilustración de cómo instalar un plugin, dibujada a partir del texto del propio BTCPay Server en la versión 2.4.7 y de su directorio de plugins. No es una captura de pantalla. El diseño y los colores están simplificados, y el mensaje de reinicio está parafraseado. Prism es un ejemplo, no una recomendación.

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.

DashboardSettingsWalletsBitcoinLightningPaymentsInvoicesReportingRequests
Create Invoice
Amount25.00
CurrencyUSD
Order Id1042
Item DescriptionCoffee beans, 1 kg
Create
1 / 4
Ilustración de cómo crear una factura y reembolsarla, dibujada a partir del texto del propio BTCPay Server en la versión 2.4.7. No es una captura de pantalla. El diseño y los colores están simplificados, y las pantallas de factura y de pagos salientes se han reducido a las partes que se mencionan aquí. Los importes, el pedido y los tipos de cambio son ejemplos.

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.

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 →

Continúa tu recorrido

Una pregunta lleva a otra.

01Ejecuta un nodo que realmente utilices02Umbrel: ejecuta un nodo y conecta tus carteras a él

Find your next answer.

Search the complete field guide · Esc to close