REDA Pay
Winter 2026 · v1.57000
5 Nov 2026
Payload API v2, captura segura de tarjetas en cualquier sitio y guías de configuración para cada canal
REDA Pay 1.57000 es una versión principal. Reúne todo lo publicado desde la versión principal 1.56: los parches 1.56001, 1.56002, 1.56003 y 1.56004 (3 y 4 de noviembre de 2026). Una organización que ya ejecuta 1.56004 tiene todos los cambios de esta página. Aquí se explica cómo instalar REDA Pay por primera vez, cómo actualizar una organización que ejecuta 1.56 o uno de los parches, qué pasos no puede hacer la actualización por ti, y qué cambió, con las palabras que usará tu equipo.
Datos de la versión. Paquete: REDA Pay · Número de versión: 1.57000 · Nombre de la versión: Winter 2026.
Actualizar ahora: producción · Instalar en un sandbox
Enlaces de instalación. La versión 1.57000 se publicó el 5 de noviembre de 2026 y no necesita contraseña de instalación; el inicio de sesión de Salesforce, las licencias del paquete y los permisos siguen aplicándose. Los enlaces identifican la versión del paquete, no una organización concreta: tu inicio de sesión de Salesforce decide dónde se instala. Para ver qué versión ejecuta hoy una organización: Configuración → Paquetes instalados → REDA Pay → Número de versión.
¿Prefieres que lo hagamos nosotros? El equipo de REDA instala, actualiza y configura REDA Pay por ti. Escribe a sales@reda.one para reservar una sesión.
En esta página
- De un vistazo: quién debe hacer qué
- Instalar REDA Pay por primera vez
- Después de instalar: configurar cada canal de pago
- Actualizar desde 1.56 o un parche
- Después de actualizar: los pasos que la actualización no puede hacer por ti
- Comprobar que todo funciona
- Novedades de esta versión
- Corregido en esta versión
- Campos, acciones y componentes nuevos, y quién puede verlos
De un vistazo: quién debe hacer qué
| Tu situación | Qué hacer | Dónde |
|---|---|---|
| REDA Pay aún no está instalado | Instala el paquete y sigue la hoja de ruta de configuración: clave de cifrado, Pay Profile y clave de API, cuentas de procesamiento, conjuntos de permisos, webhooks y los canales que uses (pantallas del personal, portal de clientes, enlaces de pago públicos, pagos programados). | Instalar y Después de instalar |
| Tu organización ejecuta 1.56 | Actualiza y completa todos los pasos de Después de actualizar: los campos y la acción nuevos del Pay Profile en tus formatos de página, el acceso para tus propios perfiles o conjuntos de permisos clonados, el acceso del usuario invitado del sitio de webhooks, los valores del conjunto de valores y la republicación de cada sitio de Experience Cloud que aloja pantallas de REDA Pay. | Actualizar |
| Tu organización ejecuta 1.56001, 1.56002 o 1.56003 | Actualiza, republica cada sitio de Experience Cloud que aloja las pantallas v2 y revisa los demás pasos de Después de actualizar; la mayoría ya se hicieron al instalar el parche. | Actualizar |
| Tu organización ejecuta 1.56004 | Ya tiene todos los cambios de esta página. Si no has completado Después de actualizar, hazlo ahora; no hace falta republicar. | Después de actualizar |
| Quieres usar la API v2 de Payload (captura segura de tarjetas, pantallas en un sitio LWR, webhooks firmados) | Pon Versión de la API de Payload (Payload API Version) en v2 en el Pay Profile y ejecuta Configurar webhooks (Setup Webhooks). Nada más se mueve; el cambio es reversible. | Elegir la versión de la API de Payload |
| Tu portal de clientes o tu sitio público es un sitio LWR | Coloca los componentes v2 en sus páginas (los componentes clásicos no funcionan en LWR). Los nombres de página, el acceso de invitados y la colaboración están explicados paso a paso. | Portal · Enlaces públicos |
| Tus usuarios trabajan en español, francés o portugués (Brasil) | Nada: después de la actualización REDA Pay aparece en el idioma del usuario. Revisa el idioma en el registro de usuario si sigue mostrándose en inglés. | Novedades |
Instalar REDA Pay por primera vez
Necesitas un administrador de Salesforce (el perfil Administrador del sistema, o un perfil con Descargar paquetes de AppExchange y Personalizar aplicación) y una cuenta de Payload a cuyo panel puedas iniciar sesión. Si tienes un sandbox, instala primero ahí.
- Abre el enlace de instalación del entorno en el que instalas (producción o sandbox). Si no lo tienes, pídelo a tu ejecutivo de cuenta de REDA o a support@reda.one.
- Inicia sesión como administrador de esa organización. Si tienes varias, comprueba el nombre de la organización en la parte superior antes de continuar.
- En la página de instalación, confirma el nombre del paquete, REDA Pay, y el número de versión contra esta página.
- Elige Instalar solo para administradores. El acceso para los demás se concede después con los conjuntos de permisos de REDA Pay, no con esta opción.
- Haz clic en Instalar. Si Salesforce indica que la instalación continúa en segundo plano, espera su correo antes de seguir.
- Abre Configuración → Paquetes instalados y confirma que REDA Pay aparece con este número de versión.
Instalar es el primero de trece pasos. El resto está en la sección siguiente.
Después de instalar: configurar cada canal de pago
Sigue Hoja de ruta de configuración: de la instalación al primer pago desde el paso 1. En resumen:
| Paso | Qué hace | Guía |
|---|---|---|
| 1. Conjuntos de permisos | Da al administrador REDA Pay - Admin User; más adelante, al personal REDA Pay - User, etc. | Quién puede hacer qué |
| 2. Clave de cifrado | Genera la clave que cifra tu clave de API de Payload y los identificadores. Una vez por organización. | Generar la clave de cifrado |
| 3. Pay Profile y clave de API | Crea el perfil, guarda la clave de API de Payload con Actualizar token de API y elige la Versión de la API de Payload, v1 o v2. | Crear un Pay Profile · Elegir la versión de la API |
| 4. Cuentas de procesamiento | Sincroniza tus cuentas de comercio desde Payload, activa el perfil y configura cada cuenta (tipos de transferencia, métodos, imagen de marca, tarifas, ajustes de enlaces). | Sincronizar y activar · Configurar |
| 5. Webhooks | Un sitio público de Salesforce al que llama Payload, el acceso de su usuario invitado y Configurar webhooks. En v2, un secreto de firma. | Configurar webhooks |
| 6. Pagos del personal | Pon la pantalla de pago en las páginas de Lead, Contact y Account; cobra un pago de prueba. | Agregar REDA Pay a las páginas de registro · Cobrar un pago |
| 7. Portal de clientes | Páginas, ajustes de componentes, conjunto de permisos, conjunto de colaboración y acceso externo predeterminado para un portal con inicio de sesión, Aura o LWR. | Permitir que los clientes paguen en tu portal · Acceso al portal |
| 8. Enlaces de pago públicos | Páginas públicas, nombres de API exactos, el conjunto de permisos y el acceso a Apex del usuario invitado, las cuatro reglas de colaboración para invitados (con la opción de registros de usuarios del portal), la preferencia de API públicas y los ajustes de enlaces de la cuenta de procesamiento. | Configurar el sitio público · Acceso de invitados |
| 9. Pagos programados y recuperación | Programa el trabajo diario y activa la recuperación de pagos fallidos. | Trabajo diario · Recuperación |
Actualizar desde 1.56 o un parche
- Anota qué versión ejecuta la organización: Configuración → Paquetes instalados → REDA Pay → Número de versión.
- Actualiza primero un sandbox. Abre el enlace de instalación con sesión iniciada en el sandbox, mantén Instalar solo para administradores, haz clic en Actualizar y espera el correo de confirmación.
- Completa Después de actualizar en el sandbox, ejecuta las comprobaciones de Comprobar que todo funciona y repite ambas cosas en producción.
Tus datos, tu configuración, la clave de cifrado, los webhooks y los trabajos programados sobreviven a la actualización. El procedimiento completo, con lo que sobrevive y lo que conviene revisar, está en Actualizar REDA Pay.
Después de actualizar: los pasos que la actualización no puede hacer por ti
La actualización de un paquete gestionado instala los componentes nuevos, pero nunca cambia un formato de página que uses, nunca concede acceso a tus propios perfiles o conjuntos de permisos, nunca añade un valor a un conjunto de valores que tu organización ya tiene y nunca vuelve a publicar un sitio de Experience Cloud. Hazlo a mano, en este orden. Cada fila indica a quién aplica.
| Paso | Aplica a | Qué hacer |
|---|---|---|
| 1. Añadir los campos y la acción nuevos del Pay Profile a tus formatos de página | Toda organización que actualiza desde 1.56 | En cada formato de página de Pay Profile en uso, añade los campos Versión de la API de Payload (Payload API Version), Secreto de firma del webhook (Webhook Signing Secret) y Apariencia del pago (Payment Appearance) — sección Information para el primero, API Setup para el segundo y External Labels para el tercero, como en el formato del paquete — y la acción Actualizar secreto del webhook (Update Webhook Secret). Paso a paso: Actualizar REDA Pay. |
| 2. Conceder las clases y la página nuevas a tus propios perfiles o conjuntos clonados | Organizaciones que no asignan los conjuntos de permisos de REDA Pay del paquete | Pagadores (personal, usuarios del portal, el usuario invitado del sitio público): clases de Apex rpay.PayloadV2SecureCapture y rpay.PayloadSecureFieldsController, página de Visualforce rpay.PayloadSecureFields. Administradores: clase rpay.UpdateWebhookSecretController y acceso de modificación a los tres campos nuevos. Los conjuntos del paquete ya traen todo esto. Pasos: Actualizar REDA Pay. |
| 3. Dar al usuario invitado del sitio de webhooks la clase de retorno v2 | Toda organización que use la API v2 de Payload | En el perfil de invitado del sitio de webhooks, habilita rpay.PayloadCallbackV2 junto a rpay.PayloadCallback. Luego pon el perfil en v2 y ejecuta Configurar webhooks. Pasos: Configurar webhooks. |
| 4. Volver a publicar cada sitio de Experience Cloud que aloja pantallas de REDA Pay | Toda organización que actualiza desde 1.56001, 1.56002 o 1.56003, y toda la que coloque los componentes v2 | Un sitio LWR sigue sirviendo el código de componentes de la versión anterior hasta que lo publicas de nuevo: abre el sitio en Experience Builder y haz clic en Publicar. Compara antes los cambios sin publicar del sitio, porque publicar también los pone en vivo. Publica los sitios de uno en uno. |
| 5. Añadir los valores del conjunto de valores que faltan en tu organización | Organizaciones que actualizan desde 1.56 y que pagan o cobran en reales brasileños o pesos colombianos, o tienen direcciones colombianas | Los valores BRL y COP (Moneda de la cuenta) y CO (País) se añadieron después de 1.56 y no se agregan a una organización existente. Añádelos en Configuración → Conjuntos de valores de lista de selección, escribiendo exactamente esos nombres de API. Pasos: Actualizar REDA Pay. |
| 6. Revisar tus propias copias de las páginas de registro de REDA Pay | Organizaciones que clonaron una página de registro Lightning de REDA Pay | Las páginas de registro del paquete toman ahora los títulos de sus pestañas de etiquetas traducibles. Una página que clonaste conserva los títulos que escribiste; vuelve a escribirlos con las etiquetas si quieres que se traduzcan. |
| 7. Decidir sobre Create Missing Transactions | Todas las organizaciones | Una instalación nueva recibe CREATE_MISSING_TRANSACTIONS = TRUE; una actualización conserva tu valor. Lee Interruptores de la organización y mensajes de error y decídelo de forma deliberada. |
Comprobar que todo funciona
- Configuración → Paquetes instalados muestra REDA Pay 1.57000.
- Abre un Pay Profile: los tres campos nuevos y la acción Actualizar secreto del webhook están en la página.
- Como usuario del personal que solo tiene REDA Pay - User, cobra un pequeño pago de prueba desde un Lead contra el entorno de pruebas de Payload. En un perfil v2 los datos de tarjeta o cuenta se escriben en el formulario seguro y aparece un mensaje de progreso mientras se ejecuta el pago.
- Si usas un portal, inicia sesión como cliente de prueba (Iniciar sesión en Experience como usuario en su Contact) y llega a la pantalla de pago.
- Si usas enlaces de pago, crea un enlace de prueba y ábrelo en una ventana privada del navegador: se abre la pantalla de pago y el resumen de revisión muestra el número de orden y los importes.
- Abre la pestaña Configuración de webhooks del Pay Profile: diez filas en v1, once en v2, cada una con un Webhook Id.
- Pon el idioma de un usuario de prueba en español, francés o portugués (Brasil) y abre una Pay Order: pestañas, campos y botones aparecen en ese idioma.
- Abre REDA Pay Logs: no hay entradas nuevas en Attention Needed.
Novedades de esta versión
| Cambio | Lo que notará tu equipo | Configuración o revisión |
|---|---|---|
| 1. API v2 de Payload, elegida por Pay Profile | Un campo nuevo, Versión de la API de Payload, en el Pay Profile. En blanco o v1, todo sigue exactamente igual. v2 cambia ese perfil a la API actual de Payload: los mismos botones, programadores e informes, con las pantallas nuevas de abajo. v1 y v2 comparten registros, identificadores y clave de API, así que el cambio no mueve datos y es reversible. | Coloca el campo en tus formatos; ponlo en v2 cuando estés listo; ejecuta Configurar webhooks. Elegir la versión de la API de Payload |
| 2. Datos de tarjeta y cuenta bancaria introducidos en el formulario seguro de Payload | En un perfil v2 el número de tarjeta, el código de seguridad y el número de cuenta se escriben en un formulario que Payload sirve dentro de la pantalla de pago. Nunca pasan por Salesforce. Si una extensión del navegador lo bloquea, la pantalla lo dice a los diez segundos. | Nada que configurar. Si usas tus propios perfiles o conjuntos de permisos, concede la página y las clases del paso 2. |
| 3. Pantallas nuevas de pago y de método de pago, para cualquier tipo de sitio | Seis componentes — REDA Pay - New Pay Order (v2), Pay Order Request (v2), Pay Order Result (v2), New Pay Method (v2), Pay Method Request (v2), Pay Method Result (v2) — con los mismos ajustes, parámetros de URL, validaciones y reglas de botones que las pantallas clásicas, en un diseño pensado para el teléfono con mosaicos de métodos y una tarjeta de resultado. Se pueden colocar en sitios LWR, cosa que las pantallas clásicas no permiten. Dentro de Salesforce, el botón de pago clásico abre la pantalla v2 por sí solo cuando el perfil está en v2. | Portales y sitios públicos en v2: coloca los componentes v2 y escribe los nombres de página exactos. Portal · Enlaces públicos · Ajustes de componentes |
| 4. Webhooks firmados y la acción Actualizar secreto del webhook | En v2, Payload firma cada envío de webhook con un secreto que estableces con Actualizar secreto del webhook en el Pay Profile, y REDA Pay comprueba la firma. Configurar webhooks en un perfil v2 elimina solo los webhooks de ese perfil y registra once (los diez de v1, con credit sustituido por payout y withdraw añadido). | Añade la acción a tus formatos; habilita rpay.PayloadCallbackV2 para el usuario invitado del sitio de webhooks. Configurar webhooks |
| 5. Apariencia del pago | Las pantallas v2 siguen por defecto el tema de Salesforce o del sitio. Un campo nuevo, Apariencia del pago, en el Pay Profile, y los ajustes Brand Colour, Text Colour, Background Colour y Font Family en los componentes v2, permiten fijar tus propios colores y fuente. | Opcional. Personalizar la pantalla de pago |
| 6. Mensajes de progreso | Mientras se ejecuta un pago v2, la pantalla muestra lo que está haciendo — Preparando el pago…, Protegiendo sus datos de pago…, Preparando su pago…, Procesando su pago… Puede tardar unos segundos. Mantenga esta ventana abierta. — en lugar de un indicador giratorio. Las pantallas de método hacen lo mismo. | Nada. |
| 7. Español, francés y portugués (Brasil) | Todas las etiquetas, campos, textos de ayuda, valores de lista, secciones de formato, mensajes de validación, pestañas y botones de REDA Pay están traducidos. Un usuario cuyo idioma sea uno de estos ve REDA Pay en él. | Revisa el Idioma del usuario en su registro. Las traducciones aplican a las páginas del paquete; una página de registro que clonaste conserva tus títulos (paso 6). |
| 8. Crear enlace siempre disponible | El botón Crear enlace (Create Link) ya no desaparece cuando una cuenta de procesamiento no está configurada para enlaces. Al pulsarlo aparece: "Los enlaces de pago no están configurados para esta cuenta de procesamiento: el campo URL pública del sitio de enlaces está vacío. Pida a su administrador que lo complete." | Rellena URL pública del sitio de enlaces en las cuentas que emiten enlaces. Configurar el sitio público |
| 9. Reembolsar y Anular explican la liquidación | En un perfil v2, Refund sobre un pago no liquidado se cierra con: "Este pago aún no se ha liquidado, por lo que no se puede reembolsar. Anúlelo en su lugar o reembólselo cuando se haya liquidado (normalmente al final del día hábil)." Void sobre un pago liquidado dice: "Este pago ya se liquidó, por lo que ya no se puede anular. Reembólselo en su lugar." (v1 y v2). | Avisa a tu mesa de reembolsos. Anular o reembolsar un pago |
| 10. Todo el texto de pantalla desde etiquetas traducibles | Cada mensaje, botón y título de pestaña de las pantallas clásicas y v2, de las páginas de registro y de los flujos de REDA Pay viene de una etiqueta. Las marcas técnicas como "[Transfer Type]" ya no aparecen en los mensajes, y las pantallas de flujo ya no muestran un nombre interno como encabezado. | Nada. |
| 11. Nombres de flujo más claros | Los flujos del paquete tienen nombres y descripciones claros, de modo que un administrador que abra Configuración → Flujos ve qué hace cada uno. | Si sustituyes un flujo de REDA Pay, compáralo con la versión nueva. |
| 12. Create Missing Transactions activado por defecto en instalaciones nuevas | Una instalación nueva concilia los depósitos incluso cuando falta una Pay Transaction en Salesforce, creándola. Las actualizaciones conservan tu ajuste actual. | Paso 7. |
Corregido en esta versión
| Corrección | Qué fallaba | Ahora |
|---|---|---|
| Los demás enlaces de un cliente siguen abiertos | Cuando se pagaba, revocaba o caducaba uno de los enlaces de pago de un cliente, sus otros enlaces abiertos podían dejar de abrirse ("Invalid request: Bad request Parameters."). | Los demás enlaces siguen funcionando. Un cliente afectado antes de la actualización se repara la próxima vez que se guarda una de sus órdenes de enlace abiertas. |
| Formulario seguro en sitios LWR | En un sitio LWR el formulario v2 de tarjeta y banco no cargaba (publicado en 1.56001, corregido en 1.56002). | El formulario carga en sitios LWR y Aura y dentro de Salesforce. |
| Resumen de revisión en sitios LWR | El número de orden y los importes del resumen v2 se partían carácter por carácter en un sitio LWR. | Se leen con normalidad. |
| Páginas de resultado | Las páginas de resultado v2 mostraban el cuadro de mensaje clásico en lugar de la tarjeta de resultado de la pantalla de pago. | Muestran la misma tarjeta de resultado. |
Campos, acciones y componentes nuevos, y quién puede verlos
Los tres campos nuevos están en Pay Profile. Los conjuntos de permisos del paquete que leen Pay Profile los leen; REDA Pay - Admin User los modifica. Si usas tus propios perfiles o conjuntos de permisos, concede el acceso tú mismo (Después de actualizar, paso 2).
| Campo o acción | Dónde en el formato del paquete | Quién lo introduce | Para qué sirve |
|---|---|---|---|
| Versión de la API de Payload (lista: v1, v2) | Sección Information | Administrador | En blanco o v1: como antes. v2: este perfil usa la API v2 de Payload. Ejecuta Configurar webhooks después de cambiarlo. |
| Secreto de firma del webhook | Sección API Setup | Nadie lo escribe: se establece con la acción Actualizar secreto del webhook | Hasta 64 caracteres con los que Payload firma los envíos de webhook v2. En blanco: los envíos se aceptan sin comprobar la firma. |
| Apariencia del pago | Sección External Labels | Administrador, opcional | Colores y fuente de las pantallas v2, por ejemplo {"brandColor":"#006B63"}. En blanco: el tema del entorno. |
| Actualizar secreto del webhook (acción) | Acciones de Pay Profile, junto a Actualizar token de API | Administrador | Abre un cuadro para establecer el secreto de firma; después ejecuta Configurar webhooks. |
| Seis componentes v2 | Lightning App Builder y Experience Builder, bajo Custom - Managed, con el nombre REDA Pay - … (v2) | El administrador los coloca | Las pantallas v2 de pago y de método de pago para páginas y sitios. Referencia de ajustes de componentes |
No se añade ningún objeto, pestaña, conjunto de permisos ni página de registro nuevos. Los valores BRL, COP y CO del conjunto de valores son nuevos para las organizaciones que actualizan desde 1.56 (paso 5).