> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bukiopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter Pedido

> Retorna os detalhes de um pedido: itens, situação, dados do cliente e valores em reais.

Retorna os dados completos de um pedido da sua loja.

**Método:** `GET /api/v1/orders/:id`

**Autenticação:** Obrigatória — inclua o header `Authorization: Bearer sk_live_sua_api_key`.

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  UUID do pedido.
</ParamField>

## Exemplo de requisição

```bash theme={null}
curl -X GET 'https://api.bukiopay.com/api/v1/orders/8159fbe2-fd7d-4b28-8028-1257210b32d0' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "order": {
    "id": "8159fbe2-fd7d-4b28-8028-1257210b32d0",
    "orderCode": "2IH180IE7K3M9P4Q6R",
    "status": "paid",
    "total": 149.9,
    "customerName": "Maria Silva",
    "customerEmail": "maria@exemplo.com",
    "payerName": "João Silva",
    "items": [
      {
        "productId": "9d40e409-28e6-481f-aafc-83f97b831f07",
        "variantId": null,
        "name": "Produto Exemplo",
        "quantity": 1,
        "price": 149.9,
        "deliveredAt": "2026-08-26T12:05:00.000Z"
      }
    ],
    "createdAt": "2026-08-26T11:58:00.000Z",
    "updatedAt": "2026-08-26T12:00:00.000Z"
  }
}
```

<Note>
  `total` e `price` são **em reais**, com decimais. `149.9` = R\$149,90.
</Note>

## Situações

| Status | Significado |
| - | - |
| `pending` | Aguardando pagamento |
| `paid` | Pagamento confirmado |
| `shipped` | Marcado como enviado |
| `cancelled` | Cancelado; o estoque volta ao catálogo |
| `refunded` | Valor devolvido ao cliente |

## Cliente e pagador

`customerName` é quem comprou, informado no checkout. `payerName` é o titular da conta que pagou o Pix. Os dois divergem quando outra pessoa paga — para identificar o comprador, use `customerName`.

## Consulta pelo checkout

Para acompanhar um pedido sem API key, use `GET /api/v1/orders/public/:id/status` com o header `X-Store-ID`. Aceita o `id` ou o `orderCode`, e devolve os links de entrega dos produtos digitais quando o pagamento está confirmado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.