Saltar al contenido principal
Yuno ofrece un conjunto de APIs de gestión de organizaciones B2B diseñadas para plataformas y socios white-label que necesitan gestionar varias suborganizaciones y sus usuarios. Estas APIs te permiten automatizar el onboarding de tus comercios mediante la creación de una estructura jerárquica de grupos de cuentas, cuentas y usuarios.
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 merchant-admin) garantiza que el usuario tenga los permisos necesarios para gestionar el Dashboard del comercio. Usa el endpoint Create User.
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.

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, define parent_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).
El anidamiento es solo estructural: mover un grupo no concede ni revoca nada, por lo que los permisos de usuario existentes no cambian. Un grupo que aún tiene subgrupos o cuentas no se puede eliminar: muévelos o quítalos primero.

Gestionar proveedores mediante la API

Una vez que tus comercios pueden iniciar sesión, la pestaña Providers de tu Dashboard white-label decide a qué proveedores de pago pueden conectarse y qué leen tus usuarios mientras lo hacen. Esa capa se puede configurar mediante la API: qué proveedores ofreces, y el nombre, las instrucciones de conexión, el enlace de documentación y el logotipo que se muestran para cada uno. Consulta la Descripción general de proveedores white-label para ver el contrato común y los endpoints.

Disponibilidad por entorno

Las APIs de gestión de organizaciones B2B están disponibles en los entornos Sandbox y Producción. Para más información sobre cómo gestionar tus claves de API y URL base, visita la página de Entornos.

Siguientes pasos

Explora la referencia completa de la API para ver opciones de gestión más avanzadas: