BTCPay Server: cómo recibir pagos en Bitcoin sin entregar la custodia de tus fondos

Cada vez que un comercio dominicano se plantea aceptar Bitcoin en su negocio, la primera pregunta que aparece no es técnica sino de confianza: ¿y quién se queda con mi dinero mientras tanto?

Es una pregunta sensata. En los pagos con tarjeta hay un procesador que recibe primero y liquida después. En muchas plataformas de criptomonedas pasa lo mismo: el dinero cruza por una empresa antes de llegar a ti.

BTCPay Server plantea otra arquitectura: el cobro puede llegar directamente a una wallet que tú controlas, sin que nadie lo retenga por el camino.

Esta guía explica cómo funciona, qué necesitas para ponerlo a andar y dónde están los matices que casi nadie cuenta.

Interfaz web de BTCPay Server
Captura: documentación oficial de BTCPay Server. © 2017-2019 BTCPayServer. Licencia MIT.

Qué es BTCPay Server

BTCPay Server es un software libre para recibir pagos en Bitcoin. No es una empresa ni un servicio contratado: es código que cualquiera puede instalar, auditar y modificar.

La documentación oficial lo define como «a free, open-source, and self-hosted bitcoin payment gateway that allows self-sovereign individuals and businesses to accept bitcoin payments online or in person without any fees». Está publicado bajo licencia MIT.

Tres consecuencias prácticas para un negocio:

  • No cobra comisión de procesamiento. El único costo de un pago on-chain es la comisión de red que va a los mineros.
  • No hay contrato, suscripción ni verificación de identidad exigidos por el software.
  • No hay una empresa que pueda cerrarte la cuenta, porque no existe tal empresa: «BTCPay Server is code, not a company.»

En República Dominicana ya hay infraestructura local corriendo sobre este software: en febrero de 2026 se anunció un nodo de BTCPay Server para la economía circular dominicana.

Qué significa «no custodial» (y qué no significa)

Custodia es una palabra concreta: significa que alguien más tiene la capacidad técnica de mover tus fondos.

En una configuración estándar de BTCPay Server, el comercio conecta una wallet que ya controla y el software solo recibe la clave pública extendida (el xpub). Con esa clave el sistema puede generar direcciones nuevas para cada cobro, pero no puede gastar nada.

La documentación es explícita: «Payments with BTCPay go directly to your wallet… Your private keys are never required to receive payments to your BTCPay Server.»

Regla que no admite excepción
Ninguna herramienta de cobro necesita tu frase semilla ni tu clave privada para recibir pagos. La propia documentación de BTCPay lo dice sin rodeos sobre los servidores de terceros: «Private key never required (if it is, it’s a scam!)». Si alguien te la pide, no es un requisito técnico: es un intento de robo.

La letra pequeña: servidor propio o servidor de un tercero

Aquí está el matiz que conviene entender antes de cobrar tu primer peso.

Puedes instalar tu propia instancia de BTCPay Server, o registrarte en una que aloje otra persona. La segunda opción es la más común porque es rápida y suele ser gratuita, y es lo que hacen quienes ofrecen instancias abiertas al público —BitcoinRepDom, por ejemplo, es un proyecto independiente que opera una instancia basada en este software.

La documentación oficial sobre alojamiento de terceros enumera las ventajas —configuración rápida, pagos directos a tu wallet, clave privada nunca requerida— pero también sus contras, y las dice con todas las letras: «No control over a server» y «Have to trust the owner of the server».

¿Por qué hay que confiar, si el host no tiene tus llaves? Por dos razones documentadas:

  1. Si el host habilita la creación de hot wallets en su servidor, quien las use estará dejando las claves en manos del operador. La documentación lo desaconseja expresamente para instancias de terceros.
  2. Un host técnicamente capaz podría correr una versión modificada del software y sustituir tu xpub por el suyo, de modo que los pagos futuros terminen en su wallet.

La defensa práctica contra lo segundo es sencilla y conviene adoptarla como rutina: sigue tus cobros desde tu propia wallet, no solo desde el panel. Si el sistema marca facturas como pagadas y en tu wallet no aparece nada, algo va mal.

Antes de empezar: lo que necesitas

  1. Una wallet Bitcoin que ya controles, con su respaldo hecho y guardado fuera de línea. Para montos de trabajo, la documentación recomienda un hardware wallet.
  2. Un correo electrónico para la cuenta de acceso.
  3. Un teléfono, tablet o computadora con navegador, que será tu punto de venta.
  4. Disposición a hacer una prueba con poco dinero antes de cobrarle a un cliente real.

Cómo configurarlo paso a paso

