Recaudo Docs
Criar conta

Configuración

Chaves de API

Gere as chaves que seus próprios sistemas usam para se conectar à API do Recaudo.

Antes de começar

As chaves ficam em Configurações › Avançado › Chaves de API. Você precisa de alguém que programe a integração; se só quer receber avisos do que acontece na sua conta, veja também os webhooks.

Tipos de chave

Sempre que você gera chaves recebe um par, e existe um par para cada ambiente:

  • Chave secreta (sk_live_… ou sk_test_…): autentica suas chamadas à API. Use só no seu servidor.
  • Chave pública (pk_live_… ou pk_test_…): identifica sua conta no navegador ou no app.
  • Produção (live) movimenta dinheiro e dados reais; teste (test, sandbox) serve para desenvolver sem cobranças reais.

Gerar suas chaves

Gere primeiro as de teste e, quando sua integração funcionar, as de produção.

  1. Abra Chaves de API

    Acesse Configurações, abra Avançado e escolha Chaves de API.

  2. Escolha o ambiente

    Localize a seção Chaves de API de teste (sandbox) ou Chaves de API de produção e clique em Gerar chaves.

  3. Copie as chaves

    Em Chaves de API geradas copie a chave pública e a secreta e guarde em um lugar seguro (por exemplo, nas variáveis de ambiente do seu servidor).

  4. Anote o ID da conta

    A mesma página mostra Seu ID de conta, caso sua integração precise.

Usar a chave nas suas chamadas

Envie a chave secreta no cabeçalho Authorization de cada requisição:

Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints, erros e paginação estão na referência de autenticação da API.

Trocar ou revogar uma chave

Não existe um botão para rotacionar: para trocar uma chave, gere uma nova e revogue a anterior.

  1. Gere um novo par

    No mesmo ambiente clique em Gerar chaves e copie as novas.

  2. Atualize seu sistema

    Substitua a chave no seu servidor e confirme que as chamadas continuam funcionando.

  3. Revogue a anterior

    Na lista, clique em Revogar ao lado da chave antiga. As chamadas que a usam param de funcionar na hora.

Dica

Nunca coloque a chave secreta no código de uma página web, de um app ou de um repositório. Se achar que alguém a viu, revogue imediatamente.

Próximo passo

Referência de autenticação Como autenticar suas chamadas à API. Webhooks Receba avisos no seu sistema quando algo acontecer. Configurações Os demais ajustes da sua conta.
Esta página ajudou? Obrigado por avisar.
Esc