API e webhooks: ligar o Volta a outros sistemas
Crie chaves, leia os reembolsos em outro sistema e receba avisos automáticos.
Disponível no plano Empresa. Fica em Integrações (só o administrador vê).
Chave de API
- Crie uma chave, dê um nome (por exemplo, "Sistema contábil") e copie. Ela aparece uma única vez: guarde em local seguro. O Volta guarda só uma impressão digital dela.
- Use no cabeçalho `Authorization: Bearer vlt_live_…`. A chave só enxerga a sua empresa e só lê dados.
- Se vazar, revogue a chave e crie outra.
Webhooks
Cadastre o endereço do seu sistema e escolha os eventos: reembolso.criado, em_analise, aprovado, recusado, pago e cancelado. O Volta envia um aviso a cada evento, assinado, e você confere a assinatura para ter certeza de que veio do Volta. Dá para testar o envio e girar o segredo em Integrações.
A documentação completa, com exemplos, está em Guia para desenvolvedores.