1. Crear la cuenta de acceso

Te registras en la instancia con tu correo y creas una contraseña. Conviene activar de una vez la autenticación en dos pasos: la documentación lo recomienda expresamente al registrar la cuenta.

Esa cuenta es una credencial de acceso a una herramienta. No es una cuenta bancaria, ni de depósito, ni de inversión: no hay un saldo tuyo guardado ahí.

2. Crear tu Store

Pantalla de creación de una tienda en BTCPay Server
Captura: documentación oficial de BTCPay Server. © 2017-2019 BTCPayServer. Licencia MIT.

La Store (tienda) es donde vive toda la configuración de cobro de tu negocio. Al crearla defines:

  1. El nombre del negocio.
  2. La moneda predeterminada en la que quieres expresar los precios —para un comercio local, normalmente pesos dominicanos.
  3. El proveedor de tasa de cambio que convertirá ese precio a bitcoin en el momento del cobro.

Si tienes varios negocios o sucursales, puedes crear una tienda para cada uno.

3. Conectar tu wallet

Confirmación de direcciones en la pantalla de un hardware wallet
Captura: documentación oficial de BTCPay Server. © 2017-2019 BTCPayServer. Licencia MIT.

Este es el paso que define si el modelo es no custodial o no.

Dentro de la tienda vas a la configuración de wallet de Bitcoin y eliges conectar una wallet existente. La documentación lista los métodos y marca su recomendación:

  • Conectar un hardware wallet — recomendado
  • Importar un archivo de wallet — recomendado
  • Introducir la clave pública extendida (xpub)
  • Escanear el código QR de la wallet
  • Introducir la semilla de la wallet — no recomendado

La última opción existe, pero la documentación advierte: «In general you should never type wallet seed words on any internet connected device.» Si vienes de una wallet móvil y estás dando el paso hacia el control de tus propias llaves, te sirve este contexto sobre la autocustodia en República Dominicana.

Sobre las hot wallets
BTCPay también permite generar una wallet nueva dentro del servidor. Es cómodo, pero las claves quedan almacenadas ahí. La documentación oficial advierte: «never leave money you cannot afford to lose spendable by those private keys». En una instancia que no administras tú, esta opción es la que convierte el arreglo en custodial.

4. Verificar que las direcciones son tuyas

Antes de cobrarle a nadie, comprueba que lo que el sistema genera coincide con lo que tu wallet reconoce:

  1. Genera una dirección de recepción desde el panel.
  2. Compárala con la que muestra tu wallet.
  3. Si usas hardware wallet, confírmala en la pantalla del dispositivo —el flujo oficial de integración incluye ese paso de validación.
  4. Envía un monto pequeño y verifica que llega a tu wallet, no solo que el panel lo marca como recibido.

Ese último punto no es paranoia: es la forma concreta de detectar el ataque de sustitución de xpub descrito arriba. Si quieres entender por qué la verificación continua importa incluso con herramientas serias, vale la pena leer los dos incidentes de Coldcard y BTCPay Server y la lección que dejaron.

Cobrar: facturas y punto de venta

La factura y sus estados

Una factura (invoice) es un documento con un monto fijado a una tasa de cambio, válido durante un tiempo determinado. La expiración existe para proteger a quien cobra de las variaciones de precio mientras el cliente paga.

El cliente ve el monto, el equivalente en bitcoin, la dirección o el QR, y el estado. Los estados base que maneja el sistema son:

  • New — emitida, aún sin pagar y dentro del tiempo válido.
  • Processing — pagada completa, pero todavía sin las confirmaciones que tú exiges en la configuración de la tienda.
  • Settled — pagada y con las confirmaciones suficientes. Es la que cierra la venta.
  • Expired — venció sin pago.
  • Invalid — se pagó, pero no llegó a reunir las confirmaciones dentro del plazo definido.

Hay variantes para pagos parciales, tardíos o en exceso. En el mostrador lo que importa es la diferencia entre Processing y Settled: la primera dice que el pago se vio en la red, la segunda que ya está asentado según el nivel de seguridad que tú definiste.

El Point of Sale desde un teléfono o tablet

Aplicación de punto de venta de BTCPay Server
Captura: documentación oficial de BTCPay Server. © 2017-2019 BTCPayServer. Licencia MIT.

Para vender en un local no hace falta ninguna terminal especial. BTCPay incluye una aplicación de punto de venta que funciona en el navegador: se abre en un teléfono, una tablet o una computadora, y puede dejarse como acceso directo en la pantalla de inicio.

