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 / Administração / Atualizar o REDA Pay

Atualizar o REDA Pay

O REDA Pay é um pacote gerenciado: uma nova versão é instalada sobre a antiga com um link de instalação, e os seus dados, a sua configuração e as suas personalizações permanecem. As atualizações são rotineiras, mas três coisas que uma atualização gerenciada nunca faz pegam os administradores de surpresa todas as vezes, então este artigo é tanto uma lista de verificação quanto um procedimento.

Antes de começar
  • Você tem a permissão do Salesforce para instalar pacotes (um administrador do sistema tem).
  • Você tem o link de instalação da nova versão, fornecido pelo seu executivo de contas da REDA ou por support@reda.one; os links não são publicados.
  • Você tem um sandbox atualizado há pouco tempo, parecido o suficiente com a produção.

Conferir o que você tem

Configuração → Pacotes instalados lista o REDA Pay com o seu Número da versão. As notas de versão deste portal indicam a versão que descrevem; compare antes de lê-las.

Atualizar primeiro um sandbox

  1. Abra o link de instalação conectado ao sandbox (ou escolha o login do sandbox quando o link pedir).
  2. Escolha quem recebe acesso aos componentes do pacote. Install for Admins Only (instalar só para administradores) é o padrão seguro: o acesso é concedido pelos conjuntos de permissões do REDA Pay, não pela escolha na instalação.
  3. Clique em Upgrade (atualizar) e aguarde o e-mail de confirmação.
  4. Faça as verificações das próximas seções, receba um pagamento de teste no ambiente de teste da Payload e só então repita em produção.

As três coisas que uma atualização nunca faz

Uma atualização gerenciada instala componentes novos, mas não mexe no que você pode ter personalizado. Para cada campo ou valor novo que uma nota de versão listar, faça isto à mão:

1. Colocar os campos novos nos seus layouts de página

Se você já editou algum layout de página do REDA Pay (e a maioria das organizações já), um campo novo é instalado, mas não é colocado no seu layout. Só os layouts intocados, padrão do pacote, o recebem. Para cada campo novo que a nota de versão listar: Configuração → Gerenciador de objetos → o objeto → Layouts de página → o seu layout, arraste o campo para a seção que a nota indica e clique em Salvar.

2. Conceder segurança no nível do campo aos seus próprios conjuntos de permissões e perfis

O pacote concede os campos novos aos seus próprios conjuntos de permissões. Se os seus usuários têm os seus próprios conjuntos de permissões ou perfis em vez dos do REDA Pay, ou além deles, eles não têm acesso ao campo novo até que você o conceda: Configuração → Gerenciador de objetos → o objeto → Campos e relacionamentos → o campo → Definir segurança no nível do campo, e marque a visibilidade (e o somente leitura, conforme o caso) para cada perfil ou conjunto de permissões.

Teste como um usuário comum da função em questão, nunca como administrador: administradores veem os campos independentemente da segurança no nível do campo, então testar com o seu próprio usuário não prova nada.

3. Acrescentar à mão os valores novos de lista de seleção

Uma atualização nunca acrescenta um valor novo de lista de seleção a um campo que a sua organização já tem. As instalações novas o recebem; as organizações atualizadas não, mesmo quando um campo novo chega na mesma versão. Se uma nota de versão listar um valor novo, acrescente-o com a grafia exata: Configuração → Gerenciador de objetos → o objeto → Campos e relacionamentos → o campo, acrescente o valor na lista de valores (botão New) e clique em Salvar; depois reordene-o. Em uma lista de seleção restrita, um valor ausente faz o recurso falhar de vez, não só esconder uma opção.

📷 Captura de tela — A página Pacotes instalados na Configuração, mostrando a linha do REDA Pay com o seu Número da versão

Onde fica a sua versão. Compare-a com as notas de versão antes de lê-las.

Ler uma nota de versão

Cada nota de versão do REDA Pay neste portal traz, para cada mudança, as etapas a fazer na sua organização. Leia-a com as três regras acima em mente:

