Cómo conectar tu wallet Bitcoin Lightning con tiankii
Cómo conectar tu wallet Bitcoin Lightning con tiankii
Conectar una wallet es lo primero que hacés en el Merchant Dashboard de tiankii, y es el paso que habilita todo lo demás: los puntos de venta, los enlaces de pago y los conectores de comercio electrónico mandan los pagos en bitcoin a la wallet que conectás acá.
Los pagos en bitcoin de tus clientes van directo a tu wallet; tiankii nunca los tiene. No te creamos una wallet, no tomamos custodia de tus bitcoin y no existe un saldo de tiankii de los pagos de tus clientes del cual retirar. Conectás la wallet que ya usás, y cada pago en bitcoin de tus clientes llega directo a esa wallet; los pagos Lightning suelen llegar en segundos. Mantenés el control de tus bitcoin todo el tiempo.
Esta guía es el punto de partida. Cuando sepas qué wallet vas a usar, seguí el artículo paso a paso de esa wallet en particular — cada uno tiene sus propias capturas.
Qué wallets podés conectar hoy
Connect Wallet abre una lista fija. El título de la pantalla es Conecta tu billetera. La tarjeta que se puede usar tiene un botón Connect. Bitcoin Onchain y Lightning dicen Pronto y no se pueden conectar. Estas son las tarjetas que cubre esta guía:
| Wallet | Ideal para | Qué vas a necesitar |
|---|---|---|
| Strike | Comercios en los países donde opera Strike que ya lo usan | Tu usuario de Strike. El formulario solo pide eso |
| Blink | Comercios que ya usan Blink en el mostrador | Tu usuario de Blink. El campo del formulario se llama Beach wallet username |
| LNbits | Comercios con su propia instancia de LNbits o una alojada | La URL de tu instancia y la invoice key de la wallet |
| Lightning Address | Está en el catálogo y, en producción, la tarjeta no abre formulario. La pantalla dice: Este método de pago aún no está disponible en esta pantalla. Contacta a soporte si necesitas habilitarlo. | Sin formulario en esta pantalla, en producción |
| Chivo | Comercios en El Salvador. La pantalla muestra dos tarjetas, las dos con Connect: Chivo BTC cobra bitcoin a tu cuenta Chivo, y Chivo USD cobra dólares, no bitcoin | El usuario y la contraseña de un usuario de punto de venta de Chivo, que creás en el portal de comercios de Chivo. No uses el acceso de tu app Chivo |
| *Spark | Comercios que ya usan una wallet Spark | Tu Spark Address o tu llave pública de Spark |
La misma pantalla también lista N1co y Stripe bajo Credit Card. Los pagos con tarjeta no son bitcoin y no van a la wallet Lightning que conectás acá; esta guía no los cubre. El efectivo no está en la lista.
Elegí una tarjeta que abra formulario. Bitcoin Onchain y Lightning dicen Pronto. Lightning Address está en la lista y, en producción, se queda en el mensaje de arriba.
Antes de empezar
- Una cuenta de tiankii. Si todavía no tenés, creala con tu correo, tu número de teléfono, o una cuenta de Google, X o Microsoft.
- La wallet que vas a usar, instalada y funcionando, con la credencial de la tabla de arriba a mano.
- El trabajo es conectar un método de la lista en pantalla.
Conectá tu wallet, paso a paso
- Entrá al Merchant Dashboard en https://pay.tiankii.com/ e iniciá sesión.
- Usá el botón de la barra Connect Wallet. El panel es Connected Wallets, y Connect New Wallet abre el catálogo. El título de la pantalla es Conecta tu billetera. El mismo catálogo es la pestaña Connect Your Wallet dentro de Store Settings. Quick Links → Connect My Wallet abre Store Settings en General Settings; desde ahí se elige la pestaña Connect Your Wallet. El menú lateral no tiene un ítem de wallet.
- La lista tiene tres filtros: All, Bitcoin y Credit Card.
- Buscá tu wallet en la lista y hacé clic en Connect en su tarjeta.
- Completá lo que pide la pantalla siguiente. Depende de la wallet: un usuario, una dirección, una key o la URL de una instancia. Chivo pide además una contraseña; mirá la tabla de arriba. Lightning Address no abre ese formulario en producción.
- El Dashboard verifica la wallet en cuanto mandás la credencial.
- Cuando la verificación pasa, la wallet aparece como conectada, con su alias visible. Ese alias es el que vas a ver en tus puntos de venta y en Transacciones.
Listo. Tu cuenta ya puede generar cobros, y cada pago en bitcoin liquida directo a la wallet que acabás de conectar.
Comprobá que de verdad funciona, antes del primer cliente
Una wallet conectada no es lo mismo que una wallet que ya recibió dinero. No te enterés en el mostrador con un cliente esperando. Hacé un cobro de prueba:
- Abrí el punto de venta que la tienda ya tiene. Una tienda nueva incluye POS Sales 1 en Main Branch.
- Cobrate a vos mismo un monto muy chico — 100 sats son unos pocos centavos.
- Pagá el QR desde tu propio teléfono.
- Confirmá que los sats llegaron a tu app de wallet, no solo a la pantalla de tiankii.
Un cobro de prueba es dinero real que se mueve de tu wallet a tu wallet, y tiankii lo registra como cualquier otro pago.
Qué hacer si la conexión falla
| Qué ves | Qué suele significar | Qué hacer |
|---|---|---|
| El Dashboard rechaza la credencial | La key se copió con un espacio, un salto de línea o le falta un carácter | Copiala de nuevo desde la wallet, pegala primero en un campo de texto plano para confirmar que está limpia, y después pegala en tiankii |
| La key es válida pero la verificación falla | La key no tiene permiso para crear invoices | Generá en tu wallet una key que pueda crear cobros y nada más. En LNbits es la Invoice/read key, nunca la Admin key |
| Todo conecta pero no llega nada | Estás mirando la wallet equivocada, o la cuenta equivocada dentro de ella | Confirmá que el alias que muestra tiankii es la misma cuenta que estás revisando en tu app |
Cambiar o quitar una wallet después
No quedás amarrado. Abrí Connect Wallet, desconectá la wallet actual y conectá otra. Tus puntos de venta, enlaces de pago, sucursales y usuarios quedan exactamente igual — lo único que cambia es el destino de los pagos nuevos.
Los pagos en bitcoin que ya liquidaron están en tu wallet anterior y ahí se quedan; desconectarla no los mueve. Asegurate de conservar el acceso a esa wallet antes de desconectarla.
Preguntas frecuentes
¿tiankii tiene los pagos en bitcoin de mis clientes?
No. Los pagos en bitcoin van de tu cliente a tu wallet. tiankii no tiene ningún saldo de esos pagos y no hay nada que retirar. El saldo de créditos prepago con el que pagás tu plan es otra cosa y no se mezcla con tus pagos.
No. Los pagos en bitcoin van de tu cliente a tu wallet. tiankii no tiene ningún saldo de esos pagos y no hay nada que retirar. El saldo de créditos prepago con el que pagás tu plan es otra cosa y no se mezcla con tus pagos.
¿Puedo conectar más de una wallet?
Cada tienda cobra a una wallet conectada a la vez. Si tenés varias sucursales o varias tiendas, cada una puede apuntar a una wallet distinta.
Cada tienda cobra a una wallet conectada a la vez. Si tenés varias sucursales o varias tiendas, cada una puede apuntar a una wallet distinta.
¿Qué pasa si mi wallet se cae en horario de atención?
Si tiankii no puede alcanzar tu wallet, el cobro no se crea y no se mueve ningún pago. Los pagos en bitcoin ya generados y pagados igual llegan a tu wallet. Una caída de tiankii no afecta los bitcoin que ya están en tu wallet, porque tiankii no los tiene.
Si tiankii no puede alcanzar tu wallet, el cobro no se crea y no se mueve ningún pago. Los pagos en bitcoin ya generados y pagados igual llegan a tu wallet. Una caída de tiankii no afecta los bitcoin que ya están en tu wallet, porque tiankii no los tiene.
¿Mis clientes necesitan una cuenta de tiankii?
No. Pagan desde su propia wallet o app. Sin cuenta de tiankii y sin instalar nada de tiankii.
No. Pagan desde su propia wallet o app. Sin cuenta de tiankii y sin instalar nada de tiankii.
Siguientes pasos
- Hacé tu primer cobro y confirmá que el pago en bitcoin llega a tu wallet.
- Aprendé cuándo usar un QR y cuándo usar el pago contactless en el mostrador.
- Abrí Transactions para saber qué entró y desde qué punto de venta.