Requisitos previos
Para usar estas APIs, tu organización debe tener la propiedad whitelabel habilitada en el Dashboard de Yuno. Contacta a tu gerente de cuenta de Yuno para habilitar esta función.
Flujo principal de gestión
Sigue estos pasos para configurar un nuevo entorno de comercio.1
Crea un grupo de cuentas
El grupo de cuentas actúa como la entidad principal de tu comercio y centraliza la gestión de las cuentas relacionadas. Usa el endpoint Create Account Group para inicializar este grupo.Salida y siguientes pasos: La respuesta incluirá un
id único para el grupo de cuentas. Guarda este ID, ya que lo necesitarás para crear cuentas de comercio específicas en el siguiente paso.2
Crea una cuenta
Dentro del grupo de cuentas recién creado, puedes crear una o más cuentas. Esta estructura te permite separar la lógica de negocio, las regiones o las líneas de negocio de un mismo comercio. Usa el endpoint Create Account.Salida y siguientes pasos: Recibirás un
id para la cuenta de comercio. Este ID se usa para acotar pagos, sesiones y configuraciones específicamente a este entorno de comercio.3
Crea un usuario y asigna permisos
Por último, crea un usuario real y otórgale acceso a la cuenta o a todo el grupo de cuentas. Asignar roles (como Salida y siguientes pasos: El usuario se creará en el sistema. Para permitirle iniciar sesión en tu portal whitelabel, usa el endpoint Authenticate Whitelabel User para generar un token de acceso seguro.
merchant-admin) garantiza que el usuario tenga los permisos necesarios para gestionar el Dashboard del comercio. Usa el endpoint Create User.Anidar grupos de cuentas
Los grupos de cuentas se pueden anidar para reflejar cómo está estructurada tu organización: un grupo puede contener cuentas y subgrupos, y un subgrupo puede contener grupos propios. Cada grupo tiene como máximo un padre, y un grupo no puede anidarse dentro de su propio subárbol. Un grupo siempre se crea como raíz. Para anidarlo, defineparent_code en Update Account Group; envía parent_code: null para desvincularlo y volver a convertirlo en raíz. Cada respuesta de grupo de cuentas informa el padre en parent_code (null para una raíz).