Generar la clave de cifrado

Antes de que REDA Pay pueda hacer nada, necesita una clave de cifrado. REDA Pay usa esta clave para cifrar cada secreto que guarda en tu organización: la clave de API de Payload, los identificadores que Payload asigna a tu perfil, a tus cuentas de procesamiento, a tus clientes y a sus métodos de pago, y los identificadores ocultos dentro de los enlaces de pago. Generar la clave es un paso de un solo clic, que se hace una vez, en la pestaña REDA Pay Admin. Hasta que lo hagas, cada pantalla de REDA Pay se detiene con el mensaje "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator."

Antes de empezar

REDA Pay está instalado (Configuración → Paquetes instalados muestra REDA Pay).
Tienes el conjunto de permisos REDA Pay - Admin User; consulta Quién puede hacer qué. Los botones de la pestaña Admin no hacen nada para otros usuarios.

Por qué existe la clave

Payload identifica a tu organización, a cada cuenta de comercio, a cada cliente y a cada tarjeta o cuenta bancaria guardada mediante un identificador. Si cualquiera que abre un registro pudiera leer esos identificadores, una persona con acceso de lectura a tu organización sabría lo suficiente para llamar a Payload en tu nombre. Por eso REDA Pay los guarda cifrados, y lo único que puede descifrarlos es la clave que se guarda en tu organización. La misma clave protege tu clave de API de Payload; por eso la clave de API debe ingresarse con el botón Update API Token y no escribirse en el campo: el botón la cifra con esta clave.

La clave se crea una vez y nunca se muestra a nadie. REDA Pay la guarda en un ajuste protegido que solo el propio paquete puede leer.

Generar la clave

Abre el Iniciador de aplicación (la cuadrícula de nueve puntos arriba a la izquierda), busca REDA Pay y abre la app.
Haz clic en la pestaña REDA Pay Admin.
En la tarjeta Encryption Key Setup, lee la nota: "REDA Pay "Encryption Key" is must for REDA Pay App to function. If the "Encryption Key" is not generated, generate the key using following button." (la clave de cifrado es imprescindible para que la app funcione; si no está generada, genérala con el botón).
Haz clic en Generate Key.
El botón cambia a Generated y queda atenuado. Eso es todo el paso: no hay nada que copiar, guardar ni ingresar en ningún sitio.

La pestaña REDA Pay Admin con la tarjeta Encryption Key Setup; el botón muestra "Generated" porque la clave ya existe en esta organización

Una vez generada la clave, el botón muestra "Generated". Nada más cambia en esta tarjeta después.

Si el botón ya muestra Generated cuando llegas, alguien hizo este paso antes y puedes pasar a Crear un Pay Profile.

Lo que no puedes hacer después

No puedes generar la clave una segunda vez. El botón se desactiva en cuanto existe una clave. Todo lo que REDA Pay cifró depende de esa clave, así que reemplazarla volvería ilegible cada secreto guardado.
No puedes ver ni exportar la clave. No se muestra en ninguna pantalla ni se guarda en ningún campo que puedas leer.
Revisa cada organización por separado. Después de crear o actualizar un sandbox, abre la pestaña REDA Pay Admin del sandbox antes de confiar en REDA Pay allí. Si el botón muestra Generate Key, genera la clave en ese sandbox y luego configura allí un Pay Profile con una clave de API de Payload de tu entorno de prueba.

Qué protege la clave

Cifrado con esta clave	Dónde está
El token de API de Payload	Pay Profile → API Token
El identificador de tu organización en Payload	Pay Profile → Profile Id
Los identificadores de Payload de cada cuenta de comercio	Processing Account → Processing Account Id, Parent Id
El identificador de Payload de cada cliente	Pay Customer → Customer Id
El token que Payload usa en lugar de cada tarjeta o cuenta bancaria guardada	Pay Method → Pay Method Id
El identificador de la orden dentro de cada enlace de pago	Pay Order → Encrypted Id, usado en Link URL
El identificador de la cuenta de procesamiento en cada transacción	Pay Transaction → Processing Id

Quien lea estos registros ve texto cifrado. La clave en sí se guarda en un ajuste protegido que solo el código de REDA Pay puede leer; no aparece en Configuración, no se puede consultar y no se puede exportar.

Qué decirle a un auditor

Los secretos y los identificadores se guardan cifrados con una clave generada dentro de la organización que nunca se muestra.
Los números de tarjeta, los códigos de seguridad y los números de cuenta bancaria nunca se guardan; consulta Seguridad y datos de tarjetas.
Un administrador con el conjunto de permisos REDA Pay - Admin User crea la clave una vez por organización, y no se puede volver a generar, reemplazar ni exportar.

Comprobar que funcionó

Abre la pestaña Pay Profiles y crea un Pay Profile como se describe en Crear un Pay Profile. Cuando pulses Update API Token y guardes una clave, el token se acepta y el campo API Token muestra un valor cifrado. Si en cambio ves "REDA Pay setting(s) are invalid or not defined. Please contact your system administrator.", falta la clave de cifrado: vuelve a la pestaña Admin y genérala.

Errores que debes evitar

Error	Qué ves	Solución
Usar REDA Pay antes de generar la clave	"REDA Pay setting(s) are invalid or not defined. Please contact your system administrator." en cada pantalla	Genera la clave en la pestaña REDA Pay Admin
Esperar una clave para copiar o descargar	No aparece nada después de pulsar el botón	Así debe ser: la clave se queda dentro de la organización
Suponer que un sandbox actualizado está listo	"REDA Pay setting(s) are invalid or not defined…" en el sandbox	Abre la pestaña Admin del sandbox; genera allí la clave si el botón todavía muestra Generate Key
Que un usuario que no es administrador pulse Generate Key	El botón no hace nada o informa un error	Asigna REDA Pay - Admin User e inténtalo de nuevo

Preguntas frecuentes

No. La clave de API de Payload la emite Payload e identifica tu cuenta ante ellos. La clave de cifrado la crea REDA Pay dentro de tu organización y solo sirve para proteger la clave de API de Payload y los demás identificadores mientras se guardan en Salesforce. La clave de API de Payload la ingresas en el paso siguiente; la clave de cifrado nunca la ves.

No. Crea un valor dentro de tu organización de Salesforce y nada sale de ella.

Comprueba que estás en la organización que crees: un sandbox y su organización de producción tienen cada uno su propia clave. Si estás en la organización correcta, escribe a support@reda.one con el nombre de la organización.

Qué sigue

Crear un Pay Profile y guardar la clave de API de Payload: el siguiente paso.
Hoja de ruta de configuración: dónde encaja este paso en toda la configuración.