Formulário de doação online

O formulário de doação é uma página pública que fica em /donate no site público da sua igreja (ex.: grace.geniuschurchmanager.com/donate ou seu domínio personalizado). Qualquer pessoa com o link pode doar — não precisa de conta.

O que os visitantes veem

Um formulário limpo com:

• Valor — botões pré-definidos (R$ 10, R$ 25, R$ 50, R$ 100, personalizado).
• Fundo — lista suspensa com todos os fundos ativos que não estejam marcados como ocultos.
• Frequência — única, semanal, quinzenal, mensal.
• Dados do doador — nome, e-mail, telefone opcional.
• Dados do cartão — através de um checkout hospedado, não coletados diretamente pelo GCM.
• Mensagem opcional — texto livre curto que o tesoureiro vê na linha da doação.

Quando o doador clica no botão de doar, redirecionamos para o Genius Checkout (nossa página de pagamento hospedada) ou para a página hospedada da PowerTranz. O visitante insere os dados do cartão lá, o gateway devolve um resultado e voltamos para seu site com uma mensagem de sucesso ou falha.

Configuração

O formulário de doação fica ativo por padrão. Para configurar:

1. Vá em Configurações → Formulário de doação.
2. Escolha:
   • Logo — o logotipo da sua igreja (pega das configurações da organização por padrão).
   • Texto do cabeçalho — o versículo, slogan ou mensagem no topo do formulário.
   • Fundo padrão — qual fundo a lista suspensa mostra primeiro.
   • URL de sucesso — para onde redirecionar após uma doação bem-sucedida. O padrão é uma página de agradecimento embutida; você pode apontar para a sua própria página se quiser.
   • URL de falha — a mesma ideia para recusas.
3. Salve.

O formulário pega sua identidade visual (cores, fontes) de Configurações → Identidade visual automaticamente.

Compartilhando o link

O formulário fica em /donate no seu site público. Lugares comuns para colocar o link:

• O botão "Doar" na navegação principal do site da sua igreja.
• O QR code impresso no boletim ou projetado durante a oferta.
• Uma mensagem de WhatsApp depois de cada culto.
• Sua bio nas redes sociais.

TIP

QR codes funcionam melhor que URLs digitadas em escala. Gere um apontando para /donate e cole na parede dos fundos do seu templo. Quem pula a cesta de oferta ainda escaneia e doa.

Única vs recorrente

O formulário suporta as duas. O seletor de frequência tem padrão única; visitantes que escolhem semanal/quinzenal/mensal caem no fluxo de doações recorrentes com o mesmo cartão.

Para recorrência, usamos um cartão tokenizado on-file — o gateway devolve um token que alimenta o job de cobrança noturno. O número completo do cartão do doador nunca é armazenado pelo GCM.

O que acontece após uma doação bem-sucedida

Na hora:

• O visitante vê a página de sucesso.
• Ele recebe um recibo por e-mail.
• Uma linha de doação cai na sua tabela donations.
• O doador é vinculado a um membro existente pelo e-mail; se não houver correspondência, é criado um novo membro do tipo visitante.

Em seguida:

• O widget de doações do painel é atualizado imediatamente.
• O perfil do doador (ou novo registro de membro) recebe a doação na aba Doações.
• Qualquer workflow escutando o gatilho giving.recorded dispara.
• O valor é incluído no extrato de fim de ano.

Pagamentos recusados

Quando um cartão é recusado:

• O visitante vê uma página de falha amigável com um link "tentar novamente".
• Nenhuma linha de doação é gravada.
• Nenhum registro de doador é criado (não queremos sujar sua tabela de membros com tentativas abandonadas).

Registramos todas as tentativas para auditoria — acessíveis aos administradores em Configurações → Dados e Logs → Tentativas de pagamento.

Segurança

• O formulário fica no seu domínio personalizado via Vercel, servido por HTTPS.
• Os dados do cartão são inseridos na página hospedada do gateway, nunca vistos pelo GCM.
• A edge function payment-callback valida assinaturas HMAC em todo callback, então um sucesso forjado não cria uma doação fantasma.
• Veja nossas notas sobre conformidade PCI para o padrão completo.

Incorporando

Você pode incorporar o formulário em um iframe no site da sua igreja já existente. O formulário é responsivo e funciona em qualquer largura até mobile. Use o código de incorporação mostrado em Configurações → Formulário de doação → Incorporar.

Perguntas comuns

Posso ter vários formulários de doação para campanhas diferentes? Atualmente um formulário por organização, com vários fundos selecionáveis. Estamos avaliando suporte a múltiplos formulários para campanhas de capital — veja Lance uma campanha de doações para a solução alternativa usando fundos e cabeçalhos.

O formulário suporta Apple Pay / Google Pay? Sim se o seu gateway suportar. O Genius Checkout suporta ambos; o suporte da PowerTranz varia por região.

Quais moedas? O formulário cobra na moeda da sua organização (definida em Configurações → Organização). Multi-moeda em um único formulário não é suportado.

Próximos passos

• Doações recorrentes — o caminho baseado em cronograma.
• Extratos e recibos — acompanhamento de fim de ano.
• Lance uma campanha de doações — receita completa de campanha.