Introducción
BTCPay Server es una solución de código abierto que permite a comerciantes y particulares aceptar pagos en Bitcoin sin depender de intermediarios centralizados. A diferencia de servicios como PayPal o procesadores de tarjetas, BTCPay Server elimina comisiones de procesamiento y otorga control total sobre los fondos.
Requisitos previos
Instalación de BTCPay Server
1. Preparar el entorno
Actualiza paquetes e instala dependencias básicas:
sudo apt update sudo apt upgrade -y
sudo apt install git curl ufw -y
2. Instalar Docker y Docker Compose
Docker es el motor que ejecutará los contenedores de BTCPay Server y sus servicios asociados.
Instalación rápida de Docker:
curl -fsSL https://get.docker.com sh
Instalación de Docker Compose:
sudo curl -L https://github.com/docker/compose/releases/download/1.29.2/docker-compose-(uname -s)-(uname -m) -o /usr/local/bin/docker-compose
sudo chmod x /usr/local/bin/docker-compose
3. Clonar el repositorio oficial
Descargar el script de instalación
git clone https://github.com/btcpayserver/btcpayserver-docker.git btcpayserver
cd btcpayserver
4. Configurar variables de entorno
Duplica el archivo de ejemplo y ajusta parámetros básicos:
cp .env.template .env
BTCPAY_HOST=tu-dominio.com
LETSENCRYPT_EMAIL=tu@correo.com
BTCPAY_GEN_CRYPTO1=BTC
5. Levantar los contenedores
Ejecuta el script principal para compilar y lanzar todos los servicios:
./btcpay-setup.sh -i
Durante este proceso, se generarán certificados TLS con Let’s Encrypt, se inicializará un nodo Bitcoin completo (o pruned) y se desplegará la interfaz web.
Configuración inicial del almacén
Accede a https://tu-dominio.com y crea una cuenta de administrador. Luego:
Configura una tienda (Store Name).
Genera y sincroniza clave privada o usa un hardware wallet.
Define monedas soportadas (p. ej. BTC, GBYTE).
Personaliza página de pago (logotipo, colores).
Modelo de tarifas
Tarifa de red en Bitcoin
Ejemplos prácticos
Microdonación de 0,0001 BTC (~10 USD): tarifa ≈ 250 vB × 10 sat/vB = 2 500 satoshis (0,000025 BTC, ~2,5 USD)
Compra de 0,01 BTC (~1 000 USD): tarifa ≈ 250 vB × 20 sat/vB = 5 000 satoshis (0,00005 BTC, ~5 USD)
Ventajas y consideraciones
Recursos adicionales
Documentación oficial de BTCPay Server: https://docs.btcpayserver.org/
Repositorio GitHub: https://github.com/btcpayserver/btcpayserver-docker