Formulários de Pagamento

Disponível agora: Formulários de pagamento estão ativos. Você pode adicionar um campo de pagamento com cartão (ou um campo de "quantidade" com preço) a um formulário, e o TimelyChurch cobrará o cartão do inscrito pela conta Stripe conectada da igreja quando ele enviar. Este artigo percorre a configuração, o que o inscrito vê e como revisar e reembolsar pagamentos.

O Que Este Recurso Faz

O campo Payment permite coletar uma cobrança única com cartão como parte de um envio de formulário. Casos de uso típicos:

• Inscrição em evento com taxa — por exemplo, uma inscrição de retiro de US$ 25 que captura as informações do inscrito e cobra o cartão em um único fluxo.
• Depósitos de conferência / viagem — um pagamento parcial para garantir a vaga, com o saldo cobrado depois.
• Doação designada vinculada a uma inscrição — colete um valor fixo junto com os dados do inscrito.
• Pré-pedidos de mercadorias / livros — um campo de "quantidade" com preço cobra por item (quantidade x preço), então "T-shirts x 3" é calculado automaticamente.

Os pagamentos passam pela mesma conta Stripe que a igreja já usa para Doações (via Stripe Connect), então você não precisa de um processador separado. A igreja arca com a taxa de processamento do Stripe, e a receita é registrada na sua conta Fundraising na Contabilidade, com um registro de doação vinculado para que apareça nas finanças.

Antes de Começar: Conecte o Stripe

Formulários de pagamento exigem que a conta Stripe da igreja esteja conectada. Se o Stripe não estiver conectado, o formulário ainda é publicado, mas a caixa de cartão mostra uma mensagem de que "the church hasn't finished connecting Stripe," e nenhum pagamento pode ser feito. Conecte o Stripe primeiro nas configurações de pagamento/doações da igreja.

Nota: Pagamento online ainda não está disponível em páginas de formulário com domínio personalizado. Se o formulário for acessado pelo domínio personalizado da igreja, os pagadores veem um aviso de que pagamentos ainda não estão disponíveis lá. Use o link padrão do formulário TimelyChurch (consulte Compartilhando o Formulário abaixo) para formulários pagos.

Configurando um Formulário Pago

Abra o construtor de formulários em Forms no portal de administração e edite o formulário em que deseja receber pagamento.

Há duas formas de adicionar uma cobrança, e você pode combinar as duas formas em um único formulário:

Opção 1: Um campo Payment fixo

1. Na paleta de campos, adicione o campo Payment (Card) (ele aparece no grupo de campos Advanced, com ícone de cartão de crédito).
2. Clique no campo para abrir o editor e defina o Amount (USD) — por exemplo, 45.00.
3. Esse valor fixo é o que o formulário cobrará no cartão.

O valor que você definir é lançado na receita Fundraising na Contabilidade quando o pagamento for bem-sucedido.

Opção 2: Um campo de "quantidade" com preço

1. Adicione um campo Number (por exemplo, "Number of T-shirts").
2. No editor do campo, defina Price per unit (USD) — por exemplo, 15.00.
3. O formulário então cobra quantidade x preço unitário para esse campo, e o total atualizado muda conforme o inscrito altera o número.

Deixe Price per unit em branco para mantê-lo como um campo numérico simples. Um campo de quantidade com preço combina automaticamente com o total de pagamento com cartão, então você não precisa de um campo Payment separado, a menos que também queira uma taxa fixa.

O total é sempre recalculado no servidor. Qualquer preço que você configure, o TimelyChurch recalcula o valor a partir das próprias configurações do formulário no momento da cobrança — o navegador do inscrito nunca pode definir o preço. Esta é a mesma abordagem anti-adulteração usada no fluxo de doações.

Salve as alterações e Publish o formulário quando estiver pronto.

O Que o Inscrito Vê

Em um formulário pago publicado, abaixo das perguntas o inscrito vê:

• Um running total que atualiza conforme ele preenche campos com preço.
• Uma caixa Card details (entrada segura de cartão do Stripe) com a nota "Secure card payment, processed by Stripe".

Quando ele envia:

1. A validação dos campos do formulário roda primeiro.
2. O cartão é cobrado pelo total recalculado pela conta Stripe da igreja.
3. Em caso de sucesso, o envio é salvo com o pagamento anexado.
4. Em caso de falha, o inscrito vê o erro do Stripe e pode corrigir o cartão sem perder as respostas.

A cobrança mínima do Stripe é US$ 0,50, então um formulário pago precisa de pelo menos um item selecionado totalizando cinquenta centavos ou mais antes de aceitar o pagamento.

Revisando Pagamentos

Abra um envio na lista Submissions do formulário para ver sua página de detalhes. Para envios pagos, um painel Payment mostra:

• Um distintivo de status — Paid, Refunded, Partially refunded, Awaiting payment ou Failed.
• O detalhamento por item e o Total paid (com moeda).
• A processing fee do Stripe (cobrada pelo Stripe, não pelo TimelyChurch).
• O Stripe charge ID para referência.

O pagamento também é registrado como doação nos registros de Contabilidade, então a receita de formulários pagos entra nas finanças automaticamente.

Emitindo um Reembolso

Na página de detalhes de um envio pago, se o pagamento for elegível (status Paid, com uma cobrança Stripe registrada e ainda não reembolsada), aparece a ação Refund to card. Emitir um reembolso exige permissão de Edit no módulo Forms.

Ao abrir o diálogo de reembolso:

• Deixe o valor em branco para reembolsar o valor total que a igreja recebeu, ou informe um valor menor para um reembolso parcial.
• Opcionalmente, escolha um motivo (duplicate, fraudulent ou requested by customer).

O reembolso volta para o mesmo cartão com que o inscrito pagou, e as entradas de receita e taxa são revertidas na Contabilidade. Alguns pontos a saber:

• A taxa de processamento do Stripe não é devolvida. O Stripe mantém sua taxa em reembolsos, então o máximo que você pode reembolsar é o valor bruto menos essa taxa. O membro arca efetivamente com a taxa.
• Um pagamento pode ser reembolsado uma vez (um reembolso parcial deixa o envio no estado Partially refunded).

Dicas e Limitações

• Conta de receita: Cobranças de formulários pagos são lançadas na sua conta de receita Fundraising. Não há seletor de fundo/conta por formulário no construtor hoje.
• Tipo de valor: O campo Payment cobra um valor fixo. Preço variável "pague o que quiser" ainda não está exposto no construtor — use um campo de quantidade com preço se precisar que o total escale com um número.
• Domínios personalizados: Como observado acima, formulários pagos devem ser compartilhados pelo link padrão TimelyChurch, não por uma página com domínio personalizado.
• Pagamentos recorrentes: Formulários cobram um valor único. Para doações recorrentes ou compromissos, use os recursos de Giving e Pledges.

Compartilhando o Formulário

Compartilhe um formulário pago da mesma forma que qualquer outro formulário. Abra o formulário e use as opções Share (QR code, Copy Link, Email). A URL pública tem o formato:

https://your-domain.com/c/your-church/forms/form-slug

Envie aos inscritos este link (ou o QR code) para que a caixa de cartão seja renderizada corretamente e o pagamento possa ser processado.

Artigos Relacionados

• Consulte 03-form-field-types.md para a lista completa de tipos de campo, incluindo o campo Payment.
• Consulte 02-creating-a-form.md para configuração geral de formulários.
• Consulte 06-managing-submissions.md para revisar, aprovar e exportar envios.