Guilder - Sistema de Gestão de Associações

GUILDER DEVELOPERS

Documentação de Integração

Sincronize cadastros, consulte adimplência e receba atualizações financeiras em tempo real no seu próprio ecossistema.

1. Autenticação Global

Todas as requisições devem ser feitas sob protocolo HTTPS e autenticadas enviando o token de segurança da associação parceira diretamente no cabeçalho (Header) do pacote de dados.

Headers Obrigatórios

Content-Type: application/json
X-Guilder-Token: gsh_live_8f9a2bxxxxxxxxxxxxxxxxxxxxxxx

2. Verificar Status de Membro

Utilize esta rota para descobrir de forma passiva se uma associada está ativa e regularizada antes de permitir acessos restritos em portais externos ou bases de dados logadas.

GET

https://guilderhub.com.br/api/v1/associada/verificar?documento=00000000000

HTTP 200 Membro Regularizado

{
  "success": true,
  "matricula": "DA-047",
  "nome": "Maria da Silva",
  "status_cadastro": "ativo",
  "financeiro_regular": true,
  "validade_cadastro": "2027-03-31"
}

HTTP 403 Inadimplente / Pendente

{
  "success": false,
  "nome": "Juliana Costa",
  "status_cadastro": "pendente",
  "financeiro_regular": false,
  "message": "Restrição financeira."
}

3. Webhooks (Eventos Ativos)

Alimente o seu sistema de forma reativa. Sempre que um pagamento for identificado no Asaas, nosso servidor enviará um gatilho de notificação para o endereço que você cadastrar.

POST

Sua URL de Escuta (Ex: https://seusite.com/webhooks/guilder)

Webhook Payload Event

{
  "event": "cobranca.paga",
  "data_hora": "2026-02-21T14:30:00Z",
  "dados": {
    "associada_id": 8492,
    "valor": 197.90,
    "metodo": "PIX",
    "status_painel": "liberado"
  }
}

4. Automação e Régua de Cobrança

O motor integrado executa verificações agendadas na base de dados para garantir que a inadimplência seja combatida de forma autônoma via multi-canais (E-mail e WhatsApp):

30 Dias Antes

Notificação prévia de renovação de plano enviada à associada.

No Vencimento

Disparo do Link de Fatura e Cópia e Cola do PIX Dinâmico.

+5 Dias de Atraso

Bloqueio automático da Urna e da Sala de Assembleias Virtuais.