Referencia de configuración de componentes
REDA Pay incluye unos pocos componentes que colocas en las páginas: la entrada de pago (NewPayOrder), la entrada para guardar métodos (NewPayMethod), las segundas pantallas que abre cada una, las páginas de resultado para los portales y un PayButton. Cada uno muestra sus ajustes en el panel derecho del Generador de aplicaciones Lightning (páginas internas) o de Experience Builder (páginas del portal y públicas). Esta página enumera todos los ajustes. Para saber cómo colocar un componente, consulta Agregar REDA Pay a las páginas de registro y Permitir que los clientes paguen en tu portal.
Los componentes aparecen en Personalizado - Gestionado en la lista de componentes, por su nombre. Los nombres de los ajustes están en inglés, porque REDA Pay no incluye traducciones.
Cómo se combinan los ajustes
Un ajuste de un componente solo puede estrechar lo que permiten la Processing Account y el Pay Customer; no puede ampliarlo. Los valores que se pasan en la dirección de la página (consulta Referencia de parámetros de URL) tienen prioridad sobre los ajustes del componente. Así, para cualquier opción:
lo que ofrece la pantalla = reglas de la cuenta ∩ reglas del cliente ∩ ajustes del componente, reemplazados por los parámetros de URLNewPayOrder: la entrada de pago
| Ajuste | Predeterminado | Efecto |
|---|---|---|
| Enable Scheduling Order | activado | Muestra el botón Schedule |
| Enable Order Link | activado | Muestra el botón Create Link |
| Limit Profile Selection | vacío | Pay Profile Codes separados por comas. Vacío: todos los perfiles activos que el usuario puede ver. Un código: ese perfil se usa sin preguntar |
| Limit Processing Account Selection | vacío | Processing Account Codes separados por comas, con la misma regla |
| Allow Pay Method Type - Card | activado | Ofrece la pestaña Card, si la cuenta y el cliente permiten tarjetas |
| Allow Pay Method Type - Bank Account | activado | Ofrece la pestaña Bank, con la misma condición |
| Allow Transfer Type - Receipt (Cash-In) | activado | Permite cobros desde esta página |
| Allow Transfer Type - Disbursement (Cash-Out) | activado | Permite desembolsos desde esta página (el usuario sigue necesitando Enable Disbursements) |
| Disable EMD Payments | desactivado | Oculta el interruptor Earnest Money Deposit |
| Do NOT Charge Convenience Fee | desactivado | Las órdenes de esta página no llevan comisión por conveniencia |
| Attribute 1 … Attribute 4 | vacío | Texto que se copia en cada orden creada desde esta página, para tus propias automatizaciones e informes |
| Customer Notes | vacío | Pensado para mostrar una nota en la pantalla. En esta versión el ajuste no tiene efecto; pasa la nota con el parámetro de URL rpay__cnotes |
| Is Portal | desactivado | Márcalo en las páginas de Experience Cloud. Cambia el componente a la navegación y la resolución de registros del portal |
| Portal Record Identifier | User-Contact | En un portal: si el registro principal del pago es el contacto o la cuenta del usuario que inició sesión |
| Portal Payment Page | vacío | Nombre de API de la página del portal que tiene NewPayOrderRequest |
| Portal Success Page | vacío | Nombre de API de la página que tiene NewPayOrderResult para los casos de éxito |
| Portal Error Page | vacío | Nombre de API de la página que tiene NewPayOrderResult para los errores |
| Portal Return URL | vacío | Adónde llevan Cancel y el Cancel de la revisión en un portal; puede ser cualquier dirección, incluido tu propio sitio web |
| Skip Geo-Location Capture | desactivado | No pide la ubicación al navegador (no lo combines con una cuenta que la exige) |
El panel de ajustes. Cada línea se explica en la tabla anterior.
NewPayOrderRequest: la pantalla de pago
No tiene ajustes. Colócalo en la página del portal indicada en Portal Payment Page. En las páginas internas se abre solo.
NewPayOrderResult: la página de resultado del portal
| Ajuste | Efecto |
|---|---|
| Is Success (una sola casilla) | Márcalo en la página indicada en Portal Success Page; déjalo sin marcar en la página indicada en Portal Error Page. El componente muestra "Success — Your order is successfully processed. Order Reference: P-000000" o "Error — Error encountered while processing order. Error Log: …" según corresponda |
NewPayMethod: la entrada para guardar métodos
| Ajuste | Predeterminado | Efecto |
|---|---|---|
| Limit Profile Selection | vacío | Pay Profile Codes separados por comas, como arriba |
| Default Pay Method | activado | El método guardado pasa a ser el predeterminado del cliente |
| Allow Pay Method Type - Card | activado | Ofrece tarjetas |
| Allow Pay Method Type - Bank Account | activado | Ofrece cuentas bancarias |
| Allow Transfer Type - Receipt (Cash-In) | activado | El método puede usarse para cobros |
| Allow Transfer Type - Disbursement (Cash-Out) | activado | El método puede usarse para desembolsos |
| Customer Notes | vacío | Igual que arriba: sin efecto en esta versión; usa rpay__cnotes |
| Is Portal, Portal Record Identifier | desactivado, User-Contact | Como en NewPayOrder |
| Portal Method Input Page | vacío | Nombre de API de la página del portal que tiene NewPayMethodRequest |
| Portal Success Page, Portal Error Page, Portal Return URL | vacío | Como en NewPayOrder, con NewPayMethodResult en las páginas de resultado |
| Default Currency | — | USD o CAD, que se completa como moneda de una cuenta bancaria nueva |
NewPayMethodRequest y NewPayMethodResult
NewPayMethodRequest no tiene ajustes. NewPayMethodResult tiene la misma casilla única que NewPayOrderResult y muestra "Your payment method is successfully processed." o "Error encountered while processing payment method. Error Log: …".
PayButton: un botón que abre una dirección
| Ajuste | Obligatorio | Efecto |
|---|---|---|
| Button Label | sí | El texto del botón |
| Button URL | sí | La dirección que se abre. En una página de registro, se agrega el Id del registro como rpay__rid=<Id> |
| Button Variant | sí | Estilo de botón de Salesforce: base, neutral, brand, brand-outline, destructive, destructive-text, inverse, success |
RedirectToURL: para flujos de pantalla
Un componente pequeño para tus propios flujos de pantalla con un solo ajuste, Navigation URL: cuando el flujo llega a él, navega a esa dirección. El flujo Add Pay Method de REDA Pay lo usa para abrir la pantalla para guardar métodos.
Configuraciones habituales
| Página | Ajustes |
|---|---|
| Página de prospecto del personal, cuotas de solicitud con tarjeta | Allow Bank desactivado; Enable Scheduling Order desactivado; Enable Order Link desactivado |
| Página de cuenta del personal, cobros y pagos salientes | Valores predeterminados |
| Página de pago del portal de residentes, solo cuenta bancaria | Is Portal activado; Portal Record Identifier User-Contact; Allow Card desactivado; Enable Order Link desactivado; Portal Payment Page, Success Page, Error Page y Return URL definidos |
| Página pública de enlaces de pago | Is Portal activado; Portal Payment Page, Success Page, Error Page y Return URL definidos. Los enlaces llevan sus propias restricciones de método y de comisión |
| Página del portal para guardar métodos | Is Portal activado; Portal Method Input Page, Success Page, Error Page y Return URL definidos |
Errores que debes evitar
| Error | Qué ocurre | Solución |
|---|---|---|
| Is Portal desactivado en una página del portal | La navegación después del primer paso falla o vuelve al lugar equivocado | Marca Is Portal y define las páginas del portal |
| Nombres de páginas del portal escritos como etiquetas | REDA Pay no encuentra la página | Usa el nombre de API de la página, de las propiedades de página de Experience Builder |
| Allow Card y Allow Bank desactivados a la vez | La pantalla no tiene pestañas | Permite al menos uno |
| Esperar que se muestre Customer Notes | No aparece nada | Usa rpay__cnotes en la dirección |
| Limitar perfiles por nombre en lugar de por código | Ningún perfil coincide | Usa el Code del Pay Profile |