Skip to main content
Esta guía está pensada para desarrolladores que configuran Midaz por primera vez. Si buscas un resumen de negocio de cómo funciona Midaz, consulta ¿Qué es Midaz?. Para conocer las opciones de despliegue, consulta SaaS y BYOC.
Sigue estos pasos para configurar Midaz.

Paso 1 - Configura tu entorno


Para configurar tu entorno de Midaz, sigue los pasos de la página Instalación del monorepo de Midaz.
  • Esto instalará Midaz Ledger.

Autenticación y autorización

Midaz no incluye un sistema integrado de autenticación ni autorización. Esto te da la flexibilidad de integrarte con tu proveedor de identidad o tu stack de seguridad existente. Si necesitas una solución lista para usar, puedes habilitar Access Manager, una función opcional desarrollada por Lerian. Se encarga tanto de la autenticación como de la autorización en todo tu ecosistema Lerian, incluidos Midaz y el resto de los productos de Lerian.
Access Manager admite estándares de identidad comunes como OAuth2 y OIDC, y se integra de forma nativa con todos los productos de Lerian. Para más detalles, consulta la guía de Access Manager.

Paso 2 - Crea tu estructura de Midaz


Empieza por crear la estructura de datos que usan tus workflows.

Paso 2.1 - Crea una organización

El primer paso es crear tu organización dentro de Midaz.
Si tu organización tiene varias sucursales, puedes crear varias organizaciones y designar una organización principal.Por ejemplo, si la empresa XYZ tiene sucursales en Nueva York y Brasil, puedes crear una organización para la empresa XYZ y establecerla como principal de XYZ Nueva York y XYZ Brasil.
Para ver la lista completa de endpoints para gestionar tu organización, expande la siguiente sección:

Paso 2.2 - Crea un ledger

Cada organización debe tener al menos un ledger. Sin embargo, puedes tener varios ledgers dentro de cada organización si lo necesitas. Para ver la lista completa de endpoints para gestionar tu ledger, expande la siguiente sección:
  • Recupera todos los ledgers con el endpoint Listar ledgers.
  • Recupera un ledger específico con el endpoint Recuperar un ledger.
  • Actualiza los detalles de un ledger con el endpoint Actualizar un ledger.
  • Elimina un ledger en Homologación con el endpoint Eliminar un ledger.
    • Para ledgers en Producción, la eliminación requiere contactar al soporte de Lerian por motivos de seguridad.

Paso 2.3 - Crea los activos

Tu organización puede tener varios activos. Sin embargo, cada activo debe crearse de forma individual, lo que permite configuraciones específicas como la cantidad de decimales.
Cuando creas un activo, Midaz configura automáticamente una cuenta externa si aún no existe una. La cuenta externa respalda todas las transacciones que entran y salen del ledger.
Para ver la lista completa de endpoints para gestionar tus activos, expande la siguiente sección:

Paso 2.4 - Crea un segmento (opcional)

Si quieres, puedes usar el ID de segmento como una etiqueta de agrupación personalizada que agrupa cuentas según políticas definidas por el usuario. Para ver la lista completa de endpoints para gestionar tu segmento, expande la siguiente sección:

Paso 2.5 - Crea un portafolio

Crea un portafolio para agrupar tus cuentas de distintos activos. Para ver la lista completa de endpoints para gestionar tus portafolios, expande la siguiente sección:

Paso 2.6 - Crea las cuentas

Ahora puedes agregar las cuentas relacionadas con los activos que quieres usar con el ledger. Debes crear una cuenta por cada activo. Para ver la lista completa de endpoints para gestionar tus cuentas, expande la siguiente sección:

Paso 3 - Explora nuestras API


Consulta la referencia de la API para conocer más sobre Midaz, desde el manejo de metadatos hasta la idempotencia.

¿Necesitas ayuda?