REDA Pay
Winter 2026 · v1.57000
5 Nov 2026
API v2 do Payload, entrada segura de cartão em todo site, e guias de configuração para cada canal
O REDA Pay 1.57000 é uma versão principal. Ela reúne tudo o que foi lançado desde a versão principal 1.56: os patches 1.56001, 1.56002, 1.56003 e 1.56004 (3 e 4 de novembro de 2026). Uma organização que já executa a 1.56004 tem todas as mudanças desta página. Esta página diz como instalar o REDA Pay pela primeira vez, como atualizar uma organização que executa a 1.56 ou um dos patches, quais etapas o upgrade não pode fazer por você, e o que mudou, nas palavras que a sua equipe vai usar.
Dados da versão. Pacote: REDA Pay · Número da versão: 1.57000 · Nome da versão: Winter 2026.
Atualizar agora: produção · Instalar em um sandbox
Links de instalação. A versão 1.57000 foi lançada em 5 de novembro de 2026 e não precisa de senha de instalação; o login do Salesforce, as licenças do pacote e as permissões continuam valendo. Os links identificam a versão do pacote, não uma organização específica: o seu login do Salesforce decide onde ela é instalada. Para ver qual versão uma organização executa hoje: Configuração → Pacotes instalados → REDA Pay → Número da versão.
Prefere que a gente faça? A equipe da REDA instala, atualiza e configura o REDA Pay para você. Escreva para sales@reda.one para agendar uma sessão.
Nesta página
- Em resumo: quem precisa fazer o quê
- Instalar o REDA Pay pela primeira vez
- Depois de instalar: configurar cada canal de pagamento
- Atualizar a partir da 1.56 ou de um patch
- Depois de atualizar: etapas que o upgrade não pode fazer por você
- Conferir que tudo funciona
- Novidades desta versão
- Corrigido nesta versão
- Campos, ações e componentes novos, e quem pode vê-los
Em resumo: quem precisa fazer o quê
| Sua situação | O que fazer | Onde |
|---|---|---|
| O REDA Pay ainda não está instalado | Instale o pacote e siga o roteiro de configuração: chave de criptografia, Pay Profile e chave de API, contas de processamento, conjuntos de permissões, webhooks e os canais que você usa (telas da equipe, portal do cliente, links de pagamento públicos, pagamentos agendados). | Instalar e Depois de instalar |
| Sua organização executa a 1.56 | Atualize e conclua todas as etapas de Depois de atualizar: os campos e a ação novos do Pay Profile nos seus layouts, o acesso para os seus próprios perfis ou conjuntos de permissões clonados, o acesso do usuário convidado do site de webhooks, os valores do conjunto de valores e a republicação de cada site do Experience Cloud que hospeda telas do REDA Pay. | Atualizar |
| Sua organização executa a 1.56001, 1.56002 ou 1.56003 | Atualize, depois publique de novo cada site do Experience Cloud que hospeda as telas v2 e confira as outras etapas de Depois de atualizar — a maioria já foi feita quando o patch foi instalado. | Atualizar |
| Sua organização executa a 1.56004 | Ela já tem todas as mudanças desta página. Se você ainda não concluiu Depois de atualizar, faça agora; não é preciso publicar de novo. | Depois de atualizar |
| Você quer usar a API v2 do Payload (entrada segura de cartão, telas em um site LWR, webhooks assinados) | Defina Versão da API do Payload como v2 no Pay Profile e execute Configurar webhooks. Nada mais se move; a mudança pode ser revertida. | Escolher a versão da API do Payload |
| Seu portal do cliente ou site público é um site LWR | Coloque os componentes v2 nas páginas dele (os componentes clássicos não funcionam em LWR). Nomes de página, acesso de convidados e compartilhamento estão descritos passo a passo. | Portal · Links públicos |
| Seus usuários trabalham em espanhol, francês ou português (Brasil) | Nada: depois do upgrade o REDA Pay aparece no idioma do usuário. Confira o idioma no registro de usuário se ainda aparecer em inglês. | Novidades |
Instalar o REDA Pay pela primeira vez
Você precisa de um administrador do Salesforce (o perfil Administrador do sistema, ou um perfil com Baixar pacotes do AppExchange e Personalizar aplicativo) e de uma conta do Payload em cujo painel você consiga fazer login. Instale primeiro em um sandbox, se tiver um.
- Abra o link de instalação do ambiente em que está instalando (produção ou sandbox). Se não o tiver, peça ao seu executivo de contas da REDA ou a support@reda.one.
- Faça login como administrador dessa organização. Se você tem várias organizações, confira o nome da organização no alto da página antes de continuar.
- Na página de instalação, confirme o nome do pacote REDA Pay e o número da versão com esta página.
- Escolha Instalar somente para administradores. O acesso de todos os outros é concedido depois pelos conjuntos de permissões do REDA Pay, não por essa escolha.
- Clique em Instalar. Se o Salesforce disser que a instalação continua em segundo plano, aguarde o e-mail antes de prosseguir.
- Abra Configuração → Pacotes instalados e confirme que o REDA Pay está listado com este número de versão.
Instalar é a primeira de doze etapas. O resto está na seção seguinte.
Depois de instalar: configurar cada canal de pagamento
Siga o Roteiro de configuração: da instalação ao primeiro pagamento a partir da etapa 1. Em resumo:
| Etapa | O que faz | Guia |
|---|---|---|
| 1. Conjuntos de permissões | Dê ao administrador o REDA Pay - Admin User; depois, dê à equipe o REDA Pay - User e assim por diante. | Quem pode fazer o quê |
| 2. Chave de criptografia | Gere a chave que criptografa a sua chave de API e os identificadores do Payload. Uma vez por organização. | Gerar a chave de criptografia |
| 3. Pay Profile e chave de API | Crie o perfil, armazene a chave de API do Payload com Atualizar token de API e escolha a Versão da API do Payload, v1 ou v2. | Criar um Pay Profile · Escolher a versão da API |
| 4. Contas de processamento | Sincronize suas contas de comerciante do Payload, ative o perfil, configure cada conta (tipos de transferência, métodos, marca, taxas, configurações de links). | Sincronizar e ativar · Configurar |
| 5. Webhooks | Um site público do Salesforce que o Payload chama, o acesso do usuário convidado dele e Configurar webhooks. Na v2, um segredo de assinatura. | Configurar webhooks |
| 6. Pagamentos pela equipe | Coloque a tela de pagamento nas páginas de Lead, Contact e Account; receba um pagamento de teste. | Adicionar o REDA Pay às páginas de registro · Receber um pagamento |
| 7. Portal do cliente | Páginas, configurações dos componentes, conjunto de permissões, conjunto de compartilhamento e acesso externo padrão para um portal com login — Aura ou LWR. | Permitir que os clientes paguem no seu portal · Acesso ao portal |
| 8. Links de pagamento públicos | Páginas públicas, nomes de API exatos das páginas, o conjunto de permissões e o acesso Apex do usuário convidado, as quatro regras de compartilhamento para convidados (com a opção de registros de usuários do portal), a preferência de APIs públicas e as configurações de links da conta de processamento. | Configurar o site público · Acesso de convidados |
| 9. Pagamentos agendados e recuperação | Agende o trabalho diário e ligue a recuperação de pagamentos com falha. | Trabalho diário · Recuperação |
Atualizar a partir da 1.56 ou de um patch
- Anote qual versão a organização executa: Configuração → Pacotes instalados → REDA Pay → Número da versão.
- Atualize primeiro um sandbox. Abra o link de instalação logado no sandbox, mantenha Instalar somente para administradores, clique em Atualizar e aguarde o e-mail de confirmação.
- Conclua Depois de atualizar no sandbox, execute as verificações de Conferir que tudo funciona e depois repita as duas coisas em produção.
Seus dados, configurações, chave de criptografia, webhooks e trabalhos agendados sobrevivem ao upgrade. O procedimento completo, com o que sobrevive e o que conferir de novo, está em Atualizar o REDA Pay.
Depois de atualizar: etapas que o upgrade não pode fazer por você
Um upgrade de pacote gerenciado instala componentes novos, mas nunca altera um layout de página que você usa, nunca concede acesso aos seus próprios perfis ou conjuntos de permissões, nunca adiciona um valor a um conjunto de valores que a sua organização já tem e nunca publica de novo um site do Experience Cloud. Faça isto à mão, nesta ordem. Cada linha diz a quem se aplica.
| Etapa | Aplica-se a | O que fazer |
|---|---|---|
| 1. Adicionar os campos e a ação novos do Pay Profile aos seus layouts | Toda organização que atualiza a partir da 1.56 | Em cada layout de página de Pay Profile em uso, adicione os campos Versão da API do Payload (Payload API Version), Segredo de assinatura do webhook (Webhook Signing Secret) e Aparência do pagamento (Payment Appearance) — seção Information para o primeiro, API Setup para o segundo e External Labels para o terceiro, como no layout do pacote — e a ação Atualizar segredo do webhook (Update Webhook Secret). Etapas clique a clique: Atualizar o REDA Pay. |
| 2. Conceder as classes e a página novas aos seus próprios perfis ou conjuntos de permissões clonados | Organizações que não atribuem os conjuntos de permissões do pacote REDA Pay | Pagadores (equipe, usuários do portal, o usuário convidado do site público): classes Apex rpay.PayloadV2SecureCapture e rpay.PayloadSecureFieldsController, página do Visualforce rpay.PayloadSecureFields. Administradores: classe rpay.UpdateWebhookSecretController e acesso de edição aos três campos novos. Os conjuntos de permissões do pacote já trazem tudo isso. Etapas: Atualizar o REDA Pay. |
| 3. Dar ao usuário convidado do site de webhooks a classe de retorno v2 | Toda organização que vai usar a API v2 do Payload | No perfil de convidado do site de webhooks, ative rpay.PayloadCallbackV2 ao lado de rpay.PayloadCallback. Depois defina o perfil como v2 e execute Configurar webhooks. Etapas: Configurar webhooks. |
| 4. Publicar de novo todos os sites do Experience Cloud que hospedam telas do REDA Pay | Toda organização que atualiza a partir da 1.56001, 1.56002 ou 1.56003, e toda organização que coloca os componentes v2 | Um site LWR continua servindo o código de componentes da versão anterior até você publicá-lo de novo: abra o site no Experience Builder e clique em Publicar. Compare antes as alterações não publicadas do site, porque publicar também as coloca no ar. Publique os sites um de cada vez. |
| 5. Adicionar os valores do conjunto de valores que faltam na sua organização | Organizações que atualizam a partir da 1.56 e pagam ou recebem em reais ou pesos colombianos, ou têm endereços na Colômbia | Os valores BRL e COP (Account Currency) e CO (Country) foram adicionados depois da 1.56 e não são adicionados a uma organização existente. Adicione-os em Configuração → Conjuntos de valores de lista de opções, digitando exatamente esses nomes de API. Etapas: Atualizar o REDA Pay. |
| 6. Conferir as suas próprias cópias das páginas de registro do REDA Pay | Organizações que clonaram uma página de registro Lightning do REDA Pay | As páginas de registro do pacote agora tomam os títulos das guias de rótulos traduzíveis. Uma página que você clonou mantém os títulos que você digitou; redigite-os com os rótulos se quiser que sejam traduzidos. |
| 7. Decidir sobre Create Missing Transactions | Todas as organizações | Instalações novas recebem CREATE_MISSING_TRANSACTIONS = TRUE; um upgrade mantém o seu valor. Leia Chaves da organização e mensagens de erro e defina-o de forma deliberada. |
Conferir que tudo funciona
- Configuração → Pacotes instalados mostra o REDA Pay 1.57000.
- Abra um Pay Profile: os três campos novos e a ação Atualizar segredo do webhook estão na página.
- Como usuário da equipe que tenha só o REDA Pay - User, receba um pequeno pagamento de teste a partir de um Lead no ambiente de teste do Payload. Em um perfil v2, os dados de cartão e de banco são informados no formulário seguro e uma mensagem de progresso aparece enquanto o pagamento é executado.
- Se você usa um portal, faça login como cliente de teste (Fazer login na Experience como usuário no Contact dele) e chegue à tela de pagamento.
- Se você usa links de pagamento, crie um link de teste e abra-o em uma janela anônima do navegador: a tela de pagamento abre, e o resumo de revisão mostra o número da ordem e os valores.
- Abra a guia Configuração de webhooks do Pay Profile: dez linhas na v1, onze na v2, cada uma com um Webhook Id.
- Defina o idioma de um usuário de teste como espanhol, francês ou português (Brasil) e abra uma Pay Order: guias, campos e botões aparecem nesse idioma.
- Abra REDA Pay Logs: nenhuma entrada nova Attention Needed.
Novidades desta versão
| Mudança | O que a sua equipe vai notar | Configuração ou revisão |
|---|---|---|
| 1. API v2 do Payload, escolhida por Pay Profile | Um campo novo, Versão da API do Payload, no Pay Profile. Em branco ou v1 mantém tudo exatamente como antes. v2 muda esse perfil para a API atual do Payload: os mesmos botões, agendamentos e relatórios, com as telas novas abaixo. v1 e v2 compartilham registros, identificadores e a chave de API, então a mudança não move dados e pode ser revertida. | Coloque o campo nos seus layouts; defina-o como v2 quando estiver pronto; execute Configurar webhooks. Escolher a versão da API do Payload |
| 2. Dados de cartão e de banco informados no formulário seguro do Payload | Em um perfil v2, o número do cartão, o código de segurança e o número da conta são digitados em um formulário que o Payload serve dentro da tela de pagamento. Eles nunca passam pelo Salesforce. Se uma extensão do navegador o bloqueia, a tela avisa depois de dez segundos. | Nada a configurar. Se os seus próprios perfis ou conjuntos de permissões estão em uso, conceda a página e as classes na etapa 2. |
| 3. Telas novas de pagamento e de método de pagamento, para todo tipo de site | Seis componentes — REDA Pay - New Pay Order (v2), Pay Order Request (v2), Pay Order Result (v2), New Pay Method (v2), Pay Method Request (v2), Pay Method Result (v2) — com as mesmas configurações, parâmetros de URL, validações e regras de botões das telas clássicas, em um layout pensado para celular com blocos de métodos e um cartão de resultado. Podem ser colocados em sites LWR, o que as telas clássicas não podem. Dentro do Salesforce, o botão de pagamento clássico abre sozinho a tela v2 quando o perfil está na v2. | Portais e sites públicos na v2: coloque os componentes v2 e defina os nomes das páginas exatamente. Portal · Links públicos · Configurações de componentes |
| 4. Webhooks assinados e a ação Atualizar segredo do webhook | Na v2, o Payload assina cada entrega de webhook com um segredo que você define por Atualizar segredo do webhook no Pay Profile, e o REDA Pay verifica a assinatura. Configurar webhooks em um perfil v2 remove só os webhooks desse perfil e registra onze (os dez da v1, com credit substituído por payout e withdraw adicionado). | Adicione a ação aos seus layouts; ative rpay.PayloadCallbackV2 para o usuário convidado do site de webhooks. Configurar webhooks |
| 5. Aparência do pagamento | As telas v2 seguem o tema do seu Salesforce ou do seu site por padrão. Um campo novo, Aparência do pagamento, no Pay Profile, e as configurações Brand Colour, Text Colour, Background Colour e Font Family nos componentes v2 permitem definir as suas próprias cores e fonte. | Opcional. Personalizar a tela de pagamento com a sua marca |
| 6. Mensagens de progresso | Enquanto um pagamento v2 é executado, a tela mostra o que está fazendo — Preparando o pagamento…, Protegendo seus dados de pagamento…, Preparando seu pagamento…, Processando seu pagamento… Isso pode levar alguns segundos. Mantenha esta janela aberta. — em vez de um indicador giratório. As telas de método fazem o mesmo. | Nada. |
| 7. Espanhol, francês e português (Brasil) | Todo rótulo, campo, texto de ajuda, valor de lista de opções, seção de layout, mensagem de validação, guia e botão do REDA Pay está traduzido. Um usuário cujo idioma é um desses vê o REDA Pay nele. | Confira o Idioma do usuário no registro de usuário. As traduções se aplicam às páginas do pacote; uma página de registro que você clonou mantém os seus títulos (etapa 6). |
| 8. Criar link sempre oferecido | O botão Criar link não desaparece mais quando uma conta de processamento não está configurada para links. Clicar nele então mostra: "Os links de pagamento não estão configurados para esta conta de processamento: o campo URL pública do site de links está vazio. Peça ao seu administrador que o preencha." | Preencha URL pública do site de links nas contas que emitem links. Configurar o site público |
| 9. Refund e Void explicam a liquidação | Em um perfil v2, Refund em um pagamento não liquidado fecha com: "Este pagamento ainda não foi liquidado e não pode ser reembolsado. Cancele-o ou reembolse-o depois que for liquidado (normalmente até o fim do dia útil)." Void em um pagamento liquidado diz: "Este pagamento já foi liquidado e não pode mais ser cancelado. Reembolse-o." (v1 e v2). | Avise a sua mesa de reembolsos. Cancelar ou reembolsar um pagamento |
| 10. Todo o texto das telas vem de rótulos traduzíveis | Toda mensagem, botão e título de guia das telas clássicas e v2, das páginas de registro e dos fluxos do REDA Pay vem de um rótulo. Tags técnicas como "[Transfer Type]" não aparecem mais nas mensagens, e as telas dos fluxos não mostram mais um nome interno como título. | Nada. |
| 11. Nomes de fluxo mais simples | Os fluxos do pacote têm nomes e descrições simples, então um administrador que abre Configuração → Fluxos vê o que cada um faz. | Se você substitui um fluxo do REDA Pay, compare-o com a versão nova. |
| 12. Create Missing Transactions ligado por padrão em instalações novas | Uma instalação nova concilia depósitos mesmo quando falta uma Pay Transaction no Salesforce, criando-a. Upgrades mantêm a sua configuração atual. | Etapa 7. |
Corrigido nesta versão
| Correção | O que estava errado | Agora |
|---|---|---|
| Os outros links de um cliente continuam abertos | Quando um dos links de pagamento de um cliente era pago, revogado ou expirava, os outros links abertos do cliente podiam parar de abrir ("Invalid request: Bad request Parameters."). | Os outros links continuam funcionando. Um cliente afetado antes do upgrade é reparado na próxima vez que uma das ordens de link abertas dele é salva. |
| Formulário seguro em sites LWR | Em um site LWR, o formulário v2 de cartão e banco não conseguia carregar (lançado na 1.56001, corrigido na 1.56002). | O formulário carrega em sites LWR e Aura e dentro do Salesforce. |
| Resumo de revisão em sites LWR | O número da ordem e os valores do resumo de revisão v2 quebravam um caractere por linha em um site LWR. | Eles aparecem normalmente. |
| Páginas de resultado | As páginas de resultado v2 mostravam a caixa de mensagem clássica em vez do cartão de resultado que a tela de pagamento mostra. | Elas mostram o mesmo cartão de resultado. |
Campos, ações e componentes novos, e quem pode vê-los
Os três campos novos estão em Pay Profile. Os conjuntos de permissões do pacote que leem Pay Profile os leem; o REDA Pay - Admin User os edita. Se você usa os próprios perfis ou conjuntos de permissões, conceda o acesso você mesmo (Depois de atualizar, etapa 2).
| Campo ou ação | Onde no layout do pacote | Quem informa | Para que serve |
|---|---|---|---|
| Versão da API do Payload (lista de opções: v1, v2) | Seção Information | Administrador | Em branco ou v1: como antes. v2: este perfil usa a API v2 do Payload. Execute Configurar webhooks depois de alterar. |
| Segredo de assinatura do webhook | Seção API Setup | Ninguém digita: definido pela ação Atualizar segredo do webhook | Até 64 caracteres que o Payload usa para assinar as entregas de webhook v2. Em branco: as entregas são aceitas sem verificação de assinatura. |
| Aparência do pagamento | Seção External Labels | Administrador, opcional | Cores e fonte das telas v2, por exemplo {"brandColor":"#006B63"}. Em branco: o tema do ambiente. |
| Atualizar segredo do webhook (ação) | Ações do Pay Profile, ao lado de Atualizar token de API | Administrador | Abre uma caixa para definir o segredo de assinatura; depois execute Configurar webhooks. |
| Seis componentes v2 | Lightning App Builder e Experience Builder, em Personalizado - Gerenciado, chamados REDA Pay - … (v2) | O administrador os coloca | As telas v2 de pagamento e de método de pagamento para páginas e sites. Referência das configurações de componentes |
Nenhum objeto, guia, conjunto de permissões ou página de registro novo é adicionado. Os valores de conjunto de valores BRL, COP e CO são novos para organizações que atualizam a partir da 1.56 (etapa 5).