Definir el límite de la cartera
Una cartera de solo observación puede detectar pagos sin tener las claves privadas de gasto. Una clave pública extendida sigue revelando actividad sensible de la cartera y debe protegerse. La integración con Lightning puede requerir una cartera en línea e introduce un riesgo operativo adicional.
Dimensiona para el stack completo
Un backend Bitcoin, una base de datos, un servicio web y un nodo Lightning opcional tienen necesidades de almacenamiento y memoria diferentes. Revise las instrucciones de despliegue compatibles actuales y los requisitos de crecimiento antes de elegir una máquina pequeña.
Protege la interfaz del comerciante
Use un nombre de host dedicado, HTTPS, una protección de inicio de sesión robusta y un acceso administrativo restringido. Mantenga el servidor actualizado y verifique las firmas de webhook o los mecanismos de verificación compatibles en la aplicación receptora. No envíe mercancías basándose únicamente en una redirección del navegador.
Hacer copia de seguridad y conciliar
Protege la configuración de la tienda, la base de datos, la información de recuperación de la cartera y el material específico de Lightning según la documentación correspondiente. Prueba la recuperación y concilia las facturas con el sistema de pagos, especialmente en lo relativo a vencimientos, pagos insuficientes y reembolsos.
Compruebe la estrategia de despliegue y de cadena
Usa las instrucciones de despliegue compatibles actuales, un nombre de host dedicado y una ruta HTTPS verificada. Una cadena podada puede reducir los requisitos de almacenamiento continuo cuando sea compatible, pero deben comprenderse las necesidades de reescaneo y recuperación. No elijas un disco basándote solo en el tamaño actual de la cadena; deja espacio para toda la pila y su crecimiento.
- Verifica la devolución de llamada de pago desde una prueba externa
- Use pagos de prueba antes de una tienda en vivo
- Confirma la política de liquidación de facturas
Documentación oficial: Opciones de despliegue de BTCPay
Mantén la clave de gasto donde pretendes
Una configuración de solo observación puede detectar pagos a partir de una clave pública extendida sin dar al servidor la clave de gasto. La xpub es sensible porque puede revelar la actividad de la cartera. Una cartera en caliente cambia este riesgo al poner la capacidad de gasto en línea. Revisa por separado la custodia de la cartera y de Lightning y sigue el proceso de copia de seguridad compatible.
Documentación oficial: Modelo de cartera de BTCPay
Crea una lista de verificación de despliegue en torno al stack elegido
Comienza con un dominio dedicado, un método de despliegue compatible, el modo de cadena previsto y suficiente espacio en disco para la sincronización. Revisa el generador Docker upstream y sus componentes seleccionados antes de la instalación; conserva las opciones de despliegue no secretas para que otra máquina pueda reconstruirse de forma coherente. Comprueba la resolución del dominio, la emisión del certificado y la titularidad de la cuenta administrativa antes de mostrar un checkout a los clientes. Un ejemplo genérico de Docker Compose no demuestra que todos los componentes opcionales de BTCPay estén configurados.
- Decide qué propietario de la instancia controla las actualizaciones, la monitorización, las copias de seguridad y la respuesta a incidentes.
- Separa la exposición del proxy inverso del RPC Bitcoin privado, la base de datos y la administración de Lightning.
- Documenta los límites de recuperación y reescaneo de un backend podado antes de conectar una cartera con pagos históricos.
- Mantén un entorno de prueba compatible o un pequeño ejercicio de pago controlado para las integraciones antes de cumplir pedidos valiosos.
Documentación oficial: BTCPay Server: opciones de despliegue · BTCPay Server: despliegue Docker compatible
Investigar pagos de cartera faltantes sin importar una semilla
Una tienda puede usar la información de xpub/derivación de una cartera mientras la clave de gasto permanece en otro dispositivo. Pruebe la recepción y la ruta de recuperación con la cartera elegida. Si BTCPay ve el pago de una factura pero una cartera externa no lo muestra, inspeccione su esquema de derivación y el comportamiento del límite de direcciones vacías antes de suponer que los fondos desaparecieron. Largas secuencias de direcciones generadas sin pagos pueden afectar el descubrimiento de una cartera. Use los diagnósticos compatibles de la cartera en lugar de copiar las palabras de recuperación en el servidor.
Documentación oficial: BTCPay Server: solución de problemas de billetera y derivación
Conciliar las facturas antes de la entrega
Registra los identificadores de factura y haz que la operación de cumplimiento sea idempotente. El regreso del navegador a la tienda es un evento de navegación, no una prueba de liquidación. Verifica el estado del pago mediante tu integración de servidor autenticada, gestiona explícitamente las facturas caducadas, tardías o pagadas por debajo del importe y mantén una vía de revisión para los resultados sin resolver. Si una devolución de llamada se repite, devolver una confirmación correcta no debe enviar ni abonar el pedido dos veces.
- Prueba un pago que llegue cerca del vencimiento y verifica que el pedido siga asociado a la factura correcta.
- Mantén la base de datos, la configuración del almacén y el material de recuperación de la cartera en una copia de seguridad independiente y probada.
- Lightning añade una responsabilidad separada de liquidez y copia de seguridad de canales; restaurar todo el VPS de ayer no es un procedimiento de recuperación universal seguro.
- Alojar una instancia de BTCPay no añade Lightning ni XMR al pago de clientes de KoalaVPS; los métodos de pago en este sitio de alojamiento siguen siendo sus siete rutas publicadas.
Documentación oficial: Guía para desarrolladores de Bitcoin: verificación de pagos · LND: recuperación ante desastres · Core Lightning: copias de seguridad de cartera y canales