Referencia de parámetros de URL
La entrada de pago (NewPayOrder) y la entrada para guardar métodos (NewPayMethod) leen instrucciones de la dirección con la que se abren. Así es como un botón de pago fija el importe de una cuota de solicitud, como el enlace de datos bancarios de un proveedor sabe a qué cuenta pertenece y como una página del portal puede preseleccionar un perfil. Un valor en la dirección tiene prioridad sobre el mismo ajuste del componente; consulta Referencia de configuración de componentes.
Antes de empezar: los parámetros se agregan después de ? y se separan con &. Los valores con espacios o signos de puntuación deben codificarse para URL (un espacio se convierte en %20). Los Ids de registro son los Ids de Salesforce de 15 o 18 caracteres.
La dirección de pago interna es /lightning/cmp/rpay__NewPayOrder; en un sitio, es la página que tiene el componente de entrada, por ejemplo https://yourcompany.my.site.com/portal/s/new-pay-order.
Parámetros de la entrada de pago (NewPayOrder)
Quién y dónde
| Parámetro | Valor | Significado |
|---|
rpay__rid | Id de registro | El registro principal: una cuenta, un contacto o un prospecto. En una página de registro, el PayButton lo agrega por ti. Obligatorio, salvo que la página sea del portal y resuelva al usuario que inició sesión, o que esté rpay__oid |
rpay__custid | Id del Pay Customer | Usa este Pay Customer en lugar de buscarlo a partir del registro principal |
rpay__ppid | Id del Pay Profile | Usa este perfil sin preguntar |
rpay__pid | Id de la Processing Account | Usa esta cuenta sin preguntar |
rpay__pfid | Id de la Processing Account | Dirige la comisión por conveniencia a esta cuenta |
rpay__lid, rpay__cid, rpay__aid, rpay__oppid | Id de prospecto, contacto, cuenta u oportunidad | Vincula la orden con estos registros además del registro principal |
rpay__oid | Id de orden cifrado | Abre un enlace de pago existente. REDA Pay lo incluye en cada Link URL; nunca lo armes tú |
Qué tipo de pago
| Parámetro | Valor | Significado |
|---|
rpay__ttype | rcpt o disb | Fija la dirección: cobro o desembolso |
rpay__otype | imm, schd o lnk | Fija el tipo de orden: pago inmediato, programación o enlace de pago |
rpay__card | 1 o 0 | Permite u oculta las tarjetas |
rpay__bank | 1 o 0 | Permite u oculta las cuentas bancarias |
rpay__noimm | 1 | Oculta el botón Pay |
rpay__nosch | 1 | Oculta el botón Schedule |
rpay__nolnk | 1 | Oculta el botón Create Link |
rpay__noemd | 1 | Oculta el interruptor Earnest Money Deposit |
Importe, comisiones y notas
| Parámetro | Valor | Significado |
|---|
rpay__amount | Un número, p. ej., 250 o 1250.50 | Completa el importe de antemano. Un valor que no es un número se ignora |
rpay__fixamt | 1 | El importe no se puede cambiar (se muestra como texto). Úsalo con rpay__amount |
rpay__nofee | 1 | Sin comisión por conveniencia en esta orden |
rpay__cfee | Un número | Reemplaza la comisión por conveniencia calculada por este importe |
rpay__cnotes | Texto | Customer Notes, que ve el pagador y se guardan en la orden |
rpay__att1 … rpay__att4 | Texto | Attribute 1–4 en la orden, para tus propias automatizaciones e informes |
rpay__geoskip | 1 | No pide la ubicación al navegador |
Parámetros de la entrada para guardar métodos (NewPayMethod)
| Parámetro | Valor | Significado |
|---|
rpay__rid | Id de registro | El registro principal (cuenta, contacto o prospecto). Obligatorio junto con rpay__custid o en su lugar |
rpay__custid | Id del Pay Customer | El cliente al que pertenece el método |
rpay__ppid | Id del Pay Profile | Usa este perfil sin preguntar |
rpay__ttype | rcpt o disb | Para qué puede usarse el método |
rpay__default | 1 o 0 | Define el método guardado como predeterminado del cliente |
rpay__card, rpay__bank | 1 o 0 | Permite u oculta cada tipo |
rpay__curr | USD o CAD | Completa de antemano la moneda de la cuenta bancaria |
rpay__cnotes | Texto | Una nota que se muestra en la pantalla |
rpay__lid, rpay__cid, rpay__aid | Ids | Vincula el método con estos registros |
Ejemplos prácticos
| Objetivo | Dirección |
|---|
| Botón de cuota de solicitud en un prospecto: $75, que no se puede cambiar, tarjeta o banco, solo pago inmediato | /lightning/cmp/rpay__NewPayOrder?rpay__amount=75&rpay__fixamt=1&rpay__ttype=rcpt&rpay__nosch=1&rpay__nolnk=1&rpay__cnotes=Application%20fee (el PayButton agrega rpay__rid) |
| Botón de pago saliente en una cuenta, fijado a una cuenta de procesamiento | /lightning/cmp/rpay__NewPayOrder?rpay__ttype=disb&rpay__ppid=a00…&rpay__pid=a01… |
| Enlace que solo crea enlaces de pago, sin comisión, solo banco | /lightning/cmp/rpay__NewPayOrder?rpay__rid=003…&rpay__otype=lnk&rpay__nofee=1&rpay__card=0 |
| Enlace de datos bancarios de un proveedor en tu sitio público | https://yourcompany.my.site.com/public/s/process-method-link?rpay__rid=001…&rpay__ttype=disb&rpay__default=1&rpay__card=0 |
| Página del portal que preselecciona un perfil para todos los residentes | Pon rpay__ppid=a00… en la dirección que usa la navegación del portal, o define Limit Profile Selection en el componente |
La fórmula de un botón personalizado en el prospecto queda, por ejemplo:
/lightning/cmp/rpay__NewPayOrder?rpay__rid={!Lead.Id}&rpay__amount=75&rpay__fixamt=1&rpay__ttype=rcpt
Reglas de prioridad
- Un valor de la URL reemplaza el ajuste del componente para la misma opción.
- Ninguno de los dos puede ofrecer más de lo que permiten la Processing Account y el Pay Customer; solo quitan opciones.
- Un perfil o una cuenta que se pasan por Id deben estar activos y corresponderse entre sí; si no, la pantalla no puede usarlos.
rpay__oid (un enlace de pago) toma el control: se aplican el importe, la elección de comisión y las restricciones de método de la propia orden, y solo está disponible Pay.
Errores que debes evitar
| Error | Qué ocurre | Solución |
|---|
Olvidar rpay__rid en un enlace para guardar métodos | "Bad Request. Parent record not found." | Agrega el Id de la cuenta, el contacto o el prospecto |
rpay__amount=100e o $100 | El importe se ignora y queda editable | Solo dígitos y un punto decimal |
rpay__fixamt=1 sin importe | No hay nada que fijar; el pagador escribe el importe | Agrega rpay__amount |
Pasar el Code de un Pay Profile en rpay__ppid | No se encuentra | rpay__ppid recibe el Id del registro; los códigos van en Limit Profile Selection del componente |
Qué sigue