La documentación describe tres vistas: Static (solo el catálogo), Cart (catálogo con carrito) y Light (un teclado numérico para escribir el monto y cobrar). Los nombres pueden variar según la versión instalada.

Para un colmado, un barbero o un restaurante, la vista de teclado suele ser suficiente: escribes el monto en pesos, el sistema muestra el QR, el cliente escanea y paga. Así es como funciona en la práctica en los más de 100 comercios dominicanos que ya aceptan Bitcoin.

¿Qué pasa realmente con el bitcoin cuando un cliente paga?

Cuando el cliente escanea el QR y envía el pago, la transacción va a una dirección derivada de tu propia wallet. No pasa por una cuenta intermedia, no queda en un saldo dentro de la plataforma y nadie tiene que «liberarla» después.

Lo que hace el software es observar la red y avisarte cuando el pago aparece y cuando reúne confirmaciones. Es un vigilante, no un cajero.

Por eso no existe un botón de «retirar»: no hay de dónde retirar. El bitcoin ya está en tu wallet desde el primer momento.

BTCPay Server, una wallet y un exchange no son lo mismo

Tres cosas distintas que se confunden a diario:

  • La wallet es donde viven tus llaves y, por tanto, tu bitcoin. Es tuya.
  • BTCPay Server es el software que genera cobros y vigila si llegaron. No guarda bitcoin.
  • Un exchange o casa de cambio es un tercero que compra y vende, y que sí recibe y retiene fondos mientras opera.

BTCPay Server no compra ni vende bitcoin, no convierte a pesos y no recibe depósitos. Si necesitas convertir a moneda local, eso ocurre en otro lugar y con otro proveedor.

Lightning: aquí la custodia depende de la configuración

Lightning permite cobros casi instantáneos y con comisiones mínimas, ideal para montos pequeños. Pero el modelo de custodia no es automático: depende de qué nodo se use.

La documentación oficial es tajante al respecto. Si el comercio usa el nodo Lightning interno del host de un servidor de terceros, advierte: «All payments made through the Lightning Network will go to your third-party’s wallet», y añade que en general debería evitarse y preferirse las opciones autoalojadas.

Traducido al mostrador: en on-chain con xpub, el pago llega a tu wallet; en Lightning por el nodo de otro, el pago llega primero a la wallet de ese otro y depende de él que te lo entregue. Son dos situaciones distintas y conviene saber en cuál estás antes de habilitar nada.

Si vas a usar Lightning, pregunta a quien administra la instancia qué nodo se está usando. La respuesta cambia por completo quién controla el dinero.

Riesgos y buenas prácticas

Antes de operar de verdad

  • Respalda tu semilla en papel, fuera de línea, y nunca la fotografíes ni la guardes en el teléfono.
  • Activa la autenticación en dos pasos en tu cuenta de acceso.
  • Nunca compartas semilla ni clave privada. Nadie legítimo te las pedirá.
  • No envíes fondos «para verificar» una cuenta. Eso no existe.
  • Haz una prueba con poco monto antes del primer cobro real.
  • Revisa tus cobros desde tu propia wallet, no solo desde el panel.
  • Recuerda que las transacciones en Bitcoin son irreversibles y que el precio es volátil.

A eso se suma lo obvio pero incómodo: tus obligaciones legales y fiscales como comercio no cambian por el medio de pago que aceptes. Conviene consultarlo con tu contador o tu abogado, porque este artículo es educativo y no sustituye asesoría profesional.

En resumen

Aceptar Bitcoin no significa necesariamente entregarle tus fondos a un intermediario. Herramientas como BTCPay Server permiten que comercios y profesionales monten una infraestructura de pagos donde el control de la wallet puede permanecer en manos del propio usuario.

Ese puede es importante y por eso lo repetimos: el modelo se sostiene si conectas una wallet propia y evitas configuraciones que trasladen la custodia a un tercero. La tecnología lo permite; la configuración lo decide.


¿Quieres seguir aprendiendo cómo usar Bitcoin en República Dominicana? En BitcoinDominicana.com encontrarás guías, comercios que ya aceptan pagos, herramientas y recursos educativos gratuitos para dar el siguiente paso. Si tienes un negocio y quieres empezar, puedes registrarlo aquí.


Bitcoin Dominicana publica este contenido con fines educativos. No operamos instancias de BTCPay Server, no procesamos pagos, no recibimos fondos ni custodiamos bitcoin de terceros. BitcoinRepDom se menciona únicamente como ejemplo de una implementación independiente basada en este software, y no forma parte de Bitcoin Dominicana. Este contenido no constituye asesoría financiera, legal ni fiscal.

Entradas recomendadas