REDA One Centro de ayuda
ES
Idioma
English EN Español ES Português PT Italiano próximamente Français FR Deutsch próximamente العربية próximamente
reda.one ↗
Inicio / REDA Pay / Administración / Actualizar REDA Pay

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.

Antes de empezar
  • 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

  1. 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).
  2. 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.
  3. Haz clic en Upgrade (actualizar) y espera el correo de confirmación.
  4. 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.

📷 Captura de pantalla — La página Paquetes instalados de Configuración con la fila de REDA Pay y su número de versió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 diceTú 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:

  1. Abre un prospecto y pulsa el botón de pago; la pantalla se abre con el logotipo y las pestañas.
  2. Cobra un pago bancario de $1 contra el entorno de prueba de Payload; la orden muestra Immediate - Processed.
  3. Abre la Pay Transaction y pulsa Sync Transaction; termina correctamente.
  4. Crea y cancela una programación; crea un enlace, ábrelo en una ventana privada y revócalo.
  5. Como usuario del portal, abre la página de pago del portal y llega a la pantalla de pago.
  6. Como administrador, abre el Pay Profile: Webhook Setup muestra diez filas; pulsa Sync Processing Accounts; termina correctamente.
  7. 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 conservaVolver a revisar después de actualizar
Pay Profiles, Processing Accounts, Fee Setups, clientes, métodos, órdenes, transacciones, extractos, registrosNada que hacer
La clave de cifrado y los valores cifradosNada 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 PayCompá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 PayloadLa 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 PayAbre cada página en Builder; vuelve a publicar si la nota lo pide
Interruptores de metadatos personalizadosValores sin cambios

Después de la actualización: una comprobación de diez minutos

  1. Paquetes instalados muestra la versión nueva.
  2. Pestaña REDA Pay Admin: la clave dice Generated y el interruptor del trabajo de recuperación está en Yes.
  3. Cobra un pago de prueba como usuario del personal y, si los tienes, como usuario del portal y mediante un enlace.
  4. Abre una Pay Order y una Pay Transaction como usuario no administrador: todos los campos que agregó la nota de versión son visibles.
  5. REDA Pay Logs: ninguna entrada Attention Needed nueva.

Errores que debes evitar

ErrorQué ocurreSolución
Actualizar primero producciónLos problemas aparecen delante de los clientesPrimero el sandbox
Dar por hecho que los campos nuevos son visiblesEl personal no los ve; las funciones parecen rotasFormatos de página y seguridad a nivel de campo
Omitir un valor de lista de selección de la nota de versiónLa función da error o falta una opciónAgrega el valor exactamente igual
Probar como administradorSe ocultan las faltas de accesoPrueba con cada rol
Olvidar un flujo reemplazadoSigue funcionando la lógica anteriorConcilia 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.

Qué sigue