Configurar um pagamento recorrente
Uma Pay Order agendada é um modelo: guarda o cliente, a conta, o método salvo e o valor, além de uma frequência e uma data de início, e o REDA Pay cria e processa um pagamento real a partir dela em cada data de vencimento. Aluguel todo dia 1º, uma taxa semanal, uma cobrança anual: tudo isso são agendamentos. A equipe os cria na tela de pagamento com o botão Schedule; os clientes podem criar os seus no portal (consulte Pagamento automático no portal).
- O trabalho diário que executa os agendamentos está agendado na sua organização. Caso contrário, nada é executado; consulte Agendar o trabalho diário de pagamentos recorrentes.
- O cliente tem, ou vai informar, um cartão ou uma conta bancária salvos. Um agendamento precisa de um método reutilizável.
- O botão ou o componente Pay permite agendar (Enable Scheduling Order ativado; nada de
rpay__nosch=1no endereço).
Etapa 1: abrir a tela e escolher o método e o valor
Siga as etapas 1 a 3 de Receber um pagamento: abra a tela de pagamento a partir do registro do cliente, selecione um método salvo ou informe um novo e digite o valor de cada pagamento. Schedule fica disponível quando o método, o e-mail e o valor estão válidos.
Etapa 2: definir o agendamento
Clique em Schedule. A Pay Order é salva e o Confirm Pay Order Summary abre com os valores e estes campos:
| Campo | Valores | Observações |
|---|---|---|
| Schedule Type | One Time · Every Week · Every 2 Weeks · Every Month · Every 3 Months (Quarterly) · Every 6 Months · Every Year | Obrigatório |
| Process on Month Day | 1 a 28 | Para agendamentos mensais, trimestrais, semestrais e anuais. Os dias 29 a 31 não são oferecidos, para que um agendamento nunca pule meses curtos |
| Process on Week Day | Monday a Sunday | Para agendamentos semanais e a cada duas semanas |
| Schedule Start Date | Uma data futura | Obrigatório. "Please provide a valid future date." bloqueia hoje ou antes |
| Schedule End Date | Uma data posterior ao início, ou em branco | Opcional; não oferecido para One Time. "Schedule end date is optional and must be greater than start date." |
Process Order aparece quando os campos estão válidos. Clique nele. O REDA Pay registra o cliente e o método na Payload agora, para que o agendamento possa rodar sem ninguém depois, mas nenhum dinheiro se movimenta hoje. Você volta ao registro com a referência da ordem.
Um agendamento mensal. A taxa mostrada é a que cada pagamento gerado vai ter.
Como o agendamento é executado
- A Pay Order tem Order Type Schedule e Status Schedule - Active enquanto todas as condições valem: um tipo de agendamento e uma data de início, o cliente registrado na Payload, um método, um perfil e uma conta ativos, uma data de término em branco ou não ultrapassada, e a ordem não revogada. Schedule Active mostra isso como uma caixa de seleção.
- O REDA Pay calcula o Schedule Next Run Date: a data de início para One Time; o dia da semana escolhido para os agendamentos semanais; o dia do mês escolhido para os demais. Nada é planejado depois da data de término.
- Todo dia, o trabalho de pagamentos recorrentes encontra os agendamentos que vencem naquele dia e clona cada um em uma nova Pay Order Immediate, vinculada de volta pelo Parent Pay Order, e então a processa exatamente como um pagamento recebido na tela, inclusive com a taxa.
- O Schedule Last Run Date do agendamento é preenchido, o System Run Instances aumenta em um e a próxima data de execução avança.
O agendamento em si nunca é processado; os filhos dele são. Na lista relacionada Pay Orders do agendamento (ou em um relatório por Parent Pay Order), você vê uma ordem filha por execução, cada uma com a sua Pay Transaction.
Os campos do próprio agendamento. O Next Run Date é o que o trabalho diário consulta.
Quando uma execução falha
Se o pagamento criado a partir de um agendamento é recusado ou falha, a ordem filha mantém uma Pay Transaction failed, o proprietário do agendamento recebe uma notificação no aplicativo "Scheduled Payment [P-000000] failed." e um REDA Pay Log registra a execução. O agendamento continua ativo e tenta de novo na próxima data de vencimento; ele não repete a execução perdida. Cobre o valor perdido com um pagamento avulso.
Alterar, pausar ou encerrar um agendamento
| Para… | Faça isto |
|---|---|
| Alterar o valor, o dia ou a frequência | Edite diretamente os campos da Pay Order do agendamento; a próxima data de execução é recalculada. Os campos de valor e de taxa podem ser editados porque o modelo nunca é processado |
| Trocar por outro método salvo | Edite o Pay Method na ordem do agendamento |
| Pausar | Defina Schedule End Date como uma data passada, ou desmarque Keep Active no método. Limpe ou restaure para retomar |
| Encerrar de vez | Use Revoke Order no agendamento, com uma observação. Agendamentos revogados nunca mais são executados |
| Ver o que já foi executado | Abra as Pay Orders relacionadas do agendamento, ou filtre as Pay Orders por Parent Pay Order |
Excluir o método salvo na tela de pagamento também encerra todos os agendamentos que o usam; a tela avisa "Any schedule payments associated with this pay method will become inactive."
Exemplo prático
Um morador paga $1,250.00 de aluguel por conta bancária todo dia 1º, de 1º de novembro de 2026 até o fim do contrato, em 31 de outubro de 2027. A conta cobra $1.75 por pagamento bancário.
| Configuração | Valor |
|---|---|
| Valor | 1250 |
| Schedule Type | Every Month |
| Process on Month Day | 1 |
| Schedule Start Date | 1º nov. 2026 |
| Schedule End Date | 31 out. 2027 |
Resultado: doze ordens filhas, uma no dia 1º de cada mês, cada uma cobrando $1,251.75. Depois da décima segunda, o Schedule Next Run Date fica em branco e o Schedule Active é desmarcado.
Erros comuns a evitar
| Erro | O que acontece | Solução |
|---|---|---|
| Trabalho diário não agendado | Os agendamentos aparecem como ativos, mas nunca são executados | Agende-o; consulte Agendar o trabalho diário de pagamentos recorrentes |
| Esperar um pagamento hoje | O primeiro pagamento acontece na data de início | Receba um pagamento imediato separado para hoje |
| Agendamento com um método de uso único (de um link de pagamento) | O Schedule Active continua desmarcado | Marque Keep Active no método, ou salve um reutilizável |
| Escolher o dia 1 esperando o fim do mês | O dia do mês é literal | Escolha 28 para "fim do mês" |
| Excluir o método para "encerrar" um agendamento | Funciona, mas também remove o método dos pagamentos avulsos | Revogue o agendamento |
Perguntas frequentes
Quando o trabalho diário roda: no horário que o seu administrador escolheu ao agendá-lo.
A Payload recusa a execução; o agendamento continua ativo e falha de novo na próxima vez. Substitua o método e edite o Pay Method do agendamento.
Não. Um agendamento cobra um valor fixo. Valores variáveis precisam de um novo pagamento avulso a cada vez, ou de uma automação que crie ordens imediatas; consulte Automatizar pagamentos com fluxos.