Quando um pagamento falha: logs, alertas e recuperação

Os pagamentos falham por motivos comuns (um cartão recusado, uma conta bancária sem saldo, um número digitado errado) e, de vez em quando, por motivos técnicos. O REDA Pay registra cada falha em um lugar específico e avisa alguém específico. Este artigo liga cada falha ao lugar onde ela fica registrada, ao alerta que ela gera e ao caminho de volta.

Antes de começar: você tem o REDA Pay - User para ler transações e logs, e o REDA Pay - Admin User para as ações de recuperação.

Onde as falhas ficam registradas

Falha	Registrada como	Quem é avisado
Um pagamento na tela é recusado ou rejeitado	Uma Pay Transaction com Status failed e o motivo em Error Message, abaixo da ordem; a ordem continua Not Processed	A pessoa na tela, imediatamente
Um link de pagamento falha quando o cliente paga	O mesmo, e a ordem continua Link - Active	O proprietário da ordem: notificação no aplicativo "Payment Link [P-000000] failed."
Uma execução agendada falha	Uma transação com falha abaixo da ordem filha gerada	O proprietário do agendamento: "Scheduled Payment [P-000000] failed."; e um REDA Pay Log da execução
A conexão com a Payload caiu no meio do pagamento	Uma transação com falha com Process Callout Exception marcado; o pagador vê a mensagem de "unexpected exception" com um código	O trabalho de recuperação de pagamentos com falha a corrige; consulte Ativar a recuperação de pagamentos com falha
Um trabalho em segundo plano encontrou erros (agendamentos, sincronizações, extratos, atualizações de clientes)	Um REDA Pay Log com Attention Needed marcado e as falhas anexadas em um arquivo CSV	Todos os usuários ativos que recebem os e-mails de administração do Salesforce, e o proprietário do trabalho, por e-mail
Um pagamento bancário é rejeitado dias depois	O Status da transação passa a rejected, com um Rejected Date	Ninguém, por padrão; consulte Disputas e pagamentos rejeitados
O nome, o e-mail ou o telefone de um cliente não puderam ser enviados à Payload	Sync Error Message no Pay Customer	Ninguém; visível no registro

Ler uma transação com falha

Abra a Pay Order e veja as Pay Transactions dela. Uma tentativa com falha tem:

Campo	O que ler
Status	failed
Error Message	O motivo da Payload, no formato "tipo de erro : descrição"; por exemplo um cartão recusado, um routing number inválido ou uma regra de cliente como "Payments are not allowed at this time for this customer."
Process Callout Exception	Marcado quando a conexão caiu: o resultado é desconhecido até o trabalho de recuperação rodar
Created Date	Quando a tentativa foi feita

A ordem em si não é alterada e pode ser paga de novo a partir do registro, com outro método.

A lista Pay Transactions de uma Pay Order mostrando uma transação com Status failed e a sua Error Message, seguida de uma transação processada mais tarde

Uma tentativa com falha ao lado da nova tentativa bem-sucedida. O registro com falha fica para a trilha de auditoria.

REDA Pay Logs

Todo trabalho em segundo plano que encontra um erro grava um REDA Pay Log (RPL-000000):

Campo	Significado
Process	Qual trabalho: ordens agendadas, sincronização de transações, processamento de extratos, transações ausentes, atualização de clientes
Start / End Datetime, Total Records, Success Records, Failed Records	Os números da execução
Exception	O texto do erro, quando o próprio trabalho falhou
Attention Needed	Marcado enquanto houver falhas que ninguém resolveu
Resolved Date Time	Preencha quando tiver tratado o log; ele sai do modo de exibição Attention Needed
Notes & Attachments	Um arquivo CSV que lista cada registro com falha e o seu erro; baixe-o para ver quais ordens ou transações foram afetadas

