Autenticação
Todas as requisições autenticadas usam um API Token no cabeçalho Authorization:
Authorization: Bearer PP_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
- O token tem o prefixo
PP_. - É exibido uma única vez na criação — guarde com segurança. No servidor é armazenado apenas como hash.
- Cada token carrega escopos (permissões).
Escopos
| Escopo | Libera |
|---|---|
DEPOSIT |
Criar cobranças Pix (POST /v1/pix) |
WITHDRAW |
Criar saques (POST /v1/withdraw) |
MERCHANT |
Endpoints de merchant (/v1/merchants/*) |
Erros de autenticação
| Código | Significado |
|---|---|
401 |
Token ausente ou inválido |
403 |
Token sem o escopo exigido, ou merchant de outro dono |
Exemplo
curl https://api.betpaympix.com/v1/user/balance \
-H "Authorization: Bearer PP_seu_token"