Hoja de ruta de configuración: de la instalación al primer pago
Esta página es el mapa. Enumera cada paso de configuración en el orden en que REDA Pay lo necesita, explica por qué importa cada uno y enlaza con el artículo que lo detalla. Los pasos 1 a 8 te llevan a un primer pago cobrado por tu personal dentro de Salesforce. Los pasos 9 a 12 agregan los demás canales y los procesos en segundo plano.
- REDA Pay está instalado en tu organización (Configuración → Paquetes instalados muestra REDA Pay). Tu ejecutivo de cuenta de REDA o support@reda.one te proporciona el enlace de instalación para tu edición.
- Tienes una cuenta de Payload y puedes iniciar sesión en su panel para copiar una clave de API.
- Tienes el conjunto de permisos REDA Pay - Admin User; consulta Quién puede hacer qué.
Parte 1: conectar Salesforce con Payload
1. Generar la clave de cifrado
REDA Pay cifra cada secreto que guarda (tu clave de API de Payload, los identificadores de Payload, los identificadores de los enlaces de pago) con una clave que solo existe en tu organización. Mientras la clave no exista, REDA Pay no funciona y muestra "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator."
Abre la app REDA Pay → pestaña REDA Pay Admin → Encryption Key Setup → Generate Key. La clave puede generarse una sola vez; después el botón muestra Generated. → Generar la clave de cifrado
La pestaña REDA Pay Admin. El paso 1 se hace en la primera tarjeta; el paso 11, en la segunda.
2. Crear un Pay Profile y guardar la clave de API de Payload
Un Pay Profile conecta Salesforce con una cuenta de Payload. Créalo en la pestaña Pay Profiles con un nombre, un Pay Profile Code único y Provider = Payload, dejando Is Active sin marcar. Después pulsa Update API Token en el perfil y pega la clave de API de tu panel de Payload. Nunca escribas la clave directamente en el campo API Token: el botón es lo que la cifra. → Crear un Pay Profile y guardar la clave de API de Payload
3. Sincronizar las cuentas de procesamiento y activar el perfil
Pulsa Sync Processing Accounts en el Pay Profile. REDA Pay lee tus cuentas de comercio en Payload, crea una Processing Account para cada una y completa el Profile Id del perfil. Ahora marca Is Active en el perfil: REDA Pay no permite activar un perfil hasta que tiene el token de API y el Profile Id. → Sincronizar las cuentas de procesamiento y activar el perfil
Parte 2: decidir cómo se mueve el dinero
4. Configurar cada cuenta de procesamiento
Abre cada Processing Account y define al menos Is Active, Allowed Transfer Type (Receipt, Disbursement, o Receipt and Disbursement) y Allowed Pay Methods (Card, Bank Account (ACH), o ambos). Si Allowed Pay Methods queda vacío, no se puede usar ningún método de pago. De paso, configura el logotipo, el encabezado y el pie que verán tus pagadores, y la pestaña predeterminada (tarjeta o banco). De vuelta en el Pay Profile, elige una Default Processing Account para que el personal no tenga que elegir una cada vez. → Configurar una cuenta de procesamiento · Personalizar la pantalla de pago con tu marca
5. Agregar comisiones por conveniencia (opcional)
Si trasladas los costos de procesamiento a los pagadores, agrega registros Fee Setup en la Processing Account: uno para los pagos bancarios y uno para todas las tarjetas o por marca de tarjeta. Sin un Fee Setup, las órdenes no llevan comisión. → Configurar comisiones por conveniencia
6. Revisar cómo se crean los clientes
La primera vez que alguien paga desde una cuenta, un contacto o un prospecto, REDA Pay crea un Pay Customer a partir de ese registro, con registros de asignación que se incluyen en el paquete para esos tres objetos. Revísalos antes de la puesta en marcha: deciden el nombre, el correo, el teléfono y los métodos de pago permitidos del cliente. → Cómo se crean los Pay Customers
Parte 3: permitir que tu equipo cobre
7. Asignar los conjuntos de permisos
Asigna a los administradores REDA Pay - Admin User, al personal REDA Pay - User, al equipo de reembolsos REDA Pay - Transaction Manager y a finanzas REDA Pay - Reconciliation Manager junto con REDA Pay - Read Only User. Si alguien va a enviar desembolsos, marca REDA Pay - Enable Disbursements en su registro de usuario. → Quién puede hacer qué: conjuntos de permisos
8. Poner la pantalla de pago donde trabaja el personal
Agrega el componente de pago de REDA Pay o un botón de pago a las páginas de registro que usa tu equipo, normalmente prospecto, contacto y cuenta. Luego cobra un pago de prueba pequeño. → Agregar REDA Pay a las páginas de registro · Cobrar un pago
En este punto el personal ya puede cobrar. Los estados no se actualizarán automáticamente hasta que termines el paso 9.
Parte 4: automatización y otros canales
9. Configurar webhooks
Payload avisa a Salesforce cuando un pago se procesa, se rechaza, se reembolsa o se devuelve, y cuando los depósitos llegan a tu banco. Para eso, Payload necesita una dirección pública de Salesforce a la que llamar. Crea (o reutiliza) un sitio público, da a su usuario invitado acceso a la llamada de retorno de REDA Pay, ingresa la dirección del sitio en Webhook API Base URL del Pay Profile y pulsa Setup Webhooks. Setup Webhooks primero elimina todos los webhooks registrados con esa clave de API de Payload: si la misma clave atiende a otro sistema, lee el artículo antes de pulsarlo. → Configurar webhooks
10. Enlaces de pago y tu portal de clientes
- Los enlaces de pago necesitan un sitio público con las páginas de REDA Pay, el acceso de su usuario invitado y dos ajustes en la Processing Account: Link Site Public URL y Link Expiration (Minutes). Completa ambos: un enlace creado mientras Link Expiration está vacío nunca queda activo. → Configurar el sitio público de enlaces de pago · Acceso de invitados a los enlaces de pago: permisos y uso compartido
- Los pagos en el portal necesitan las páginas de REDA Pay en tu portal de Experience Cloud y el acceso de los usuarios del portal. → Permitir que los clientes paguen en tu portal · Acceso al portal: permisos y uso compartido para clientes
11. Activar los procesos en segundo plano
- Los pagos recurrentes solo se ejecutan si el trabajo diario está programado: Configuración → Clases de Apex → Programar Apex, clase
SchedulePayOrderJob, todos los días. → Programar el trabajo diario de pagos recurrentes - La recuperación de pagos fallidos revisa cada 15 minutos los pagos cuyo resultado quedó desconocido porque se cortó la conexión con Payload. Activa el interruptor Sync Failed Pay Order Transactions en la pestaña REDA Pay Admin. → Activar la recuperación de pagos fallidos
12. Preparar la producción
- Desactiva el detalle técnico en los errores en pantalla, para que los pagadores vean un mensaje claro en lugar de un seguimiento de pila (stack trace). → Interruptores de la organización y mensajes de error
- Prueba con cada función, no como administrador: un miembro del personal, un cliente del portal y un pagador anónimo que abre un enlace.
Lista de verificación
| # | Paso | Listo cuando |
|---|---|---|
| 1 | Clave de cifrado | El botón de la pestaña Admin muestra Generated |
| 2 | Pay Profile + clave de API | El perfil existe y Update API Token se completó |
| 3 | Sincronizar + activar | Las Processing Accounts aparecen en el perfil y Is Active está marcado |
| 4 | Cuentas de procesamiento | Cada cuenta activa tiene definidos los tipos de transferencia y los métodos de pago |
| 5 | Comisiones (opcional) | Existen Fee Setups para los métodos con los que cobras comisión |
| 6 | Asignación de clientes | Registros de asignación revisados para cuenta, contacto y prospecto |
| 7 | Conjuntos de permisos | Cada usuario tiene el conjunto correcto; quienes desembolsan tienen Enable Disbursements |
| 8 | Páginas de registro | Un pago de prueba desde un prospecto muestra una Pay Transaction procesada |
| 9 | Webhooks | La pestaña Webhook Setup del perfil enumera los webhooks registrados |
| 10 | Enlaces / portal | Un enlace de prueba se abre en tu sitio público; un usuario del portal puede pagar |
| 11 | Trabajos | El trabajo diario aparece en Configuración → Trabajos programados; el interruptor de recuperación está activado |
| 12 | Producción | Seguimientos de pila desactivados; cada función probada |
Preguntas frecuentes
Sí. El pago se procesa y queda registrado. Los cambios posteriores (un pago bancario devuelto días después, un depósito que llega a tu banco) solo llegan a Salesforce una vez configurados los webhooks, o cuando alguien pulsa Sync Transaction.
No. REDA Pay incluye la configuración de sitio remoto que necesita para la API de Payload.
No. Se genera una sola vez por organización, y todo lo que REDA Pay cifra depende de ella.
Qué sigue
- Generar la clave de cifrado: el paso 1.
- Conceptos clave y terminología: si algún término de esta página no te resulta familiar.