Roteiro de configuração: da instalação ao primeiro pagamento
Esta página é o mapa. Ela lista cada etapa de configuração na ordem em que o REDA Pay precisa delas, explica por que cada uma importa e aponta para o artigo que a detalha. As etapas 1 a 8 levam ao primeiro pagamento recebido pela sua equipe dentro do Salesforce. As etapas 9 a 12 acrescentam os outros canais e os trabalhos em segundo plano.
- O REDA Pay está instalado na sua organização (Configuração → Pacotes instalados lista o REDA Pay). O executivo de contas da REDA ou support@reda.one fornece o link de instalação da sua edição.
- Você tem uma conta na Payload e consegue entrar no painel dela para copiar uma chave de API.
- Você tem o conjunto de permissões REDA Pay - Admin User; consulte Quem pode fazer o quê.
Parte 1: conectar o Salesforce à Payload
1. Gerar a chave de criptografia
O REDA Pay criptografa todos os segredos que armazena (sua chave de API da Payload, os identificadores da Payload, os identificadores dos links de pagamento) com uma chave que existe apenas na sua organização. Enquanto a chave não existir, o REDA Pay não funciona e mostra "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator."
Abra o aplicativo REDA Pay → guia REDA Pay Admin → Encryption Key Setup → Generate Key. A chave pode ser gerada uma única vez; depois, o botão mostra Generated. → Gerar a chave de criptografia
A guia REDA Pay Admin. A etapa 1 acontece no primeiro cartão; a etapa 11, no segundo.
2. Criar um Pay Profile e armazenar a chave de API da Payload
Um Pay Profile conecta o Salesforce a uma conta da Payload. Crie-o na guia Pay Profiles com um nome, um Pay Profile Code único e Provider = Payload, deixando Is Active desmarcado. Depois pressione Update API Token no perfil e cole a chave de API do seu painel da Payload. Nunca digite a chave diretamente no campo API Token: é o botão que a criptografa. → Criar um Pay Profile e armazenar sua chave de API da Payload
3. Sincronizar as contas de processamento e ativar o perfil
Pressione Sync Processing Accounts no Pay Profile. O REDA Pay lê suas contas de estabelecimento na Payload, cria uma Processing Account para cada uma e preenche o Profile Id do perfil. Agora marque Is Active no perfil: o REDA Pay se recusa a ativar um perfil que não tenha o token de API e o Profile Id. → Sincronizar as contas de processamento e ativar o perfil
Parte 2: decidir como o dinheiro se movimenta
4. Configurar cada conta de processamento
Abra cada Processing Account e defina pelo menos Is Active, Allowed Transfer Type (Receipt, Disbursement ou Receipt and Disbursement) e Allowed Pay Methods (Card, Bank Account (ACH) ou ambos). Um Allowed Pay Methods em branco significa que nenhum método de pagamento pode ser usado. Aproveite para definir o logotipo, o cabeçalho e o rodapé que seus pagadores verão, além da guia padrão (cartão ou banco). De volta ao Pay Profile, escolha uma Default Processing Account para que a equipe não precise escolher uma toda vez. → Configurar uma conta de processamento · Personalizar a tela de pagamento com a sua marca
5. Adicionar taxas de conveniência (opcional)
Se você repassa os custos de processamento aos pagadores, adicione registros Fee Setup abaixo da Processing Account: um para pagamentos bancários e um para todos os cartões ou para cada bandeira. Sem Fee Setup, as ordens não têm taxa. → Configurar taxas de conveniência
6. Verificar como os clientes são criados
Na primeira vez em que alguém paga a partir de uma conta, um contato ou um lead, o REDA Pay cria um Pay Customer a partir dele, usando registros de mapeamento que vêm com o pacote para esses três objetos. Revise-os antes da entrada em produção: eles definem o nome, o email, o telefone e os métodos de pagamento permitidos do cliente. → Como os Pay Customers são criados
Parte 3: permitir que a sua equipe receba pagamentos
7. Atribuir conjuntos de permissões
Dê aos administradores o REDA Pay - Admin User, à equipe o REDA Pay - User, à equipe de reembolsos o REDA Pay - Transaction Manager e ao financeiro o REDA Pay - Reconciliation Manager com o REDA Pay - Read Only User. Se alguém for enviar repasses, marque REDA Pay - Enable Disbursements no registro de usuário dessa pessoa. → Quem pode fazer o quê: conjuntos de permissões
8. Colocar a tela de pagamento onde a equipe trabalha
Adicione o componente de pagamento do REDA Pay ou um botão de pagamento às páginas de registro que sua equipe usa, normalmente lead, contato e conta. Depois faça um pagamento de teste pequeno. → Adicionar o REDA Pay às páginas de registro · Receber um pagamento
A partir daqui a equipe já pode receber pagamentos. Os status só serão atualizados automaticamente depois que você concluir a etapa 9.
Parte 4: automação e outros canais
9. Configurar os webhooks
A Payload avisa o Salesforce quando um pagamento é processado, recusado, reembolsado ou rejeitado, e quando os depósitos chegam ao seu banco. Para isso, a Payload precisa de um endereço público do Salesforce para chamar. Crie (ou reutilize) um site público, dê ao usuário convidado dele acesso à chamada de retorno do REDA Pay, informe o endereço do site em Webhook API Base URL no Pay Profile e pressione Setup Webhooks. O Setup Webhooks primeiro exclui todos os webhooks registrados com essa chave de API da Payload: se a mesma chave atende outro sistema, leia o artigo antes de pressioná-lo. → Configurar webhooks
10. Links de pagamento e o seu portal de clientes
- Os links de pagamento precisam de um site público com as páginas do REDA Pay, do conjunto de permissões REDA Pay - Public Site User para o usuário convidado e de duas configurações na Processing Account: Link Site Public URL e Link Expiration (Minutes). Preencha as duas: um link criado enquanto o Link Expiration está em branco nunca fica ativo. → Configurar o site público de links de pagamento · Acesso de convidados aos links de pagamento: permissões e compartilhamento
- Os pagamentos no portal precisam das páginas do REDA Pay no seu portal do Experience Cloud e do REDA Pay - Community User para os usuários do portal. → Permitir que os clientes paguem no seu portal · Acesso ao portal: permissões e compartilhamento para clientes
11. Ativar os trabalhos em segundo plano
- Os pagamentos recorrentes só são executados se o trabalho diário estiver agendado: Configuração → Classes do Apex → Agendar Apex, classe
SchedulePayOrderJob, todos os dias. → Agendar o trabalho diário de pagamentos recorrentes - A recuperação de pagamentos com falha verifica a cada 15 minutos os pagamentos cujo resultado ficou desconhecido porque a conexão com a Payload caiu. Ative a chave Sync Failed Pay Order Transactions na guia REDA Pay Admin. → Ativar a recuperação de pagamentos com falha
12. Preparar para produção
- Desative o detalhe técnico nos erros exibidos na tela, para que os pagadores vejam uma mensagem simples e não um rastreamento de pilha. → Chaves da organização e mensagens de erro
- Teste com cada função, não como administrador: alguém da equipe, um cliente do portal e um pagador anônimo abrindo um link.
Checklist
| # | Etapa | Concluída quando |
|---|---|---|
| 1 | Chave de criptografia | O botão da guia Admin mostra Generated |
| 2 | Pay Profile + chave de API | O perfil existe e o Update API Token foi bem-sucedido |
| 3 | Sincronizar + ativar | As Processing Accounts aparecem abaixo do perfil e Is Active está marcado |
| 4 | Contas de processamento | Cada conta ativa tem os tipos de transferência e os métodos de pagamento definidos |
| 5 | Taxas (opcional) | Existem Fee Setups para os métodos em que você cobra taxa |
| 6 | Mapeamento de clientes | Registros de mapeamento revisados para conta, contato e lead |
| 7 | Conjuntos de permissões | Cada usuário tem o conjunto certo; quem faz repasses tem Enable Disbursements |
| 8 | Páginas de registro | Um pagamento de teste a partir de um lead mostra uma Pay Transaction processada |
| 9 | Webhooks | A guia Webhook Setup do perfil lista os webhooks registrados |
| 10 | Links / portal | Um link de teste abre no seu site público; um usuário do portal consegue pagar |
| 11 | Trabalhos | O trabalho diário aparece em Configuração → Trabalhos agendados; a chave de recuperação está ativada |
| 12 | Produção | Rastreamento de pilha desativado; cada função testada |
Perguntas frequentes
Sim. O pagamento é processado e registrado. As alterações posteriores (um pagamento bancário rejeitado dias depois, um depósito chegando ao seu banco) só chegam ao Salesforce depois que os webhooks estiverem configurados, ou quando alguém pressionar Sync Transaction.
Não. O REDA Pay inclui a configuração de site remoto de que precisa para a API da Payload.
Não. Ela é gerada uma única vez por organização, e tudo o que o REDA Pay criptografa depende dela.
O que vem a seguir
- Gerar a chave de criptografia: a etapa 1.
- Conceitos-chave e terminologia: se algum termo acima não for familiar.