Autenticação
Toda chamada autenticada leva a chave da plataforma no header Authorization.
Header
Authorization: Bearer psp_test_...Chaves e ambientes
| Prefixo | Ambiente | Quando sai |
|---|---|---|
psp_test_ | Sandbox, provedor simulado | No cadastro, na mesma hora |
psp_live_ | Produção | Depois da aprovação do credenciamento |
Dados de sandbox e de produção ficam em contas separadas: uma cobrança criada com a chave de teste nunca aparece com a chave de produção.
Guarde a chave com cuidado
- O segredo é mostrado uma única vez, na emissão. Guardamos só um hash.
- Use a chave apenas no servidor da sua plataforma, nunca no navegador ou no app.
- Para trocar uma chave, peça uma nova e a revogue a antiga.
Status do credenciamento
Com qualquer chave válida você consulta a situação da plataforma e o ambiente da chave:
GET /v1/plataforma
{
"id": "plat_...",
"nome": "Cursos do Zé",
"status": "em_analise",
"ambiente": "teste"
}| Status | Significado |
|---|---|
em_analise | Cadastro recebido. Só o sandbox funciona. |
aprovada | Liberada para produção. |
reprovada | Análise negada. Todas as chaves ficam bloqueadas. |
suspensa | Bloqueio temporário. Todas as chaves, inclusive de teste, retornam 403 até a reativação. |