Skip to content

API e webhooks ​

Para quem vai integrar a FastGivr a outro sistema (ERP, loja virtual, sistema próprio). A referência técnica completa está em Integrações.

Usuários de API ​

Onde: Configurações → Tokens de API.

Cartão Tokens de API em Configurações

Account Token ​

Sua chave de API (Account Token) identifica a conta. Use Mostrar/ocultar e Copiar. Ela vai junto com o e-mail de um usuário de API para autenticar.

Account Token da conta

Usuários de API ​

Cada sistema que integra tem uma identidade própria. Na lista: Copiar e-mail, Baixar credenciais, Editar e Remover (o acesso é revogado na hora).

Lista de usuários de API

Para criar, clique em Novo usuário de API e informe Nome completo, E-mail (API Identifier), CPF/CNPJ e, se quiser, telefone.

Formulário de novo usuário de API

Para autenticar, o sistema faz um POST em /access/account/get-token enviando email (o e-mail do usuário de API) e token (o Account Token). Detalhes em Autenticação.

WARNING

Trate o Account Token e as credenciais como senha: não publique em código aberto nem envie por chat.

Webhooks ​

Onde: Configurações → Webhooks.

Cartão Webhooks em Configurações

Notificações webhook é o histórico dos avisos que a FastGivr enviou ao seu sistema (por exemplo, quando uma cobrança é paga): evento, status (Enviado, Falhou ou Pendente), URL de destino, data/hora e tentativas. Pesquise por URL, evento ou cobrança e filtre por status.

Lista de notificações webhook

Clique em um aviso para ver o payload enviado (JSON) — com botão Copiar — e a resposta do servidor.

Detalhes de uma notificação webhook

A URL que recebe os avisos é informada ao criar a cobrança — veja Webhooks.

Vídeo: usuários de API ​

Vídeo: webhooks ​

Imagens e vídeos feitos com dados fictícios.