Quando um log é criado com falhas, o REDA Pay envia um e-mail a todos os usuários ativos que recebem os e-mails de administração e ao proprietário do trabalho. O assunto é "RPL-000000 - processo - System Asynchronous Automation Exception" e o corpo começa com "ATTENTION NEEDED", com um link para o log.

O aplicativo REDA Pay tem uma guia REDA Pay Logs com os modos de exibição Attention Needed, Created Today e All; o painel REDA Pay Admin mostra a quantidade de logs que precisam de atenção.

O modo de exibição de lista "Attention Needed" de REDA Pay Logs com colunas para o número do log, Process, Failed Records e Created Date

O modo de exibição Attention Needed é a verificação diária de quem é responsável pelas operações de pagamento.

Recuperação, por situação

Situação	Faça isto
Pagamento com cartão ou bancário recusado	Receba o pagamento de novo com outro método. A transação com falha fica como histórico
Uma regra de cliente bloqueou ("not allowed for this customer", "pay method type is not allowed…")	Corrija os métodos permitidos ou o tipo de transferência do Pay Customer (consulte Regras por cliente) e pague de novo
Pagador debitado, mas o Salesforce mostra uma tentativa com falha com Process Callout Exception	Aguarde o trabalho de recuperação (a cada 15 minutos), ou abra a ordem e pressione Sync Transaction para buscar agora o registro da Payload. Não processe a ordem de novo
O status de uma transação parece desatualizado	O Sync Transaction na transação (ou na ordem, para todas elas) a relê na Payload
Uma execução agendada falhou	Cobre o valor perdido com um pagamento avulso; o agendamento continua na próxima data. Se o método não serve mais, substitua-o; consulte Configurar um pagamento recorrente
Um log informa muitas falhas de um trabalho	Abra o CSV, corrija a causa comum (uma conta inativa, um método excluído, uma permissão ausente) e depois preencha o Resolved Date Time
Statement Activity parada em In Process	Use Reprocess nela; consulte Conciliar depósitos e repasses

Sync Transaction

Em uma Pay Transaction: clique em Sync Transaction e depois em Sync. O REDA Pay relê essa transação na Payload e atualiza o status, o código de status, o status de liquidação e as datas. Em uma Pay Order: a mesma ação pede à Payload todas as transações marcadas com a ordem, atualiza as que o Salesforce tem e cria as que faltam; é a versão manual do trabalho de recuperação, sem o limite de uma hora.

Mensagens de erro com detalhes técnicos

Por padrão, o REDA Pay mostra o detalhe técnico de um erro (números de linha e um rastreamento de pilha) depois da mensagem, porque a chave da organização ERROR_STACK_TRACE vem como TRUE. Esse detalhe ajuda o suporte, mas não deve aparecer na tela de nenhum cliente. Antes de entrar em produção, defina-a como FALSE; consulte Chaves da organização e mensagens de erro.

Erros comuns a evitar

Erro	O que acontece	Solução
Processar uma ordem de novo depois da mensagem "unexpected exception"	Uma segunda cobrança	Sincronize primeiro; olhe as transações
Ignorar os e-mails Attention Needed	Execuções agendadas com falha e erros de sincronização se acumulam sem ninguém ver	Dê a uma pessoa a verificação diária
Excluir transações com falha para "arrumar"	A trilha de auditoria da tentativa se perde; transações com reembolsos não podem ser excluídas de qualquer forma	Deixe-as
Deixar tentativas com Process Callout Exception por mais de uma hora	O trabalho de recuperação não as pega mais	Use o Sync Transaction na ordem

Perguntas frequentes

Não. O REDA Pay não envia e-mails aos pagadores. O pagador vê o resultado na tela; a sua própria automação pode enviar um e-mail a partir da transação com falha.

Todos os usuários ativos configurados para receber os e-mails de administrador do Salesforce, e o proprietário do trabalho que falhou.

Crie um fluxo em REDA Pay Log (quando Attention Needed passar a verdadeiro) que publique onde você quiser.