# API StacePay

Crie cobranças, links de pagamento, saques e receba eventos em tempo real. A API é REST, aceita e devolve JSON, e toda chamada exige autenticação por chave.

> ✅ Base URL: `https://stacepay.com.br/api/v1`

## Primeiros passos

1. Gere uma chave em [Painel → Integrações](https://stacepay.com.br/painel/integracoes).
2. Envie `Authorization: Bearer SUA_CHAVE` em toda chamada.
3. Confirme a chave com `GET /ping`.

_curl_

```bash
curl https://stacepay.com.br/api/v1/ping \
  -H "Authorization: Bearer nvx_live_..."
```

## Convenções

- Todo valor monetário é um inteiro em **centavos** (1990 = R$ 19,90) nunca ponto ou vírgula.
- Datas saem em ISO-8601 com fuso de Brasília (`2026-08-12T14:32:10-03:00`).
- Listagens são paginadas por `limit` / `offset` e devolvem `{"object":"list","data":[...],"has_more":bool}`.
- Todo erro tem o mesmo formato veja [Erros](https://stacepay.com.br/docs/erros).

## Assuntos

- [Autenticação](https://stacepay.com.br/docs/autenticacao) Chave de API e escopos
- [Idempotência](https://stacepay.com.br/docs/idempotencia) Evitando cobrança duplicada
- [Erros](https://stacepay.com.br/docs/erros) Formato e códigos
- [Cobranças](https://stacepay.com.br/docs/cobrancas) Pix, boleto e cartão
- [Links de pagamento](https://stacepay.com.br/docs/checkouts) Checkout hospedado
- [Webhooks](https://stacepay.com.br/docs/webhooks) Eventos em tempo real