Skip to main content
Una operación es la unidad más pequeña de una transacción. Cada transacción contiene dos o más operaciones (Figura 1). Cada operación registra un cambio en el saldo de una cuenta:
  • Una operación de débito registra el valor que sale de una cuenta (el origen).
  • Una operación de crédito registra el valor que entra a una cuenta (el destino).
El efecto en el saldo almacenado depende de la direction del saldo. Una cuenta normal (el caso común) se reduce con un débito y aumenta con un crédito. Una transacción contiene operaciones que deben sumar cero desde la perspectiva del ledger. Por ejemplo, un pago P2P con una comisión incluye:
  • un débito de $100 de la cuenta del remitente.
  • un crédito de $98 a la cuenta del destinatario.
  • un crédito de $2 a la cuenta de comisión de la plataforma.
Midaz se asegura de que una transacción balancee antes de confirmarla. Las operaciones también llevan metadatos como marcas de tiempo y referencias a la transacción a la que pertenecen. Creas una transacción a través de la API JSON de Midaz. Para cada transacción, especificas un conjunto de operaciones. Cada operación tiene un monto, un activo y una cuenta de origen o destino.

​
Características clave

  • Cada operación pertenece a una transacción y hace referencia a una cuenta y un activo específicos.
  • Las operaciones incluyen metadatos como monto, dirección (débito/crédito), tipo, marcas de tiempo, referencias y más.
  • Midaz crea las operaciones cuando empiezas una transacción y las completa con los datos que proporcionas.
  • Midaz valida todas las operaciones según las reglas configuradas antes de confirmarlas en el ledger.
Cada operación tiene una direction (debit o credit) y un type. La direction es la columna vertebral de partida doble descrita anteriormente. El type clasifica el movimiento. Además de los valores estándar CREDIT y DEBIT, el type marca movimientos especiales:
  • ON_HOLD y RELEASE: reservas de fondos en dos fases.
  • OVERDRAFT: operaciones complementarias generadas por el sistema en el saldo interno de sobregiro.
  • BLOCK y UNBLOCK: la etiqueta aplicada a cada operación de una transacción creada a través de los endpoints dedicados de bloqueo y desbloqueo. La etiqueta reemplaza solo el type de la operación, nunca su dirección ni su monto.
La direction siempre conserva su significado de débito o crédito, sin importar el type.

​
Rutas de Operación

Con las Rutas Contables, cada operación se conecta a una lógica de validación estructurada. Esa lógica vive en Rutas de Operación.

​
¿Qué es una Ruta de Operación?

Una Ruta de Operación es una regla de validación. Define qué tipos de cuenta o cuentas específicas puede usar un componente de la transacción. También establece la dirección contable (origen o destino) y una anotación descriptiva. Es una capa de validación entre la entrada de la transacción y la estructura del ledger. Cada operación que envías debe cumplir con los requisitos de cuenta y las reglas de negocio.
Las transacciones contienen varias operaciones. Las Rutas de Operación validan cada operación según las reglas de validación configuradas.

​
Relación Operación > Ruta de Operación

Cuando envías una transacción a Midaz, esta contiene varias Operaciones. Con los Tipos de Cuenta y las Rutas Contables habilitados, Midaz valida cada operación según las reglas de las Rutas de Operación. Esto garantiza que:
  • La cuenta especificada coincide con el tipo de cuenta esperado o con el requisito de cuenta específica.
  • La dirección de la operación (débito/crédito) coincide con la definición de la ruta.
Si las operaciones que envías no coinciden con los requisitos configurados de la Ruta de Operación, Midaz falla la validación y rechaza la transacción.

​
Gestión de Operaciones

Midaz genera las operaciones automáticamente como parte del flujo de una transacción. No puedes crear una operación directamente. Puedes consultar una operación cuando lo necesites.