Skip to main content
POST
/
api
/
v1
/
order
/
create
/
lightning
Criar Ordem Lightning
curl --request POST \
  --url https://api.example.com/api/v1/order/create/lightning \
  --header 'Content-Type: application/json' \
  --data '
{
  "value": 123,
  "email": "<string>",
  "name": "<string>"
}
'
{
  "message": "<string>",
  "order": {
    "id": "<string>",
    "paymentLinkId": "<string>",
    "value": 123,
    "status": "<string>",
    "invoice": "<string>",
    "link": "<string>",
    "createdAt": "<string>"
  }
}

​
Criar ordem de pagamento Lightning Network

Este endpoint gera uma nova fatura (invoice) Lightning Network para o valor especificado, permitindo pagamentos rápidos e com baixas taxas em Bitcoin.

​
Requisição

​
value
number
required
O valor do pagamento em BRL (será convertido para satoshis)
​
email
string
Email do cliente (opcional)
​
name
string
Nome do cliente (opcional)

​
Exemplo de requisição

curl -X POST "https://server.cryptouse.com.br/api/v1/order/create/lightning" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer seu_token_aqui" \
  -d '{
    "value": 50.00,
    "email": "cliente@exemplo.com",
    "name": "João Silva"
  }'

​
Resposta

​
message
string
Mensagem de sucesso
​
order
object

​
Exemplo de resposta

{
  "message": "Lightning invoice was successfully created",
  "order": {
    "id": "688a5e459b11ce1a1a85e32a",
    "paymentLinkId": "98e56f6d-b600-48d2-a251-8c7b206958b2",
    "value": 5000,
    "status": "PENDING",
    "invoice": "Inbc75800n1p5g5hj9pp58x8fx94hdc19zxpn3ecxc349mkje27v738a981ztczeqq2y0cmvsdquf9h8vmmfvdjjqsmj09c8gmm4wdjscqzysxqzjhsp54qv2q6",
    "link": "https://cryptouse.com.br/order/lightning/98e56f6d-b600-48d2-a251-8c7b206958b2",
    "createdAt": "2025-07-30T18:02:45.965Z"
  }
}

​
O que é Lightning Network?

Lightning Network é uma solução de “segunda camada” construída sobre o Bitcoin que permite transações quase instantâneas e com taxas extremamente baixas. É ideal para:
  • Micropagamentos
  • Transações de alto volume
  • Pagamentos em tempo real

​
Pagamento via Lightning Network

Os usuários podem pagar uma fatura Lightning das seguintes formas:
  1. Escaneando o QR code com uma carteira Lightning compatível
  2. Copiando e colando a string da fatura em sua carteira Lightning
  3. Clicando no link de pagamento em um dispositivo com uma carteira Lightning instalada

​
Tempo de expiração

As faturas Lightning Network expiram após 15 minutos se não forem pagas.

​
Conversão de valor

O valor em BRL é convertido para satoshis (a menor unidade do Bitcoin) no momento da criação da fatura, utilizando a taxa de câmbio atual. O campo satoshis na resposta indica o valor exato a ser pago.