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

# Introdução

> Base URL, autenticação, formato de resposta, códigos de status e limites da API.

## Base URL

Todas as requisições usam essa URL base.

```text theme={null}
https://checkout.uspix.vc/api
```

## Autenticação

Você deve usar uma Chave API para se autenticar na API, caso já tenha uma conta criada basta acessar "API" na [Dashboard](https://checkout.uspix.vc/dashboard).

Todas as requisições devem ser autenticadas usando o header `Authorization`

```yaml theme={null}
Authorization: Bearer CHAVE_API
```

## Recebimento

**Importante**: você só conseguirá criar pagamentos caso já tenha configurado a forma de recebimento (Chave Pix) nas configurações de Recebimento na [Dashboard](https://checkout.uspix.vc/dashboard).

## Pronto pra começar?

Crie seu primeiro pagamento usando sua linguagem preferida.

<CodeGroup>
  ```python Python theme={null}
  import requests

  url = "https://checkout.uspix.vc/api/orders"

  payload = {
      "amount": 45, # BRL
      "network": "POLYGON"
  }
  headers = {
      "authorization": "Bearer SUA_CHAVE_API",
      "content-type": "application/json"
  }

  response = requests.post(url, json=payload, headers=headers)

  print(response.json())
  ```

  ```text Javascript theme={null}
  ```

  ```text Python theme={null}
  ```
</CodeGroup>

Exemplo de resposta:

```json theme={null}
{
  "id": "019f9eee-8dd4-71f0-9a02-9045090c8106",
  "status": "OPEN",
  "network": "POLYGON",
  "amount": "45.00",
  "currency": "BRL",
  "usdt_amount": "9.29",
  "address": "0x03baf1c24f3167C378903CFb9A5c949A46Ad6547",
  "checkout_url": "https://checkout.uspix.vc/checkout/019f9eee-8dd4-71f0-9a02-9045090c8106",
  "status_url": "https://checkout.uspix.vc/api/orders/019f9eee-8dd4-71f0-9a02-9045090c8106/status",
  "created_at": "2026-07-26T14:57:41+00:00",
  "expires_at": "2026-07-26T15:12:43+00:00",
}
```