Gestión de usuarios
1. Creación de la cuenta maestra
Una cuenta maestra se crea al registrase el cliente recaudador final en SyPago.
Esta cuenta tiene los permisos requeridos para realizar cobro, emitir pagos, afiliar cuentas y gestionar usuarios.
2. Genera tu API Key (Usuario maestro)
El API Key es la forma de autenticarte en nuestra API.
El usuario maestro debe comenzar por generar una API Key. Aunque la clave generada por el usuario maestro puede ser desechada más tarde, este paso es fundamental. Al crear esta API Key, se activa la funcionalidad que permite a los usuarios, con permisos, generar sus propias claves acceder y utilizar los servicios de la API.
Para obtener esta clave, sigue los siguientes pasos:
Accede a tu perfil: ubica la sección de perfil en la parte superior derecha (versión web) o superior izquierda (versión móvil) de la pantalla.
API Key dinámico o fijo: selecciona el tipo de API Key de tu preferencia. Para detalles dirígete al apartado de API Key.
Genera tu API Key: busca la opción "Generar API Key" y haz clic en ella.
Guarda tu API Key: el API Key generado es único para tu cuenta. Guárdalo en un lugar seguro y confidencial, ya que te será necesario para realizar todas las solicitudes a nuestra API. Si pierdes tu API Key, podrás generar uno nuevo, pero recuerda actualizarlo en todas las integraciones donde lo estés utilizando.
3. Generación del usuario técnico
Este usuario está destinado exclusivamente para el usuario técnico.
Desde el panel de control de su cuenta maestra, el cliente recaudador, crea un nuevo "usuario".
A continuación, el cliente recaudador debe llenar los datos del usuario (nombre de usuario, tipo de documento, número de documento, nombre, apellido, email, número de teléfono, contraseña y confirmar contraseña) para crear al usuario técnico en la plataforma.
Es indispensable que el usuario maestro haya generado un APIkey desde su usuario, para que el resto de los usuarios puedan generar el suyo.
4. Asignación de roles y permisos
Este paso es clave para la seguridad del proceso. Al crear el usuario técnico, el cliente recaudador debe asignar un rol y permisos asociados. , Solo se debe otorgar permisos para cobrar (generar solicitudes de pago, consultar estatus de cobros, etc.)
5. Inicio de sesión del usuario técnico
Una vez que tengas las credenciales de tu cuenta técnica (usuario y contraseña), es momento de iniciar sesión en la plataforma de SyPago.
El formato para el nombre de usuario es: maestro@usuario.
Al ingresar por primera vez, el sistema te pedirá que cambies la contraseña. Esto es un paso de seguridad obligatorio y la nueva contraseña quedará registrada para todos los accesos futuros de este subusuario. Una vez dentro, recuerda que tu vista y funcionalidad estará limitada de acuerdo a los permisos que te hayan sido otorgados.
6. Generación de la API Key
Una vez que el usuario técnico ha iniciado sesión, por primera vez, procede a generar una API Key (Clave de API). Es fundamental entender que esta API Key estará ligada a este usuario, no a la cuenta maestra. En este sentido, todas las acciones que se ejecuten con esa API Key heredarán las limitaciones del usuario técnico (solo cobrar).
7. Gestión de la cobranza
Con la API Key en manos,del usuario técnico, se habilita la integración de los sistemas del negocio (página web, aplicación, sistema de facturación, etc.) con la plataforma de SyPago.
El usuario técnico puede realizar funciones específicas dentro de la plataforma (como cobrar, realizar pagos o ambas) basándose en los permisos que se le hayan otorgado por el usuario maestro.