Esta guía explica cómo configurar pagos Bitcoin en su sitio web utilizando Electrum. Utilizaremos solicitudes de pago firmadas con SSL, siguiendo la BIP-70 estándar. Esta documentación está actualizada para Electrum 4.0 y posteriores.
Antes de empezar, asegúrate de que tienes:
- Un certificado SSL válido (firmado por una CA, como el gratuito LetsEncrypt).
- La versión de desarrollo de Electrum instalada.
Recuerde ejecutar el comando de actualización del submódulo durante la instalación.
Configure su certificado SSL en Electrum
Para habilitar conexiones seguras, necesita añadir su certificado SSL a Electrum. Utilice estos comandos en su terminal:
electrum -o setconfig ssl_keyfile /path/to/ssl/privkey.pem
electrum -o setconfig ssl_certfile /path/to/ssl/fullchain.pem
Para obtener instrucciones más detalladas sobre cómo añadir SSL a Electrum, consulte la página Configuración de SSL para Electrum.
Creación y uso de su monedero electrónico
Configure un monedero seguro para sus transacciones comerciales. Este proceso ayuda a proteger su criptomoneda incluso si su servidor comercial se ve comprometido.
- Crear una nueva cartera
En un ordenador seguro, crea un nuevo monedero:
electrum create
Lo mejor es utilizar un monedero distinto para su negocio, no el personal.
- Exportar la clave pública maestra
Siempre en su ordenador seguro, exporte la clave pública maestra (xpub):
electrum getmpk -w .electrum/wallets/your-wallet
- Configurar el servidor de comercio
En su máquina servidor, restaure el monedero utilizando la Clave Pública Maestra exportada:
electrum restore xpub...............................................
Sustituir xpub... con su Clave Pública Maestra actual
- Configurar los ajustes del servidor.
electrum -o setconfig payserver_address yourdomain.com:80
Sustituir yourdomain.com con su dominio real.
Iniciar el demonio de Electrum
Después de configurar su monedero de sólo lectura, necesita ejecutar Electrum como un servicio en segundo plano. He aquí cómo:
- Iniciar el demonio
Ejecute este comando para iniciar Electrum como demonio:
electrum daemon -d
Esto inicia Electrum en modo demonio, lo que le permite ejecutarse en segundo plano.
- Cargue su cartera
A continuación, carga tu monedero en el demonio en ejecución:
electrum load_wallet
Este comando hace que tu monedero esté activo y listo para su uso.
Detener el demonio
Si necesita detener el demonio de Electrum en cualquier momento, utilice este comando:
electrum stop
Esto cerrará de forma segura el demonio de Electrum.
Crear una solicitud de pago firmada
electrum add_request 0.5 -m "test"
{
"URI": "bitcoin:bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z?amount=0.5&message=test&time=1589115653&exp=3600",
"address": "bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z",
"amount": 50000000,
"amount_BTC": "0.5",
"bip70_url": "https://yourdomain.com:80/bip70/bc1qyr5xx5jkue3k72sldm5xa0taqs3n2achupymz8.bip70",
"exp": 3600,
"id": "63822b69013",
"memo": "test",
"status": 0,
"status_str": "Expires in about 1 hour",
"time": 1589115653,
"type": 0,
"view_url": "https://yourdomain.com:80/r/pay?id=bc1q3hr4xnta7s4jgeymjhs498ygqa53qkjxqhlx3z"
}
He aquí un desglose de la información clave:
URI: Un URI de Bitcoin que incluye el importe, el mensaje, la marca de tiempo y la caducidad.address: La dirección Bitcoin para el pago.amount: La cantidad solicitada en satoshis.amount_BTC: La cantidad solicitada en BTC.bip70_url: La URL de la solicitud BIP70 firmada.view_url: La URL de una página web que muestra la solicitud.
La salida del comando incluye dos URL importantes:
bip70_url: Es la URL de la solicitud BIP70 firmada.view_url: Es la URL de una página web que muestra los detalles de la solicitud.
Para ver la lista actual de solicitudes, utilice el botón list_requests mando.
Para eliminar todas las solicitudes de la lista, utilice la opción clear_requests mando.
Abra la página de solicitud de pago en su navegador
Después de crear una solicitud de pago, puede visualizarla en un navegador web.
A continuación se explica cómo utilizar la página de solicitud de pago:
- Abra el
view_urlde la salida de la solicitud de pago en su navegador web. - La página mostrará los detalles de la solicitud de pago, incluyendo:
- Un URI de Bitcoin que puede abrirse con un monedero.
- Un código QR que se puede escanear para pagar.
- El tiempo restante hasta que expire la solicitud.
- Para efectuar un pago:
- Utilice un monedero Bitcoin para abrir el URI Bitcoin proporcionado.
- Escanee el código QR con un monedero móvil.
- La página utiliza websockets para actualizarse en tiempo real. Cuando se reciba el pago, la página se actualizará automáticamente para mostrar el estado actualizado.
La apariencia real de la página puede variar, pero contendrá la información esencial necesaria para completar el pago.
Importante: Verifique siempre los datos de pago antes de enviar fondos.
Pagos relámpago
Configuración de Lightning
Para utilizar Lightning, debes configurar claves Lightning en tu monedero. Sigue estos pasos:
- Detener el demonio Electrum:
electrum stop - Inicializar las llaves del rayo:
electrum -o init_lightning - Reinicie el demonio:
electrum daemon -d
Puedes añadir claves Lightning a un monedero de vigilancia. Este monedero no podrá gastar monedas en la cadena, pero sí realizar transacciones Lightning.
Abrir un canal
Después de configurar Lightning, tienes que abrir un canal:
electrum open_channel <node_id> <amount>
Para comprobar si el canal está listo para su uso:
electrum list_channels
Tenga en cuenta que su nuevo canal no tendrá capacidad de entrada al principio, por lo que no podrá recibir pagos inmediatamente. Si necesitas recibir inmediatamente, considera hacer un intercambio submarino de los fondos de tu canal.
Creación de una solicitud de pago relámpago
Para crear una solicitud de pago Lightning:
electrum add_lightning_request 0.0001 -m "test"
Este comando crea una solicitud de 0,0001 BTC con el mensaje "test".