Lightning Address

Cada usuario puede activar una Lightning Address con la forma [email protected]. Cualquier wallet Lightning del mundo (Phoenix, Wallet of Satoshi, Blink, Alby, Zeus, Breez…) puede pagarle a esa dirección y el pago se acredita al momento en el saldo de QvaPay en USD, al precio de BTC del momento y sin comisión.

La dirección implementa LUD-16 sobre LUD-06 (payRequest) y admite comentarios (LUD-12) de hasta 255 caracteres.

• Quién puede activarla: cuentas personales con la verificación de identidad (KYC) aprobada. Las cuentas de empresa todavía no.
• US persons: por ahora no está disponible. Cada depósito de una US person requiere una atestación OFAC y un pago a una dirección fija no tiene ese momento.
• El nombre es fijo: por defecto es tu nombre de usuario en minúsculas y no cambia aunque cambies tu nombre de usuario. Si cambias el nombre de la dirección, la anterior deja de funcionar y queda reservada: nadie más puede usarla.
• Límites (se ajustan sin aviso): un mínimo y un máximo por pago y un máximo por usuario en 24 horas. Los valores vigentes salen en limits de GET /user/lightning-address, y los montos que acepta la dirección en minSendable / maxSendable de la consulta LNURL.

GET /user/lightning-addressCopy Anchor Link

Estado de la Lightning Address del usuario y sus últimos cobros.

AutenticaciónCopy Anchor Link

Bearer Token (Authorization: Bearer {token}).

RequestCopy Anchor Link

curl https://api.qvapay.com/user/lightning-address \
  -H "Authorization: Bearer {token}"

ResponseCopy Anchor Link

{
  "data": {
    "visible": true,
    "available": true,
    "receiving": true,
    "reason_code": null,
    "message": null,
    "address": {
      "uuid": "0b9f3c1e-6a2d-4c5b-9e7f-2a1b3c4d5e6f",
      "name": "erich",
      "address": "[email protected]",
      "lnurl": "LNURL1DP68GURN8GHJ7AMHWUH8ZANPWPSHJTNRDAKJ7TNHV4KXCTTTDEHHWM30D3H82UNVWQHK2UNFVD5QNY3K9Z",
      "qr": "lightning:LNURL1DP68GURN8GHJ7AMHWUH8ZANPWPSHJTNRDAKJ7TNHV4KXCTTTDEHHWM30D3H82UNVWQHK2UNFVD5QNY3K9Z",
      "status": "active",
      "created_at": "2026-10-30T12:00:00.000Z"
    },
    "suggested_name": null,
    "renames_left": 2,
    "limits": { "min_usd": 0.1, "max_usd": 500, "daily_usd": 1000, "used_24h_usd": 14.61, "remaining_usd": 985.39 },
    "payments": [
      {
        "uuid": "6c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
        "address": "[email protected]",
        "sats": 21000,
        "credit_usd": "14.61",
        "comment": "Gracias por el café",
        "paid_at": "2026-10-30T12:05:00.000Z",
        "transaction_uuid": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d"
      }
    ]
  }
}

Campos de respuestaCopy Anchor Link

POST /user/lightning-addressCopy Anchor Link

Activa, renombra, pausa o reanuda la dirección. Responde el mismo objeto que GET.

AutenticaciónCopy Anchor Link

Bearer Token (Authorization: Bearer {token}). Requiere la verificación de identidad (KYC) aprobada.

RequestCopy Anchor Link

curl -X POST https://api.qvapay.com/user/lightning-address \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "action": "activate", "name": "erich" }'

ErroresCopy Anchor Link

Endpoints LNURL públicosCopy Anchor Link

Los usa la wallet de quien paga; no llevan autenticación y responden con Access-Control-Allow-Origin: *.

GET https://qvpay.me/.well-known/lnurlp/{name}Copy Anchor Link

Respuesta payRequest de LUD-06. Los montos van en millisatoshis y siempre son sats enteros (múltiplos de 1000).

{
  "tag": "payRequest",
  "callback": "https://www.qvapay.com/.well-known/lnurlp/erich/callback",
  "minSendable": 143000,
  "maxSendable": 714285000,
  "metadata": "[[\"text/plain\",\"Pago a erich en QvaPay\"],[\"text/identifier\",\"[email protected]\"]]",
  "commentAllowed": 255
}

[email protected] funciona igual que [email protected] (el tag se ignora).

GET {callback}?amount={msat}&comment={texto}Copy Anchor Link

Devuelve la factura Lightning por exactamente amount msat, con description_hash = sha256 de metadata. La factura vence a los pocos minutos y el precio queda fijado durante ese tiempo.

{
  "pr": "lnbc210u1p...",
  "routes": [],
  "successAction": { "tag": "message", "message": "Pago enviado a [email protected]. ¡Gracias!" }
}

Errores LNURLCopy Anchor Link

Siguen LUD-06: { "status": "ERROR", "reason": "…" }.

Notificación al recibirCopy Anchor Link

Cuando un pago se acredita, el usuario recibe un email, un mensaje de Telegram (si lo tiene vinculado) y un push con data.type = "ln_address_received" y data.transaction_uuid. En el historial el cobro es una transacción con la descripción Lightning Address {name}@qvpay.me: {sats} sats.

Para enviarle dinero a otro usuario de QvaPay usa una transferencia: los retiros BTCLN a una Lightning Address de QvaPay se rechazan.