Adicionar o REDA Pay às páginas de registro: o botão Pay
A equipe recebe pagamentos a partir dos registros com que já trabalha: um lead que se candidata a uma unidade, um contato que paga uma caução, uma conta que quita uma fatura. O REDA Pay oferece três maneiras de abrir a tela de pagamento a partir de uma página de registro, e você escolhe por objeto. Cada ponto de entrada pode predefinir o perfil, a conta, os métodos e os botões que a tela oferece, para que o botão da equipe de locação e o botão do atendimento a proprietários se comportem de forma diferente.
- O Pay Profile e a Processing Account estão configurados e ativos; consulte o Roteiro de configuração.
- Você tem a permissão do Salesforce para editar páginas do Lightning (um administrador do sistema tem) e o REDA Pay - Admin User.
- A equipe que vai usar o botão tem o REDA Pay - User.
Escolher um ponto de entrada
| Ponto de entrada | O que é | Escolha quando |
|---|---|---|
| Componente PayButton | Um botão na página de registro que abre a tela de pagamento em página inteira, levando o Id do registro | Você quer um botão claro e talvez predefinir opções pelo endereço que ele abre |
| Componente NewPayOrder | A própria tela de pagamento, colocada na página de registro ou em uma guia | Você quer a tela integrada à página, com as opções definidas no Criador de aplicativo Lightning |
| Um botão personalizado ou uma ação rápida que abre o endereço da tela | O seu próprio botão, criado no Gerenciador de objetos, apontando para o endereço da tela de pagamento com parâmetros | Você já gerencia botões assim, ou precisa da tela como ação rápida |
Os três abrem a mesma tela e as mesmas regras se aplicam. A diferença é só onde ficam as configurações.
Opção 1: o botão Pay
- Abra um registro do objeto, por exemplo um lead, clique no ícone de engrenagem e escolha Editar página. O Criador de aplicativo Lightning abre.
- Na lista de componentes, em Personalizado - Gerenciado, encontre PayButton e arraste-o para onde quer o botão: o topo da página ou uma guia.
- Defina as propriedades:
| Propriedade | Informe |
|---|---|
| Button Label | O que a equipe lê, por exemplo Receive Payment |
| Button URL | O endereço da tela de pagamento: /lightning/cmp/rpay__NewPayOrder, seguido opcionalmente de ? e de parâmetros que fixam o perfil, a conta, os métodos ou os botões (veja abaixo) |
| Button Variant | O estilo de botão do Salesforce: brand para um botão principal azul, neutral para um simples e assim por diante |
- Salve e ative a página para a organização, o aplicativo ou os perfis que devem vê-la.
Ao ser pressionado, o botão acrescenta o Id do registro ao endereço (rpay__rid=<Id>) e abre a tela. O registro passa a ser o registro pai do pagamento: o REDA Pay encontra ou cria o Pay Customer dele e vincula a Pay Order a ele.
Um botão Pay em um lead. Um clique abre a tela de pagamento para esse lead.
Predefinir a tela pelo endereço
Acrescente parâmetros ao Button URL para decidir o que a tela oferece. Exemplos:
| Button URL | Efeito |
|---|---|
/lightning/cmp/rpay__NewPayOrder | Tudo o que o usuário, o cliente e a conta permitem |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt | Só recebimentos: sem a pergunta de desembolso |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt&rpay__bank=0 | Recebimentos só por cartão |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt&rpay__nosch=1&rpay__nolnk=1 | Só pagar agora: sem os botões Schedule e Create Link |
/lightning/cmp/rpay__NewPayOrder?rpay__ppid=<Id do Pay Profile>&rpay__pid=<Id da Processing Account> | Pula as perguntas de perfil e de conta |
/lightning/cmp/rpay__NewPayOrder?rpay__amount=250&rpay__fixamt=1&rpay__cnotes=Application%20fee | Um valor fixo de $250 com uma observação: um botão de taxa de candidatura |
A lista completa está na Referência de parâmetros de URL. Os valores no endereço prevalecem sobre as configurações do próprio componente.
Opção 2: a tela de pagamento na página
- No Criador de aplicativo Lightning da página de registro, arraste NewPayOrder (em Personalizado - Gerenciado) para a página, normalmente para uma guia própria, como Payments, porque a tela precisa de largura.
- Defina as propriedades no painel da direita: quais tipos de transferência, métodos e botões permitir, se os perfis e as contas devem ser limitados por código, as chaves de EMD e de taxa, e até quatro atributos a gravar na ordem. Cada propriedade é explicada na Referência das configurações de componentes. Deixe Is Portal desmarcado nas páginas internas.
- Salve e ative a página.
A tela abre assim que a guia aparece e deduz o perfil, o cliente e a conta a partir do registro.
Opção 3: um botão personalizado ou uma ação rápida
Se a sua equipe prefere botões do Gerenciador de objetos:
- Configuração → Gerenciador de objetos → Lead → Botões, links e ações → Novo botão ou link.
- Escolha Detail Page Button (botão da página de detalhes), comportamento Display in existing window (exibir na janela atual), origem do conteúdo URL e a fórmula
/lightning/cmp/rpay__NewPayOrder?rpay__rid={!Lead.Id}com os parâmetros que quiser. - Acrescente o botão ao layout de página.
Uma ação rápida do tipo Lightning Component (componente Lightning) também pode hospedar o NewPayOrder; ela abre a primeira etapa em uma janela, e a tela de pagamento abre depois em página inteira.
Quais objetos cobrir
| Objeto | Uso típico | Endereço sugerido |
|---|---|---|
| Lead | Taxas de candidatura, depósitos de reserva | Só recebimentos |
| Contato | Aluguel, cauções e taxas de um morador | Só recebimentos |
| Conta | Faturas de uma empresa; repasses a um fornecedor ou proprietário | Recebimentos e desembolsos; a chave do próprio usuário decide o que ele pode fazer |
| Oportunidade | Sinais em uma venda | Acrescente rpay__oppid={!Opportunity.Id} junto com o rpay__rid do contato ou da conta, para que a ordem fique vinculada à oportunidade |
O registro pai precisa ser uma conta, um contato ou um lead: os objetos que o REDA Pay sabe transformar em Pay Customer. Para uma oportunidade, o botão passa o contato ou a conta relacionados como registro pai e a oportunidade como vínculo.
Erros comuns a evitar
| Erro | O que acontece | Solução |
|---|---|---|
| Button URL sem a barra inicial | O endereço não é resolvido | Comece com /lightning/cmp/ |
| Procurar o componente pelo nome do produto | O Criador de aplicativo Lightning lista os componentes gerenciados pelos nomes: PayButton, NewPayOrder | Procure em Personalizado - Gerenciado |
| Colocar o botão Pay em um objeto que não seja conta, contato ou lead | "Bad Request. Parent record not found." ou "Transaction not allowed for SObject: …" | Passe um Id de conta, contato ou lead com rpay__rid |
| Página ativada para o aplicativo errado | A equipe não vê o botão | Confira a ativação (padrão da organização, padrão do aplicativo, ou aplicativo e perfil) |
| Equipe sem o REDA Pay - User | A tela não carrega | Atribua o conjunto de permissões |
Perguntas frequentes
Sim: por exemplo, Collect Application Fee com valor fixo e Receive Payment sem. Cada um é um componente PayButton próprio, com o seu próprio endereço.
Teste-o nos dispositivos que a sua equipe usa antes de depender dele; a tela de pagamento foi projetada para uma janela de navegador.
Não. Os rótulos da tela são fixos; o rótulo de botão que você define vale só para o botão Pay na página.
O que vem a seguir
- Receber um pagamento: o que acontece depois que o botão é pressionado.
- Referência das configurações de componentes
- Referência de parâmetros de URL