Desenvolvedores
Uma API que você consegue prever
Pix, boleto, cartão e recorrência atrás de uma REST com erro tipado e webhook assinado. Sem SDK obrigatório, teste e produção na mesma URL.
Feita para integrar sem surpresa
REST com 3 verbos
GET lê, POST cria e atualiza, DELETE tira de uso. Recurso no plural, ID no path, listas por cursor, sem RPC escondido.
Erro que diz o que fazer
type, code e message em todo erro, com doc_url e link do log. Você ramifica no code, não num status solto.
Webhook assinado por evento
Uma mudança de estado, um evento assinado em HMAC no padrão Standard Webhooks. Verifica com a lib que você já usa.
Erros que dizem o que fazer
Todo erro vem tipado: type pra categoria, code pro caso, message pro humano, mais doc_url e link do log. Você trata no code, não em texto solto.
Cinco tipos, sempre os mesmos: seu retry sabe quando insistir e quando parar.
Feita para você codar com IA
Documentação agêntica
llms.txt, llms-full.txt e a versão .md de cada página. Abre no ChatGPT ou no Claude direto da doc.
Skills para codar com IA
Skills que o agente carrega e executa na sua conta: criar cobrança, assinatura Pix, repasse. Em breve.
MCP
Um servidor MCP para o agente operar a sua conta com as ferramentas certas. Em breve.
Teste e produção na mesma URL
A chave decide o ambiente: ch_test_ roda no sandbox, ch_live_ vai ao vivo. Mesma URL, mesmos objetos, mesmos webhooks.
Simule o que quiser: o cartão 4242 aprova, outro recusa, e os test-helpers liquidam Pix e boleto na hora.
Pegue a chave e mande o primeiro POST
Perguntas frequentes
Preciso de SDK para integrar?
Não. A API é REST pura: você chama com curl, fetch ou a lib HTTP da sua linguagem. Para cartão, o Chargefy.js tokeniza no browser, então o número não passa pelo seu servidor. SDKs oficiais estão a caminho.
Como funciona teste e produção?
Na mesma URL. A chave decide o ambiente: ch_test_ roda no sandbox, isolado e sem mover dinheiro; ch_live_ vai ao vivo. O campo livemode acompanha cada objeto.
Como eu verifico um webhook?
Cada evento é assinado em HMAC-SHA-256, no padrão Standard Webhooks, com os headers webhook-id, webhook-timestamp e webhook-signature. Dá para verificar com as libs oficiais de Webhooks. A entrega é ao menos uma vez, então use o id do evento para deduplicar.
Os erros são previsíveis?
São. Todo erro traz type, code e message, mais doc_url e o link do log. São cinco tipos fixos, então o seu retry sabe quando insistir e quando parar.
Dá para simular falhas antes de ir ao vivo?
Sim. No sandbox você usa cartões mágicos (o 4242 aprova) ou cenários por metadata, e os test-helpers liquidam Pix e boleto na hora para testar o fluxo assíncrono.
A Chargefy é feita para IA?
Sim. A documentação é agêntica: llms.txt, llms-full.txt, a versão .md de cada página e o botão de abrir no ChatGPT ou no Claude. Erros tipados e contrato limpo deixam um agente integrar quase sozinho. SDKs, skills e um servidor MCP estão a caminho.
Como funciona a autenticação?
Por API key no header Authorization: Bearer. A chave de organização age na própria conta; a chave de plataforma age em contas conectadas usando o header Organization.