Bitcoin Lightning

Acepta Bitcoin por Lightning.

Ofrece Lightning junto a Bitcoin on-chain. Conecta un nodo LND externo o una wallet NWC compatible. Wholly Crypto crea y sigue las solicitudes.

De un vistazo

Moneda nativa
BTC
Tokens aceptados
Solo moneda nativa
Moneda para comisiones
BTC (satoshis)
Referencia del pago
Factura BOLT11
Configuración de wallet
LND / NWC externo
Envío manual / barrido automático
Los envíos se hacen en tu wallet externa

Qué puedes recibir

Lightning recibe BTC, no stablecoins ni envíos on-chain. Cada solicitud tiene importe, hash y vencimiento. El cliente paga la factura Lightning completa.

Pagos Bitcoin on-chain

Configura tu tienda

En Ajustes → Conexiones de red añade LND por HTTPS o NWC por WSS y actívalo en la tienda. El endpoint debe ser accesible públicamente; una dirección solo LAN o Tor no funciona directamente.

Credenciales y custodia

Usa credenciales limitadas a recepción, nunca un macaroon LND de administrador o gasto. NWC define la conexión, no la custodia. Comprueba quién guarda las claves.

Configura Lightning

Dónde llegan tus pagos

El QR contiene una factura BOLT11, no una dirección Bitcoin. Nunca la pagues on-chain. Si caduca, crea otra factura; no basta con alargar el plazo.

¿Cuándo se completa el pago?

Wholly Crypto verifica la liquidación indicada por la wallet. Una factura abierta o HTLC retenido no es pago. Lightning no tiene confirmaciones de bloque ni enlace público de transacción.

Mueve los fondos cuando quieras

Usa la wallet o nodo externo para enviar, gestionar liquidez y copias. Los barridos on-chain no mueven Lightning. Exportar la wallet del proyecto no respalda la externa.

Guía de wallet Lightning

Problemas con pagos

Si falla la ruta, revisa liquidez entrante, wallet y vencimiento. Una API saludable no garantiza rutas. Si el pago es incierto, verifica la liquidación antes de pedir reintentar.

Comisiones y verificación

La comisión predeterminada es el 1 % del valor fiat de la factura, pagada con créditos aparte. Se aplica tu tarifa asignada. Las comisiones de red y el servidor van aparte.

Los proveedores públicos pueden fallar o limitar peticiones. Una transacción enviada o una redirección no prueban el pago. Usa el estado verificado y las notificaciones firmadas.

Créditos de procesamiento API, IPN y webhooks
Calculadora de cambio

Convertir un importe

De
A
Valor estimado…

Cargando tipos de cambio…

    Es una estimación, no una cotización de pago. No incluye comisiones de red, del exchange ni márgenes del comercio.

    ¿De dónde vienen los tipos de cambio?

    Las estimaciones cripto usan precios públicos de Kraken en caché y Binance cuando está disponible. Algunos precios de Binance usan USDT como referencia de USD. Los tipos fiat vienen de Frankfurter y son referencias diarias, no cotizaciones de negociación en tiempo real.

    Los datos se actualizan automáticamente. Comprueba las fechas de las fuentes debajo del resultado. El importe que introduces permanece en tu navegador. Que un activo aparezca no garantiza que admita pagos.

    Kraken · Binance · Frankfurter · Nombres e iconos de activos: CoinGecko

    Elegir una moneda

    Crea una factura con la API

    Ejecuta los ejemplos en tu servidor. Sustituye el host API y los IDs de proyecto y tienda. Mantén la clave privada. Los importes son cadenas decimales.

    Activa primero el método en la tienda. La selección limita los métodos activos, no añade activos. Si no coincide ninguno, se usan los predeterminados. Revisa la respuesta antes de abrir el checkout.

    : "${WHOLLY_TOKEN:?Set WHOLLY_TOKEN to your server-side API token}"
    # Keep this key and the exact body for retries; use a new key for each new invoice.
    curl --fail-with-body --max-time 30 \
      --request POST \
      --url "https://api.example.com/v1/projects/YOUR_PROJECT_ID/stores/YOUR_STORE_ID/invoices" \
      --header "Authorization: Bearer $WHOLLY_TOKEN" \
      --header 'Idempotency-Key: order-1042-attempt-1' \
      --header 'Content-Type: application/json' \
      --data-raw '{
      "amount": "25.00",
      "currency": "EUR",
      "order_id": "order-1042",
      "payment_methods": [
        {
          "chain_slug": "bitcoin",
          "payment_rail": "lightning"
        }
      ]
    }'
    Referencia completa de la API de facturas IDs de proyecto y tienda API, IPN y webhooks