Uma API que você consegue prever

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.

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.

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.

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.

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.

Sim. A documentação é agêntica, e o MCP conecta ChatGPT, Claude e Codex à Chargefy. O agente pode consultar dados, buscar a documentação e executar alterações de baixo risco conforme a permissão concedida.

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.