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

# Erros

> O formato do erro, o que cada status significa e os problemas mais comuns

Os erros vêm neste formato:

```json Erro theme={null}
{
  "status": "Bad Request",
  "message": "Mensagem legível do erro",
  "assinyCode": "CODIGO_DO_ERRO",
  "causes": "Detalhe técnico"
}
```

| Status | Quando acontece | O que fazer |
| - | - | - |
| `400` | Corpo inválido, campo obrigatório faltando ou projeto não informado | Confira o corpo e o `ProjectId` |
| `401` | Chave ausente, errada ou revogada | Confira o cabeçalho `Authorization: Bearer ...`; se continuar, peça uma chave nova |
| `403` | O projeto não foi liberado para a chave | Peça ao suporte para liberar o projeto na chave |
| `404` | O ID não existe | Confira o ID no caminho |
| `409` | Conflito com um registro que já existe | Leia a `message` |
| `422` | Regra de negócio, ex.: `COUPON_BELOW_MIN_PRICE` | Leia a `message` e ajuste |
| `5xx` | Falha temporária | Tente de novo depois de alguns segundos, sem repetir em loop |

## Problemas comuns

> [accordion] Toda chamada responde 401
>
> Confira se o cabeçalho é exatamente `Authorization: Bearer SUA_CHAVE`, com a palavra `Bearer` e um espaço antes da chave, e se a chave foi colada inteira.
>
> Se estiver certo, ela pode ter sido revogada: peça uma nova ao suporte.

> [accordion] A chamada responde 403
>
> O projeto informado não foi liberado para a sua chave. Confira se o ID do projeto está certo e, se precisar de outro projeto, peça ao suporte para incluí-lo na chave.

> [accordion] A chamada responde 400 e o corpo está certo
>
> Provavelmente faltou o cabeçalho `ProjectId`. Ele é obrigatório em quase todas as rotas — veja [Autenticação](https://docs.assiny.com/api/autenticacao.md).

> [accordion] Criei a oferta e o preço ficou errado
>
> Os valores vão em centavos: para R\$ 49,90 mande `4990`, não `49.90`.

> [accordion] Quero reembolsar uma venda que não tem pedido de reembolso
>
> A API só responde a pedidos que o comprador já abriu. Para reembolsar outras vendas, use o painel da Assiny.

> [accordion] Perdi a chave ou ela vazou
>
> A Assiny não consegue mostrar a mesma chave de novo e não se responsabiliza pelo uso de uma chave vazada. Peça ao suporte, na mesma hora, para revogar a antiga e gerar outra.


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