REDA One Centro de ajuda
PT
Idioma
English EN Español ES Português PT Italiano em breve Français FR Deutsch em breve العربية em breve
reda.one ↗
Início / REDA Pay / Processamento agendado / Automatizar pagamentos com fluxos

Automatizar pagamentos com fluxos

Tudo o que a tela de pagamento faz é conduzido por registros, então o Salesforce Flow também pode conduzir. Uma automação pode criar uma Pay Order e fazer o REDA Pay processá-la em segundo plano, pagar um proprietário quando um extrato é lançado, enviar por e-mail um link de pagamento assim que ele é criado ou avisar o financeiro quando um pagamento é rejeitado. Este artigo lista os pontos de integração que o REDA Pay oferece aos fluxos e as regras de cada um. Nenhum código é necessário; para Apex, consulte API Apex para desenvolvedores.

Antes de começar: você conhece o Flow Builder do Salesforce, tem o REDA Pay - Admin User e testa toda automação primeiro em um sandbox, contra o ambiente de teste da Payload. Automações movimentam dinheiro.

Ponto 1: Process Pay Order: cobrar uma ordem criada por automação

Uma Pay Order salva com a caixa Process Pay Order marcada é processada pelo REDA Pay em segundo plano, exatamente como se Pay tivesse sido pressionado na tela. A ordem precisa estar completa e válida:

CampoValor
Pay ProfileUm perfil ativo
Pay CustomerUm cliente desse perfil, registrado na Payload (já pagou ou já foi sincronizado antes)
Processing AccountUma conta ativa do perfil que permita o tipo de transferência
Pay MethodUm método ativo e reutilizável desse cliente que permita o tipo de transferência (conta bancária para desembolsos)
Transfer TypeReceipt ou Disbursement
Order TypeImmediate
Principal AmountO valor
Process Pay Ordermarcado

Salve o registro; um lote começa em instantes e a ordem recebe a sua Pay Transaction e o Processed Datetime. Se a ordem já estiver processada, salvar com a marcação é recusado com "Pay Order is already processed." Uma falha gera uma transação failed abaixo da ordem, como um pagamento com falha na tela. As taxas são calculadas a partir dos Fee Setups da conta ao salvar, como na tela.

Marque uma ordem por operação. O processamento em segundo plano foi projetado para registros individuais: marque as ordens uma de cada vez (uma entrevista de fluxo, um registro), não em massa a partir de uma carga de dados. Marcar muitas ordens em massa em um só salvamento não é suportado nesta versão.

Um padrão de fluxo: um fluxo acionado por registro no seu registro de cobrança (uma fatura, uma cobrança, um extrato de proprietário) que, quando ele vence, usa um elemento Get Records (obter registros) para buscar o Pay Customer da conta, outro para buscar o Default Pay Method do cliente, um elemento Create Records (criar registros) para criar uma Pay Order com os campos acima, e define o Process Pay Order como verdadeiro.

Ponto 2: Default Pay Method (Disbursement): encontrar para onde pagar

O REDA Pay mantém o Default Pay Method (Disbursement) na conta, no contato e no lead em sintonia com o método padrão do Pay Customer sempre que o cliente tem permissão para desembolsos. Um fluxo de repasse lê essa pesquisa na conta, verifica se não está vazia e a usa como o Pay Method da Pay Order. Os fornecedores a preenchem por conta própria por meio de Solicitar os dados bancários de um fornecedor.

Ponto 3: Attribute 1–4: levar a sua referência

As ordens têm quatro campos de texto livre Attribute, definidos pelas configurações do componente de pagamento ou pelos parâmetros de URL rpay__att1 a rpay__att4, e pelo seu fluxo quando ele cria a ordem. Use-os para levar o número da fatura, o contrato, o imóvel ou o tipo de cobrança, para que um fluxo na Pay Transaction resultante saiba o que foi pago.

Ponto 4: fluxos acionados por registro nos registros do REDA Pay

Os registros mudam de formas previsíveis; crie fluxos sobre eles:

