Autenticação

Toda chamada autenticada leva a chave da plataforma no header Authorization.

Header
Authorization: Bearer psp_test_...

Chaves e ambientes

PrefixoAmbienteQuando sai
psp_test_Sandbox, provedor simuladoNo cadastro, na mesma hora
psp_live_ProduçãoDepois 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"
}
StatusSignificado
em_analiseCadastro recebido. Só o sandbox funciona.
aprovadaLiberada para produção.
reprovadaAnálise negada. Todas as chaves ficam bloqueadas.
suspensaBloqueio temporário. Todas as chaves, inclusive de teste, retornam 403 até a reativação.