IntroduçãoAutenticação

Autenticação

A ISolutionPay usa API Keys pra autenticar suas requisições. Toda chamada precisa da sua chave no header — sem ela você recebe 401.


Criando sua API Key

  1. Acesse isolutionpay.com/dashboard/api-keys
  2. Clique em Cadastrar API
  3. Dê um nome (ex: Produção, Meu Site)
  4. Copie a secret key gerada — ela começa com casperspay_sk_

⚠️ A secret key aparece uma única vez. Guarde em um lugar seguro, como variável de ambiente.


Usando a chave

Envie no header token em todas as requisições:

curl -X POST https://isolutionpay.com/api/pix \
  -H "Content-Type: application/json" \
  -H "token: isolutionpay_sk_SUA_CHAVE_AQUI" \
  -d '{ "valor": "99.90", "nome": "João Silva", "cpf": "12345678900" }'

Também aceita Authorization Bearer:

Authorization: Bearer isolutionpay_sk_SUA_CHAVE_AQUI

Boas práticas

  • Nunca exponha a secret key no frontend ou em repositórios públicos
  • Use variáveis de ambiente (.env) para armazenar a chave
  • Crie uma chave separada para cada ambiente (produção, testes)
  • Se suspeitar que foi comprometida, delete e crie uma nova no painel