API e chaves de acesso
Como gerar chaves de API, escolher escopos e autenticar suas chamadas.
Onde ficaAppsAPI
A Pearfy tem uma API REST pra integrar sistemas próprios com sua conta. Na aba Apps, você gera uma chave com prefixo pk_live_.
Passo a passo
- Abra Apps > API
- Crie uma chave, marcando só os escopos necessários
- Copie a chave na hora: ela aparece uma única vez
- Guarde num lugar seguro
- Use no header de autenticação das chamadas
Regras da chave
- Até 20 chaves ativas por conta
- Uma chave por sistema, pra revogar sem afetar as outras
- Nunca exponha em código público ou no front-end
- Limite de 300 requisições por minuto por chave
Escopos e autenticação
Escopos disponíveis: stats, products, events, sales, sales_refund, financial, affiliates e webhooks. Autentique por Authorization: Bearer pk_live_... ou pelo header x-api-key.
AtençãoTodo valor monetário na API é em centavos. Reembolso pela API é sempre total: não há reembolso parcial por essa via.
Perguntas frequentes
Perdi a chave. Consigo ver de novo?
Não. A chave aparece só na criação. Se perdeu, revogue e gere outra.
Quantos escopos devo dar?
Só os necessários pra cada integração. Menos escopo, menos risco se a chave vazar.
A API aceita reembolso parcial?
Não. Pela API o reembolso é total. Parcial é tratado com o suporte.
Este artigo foi útil?