BLOG |
Anuncios intermitentes
Añade Bitcoin Lightning a tu proceso de pago de WooCommerce con una clave API de custodia o, ahora, con una dirección Blink Lightning sin custodia, en la que tú mismo conservas las claves.
WooCommerce gestiona más de cuatro millones de tiendas online activas, más que cualquier otra plataforma. Nuestro plugin Blink for WooCommerce lleva desde 2024 ofreciendo a esas tiendas la posibilidad de aceptar Bitcoin en la página de pago: Lightning como opción de pago junto a la transferencia bancaria, PayPal, Stripe o cualquier otra forma de pago disponible, sin necesidad de un servidor ni de un nodo. El cliente selecciona Lightning, se genera una factura para su carrito, la abona y, cuando se confirma el pago, WooCommerce cambia el estado del pedido a «pagado» y lo marca como listo para su tramitación. Esa es la idea en su totalidad.
La novedad es que ahora esto funciona con una cuenta de Blink sin custodia. Seleccionas «sin custodia» en el menú desplegable, introduces tu dirección de Blink Lightning y los sats de cada venta van directamente a tu propio monedero. Nosotros nunca tocamos ese dinero.
Quiero explicar por qué hemos creado el complemento, en qué se diferencian realmente los dos tipos de cuenta, por qué solo funciona con una dirección de Blink, qué es lo que aún no funciona y, a continuación, guiaros paso a paso por la configuración de ambas opciones.
Por la misma razón por la que creamos el botón de donaciones: llevar Lightning allí donde ya está la gente. El comercio electrónico está dominado por un puñado de plataformas. La mayoría de las tiendas utilizan WooCommerce, y el resto, Shopify, PrestaShop, Joomla o similares. WooCommerce es de código abierto, nosotros también lo somos, y no existía ninguna opción válida de « Lightning » con Bitcoin para su proceso de pago.
Si ya tienes un servidor BTCPay, no tienes de qué preocuparte: cuenta con un excelente complemento para WooCommerce, y también disponemos de un complemento de Blink para BTCPay. Pero utilizar BTCPay implica tener un servidor o conocer a alguien que lo tenga, y la mayoría de los propietarios de tiendas no cumplen estos requisitos. Este complemento está pensado para ellos: una forma de recibir los pagos de tu tienda directamente en tu cuenta de Blink, sin necesidad de alojar nada.
De hecho, en diciembre de 2023 ofrecimos una recompensa por ello. Algunas personas lo intentaron, pero nadie lo terminó, así que al final fue Juan Pablo (dolcalmi), de nuestro equipo, quien lo desarrolló y lo publicó en WordPress.org.
Y es precisamente en el comercio digital donde el bitcoin cobra más sentido. Para las transacciones presenciales existen muchas soluciones, sobre todo el dinero en efectivo. Pero para el comercio digital, las opciones se reducen básicamente a las tarjetas de crédito y a PayPal, que requieren una cuenta bancaria y, de todos modos, acarrean un sinfín de problemas. El bitcoin es dinero digital. Hacer que funcione en el comercio electrónico ha sido una antigua ambición de los usuarios de bitcoin, y un complemento de pago para la plataforma de tiendas más utilizada supone un paso práctico hacia ese objetivo.
Hasta ahora, se necesitaba una clave API de tu cuenta de Blink, y las cuentas sin custodia no disponen de claves API. No se trata de un descuido. Una clave API es un elemento propio de las cuentas con custodia: permite que un programa realice operaciones con los fondos que guardamos para ti. Con una cuenta sin custodia no guardamos nada, por lo que no hay nada sobre lo que pueda actuar una clave. Si hubieras migrado tu cuenta, ya no podrías utilizar el complemento.
Ahora ya puedes hacerlo. El complemento genera facturas a través de tu dirección de Blink Lightning en lugar de una clave, muestra el código QR en tu propia tienda y confirma el pago por sí mismo. Tu cliente paga, los sats llegan a tu cuenta y nadie se interpone en el proceso.
Ambas opciones incluyen un « Lightning » en el proceso de pago. La diferencia radica en quién retiene el dinero y cómo sabe la tienda que ha recibido el pago.
Con una cuenta de custodia, el complemento genera facturas a través de la API de Blink, redirige a tu cliente a pay.blink.sv para que complete el pago y tu panel de control de Blink notifica a tu tienda mediante un webhook cuando se liquida el pago. Blink retiene los fondos en tu cuenta y tú eliges en qué monedero se ingresan: en tu saldo de bitcoins o en tu saldo en dólares.
Con una cuenta sin custodia, no hay ninguna clave API. El plugin funciona a través de tu dirección de Blink Lightning , muestra el código QR en tu propia web y confirma el pago de forma automática. Tú conservas las claves y los pagos se reciben en sats.
La gente me pregunta si pueden introducir ahí una dirección de Wallet of Satoshi o de algún otro monedero. La respuesta es no, y el motivo es técnico.
Generar una factura a partir de una dirección pública de Lightning es fácil; cualquiera puede hacerlo. El problema surge después. Cuando el cliente ha pagado una factura generada en nombre del comerciante, la tienda debe verificar que el pago se haya realizado correctamente, y para ello el servidor LNURL del monedero tiene que implementar la verificación LNURL (LUD-21). Blink lo implementa. No podemos controlar ni garantizar el funcionamiento de otros monederos, y Wallet of Satoshi no es de código abierto, por lo que ni siquiera podemos comprobarlo. Por lo tanto, el complemento solo es compatible con Blink.
Vale la pena conocer cómo funciona la comprobación. La tienda consulta a Blink en segundo plano, una y otra vez, si se ha pagado la factura, mientras esta siga siendo válida. Si no puede conectarse al servidor en ese momento, deja el pedido pendiente en lugar de cancelarlo, ya que, desde el punto de vista de la tienda, un servidor inaccesible y una factura impagada son lo mismo, y solo uno de ellos es motivo para rechazar a un cliente.
Dicho esto, si hay algún desarrollador de código abierto por ahí que quiera emprender un proyecto: un plugin de WooCommerce para Lightning que sea de uso general, que funcione con cualquier monedero que implemente la verificación LNURL y no solo con Blink, sería una auténtica contribución al ecosistema. Nuestro código es abierto. Adelante.
Con una cuenta custodial, puedes indicar dónde van los fondos recibidos —saldo en bitcoins o saldo en dólares— mediante el ID del monedero. Con una cuenta no custodial también dispones de un saldo en dólares, pero el complemento aún no puede desviar los pagos directamente hacia allí. Requiere un intercambio, y como no somos el proveedor de ese servicio, su implementación resulta más compleja. Quizás más adelante. Por ahora, «no custodial» significa que recibes sats.
Si de todos modos quieres dólares, hay una forma de hacerlo manualmente. En la aplicación, ve a tu «Saldo en dólares», genera una factura de Lightning y págalo desde tu «Saldo en bitcoins». Así se transfiere el importe. Si realizas muchas ventas, podrías automatizar ese proceso con el SDK de Breez, y si alguien lo desarrolla y lo publica como código abierto, me encantaría verlo.
Esa es la historia. A continuación te explicamos cómo funciona y, después, las preguntas que más nos hacen.
Esta ruta prescinde por completo de la clave API.
1. Instala el plugin. En el panel de administración de WordPress, ve a Plugins → Añadir nuevo, busca «Blink for WooCommerce», instálalo y actívalo.
2. Abre la configuración del plugin en WooCommerce.
3. Selecciona «sin custodia» en el menú desplegable de tipo de cuenta e introduce tu dirección de Blink Lightning (por ejemplo, you@blink.sv). No se requiere ninguna clave.
4. Guarda los cambios y, a continuación, activa la opción «Pagar con Bitcoin Lightning» en WooCommerce → Ajustes → Pagos.
Necesitarás una cuenta de Blink y unos minutos en el panel de control de Blink para crear una clave API.
1. Instala el plugin. En el panel de administración de WordPress, ve a Plugins → Añadir nuevo y busca «Blink for WooCommerce». Comprueba que sea el publicado por Blink, instálalo y actívalo.
2. Abre el panel de control de Blink. En la configuración del complemento, haz clic para acceder al panel de control de Blink e inicia sesión con tu cuenta de Blink utilizando tu correo electrónico o tu número de teléfono, además del código de autenticación de dos factores. Ten a mano el panel de control; volverás a él más adelante.
3. Crea una clave API de solo recepción. En la sección «Claves API» del panel de control, crea una nueva clave. Asígnale un nombre como «WooCommerce» y configura su ámbito de acceso para que solo permita leer y recibir, no escribir, de modo que pueda aceptar fondos pero nunca enviarlos. Copia la clave inmediatamente: Blink la muestra una sola vez y no volverás a verla, así que guárdala en un lugar seguro.
4. Pega la clave en el plugin. Vuelve a la configuración del plugin de WooCommerce y pega tu clave API.
5. Elige tu monedero. Elige el monedero de Bitcoin si quieres que los fondos que recibas varíen según el precio del Bitcoin, o el monedero de Stablesats si quieres que mantengan su valor en dólares. Guarda.
6. Activa el método de pago. Ve a WooCommerce → Ajustes → Pagos y activa «Pagar con Bitcoin Lightning ». Guarda los cambios y « Lightning » aparecerá ahora en tu página de pago.
Sea cual sea la opción elegida, el cliente selecciona Bitcoin al finalizar la compra, escanea el código QR con cualquier monedero de Lightning y el pedido se marca como pagado en cuanto se reciba el pago. Yo haría primero un pequeño pedido de prueba, solo para comprobar que los sats llegan donde esperas. Si prefieres ver cómo se hace, una tienda de Curazao ha grabado un tutorial completo: el tutorial de Bitcoin Curazao.
Tu servidor necesita WordPress 6.5 o superior, WooCommerce 9.0 o superior y PHP 8.1 o superior, con la extensión cURL de PHP activada. Para resolver problemas y consultar la guía completa paso a paso sin custodia, consulta la guía de configuración para comerciantes en el repositorio de plugins.
¿Necesito una clave API para una cuenta sin custodia? No. Las claves API son una función propia de las cuentas con custodia en Blink. Las cuentas sin custodia se conectan únicamente con tu dirección de Blink Lightning .
¿Puedo utilizar una dirección « Lightning » que no sea de Blink, como la de Wallet of Satoshi? No, el complemento solo funciona con Blink. El motivo es el requisito de verificación de LNURL mencionado anteriormente: no todas las carteras lo implementan, por lo que no se puede garantizar la confirmación del pago con otros proveedores.
¿Tengo que ejecutar un servidor o un nodo Lightning ? No. Blink se encarga de la parte de Lightning ; tú solo tienes que conectar tu cuenta o tu dirección.
¿Mis clientes necesitan Blink? No. Cualquier monedero de Lightning puede pagar la factura al finalizar la compra.
¿En qué saldo se ingresan los pagos? En una cuenta con custodia, puedes elegir entre el saldo en bitcoins o el saldo en dólares (mantenido en dólares mediante Stablesats). En una cuenta sin custodia, los pagos se ingresan en bitcoins.
¿Puedo recibir pagos en mi saldo en dólares a través de una conexión sin custodia? Todavía no. Por el momento, los pagos sin custodia se reciben en Bitcoin (consulta más arriba cómo hacerlo manualmente). Es posible que esta opción se incorpore en el futuro.
¿El complemento es de código abierto? Sí. El código está disponible en el repositorio de complementos.
Empieza aquí: blink.sv/en/woocommerce
• Página de destino de Blink para WooCommerce
• Blink para WooCommerce en WordPress.org
• Tutorial de configuración de Bitcoin Curaçao (vídeo)
• Guía de configuración para comerciantes (sin custodia)
• Vamos a lanzar cuentas sin custodia para Blink Wallet
• Documentación de la API de Blink
Empieza a recibir y enviar bitcoins ahora