A nota dizVocê faz
"New field X on Object, section Y"Coloque X nos seus layouts, na seção Y; conceda segurança no nível do campo aos seus perfis e conjuntos de permissões; teste como usuário
"New picklist value V on field F"Acrescente V a F à mão, com a grafia exata; reordene-o; se F for restrito, faça isso antes que alguém use o recurso
"New action A on Object"Acrescente a ação à seção de ações dos seus layouts de página
"Run Setup Webhooks again"Abra cada Pay Profile ativo e pressione-o
"Place component C on your portal pages"Abra o Experience Builder, coloque-o, defina as propriedades e publique
"Schedule job J"Configuração → Classes do Apex → Agendar Apex

Roteiro de teste no sandbox

Execute isto no sandbox depois da atualização, como um usuário que tenha só o conjunto de permissões do REDA Pay da função em questão:

  1. Abra um lead e pressione o botão Pay; a tela abre com o logotipo e as guias.
  2. Receba um pagamento bancário de $1 no ambiente de teste da Payload; a ordem mostra Immediate - Processed.
  3. Abra a Pay Transaction e pressione Sync Transaction; ela é concluída.
  4. Crie e cancele um agendamento; crie um link, abra-o em uma janela privada e revogue-o.
  5. Como usuário do portal, abra a página de pagamento do portal e chegue à tela de pagamento.
  6. Como administrador, abra o Pay Profile: o Webhook Setup lista dez linhas; pressione Sync Processing Accounts; dá certo.
  7. Confira se há algo novo nos REDA Pay Logs.

Se alguma etapa falhar no sandbox, pare e fale com support@reda.one informando a etapa e a mensagem antes de mexer na produção.

Avisar os seus usuários

Uma atualização raramente muda o que a equipe vê, mas quando uma versão acrescenta um botão, um campo ou uma tela, avise as pessoas que vão usá-lo antes que elas o encontrem. A seção "o que você vai ver" da nota de versão é escrita para ser encaminhada.

O que sobrevive a uma atualização, e o que conferir de novo

SobreviveConferir de novo depois da atualização
Pay Profiles, Processing Accounts, Fee Setups, clientes, métodos, ordens, transações, extratos, logsNada a fazer
A chave de criptografia e os valores criptografadosNada a fazer
Os seus layouts personalizados, os seus conjuntos de permissões, os seus fluxosCampos novos colocados? Acesso novo concedido?
As suas substituições de fluxos do REDA PayCompare com a nova versão do pacote; concilie de forma deliberada
Trabalhos agendados (pagamentos recorrentes diários, recuperação de pagamentos com falha)Continuam listados na página Todos os trabalhos agendados, com uma data em Próxima execução agendada
Webhooks registrados na PayloadA guia Webhook Setup continua listando dez; execute o Setup Webhooks de novo se uma nota de versão pedir
Páginas do Experience Cloud com componentes do REDA PayAbra cada página no Builder; publique de novo se a nota pedir
Chaves em metadados personalizadosValores inalterados

Depois da atualização: uma verificação de dez minutos

  1. Pacotes instalados mostra a nova versão.
  2. Guia REDA Pay Admin: chave Generated, chave do trabalho de recuperação em Yes.
  3. Receba um pagamento de teste como usuário da equipe e, se você os tiver, como usuário do portal e por um link.
  4. Abra uma Pay Order e uma Pay Transaction como não administrador: todos os campos que a nota de versão acrescentou estão visíveis.
  5. REDA Pay Logs: nenhuma entrada nova Attention Needed.

Erros comuns a evitar

ErroO que aconteceSolução
Atualizar a produção primeiroOs problemas aparecem na frente dos clientesSandbox primeiro
Supor que os campos novos estão visíveisA equipe não os vê; os recursos parecem quebradosLayouts e segurança no nível do campo
Pular um valor de lista de seleção da nota de versãoO recurso dá erro ou falta uma opçãoAcrescente o valor com a grafia exata
Testar como administradorAs lacunas de acesso ficam escondidasTeste como cada função
Esquecer um fluxo substituídoA lógica antiga continua rodandoConcilie as substituições

Perguntas frequentes

Não. Pacotes gerenciados não voltam de versão; é por isso que o sandbox vem primeiro.

A instalação leva minutos e não interrompe os trabalhos agendados. Para garantir, atualize fora da hora em que roda o seu trabalho de pagamentos recorrentes.

Neste portal, nas versões do REDA Pay, com as etapas do lado do assinante para cada versão.

O que vem a seguir