Actualizar REDA Pay
REDA Pay es un paquete gestionado: una versión nueva se instala sobre la anterior con un vínculo de instalación, y tus datos, tu configuración y tus personalizaciones se conservan. Las actualizaciones son rutinarias, pero hay tres cosas que una actualización gestionada nunca hace y que sorprenden a los administradores cada vez, así que este artículo es tanto una lista de comprobación como un procedimiento.
- Tienes el permiso de Salesforce para instalar paquetes (un administrador del sistema lo tiene).
- Tienes el vínculo de instalación de la versión nueva, que te da tu ejecutivo de cuenta de REDA o support@reda.one; los vínculos no se publican.
- Tienes un sandbox actualizado hace poco, para que se parezca a producción.
Comprobar lo que tienes
Configuración → Paquetes instalados muestra REDA Pay con su Número de versión. Las notas de versión de este portal indican la versión que describen; compáralas antes de leerlas.
Actualizar primero un sandbox
- Abre el vínculo de instalación con la sesión iniciada en el sandbox (o elige el inicio de sesión del sandbox cuando el vínculo lo pida).
- Elige quién recibe acceso a los componentes del paquete. Install for Admins Only (instalar solo para administradores) es el valor predeterminado seguro: el acceso lo conceden los conjuntos de permisos de REDA Pay, no la opción de instalación.
- Haz clic en Upgrade (actualizar) y espera el correo de confirmación.
- Haz las comprobaciones de las secciones siguientes, cobra un pago de prueba contra el entorno de prueba de Payload y solo entonces repite en producción.
Las tres cosas que una actualización nunca hace
Una actualización gestionada instala componentes nuevos pero no toca lo que puedas haber personalizado. Para cada campo o valor nuevo que enumere una nota de versión, haz esto a mano:
1. Colocar los campos nuevos en tus formatos de página
Si alguna vez editaste un formato de página de REDA Pay (y la mayoría de las organizaciones lo hicieron), un campo nuevo se instala pero no se coloca en tu formato. Solo lo reciben los formatos predeterminados del paquete que no se tocaron. Para cada campo nuevo que enumere la nota de versión: Configuración → Gestor de objetos → el objeto → Formatos de página → tu formato, arrastra el campo a la sección que indica la nota y haz clic en Guardar.
2. Conceder la seguridad a nivel de campo a tus propios conjuntos de permisos y perfiles
El paquete concede los campos nuevos a sus propios conjuntos de permisos. Si tus usuarios tienen tus propios conjuntos de permisos o perfiles en lugar de los de REDA Pay, o además de ellos, no tienen acceso al campo nuevo hasta que se lo concedas: Configuración → Gestor de objetos → el objeto → Campos y relaciones → el campo → Definir la seguridad a nivel de campo, y concede la visibilidad (y, si corresponde, solo lectura) a cada perfil o conjunto de permisos.
Prueba como un usuario común del rol correspondiente, nunca como administrador: los administradores ven los campos sea cual sea la seguridad a nivel de campo, así que probar como tú mismo no demuestra nada.
3. Agregar a mano los valores nuevos de las listas de selección
Una actualización nunca agrega un valor nuevo de lista de selección a un campo que tu organización ya tiene. Las instalaciones nuevas lo reciben; las organizaciones actualizadas no, aunque en la misma versión llegue un campo nuevo. Si una nota de versión enumera un valor nuevo, agrégalo escrito exactamente igual: Configuración → Gestor de objetos → el objeto → Campos y relaciones → el campo → Nuevo → el valor → Guardar, y luego reordénalo. En una lista de selección restringida, un valor que falta hace que la función falle por completo, no que solo se oculte una opción.
Donde está tu versión. Compárala con las notas de versión antes de leerlas.
Leer una nota de versión
Cada nota de versión de REDA Pay de este portal incluye, para cada cambio, los pasos que debes hacer en tu organización. Léela teniendo en cuenta las tres reglas anteriores:
| La nota dice | Tú haces |
|---|---|
| "New field X on Object, section Y" | Coloca X en tus formatos en la sección Y; concede la seguridad a nivel de campo a tus perfiles y conjuntos de permisos; prueba como usuario |
| "New picklist value V on field F" | Agrega V a F a mano, escrito exactamente igual; reordénalo; si F está restringido, hazlo antes de que alguien use la función |
| "New action A on Object" | Agrega la acción a la sección de acciones de tus formatos de página |
| "Run Setup Webhooks again" | Abre cada Pay Profile activo y púlsalo |
| "Place component C on your portal pages" | Abre Experience Builder, colócalo, define sus propiedades y publica |
| "Schedule job J" | Configuración → Clases de Apex → Programar Apex |
Guion de prueba en el sandbox
Ejecútalo en el sandbox después de actualizar, como un usuario que solo tiene el conjunto de permisos de REDA Pay correspondiente:
- Abre un prospecto y pulsa el botón de pago; la pantalla se abre con el logotipo y las pestañas.
- Cobra un pago bancario de $1 contra el entorno de prueba de Payload; la orden muestra Immediate - Processed.
- Abre la Pay Transaction y pulsa Sync Transaction; termina correctamente.
- Crea y cancela una programación; crea un enlace, ábrelo en una ventana privada y revócalo.
- Como usuario del portal, abre la página de pago del portal y llega a la pantalla de pago.
- Como administrador, abre el Pay Profile: Webhook Setup muestra diez filas; pulsa Sync Processing Accounts; termina correctamente.
- Revisa si hay algo nuevo en REDA Pay Logs.
Si algún paso falla en el sandbox, detente y escribe a support@reda.one con el paso y el mensaje antes de tocar producción.
Avisar a tus usuarios
Una actualización rara vez cambia lo que ve el personal, pero cuando una versión agrega un botón, un campo o una pantalla, avisa a las personas que lo usan antes de que lo encuentren. La sección "what you'll see" de la nota de versión está escrita para reenviarla.
Lo que se conserva en una actualización y lo que hay que volver a revisar
| Se conserva | Volver a revisar después de actualizar |
|---|---|
| Pay Profiles, Processing Accounts, Fee Setups, clientes, métodos, órdenes, transacciones, extractos, registros | Nada que hacer |
| La clave de cifrado y los valores cifrados | Nada que hacer |
| Tus formatos personalizados, tus conjuntos de permisos, tus flujos | ¿Se colocaron los campos nuevos? ¿Se concedió el acceso nuevo? |
| Tus reemplazos de flujos de REDA Pay | Compáralos con la nueva versión del paquete; concilia de forma deliberada |
| Trabajos programados (pagos recurrentes diarios, recuperación de pagos fallidos) | Siguen en Configuración → Trabajos programados con una fecha en Siguiente ejecución programada |
| Webhooks registrados en Payload | La pestaña Webhook Setup sigue mostrando diez; vuelve a ejecutar Setup Webhooks si una nota de versión lo indica |
| Páginas de Experience Cloud con componentes de REDA Pay | Abre cada página en Builder; vuelve a publicar si la nota lo pide |
| Interruptores de metadatos personalizados | Valores sin cambios |
Después de la actualización: una comprobación de diez minutos
- Paquetes instalados muestra la versión nueva.
- Pestaña REDA Pay Admin: la clave dice Generated y el interruptor del trabajo de recuperación está en Yes.
- Cobra un pago de prueba como usuario del personal y, si los tienes, como usuario del portal y mediante un enlace.
- Abre una Pay Order y una Pay Transaction como usuario no administrador: todos los campos que agregó la nota de versión son visibles.
- REDA Pay Logs: ninguna entrada Attention Needed nueva.
Errores que debes evitar
| Error | Qué ocurre | Solución |
|---|---|---|
| Actualizar primero producción | Los problemas aparecen delante de los clientes | Primero el sandbox |
| Dar por hecho que los campos nuevos son visibles | El personal no los ve; las funciones parecen rotas | Formatos de página y seguridad a nivel de campo |
| Omitir un valor de lista de selección de la nota de versión | La función da error o falta una opción | Agrega el valor exactamente igual |
| Probar como administrador | Se ocultan las faltas de acceso | Prueba con cada rol |
| Olvidar un flujo reemplazado | Sigue funcionando la lógica anterior | Concilia los reemplazos |
Preguntas frecuentes
No. Los paquetes gestionados no admiten volver atrás; por eso primero va el sandbox.
La instalación dura minutos y no detiene los trabajos programados. Para mayor seguridad, actualiza fuera de la hora en que se ejecuta tu trabajo de pagos recurrentes.
En este portal, en las versiones de REDA Pay, con los pasos para el suscriptor de cada versión.