Agregar REDA Pay a las páginas de registro: el botón de pago
El personal cobra desde los registros con los que ya trabaja: un prospecto que solicita una unidad, un contacto que paga un depósito, una cuenta que salda una factura. REDA Pay ofrece tres formas de abrir la pantalla de pago desde una página de registro, y eliges una por objeto. Cada punto de entrada puede definir de antemano el perfil, la cuenta, los métodos y los botones que ofrece la pantalla, así que el botón de un equipo de arrendamiento y el de atención a propietarios pueden comportarse de forma distinta.
- El Pay Profile y la Processing Account están configurados y activos; consulta la Hoja de ruta de configuración.
- Tienes el permiso de Salesforce para editar páginas Lightning (un administrador del sistema lo tiene) y REDA Pay - Admin User.
- El personal que va a usar el botón tiene REDA Pay - User.
Elegir un punto de entrada
| Punto de entrada | Qué es | Elígelo cuando |
|---|---|---|
| Componente PayButton | Un botón en la página de registro que abre la pantalla de pago a página completa, con el Id del registro | Quieres un botón claro y quizás definir opciones mediante la dirección que abre |
| Componente NewPayOrder | La propia pantalla de pago, colocada en la página de registro o en una pestaña | Quieres la pantalla integrada en la página, con sus opciones definidas en el Generador de aplicaciones |
| Un botón personalizado o una acción rápida que abre la dirección de la pantalla | Tu propio botón, creado en el Gestor de objetos, que apunta a la dirección de la pantalla de pago con parámetros | Ya gestionas los botones así, o necesitas la pantalla como acción rápida |
Los tres abren la misma pantalla y se aplican las mismas reglas. La única diferencia es dónde están los ajustes.
Opción 1: el botón de pago
- Abre un registro del objeto, por ejemplo un prospecto, haz clic en el icono del engranaje y elige Modificar página. Se abre el Generador de aplicaciones Lightning.
- En la lista de componentes, en Personalizado - Gestionado, busca PayButton y arrástralo adonde quieras el botón: la parte superior de la página o una pestaña.
- Define sus propiedades:
| Propiedad | Ingresa |
|---|---|
| Button Label | Lo que lee el personal, por ejemplo Receive Payment |
| Button URL | La dirección de la pantalla de pago: /lightning/cmp/rpay__NewPayOrder, seguida opcionalmente de ? y parámetros que fijan el perfil, la cuenta, los métodos o los botones (ver más abajo) |
| Button Variant | El estilo de botón de Salesforce: brand para un botón principal azul, neutral para uno simple, etc. |
- Guarda y activa la página para la organización, la aplicación o los perfiles que deben verla.
Al pulsarlo, el botón agrega el Id del registro a la dirección (rpay__rid=<Id>) y abre la pantalla. El registro pasa a ser el registro principal del pago: REDA Pay busca o crea su Pay Customer y vincula la Pay Order con él.
Un botón de pago en un prospecto. Una pulsación abre la pantalla de pago para ese prospecto.
Definir la pantalla de antemano mediante la dirección
Agrega parámetros a Button URL para decidir qué ofrece la pantalla. Ejemplos:
| Button URL | Efecto |
|---|---|
/lightning/cmp/rpay__NewPayOrder | Todo lo que permiten el usuario, el cliente y la cuenta |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt | Solo cobros, sin la pregunta de desembolso |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt&rpay__bank=0 | Cobros solo con tarjeta |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt&rpay__nosch=1&rpay__nolnk=1 | Solo pago inmediato, sin los botones Schedule ni Create Link |
/lightning/cmp/rpay__NewPayOrder?rpay__ppid=<Id del Pay Profile>&rpay__pid=<Id de la Processing Account> | Omite las preguntas de perfil y de cuenta |
/lightning/cmp/rpay__NewPayOrder?rpay__amount=250&rpay__fixamt=1&rpay__cnotes=Application%20fee | Un importe fijo de $250 con una nota: un botón de cuota de solicitud |
La lista completa está en Referencia de parámetros de URL. Los valores de la dirección tienen prioridad sobre los ajustes del propio componente.
Opción 2: la pantalla de pago en la página
- En el Generador de aplicaciones Lightning de la página de registro, arrastra NewPayOrder (en Personalizado - Gestionado) a la página; normalmente a su propia pestaña, como Pagos, porque la pantalla necesita ancho.
- Define sus propiedades en el panel derecho: qué tipos de transferencia, métodos y botones se permiten, si se limitan los perfiles y las cuentas por código, los interruptores de EMD y de comisión, y hasta cuatro atributos que se graban en la orden. Cada propiedad se explica en Referencia de configuración de componentes. Deja Is Portal sin marcar en las páginas internas.
- Guarda y activa la página.
La pantalla se abre en cuanto se muestra la pestaña y determina el perfil, el cliente y la cuenta a partir del registro.
Opción 3: un botón personalizado o una acción rápida
Si tu equipo prefiere los botones del Gestor de objetos:
- Configuración → Gestor de objetos → Candidato (el objeto de prospectos) → Botones, vínculos y acciones → Nuevo botón o vínculo.
- Elige Detail Page Button (botón de página de detalles), comportamiento Display in existing window (mostrar en la ventana actual), origen del contenido URL y la fórmula
/lightning/cmp/rpay__NewPayOrder?rpay__rid={!Lead.Id}más los parámetros que quieras. - Agrega el botón al formato de página.
Una acción rápida de tipo Lightning Component (componente Lightning) también puede alojar NewPayOrder; abre el primer paso en un diálogo, y la pantalla de pago se abre luego a página completa.
Qué objetos cubrir
| Objeto | Uso habitual | Dirección sugerida |
|---|---|---|
| Prospecto | Cuotas de solicitud, depósitos de reserva | Solo cobros |
| Contacto | Alquiler, depósitos y cuotas de un residente | Solo cobros |
| Cuenta | Facturas de una empresa; pagos salientes a un proveedor o propietario | Cobros y desembolsos; el interruptor del propio usuario decide qué puede hacer |
| Oportunidad | Depósitos de una venta | Agrega rpay__oppid={!Opportunity.Id} junto con rpay__rid del contacto o la cuenta, para que la orden se vincule a la oportunidad |
El registro principal debe ser una cuenta, un contacto o un prospecto: los objetos que REDA Pay sabe convertir en Pay Customer. Para una oportunidad, el botón pasa el contacto o la cuenta relacionados como registro principal y la oportunidad como vínculo.
Errores que debes evitar
| Error | Qué ocurre | Solución |
|---|---|---|
| Button URL sin la barra inicial | La dirección no se resuelve | Empieza con /lightning/cmp/ |
| Buscar el componente por el nombre del producto | El Generador de aplicaciones muestra los componentes gestionados por su nombre: PayButton, NewPayOrder | Busca en Personalizado - Gestionado |
| Colocar el botón de pago en un objeto que no es cuenta, contacto ni prospecto | "Bad Request. Parent record not found." o "Transaction not allowed for SObject: …" | Pasa un Id de cuenta, contacto o prospecto con rpay__rid |
| Página activada para la aplicación equivocada | El personal no ve el botón | Revisa la activación (predeterminada de la organización, de la aplicación, o por aplicación y perfil) |
| Personal sin REDA Pay - User | La pantalla no carga | Asigna el conjunto de permisos |
Preguntas frecuentes
Sí, por ejemplo Collect Application Fee con un importe fijo y Receive Payment sin él. Cada uno es su propio componente PayButton con su propia dirección.
Pruébalo en los dispositivos que usa tu equipo antes de depender de él; la pantalla de pago está diseñada para una ventana de navegador.
No. Las etiquetas de la pantalla son fijas; la etiqueta que defines solo se aplica al botón de pago de la página.
Qué sigue
- Cobrar un pago: qué ocurre después de pulsar el botón.
- Referencia de configuración de componentes
- Referencia de parámetros de URL