Referência das configurações de componentes
O REDA Pay inclui alguns componentes que você coloca nas páginas: a entrada de pagamento (NewPayOrder), a entrada de salvar método (NewPayMethod), as segundas telas que cada uma abre, as páginas de resultado para portais e um PayButton. Cada um expõe configurações no painel da direita do Criador de aplicativo Lightning (páginas internas) ou do Experience Builder (páginas de portal e públicas). Esta página lista todas as configurações. Para saber como colocar um componente, consulte Adicionar o REDA Pay às páginas de registro e Permitir que os clientes paguem no seu portal.
Os componentes aparecem em Personalizado - Gerenciado na lista de componentes, pelo nome.
Como as configurações se combinam
Uma configuração em um componente só pode estreitar o que a Processing Account e o Pay Customer permitem; ela não pode ampliar. Os valores passados no endereço da página (consulte a Referência de parâmetros de URL) prevalecem sobre as configurações do componente. Assim, para qualquer opção:
o que a tela oferece = regras da conta ∩ regras do cliente ∩ configurações do componente, prevalecendo os parâmetros de URLNewPayOrder: a entrada de pagamento
| Configuração | Padrão | Efeito |
|---|---|---|
| Enable Scheduling Order | ativado | Mostra o botão Schedule |
| Enable Order Link | ativado | Mostra o botão Create Link |
| Limit Profile Selection | em branco | Pay Profile Codes separados por vírgula. Em branco: todos os perfis ativos que o usuário pode ver. Um código: esse perfil é usado sem perguntar |
| Limit Processing Account Selection | em branco | Processing Account Codes separados por vírgula, mesma regra |
| Allow Pay Method Type - Card | ativado | Oferece a guia Card, se a conta e o cliente permitirem cartões |
| Allow Pay Method Type - Bank Account | ativado | Oferece a guia Bank, com a mesma condição |
| Allow Transfer Type - Receipt (Cash-In) | ativado | Permite recebimentos a partir desta página |
| Allow Transfer Type - Disbursement (Cash-Out) | ativado | Permite desembolsos a partir desta página (o usuário ainda precisa do Enable Disbursements) |
| Disable EMD Payments | desativado | Oculta a chave Earnest Money Deposit |
| Do NOT Charge Convenience Fee | desativado | As ordens desta página não têm taxa de conveniência |
| Attribute 1 … Attribute 4 | em branco | Texto copiado para toda ordem criada a partir desta página, para as suas automações e relatórios |
| Customer Notes | em branco | Pensado para mostrar uma observação na tela. Nesta versão a configuração não tem efeito; passe a observação com o parâmetro de URL rpay__cnotes |
| Is Portal | desativado | Marque em páginas do Experience Cloud. Muda o componente para a navegação e a identificação de registros do portal |
| Portal Record Identifier | User-Contact | Em um portal: se o Contact ou a Account do usuário conectado é o registro pai do pagamento |
| Portal Payment Page | em branco | Nome de API da página do portal que contém o NewPayOrderRequest |
| Portal Success Page | em branco | Nome de API da página que contém o NewPayOrderResult para sucesso |
| Portal Error Page | em branco | Nome de API da página que contém o NewPayOrderResult para erros |
| Portal Return URL | em branco | Para onde vão o Cancel e o Cancel da revisão em um portal; pode ser qualquer endereço, inclusive o seu site |
| Skip Geo-Location Capture | desativado | Não pede a localização ao navegador (não combine com uma conta que a exija) |
O painel de configurações. Cada linha aqui é explicada na tabela acima.
NewPayOrderRequest: a tela de pagamento
Sem configurações. Coloque-o na página do portal indicada em Portal Payment Page. Internamente, ele abre sozinho.
NewPayOrderResult: a página de resultado do portal
| Configuração | Efeito |
|---|---|
| Is Success (uma única caixa de seleção) | Marque na página indicada em Portal Success Page; deixe desmarcada na página indicada em Portal Error Page. O componente mostra "Success — Your order is successfully processed. Order Reference: P-000000" ou "Error — Error encountered while processing order. Error Log: …", conforme o caso |
NewPayMethod: a entrada de salvar método
| Configuração | Padrão | Efeito |
|---|---|---|
| Limit Profile Selection | em branco | Pay Profile Codes separados por vírgula, como acima |
| Default Pay Method | ativado | O método salvo se torna o padrão do cliente |
| Allow Pay Method Type - Card | ativado | Oferece cartões |
| Allow Pay Method Type - Bank Account | ativado | Oferece contas bancárias |
| Allow Transfer Type - Receipt (Cash-In) | ativado | O método pode ser usado para recebimentos |
| Allow Transfer Type - Disbursement (Cash-Out) | ativado | O método pode ser usado para desembolsos |
| Customer Notes | em branco | Igual ao acima: sem efeito nesta versão; use rpay__cnotes |
| Is Portal, Portal Record Identifier | desativado, User-Contact | Como no NewPayOrder |
| Portal Method Input Page | em branco | Nome de API da página do portal que contém o NewPayMethodRequest |
| Portal Success Page, Portal Error Page, Portal Return URL | em branco | Como no NewPayOrder, com o NewPayMethodResult nas páginas de resultado |
| Default Currency | — | USD ou CAD, preenchida como moeda de uma conta bancária nova |
NewPayMethodRequest e NewPayMethodResult
O NewPayMethodRequest não tem configurações. O NewPayMethodResult tem a mesma caixa de seleção única do NewPayOrderResult e mostra "Your payment method is successfully processed." ou "Error encountered while processing payment method. Error Log: …".
PayButton: um botão que abre um endereço
| Configuração | Obrigatória | Efeito |
|---|---|---|
| Button Label | sim | O texto do botão |
| Button URL | sim | O endereço a abrir. Em uma página de registro, o Id do registro é acrescentado como rpay__rid=<Id> |
| Button Variant | sim | Estilo de botão do Salesforce: base, neutral, brand, brand-outline, destructive, destructive-text, inverse, success |
RedirectToURL: para fluxos de tela
Um componente pequeno para os seus próprios fluxos de tela, com uma configuração, Navigation URL: quando o fluxo chega a ele, navega para esse endereço. O fluxo Add Pay Method do REDA Pay o usa para abrir a tela de salvar método.
Configurações típicas
| Página | Configurações |
|---|---|
| Página de lead da equipe, taxas de candidatura por cartão | Allow Bank desativado; Enable Scheduling Order desativado; Enable Order Link desativado |
| Página de conta da equipe, recebimentos e repasses | Padrões |
| Página de pagamento do portal de moradores, só banco | Is Portal ativado; Portal Record Identifier User-Contact; Allow Card desativado; Enable Order Link desativado; Portal Payment Page, Success Page, Error Page e Return URL definidos |
| Página pública de links de pagamento | Is Portal ativado; Portal Payment Page, Success Page, Error Page e Return URL definidos. Os links levam as suas próprias restrições de método e de taxa |
| Página do portal para salvar método | Is Portal ativado; Portal Method Input Page, Success Page, Error Page e Return URL definidos |
Erros comuns a evitar
| Erro | O que acontece | Solução |
|---|---|---|
| Is Portal desativado em uma página de portal | A navegação depois da primeira etapa falha ou volta para o lugar errado | Marque Is Portal e defina as páginas do portal |
| Nomes de páginas do portal digitados como rótulos | O REDA Pay não encontra a página | Use o nome de API da página, nas propriedades de página do Experience Builder |
| Allow Card e Allow Bank desativados | A tela não tem guias | Permita pelo menos um |
| Esperar que o Customer Notes apareça | Nada aparece | Use rpay__cnotes no endereço |
| Limitar perfis pelo nome em vez do código | Nenhum perfil corresponde | Use o Code do Pay Profile |