> ## Documentation Index
> Fetch the complete documentation index at: https://cryptouse-d1f5ba06.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Ordem Lightning

> Crie uma nova ordem de pagamento Lightning Network

## 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

<ParamField body="value" type="number" required>
  O valor do pagamento em BRL (será convertido para satoshis)
</ParamField>

<ParamField body="email" type="string">
  Email do cliente (opcional)
</ParamField>

<ParamField body="name" type="string">
  Nome do cliente (opcional)
</ParamField>

### Exemplo de requisição

```bash theme={null}
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

<ResponseField name="message" type="string">
  Mensagem de sucesso
</ResponseField>

<ResponseField name="order" type="object">
  <Expandable title="Propriedades">
    <ResponseField name="id" type="string">
      ID da ordem
    </ResponseField>

    <ResponseField name="paymentLinkId" type="string">
      Identificador único do link de pagamento
    </ResponseField>

    <ResponseField name="value" type="number">
      Valor do pagamento em BRL
    </ResponseField>

    <ResponseField name="status" type="string">
      Status da ordem

      Valores possíveis: `PENDING`, `COMPLETED`, `CANCELLED`, `FAILED`, `REFUND`
    </ResponseField>

    <ResponseField name="invoice" type="string">
      String da fatura Lightning Network
    </ResponseField>

    <ResponseField name="link" type="string">
      URL de pagamento para o usuário
    </ResponseField>

    <ResponseField name="createdAt" type="string" format="date-time">
      Timestamp de criação da ordem
    </ResponseField>
  </Expandable>
</ResponseField>

### Exemplo de resposta

<CodeGroup>
  ```json Sucesso (201) theme={null}
  {
    "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"
    }
  }
  ```

  ```json Requisição inválida (400) theme={null}
  {
    "success": false,
    "error": "OpenNode API error: 400 Bad Request"
  }
  ```
</CodeGroup>

## 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.