Pular para o conteúdo principal
Envie sua chave sk_live_... no header Authorization de cada requisição:
Header
Gere a chave em Chave de API, no painel, com a empresa correta selecionada. Cada chave está vinculada a uma empresa; a API usa esse vínculo para limitar o acesso aos dados.

Onde guardar

Use variáveis de ambiente do servidor ou o gerenciador de segredos da sua infraestrutura. No Next.js, a variável não deve ter o prefixo NEXT_PUBLIC_.
Servidor TypeScript
O navegador recebe somente os dados públicos necessários à interface, como a URL do checkout. Não recebe a chave.

Escolha os escopos

Conceda à chave as operações que sua integração precisa executar. Uma chave de leitura não pode criar links. O escopo read cobre os escopos de leitura. Ele não concede escrita nem estorno. Uma chave criada sem transactions:refund não estorna; para estornar pela API, crie uma chave com esse escopo e revogue a anterior. Para o primeiro link deste guia, habilite links:write; adicione links:read para consultar o link depois e customers:write quando enviar dados do comprador (customer) na criação ou edição do link. Um escopo não substitui outras verificações de acesso da operação. Se uma chamada retornar 403, confira também o contexto da empresa e as permissões necessárias.

Diagnostique uma falha

Rotacione uma chave

Crie uma nova chave, atualize o segredo no servidor e verifique uma consulta de leitura. Depois, revogue a anterior. Se houver exposição da chave, revogue-a e revise seu uso. A chave de API e o segredo do webhook têm funções diferentes. O segundo verifica eventos recebidos e não autentica chamadas à API.