GatilhoAutomação típica
Pay Transaction criada com Status processedLançar o pagamento nos seus registros contábeis; enviar um comprovante por e-mail; atualizar a fatura
O Status da Pay Transaction muda para rejected ou declinedAvisar a cobrança; sinalizar o cliente
Pay Transaction criada com Type refundEstornar o lançamento
Pay Order criada com Order Type LinkEnviar ao cliente, por e-mail, o Link URL com o valor e as Customer Notes: o REDA Pay não o envia
O Status da Pay Order muda para Link - ProcessedFechar a solicitação que precisava do pagamento
O Status da Statement Activity muda para CompletedAvisar o financeiro de que um depósito está pronto para conciliar
REDA Pay Log criado com Attention NeededPublicar em um canal da equipe

Quando um fluxo lê os Attribute 1–4 ou a conta, o contato e o lead relacionados à ordem, ele sabe para que era o pagamento.

Ponto 5: a ação Update Payload Customer

O Flow Builder oferece uma ação chamada Update Payload Customer (uma ação Apex do pacote REDA Pay). Passe a ela um Id de Pay Customer e ela envia à Payload o nome, o e-mail e o telefone atuais do cliente e guarda o identificador de cliente da Payload, se estiver faltando. O próprio fluxo do REDA Pay a chama quando os dados de um cliente mudam; chame-a no seu fluxo depois de atualizar um Pay Customer por automação.

Os fluxos do próprio REDA Pay podem ser substituídos

Os quinze fluxos do REDA Pay (padrões nas novas ordens, escolha de taxa, ativação de links, criação de clientes a partir de um registro pai, propagação do método padrão, notificações, as telas de revogar e de adicionar método) estão marcados como substituíveis. Um administrador pode desativar um e substituí-lo pela própria versão, por exemplo para enviar uma notificação diferente. Faça isso só quando precisar; uma atualização do REDA Pay não desfaz a sua substituição, então você mesmo precisa conciliar as mudanças depois de cada atualização.

Exemplo prático: pagar os proprietários no dia 5

Uma administradora de imóveis paga a cada proprietário o seu valor líquido no dia 5 de cada mês.

  1. Um fluxo agendado roda no dia 5 sobre os registros Owner Statement com saldo positivo.
  2. Para cada um: busca a conta do proprietário; para se o Default Pay Method (Disbursement) estiver vazio (cria uma tarefa para solicitar os dados bancários); busca o Pay Customer da conta no perfil.
  3. Cria uma Pay Order: Pay Profile, Pay Customer, Processing Account (a conta operacional), Pay Method (o método de desembolso padrão), Transfer Type Disbursement, Order Type Immediate, Principal Amount = saldo, Attribute 1 = o número do extrato, Process Pay Order = verdadeiro.
  4. Um segundo fluxo em Pay Transaction (Status processed, Type credit) marca o extrato como pago usando o Attribute 1.

Como há desembolsos envolvidos, o fluxo roda como um usuário com o REDA Pay - Enable Disbursements marcado.

Erros comuns a evitar

ErroO que aconteceSolução
Marcar ordens em massaNão é suportado; as ordens podem ser processadas incorretamenteUma ordem por operação
Criar uma ordem para um cliente nunca registrado na PayloadO processamento falhaExecute o Update Payload Customer ou receba antes um pagamento pela tela
Usuário do fluxo sem o conjunto de permissões ou as chaves certasA ordem é recusada ("You are not authorized to process disbursements.")Execute o fluxo como um usuário com o REDA Pay - Admin User e as chaves
Marcar de novo uma ordem processada"Pay Order is already processed."Crie uma ordem nova
Substituir um fluxo do REDA Pay e esquecer disso na atualizaçãoA sua versão mantém a lógica antigaMantenha uma lista dos fluxos substituídos

Perguntas frequentes

Sim: uma ordem com Order Type Schedule, com os campos de agendamento definidos, um cliente registrado e um método ativo passa a Schedule - Active e roda com o trabalho diário.

Sim: uma ordem com Order Type Link em uma conta com Link Site Public URL e Link Expiration (Minutes) recebe o Link URL e é ativada ao salvar; o seu fluxo pode então enviá-la por e-mail.

Não. Os dados de cartão e de banco só são informados nas telas (ou pela API Apex, por um desenvolvedor). Os fluxos trabalham com Pay Methods salvos.

O que vem a seguir