Acepta Bitcoin sin intermediarios: BTCPay Server en tu VPS

Un procesador de pagos hace más que cobrar una comisión. Retiene tus fondos, ve a tus clientes y puede congelar tu cuenta. BTCPay Server es un software gratuito y de código abierto que te permite aceptar Bitcoin directamente en una cartera que controlas. Funciona en un VPS, y esta guía muestra la instalación estándar basada en Docker.

Qué necesitas

• Un VPS con 2 vCPU, 4 GB de RAM y 80 GB de disco si ejecutas a su lado un nodo Bitcoin podado. Menos si lo apuntas a un nodo externo.
• Un nombre de dominio, por ejemplo pay.example.com, con un registro A que apunte al servidor.
• Ubuntu 22.04 o 24.04 con Docker instalado y una configuración SSH reforzada.

Paso 1: apunta el dominio

Crea primero el registro A y espera a que se resuelva. El instalador solicita un certificado de Let's Encrypt para el nombre, y fallará si falta el registro. Nuestra guía de DNS lo explica.

Paso 2: ejecuta el instalador oficial

sudo su -
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="pay.example.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="clightning"
export BTCPAYGEN_REVERSEPROXY="nginx"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-s"
export LETSENCRYPT_EMAIL="you@example.com"
. ./btcpay-setup.sh -i

El fragmento opt-save-storage-s poda la blockchain para ahorrar disco. La sincronización inicial puede tardar muchas horas, y la tienda funciona para facturas una vez que el nodo se ha puesto al día. Lightning es opcional, así que omite esa línea si no lo quieres.

Paso 3: crea el administrador y una tienda

Abre tu dominio, registra la primera cuenta (se convierte en el administrador del servidor) y después desactiva el registro público en Server Settings. Crea una tienda y define su moneda por defecto.

Paso 4: conecta una cartera que controles

Genera la cartera en una cartera hardware o en tu propio dispositivo, y pega en BTCPay solo la clave pública (la xpub). No generes una hot wallet en el servidor si puedes evitarlo, porque entonces los fondos dependen de que el servidor siga seguro. Los pagos van directamente a direcciones derivadas de tu clave pública.

Paso 5: prueba e integra

Crea una factura de prueba y paga una cantidad pequeña. Después instala un plugin para tu tienda (WooCommerce, Shopify, una clave de API personalizada) siguiendo la documentación de BTCPay.

Mantenlo seguro

• Activa la autenticación de dos factores en el administrador.
• Haz copia de seguridad de los datos de BTCPay con el script de copia integrado y guárdala fuera del servidor y cifrada.
• Actualiza con btcpay-update.sh, después de leer las notas de la versión.
• Ejecuta el cortafuegos con solo SSH, 80 y 443 abiertos.

Para saber qué moneda conviene a tus clientes, lee la cripto más barata para pagos. ¿Ejecutas tu propio nodo de respaldo? Consulta ejecutar un nodo Bitcoin.