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

> Crie uma nova ordem de pagamento Binance

## Criar ordem de pagamento Binance

Este endpoint gera um novo QR code de pagamento Binance para o valor especificado.

### Requisição

<ParamField body="value" type="number" required>
  O valor do pagamento em BRL
</ParamField>

<ParamField body="payerId" type="string">
  ID de referência do pagador (opcional)
</ParamField>

<ParamField body="merchant" type="object">
  <Expandable title="Propriedades">
    <ParamField body="subMerchantId" type="string">
      Identificador do comerciante para o pagamento
    </ParamField>
  </Expandable>
</ParamField>

### Exemplo de requisição

```bash theme={null}
curl -X POST "https://server.cryptouse.com.br/api/v1/order/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer seu_token_aqui" \
  -d '{
    "value": 150.00,
    "payerId": "user_123",
    "merchant": {
      "subMerchantId": "merch_456"
    }
  }'
```

### 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="qrCodeLink" type="string">
      URL para a imagem do QR code
    </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": "Ordem criada com sucesso",
    "order": {
      "id": "ord_67890fghij",
      "paymentLinkId": "pmt_12345abcde",
      "value": 150.00,
      "status": "PENDING",
      "qrCodeLink": "https://server.cryptouse.com.br/qrcode/pmt_12345abcde.png",
      "link": "https://pay.cryptouse.com/binance/pmt_12345abcde",
      "createdAt": "2023-04-20T15:00:00Z"
    }
  }
  ```

  ```json Requisição inválida (400) theme={null}
  {
    "success": false,
    "error": "Valor de pagamento inválido"
  }
  ```

  ```json Não autorizado (401) theme={null}
  {
    "success": false,
    "error": "Chave de API inválida ou não autorizada"
  }
  ```
</CodeGroup>

## Integração com Binance Pay

Este endpoint utiliza o serviço Binance Pay para processar pagamentos em criptomoedas. Os usuários poderão pagar usando:

1. O aplicativo Binance escaneando o QR code
2. Qualquer carteira compatível com o link de pagamento
3. Acessando diretamente o link de pagamento

## Notificações

Você receberá uma notificação quando o status da ordem for alterado. Os possíveis status incluem:

| Status      | Descrição                              |
| ----------- | -------------------------------------- |
| `PENDING`   | A ordem foi criada e aguarda pagamento |
| `COMPLETED` | O pagamento foi recebido e confirmado  |
| `CANCELLED` | A ordem foi cancelada                  |
| `FAILED`    | O pagamento falhou                     |
| `REFUND`    | O pagamento foi reembolsado            |

## Tempo de expiração

As ordens Binance expiram após 30 minutos se nenhum pagamento for recebido.