Chaves da organização e mensagens de erro
Duas chaves para toda a organização ficam em um tipo de metadados personalizados chamado REDA Pay Setup. Uma delas decide quanto detalhe técnico o REDA Pay coloca nas mensagens de erro que as pessoas veem, e ela vem no modo pensado para a configuração, não para os clientes. Este artigo explica as duas chaves e depois lista as mensagens que o REDA Pay mostra e o que fazer com cada uma.
Antes de começar: você tem o REDA Pay - Admin User e a permissão do Salesforce para editar registros de metadados personalizados (Customize Application).
As chaves
Abra Configuração → Tipos de metadados personalizados → REDA Pay Setup → Gerenciar registros (Manage Records). Cada registro tem um Key, um Value e uma Description. Altere só o Value, para TRUE ou FALSE.
| Key | Valor no pacote | O que faz | Recomendado |
|---|---|---|---|
| ERROR_STACK_TRACE | TRUE | Com TRUE, um erro exibido na tela é seguido do seu detalhe técnico: um número de linha e um rastreamento de pilha. Com FALSE, só a mensagem é exibida | FALSE em produção. O detalhe também aparece na página pública de pagamento e no portal, e não significa nada para um pagador. Mude para TRUE temporariamente quando estiver trabalhando com o suporte em um problema |
| CREATE_MISSING_TRANSACTIONS | FALSE | Com TRUE, a conciliação sempre cria uma Pay Transaction para qualquer pagamento de um depósito que o Salesforce não conhece. Com FALSE, essas linhas ficam não conciliadas até que alguém execute o Reprocess com a chave dele ativada | FALSE, a menos que pagamentos sejam recebidos com frequência fora do REDA Pay e você queira registrá-los automaticamente; consulte Conciliar depósitos e repasses |
Um registro adicional, REDA_PAY_ACCOUNTING_EXT (listado como REDA PAY ACCOUNTING EXT), é reservado para uma extensão contábil da REDA e não tem efeito no próprio REDA Pay. Deixe-o como veio.
A lista de registros de metadados personalizados REDA Pay Setup na Configuração, com os três registros do pacote CREATE MISSING TRANSACTIONS, ERROR_STACK_TRACE e REDA PAY ACCOUNTING EXT; abra um registro para ver o Value
As chaves. Defina ERROR_STACK_TRACE como FALSE antes que os clientes vejam as páginas de pagamento.
Para alterar uma: clique em Editar no registro, altere o Value e clique em Salvar. A alteração vale imediatamente.
Referência das mensagens de erro
As mensagens estão agrupadas por onde aparecem. Muitas são citadas literalmente, para que o suporte consiga relacioná-las ao relato de um cliente.
Nas telas de pagamento e de salvar método
| Mensagem | Significado | O que fazer |
|---|---|---|
| "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator." | A chave de criptografia não foi gerada | Gerar a chave de criptografia |
| "Bad Request. Parent record not found." | A tela foi aberta sem um registro (nenhum rpay__rid, nenhum registro de usuário do portal) | Abra-a a partir de uma conta, um contato ou um lead, ou confira as configurações do portal |
| "Transaction not allowed for SObject: …" | Não há registro REDA Pay Process Config ativo para esse objeto | Ative ou crie o mapeamento; consulte Como os Pay Customers são criados |
| "No transfers are allowed. [Transfer Type]" | Nem recebimentos nem desembolsos são permitidos para este usuário nesta página | Confira as chaves do usuário, o componente e a conta |
| "Payments are not allowed at this time for this customer. [Pay Methods]" | O Pay Customer não tem métodos de pagamento permitidos | Defina o Allowed Payment Methods no cliente |
| "New payment methods are not allowed at this time for this customer." | O mesmo, na tela de salvar método | O mesmo |
| "Invalid request. Payment session is expired." / "Invalid request. New method session is expired." | A tela ficou aberta por mais tempo do que a sessão permite | Reabra a partir do registro; aumente a duração da sessão, se necessário |
| "Please provide a valid amount" / "Please enter a valid email address" | Um campo está vazio ou mal preenchido | Corrija-o |
| "You must share geo-location access on browser or device to process the payment." | A geolocalização é exigida e o navegador a negou | Permita a localização, ou altere a exigência da conta |
| "Our systems have detected a duplicate payment request. We will only consider the first payment request." | O botão de pagar foi pressionado duas vezes | Aguarde o primeiro resultado |
| "Ooops.. we have experienced an unexpected exception. Your payment method may have been debited. Do not try to pay again and quote following code to the support team…" | A conexão falhou depois da cobrança | Não tente de novo; execute a recuperação; consulte Ativar a recuperação de pagamentos com falha |
| "Failed to process pay method." / "Failed to process pay method. Bad Customer Data." | A Payload recusou o cartão ou a conta, ou os dados do cliente | Confira os dados e o nome, o e-mail e o telefone do cliente |
Nos links de pagamento
| Mensagem | Significado |
|---|---|
| "Invalid request: Order link has expired." | O prazo do link passou |
| "Invalid request: Order is already processed." | Já foi pago |
| "Invalid request: Bad request Parameters." | Endereço alterado, link nunca ativado ou revogado |
Consulte a Solução de problemas de links de pagamento.
Quando uma ordem é salva
| Mensagem | Significado |
|---|---|
| "The transfer type is not allowed on either Customer, Processing Account or Pay Method." | Recebimento/desembolso não permitido em algum ponto da cadeia |
| "The pay method type is not allowed for the provided customer or processing account." | Cartão ou banco não permitido na cadeia |
| "Only active processing account associated to provided pay profile can be selected." / "Only active and valid pay profile can be selected." | Registros de configuração inativos ou que não combinam |
| "Processing account is not applicable for provided Pay Customer." | As Applicable Processing Accounts do cliente a excluem |
| "Disbursements are only supported for following pay methods.[Bank Account]" | Um cartão foi usado em um repasse |
| "Earnest Money Deposit payment is not allowed for this order." / "…only supported for following payments methods.[Bank Account (ACH)]." | Regras de EMD violadas |
| "Order type link can not be processed if the required setup does not exist on the provided processing account." | A conta não tem Link Site Public URL |
| "You are not authorized to process disbursements." / "You are not authorized to process receipts." | As chaves do usuário |
| "Pay Order is already processed." | Process Pay Order marcado em uma ordem processada |
| "Invalid Pay Order. Pay order was revoked." | Tentativa de processar uma ordem revogada |
Nas ações de registro
| Mensagem | Ação | Significado |
|---|---|---|
| "Bad Config Setup." | Qualquer ação | A ação foi aberta no tipo de registro errado, ou falta a configuração de que ela precisa |
| "Insufficient Access" | Qualquer ação | O usuário não consegue ver o registro |
| "Transaction is not eligible for Voiding." / "Failed to void Transaction. Transaction is already processed." | Void Transaction | Não processada, ou já liquidada: reembolse |
| "Only transaction of type "Payment" can be refunded." / "Only transaction in status "Processed" can be refunded." / "Partial refunds are not allowed for this transaction." | Refund Transaction | Regras dos reembolsos |
| "Pay Method is not processed." / "Pay Method is already deleted." / "Pay Method is already processed." | Delete / Process Pay Method | Estado do método |
| "Only immediate orders can be processed manually." / "Order is associated with invalid payment method." | Process Pay Order | Regras do processamento manual |
| ""Reconciled" statement activity can not be reprocessed." | Reprocess | Já conciliada |
| "Statement and Reconciled amount must be the same for reconciled activities." | Editar uma Statement Activity | Os valores são diferentes |
| "Failed to setup webhooks. Bad Pay Profile Setup." / "Failed to setup webhooks. Bad Server Response." | Setup Webhooks | Falta a URL base ou a chave, ou a Payload recusou a solicitação |
| "Please provide API Key and Profile Id prior activating the profile." | Editar um Pay Profile | Ative depois de guardar a chave e sincronizar |
Perguntas frequentes
As mensagens são rótulos personalizados do pacote. O Translation Workbench do Salesforce permite substituir os rótulos de um pacote gerenciado para um idioma, que é a forma suportada de reescrever uma mensagem.
O ERROR_STACK_TRACE está como TRUE. Defina-o como FALSE.
Para os REDA Pay Logs, não para as telas; consulte Quando um pagamento falha.