> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirmar una Transacción Pendiente

> Utilice este endpoint para confirmar una transacción pendiente que fue creada previamente y puesta en espera. Solo las transacciones en estado PENDING pueden confirmarse; confirmar una transacción en cualquier otro estado devuelve 422 (ErrCommitTransactionNotPending, código 0099).



## OpenAPI

````yaml es/openapi/v3-current/ledger.yaml post /v1/organizations/{organization_id}/ledgers/{ledger_id}/transactions/{transaction_id}/commit
openapi: 3.1.0
info:
  title: API de Midaz Ledger
  description: >-
    Referencia completa de la API para los servicios de Midaz Ledger, incluyendo
    gestión de organizaciones, operaciones de ledger, activos, segmentos,
    portafolios, cuentas, tipos de cuenta, transacciones, operaciones, saldos,
    rutas de operación, rutas de transacción e índices de metadatos.
  version: 3.7.8
servers:
  - url: https://ledger.sandbox.lerian.net
security: []
tags:
  - name: Organizations API
  - name: Ledgers API
  - name: Assets API
  - name: Segments API
  - name: Portfolios API
  - name: Account Types API
  - name: Accounts API
  - name: Balances API
  - name: Transactions API
  - name: Operations API
  - name: Operation Routes API
  - name: Transaction Routes API
  - name: Metadata Indexes API
  - name: Holders API
  - name: Instruments API
  - name: Billing Packages API
  - name: Packages API
  - name: Billing Calculation API
  - name: Estimation API
  - name: Encryption API
  - name: Protection API
  - name: Asset Rates API
paths:
  /v1/organizations/{organization_id}/ledgers/{ledger_id}/transactions/{transaction_id}/commit:
    post:
      tags:
        - Transactions API
      summary: Confirmar una Transacción Pendiente
      description: >-
        Utilice este endpoint para confirmar una transacción pendiente que fue
        creada previamente y puesta en espera. Solo las transacciones en estado
        PENDING pueden confirmarse; confirmar una transacción en cualquier otro
        estado devuelve 422 (ErrCommitTransactionNotPending, código 0099).
      parameters:
        - $ref: '#/components/parameters/OrganizationId'
        - $ref: '#/components/parameters/LedgerId'
        - $ref: '#/components/parameters/TransactionId'
      responses:
        '201':
          description: >-
            Indica que la solicitud fue exitosa y la respuesta contiene los
            datos esperados.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateTransactionResponse'
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0009:
                  $ref: '#/components/examples/Error0009'
                Error0032:
                  $ref: '#/components/examples/Error0032'
                Error0047:
                  $ref: '#/components/examples/Error0047'
                Error0067:
                  $ref: '#/components/examples/Error0067'
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0041:
                  $ref: '#/components/examples/Error0041'
                Error0042:
                  $ref: '#/components/examples/Error0042'
        '403':
          description: Prohibido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0043:
                  $ref: '#/components/examples/Error0043'
        '404':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0007:
                  $ref: '#/components/examples/Error0007'
        '422':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0099:
                  $ref: '#/components/examples/Error0099'
        '500':
          description: Error Interno del Servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorFormat'
              examples:
                Error0046:
                  $ref: '#/components/examples/Error0046'
components:
  parameters:
    OrganizationId:
      name: organization_id
      in: path
      description: El identificador único de la Organización asociada al Ledger.
      required: true
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
        format: uuid
    LedgerId:
      name: ledger_id
      in: path
      description: El identificador único del Ledger asociado.
      required: true
      example: 019c96a0-0ac0-7de9-9f53-9cf842a2ee5a
      schema:
        type: string
        format: uuid
    TransactionId:
      name: transaction_id
      in: path
      description: El identificador único de la transacción que desea recuperar.
      required: true
      example: 019c96a0-10ce-75fc-a273-dc799079a99c
      schema:
        type: string
        format: uuid
  schemas:
    CreateTransactionResponse:
      type: object
      properties:
        id:
          type: string
          description: El identificador único de la transacción.
          format: uuid
        parentTransactionId:
          type: string
          description: >-
            El identificador único de la transacción padre/original para
            reversiones. Este campo es completado por el servidor cuando una
            transacción es revertida y debe ser tratado como solo lectura por
            los clientes.
          format: uuid
          nullable: true
        organizationId:
          type: string
          format: uuid
          description: El identificador único de la Organización.
        ledgerId:
          type: string
          description: El identificador único del Ledger.
          format: uuid
        description:
          type: string
          description: Descripción de la transacción.
        route:
          type: string
          description: Especifica la Ruta de Transacción asociada a la transacción.
        routeId:
          type: string
          format: uuid
          description: >-
            El identificador único de la Ruta de Transacción aplicada a esta
            transacción.
        status:
          type: object
          description: El estado de la transacción (pendiente, completada, revertida).
          properties:
            code:
              type: string
              description: Código de estado de la transacción.
            description:
              type: string
              description: Descripción del estado de la transacción.
        amount:
          type: string
          description: El monto enviado.
        assetCode:
          type: string
          description: El nombre del activo utilizado en la operación.
        chartOfAccountsGroupName:
          type: string
          description: El nombre del grupo del plan de cuentas.
        source:
          type: array
          description: La lista de cuentas utilizadas como origen.
          items:
            type: string
        destination:
          type: array
          description: La lista de cuentas utilizadas como destino.
          items:
            type: string
        createdAt:
          type: string
          format: date-time
          description: Fecha y hora de creación (UTC).
        updatedAt:
          type: string
          format: date-time
          description: Fecha y hora de la última actualización (UTC).
        deletedAt:
          type: string
          format: date-time
          description: Fecha y hora de la eliminación lógica, si aplica (UTC).
          nullable: true
        operations:
          type: array
          items:
            $ref: '#/components/schemas/OperationResponse'
        metadata:
          $ref: '#/components/schemas/Metadata'
    ErrorFormat:
      type: object
      description: El mensaje de error de respuesta.
      required:
        - code
        - title
        - message
      properties:
        code:
          type: string
          description: Un identificador único y estable para el error.
        title:
          type: string
          description: Un breve resumen del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
        entityType:
          type: string
          description: >-
            El tipo de entidad a la que se refiere el error (p. ej.
            organization, ledger, account, transaction). Opcional.
        fields:
          type: object
          additionalProperties: true
          description: Información adicional sobre los campos que causaron el error.
    OperationResponse:
      type: object
      properties:
        id:
          type: string
          description: El identificador único de la Operación.
          format: uuid
        transactionId:
          type: string
          format: uuid
          description: El identificador único de la Transacción.
        organizationId:
          type: string
          format: uuid
          description: El identificador único de la Organización.
        ledgerId:
          type: string
          description: El identificador único del Ledger.
          format: uuid
        accountId:
          type: string
          description: El identificador único de la Cuenta.
          format: uuid
        accountAlias:
          type: string
          description: El alias de la cuenta utilizada en la operación.
        balanceId:
          type: string
          description: El identificador único del Saldo.
        balanceKey:
          type: string
          description: El identificador de clave del Saldo.
        description:
          type: string
          description: Una descripción para la operación.
        type:
          type: string
          description: >-
            El tipo de la operación. `OVERDRAFT` identifica operaciones
            companion generadas por el sistema en el saldo interno `"overdraft"`
            — `direction` lleva entonces la semántica del ciclo de vida (`debit`
            para un draw, `credit` para un reembolso). `BLOCK` y `UNBLOCK`
            identifican operaciones producidas por los endpoints de transacción
            de bloqueo/desbloqueo; `direction` sigue llevando la semántica de
            débito/crédito.
          enum:
            - CREDIT
            - DEBIT
            - ON_HOLD
            - RELEASE
            - OVERDRAFT
            - BLOCK
            - UNBLOCK
        assetCode:
          type: string
          description: El código que identifica el activo enviado.
        chartOfAccounts:
          type: string
          description: El nombre del Plan de Cuentas al que pertenece la operación.
        route:
          type: string
          deprecated: true
          description: >-
            **Obsoleto.** Use `routeId` en su lugar. Se eliminará en la próxima
            versión mayor.
        routeId:
          type: string
          format: uuid
          description: >-
            El identificador único de la ruta de operación asociada a esta
            operación. Las operaciones companion de overdraft heredan este valor
            de la operación primaria que las generó.
        routeCode:
          type: string
          maxLength: 100
          description: >-
            Un código legible de la ruta de operación, útil para auditoría y
            rastreabilidad.
        routeDescription:
          type: string
          description: La descripción de la ruta de operación asociada a esta operación.
        direction:
          type: string
          enum:
            - debit
            - credit
          description: La dirección de la operación en la contabilidad de partida doble.
        amount:
          type: object
          description: >-
            Un objeto que contiene información sobre el monto utilizado en la
            operación.
          properties:
            value:
              type: string
              description: El monto que se enviará.
        balance:
          type: object
          description: >-
            Un objeto que contiene información sobre el saldo antes de la
            operación.
          properties:
            available:
              type: string
              description: Saldo disponible anterior.
            onHold:
              type: string
              description: Monto retenido/reservado.
            version:
              type: integer
              description: Versión del saldo, que se actualiza con cada transacción.
            overdraftUsed:
              type: string
              description: >-
                El overdraft consumido por este saldo antes de la operación,
                como string decimal. `"0"` para operaciones que no tocan el
                overdraft.
        balanceAfter:
          type: object
          description: >-
            Un objeto que contiene información sobre el saldo después de la
            operación.
          properties:
            available:
              type: string
              description: Saldo disponible actual.
            onHold:
              type: string
              description: Monto retenido/reservado.
            version:
              type: integer
              description: Versión del saldo, que se actualiza con cada transacción.
            overdraftUsed:
              type: string
              description: >-
                El overdraft consumido por este saldo después de la operación,
                como string decimal. `"0"` para operaciones que no tocan el
                overdraft.
        status:
          type: object
          description: El estado de la transacción (pendiente, completada, revertida).
          properties:
            code:
              type: string
              description: Código de estado de la transacción.
            description:
              type: string
              description: Descripción del estado de la transacción.
              nullable: true
        balanceAffected:
          type: boolean
          description: Indica si la operación tuvo impacto en el saldo de la cuenta.
        createdAt:
          type: string
          format: date-time
          description: Fecha y hora de creación (UTC).
        updatedAt:
          type: string
          format: date-time
          description: Fecha y hora de la última actualización (UTC).
        deletedAt:
          type: string
          format: date-time
          description: Fecha y hora de la eliminación lógica, si aplica (UTC).
          nullable: true
        metadata:
          $ref: '#/components/schemas/Metadata'
    Metadata:
      type: object
      additionalProperties:
        oneOf:
          - type: string
            maxLength: 2000
          - type: number
          - type: boolean
      description: >-
        Un objeto que contiene pares clave-valor para agregar como metadatos,
        donde el campo `name` es la clave y el campo `value` es el valor. Por
        ejemplo, para agregar un Centro de Costo, use `'costCenter':
        'BR_11101997'`.


        **Restricciones:** las claves deben tener como máximo 100 caracteres;
        los valores de cadena de texto, como máximo 2000 caracteres. No se
        permiten objetos anidados (los valores deben ser cadena de texto, número
        o booleano), la estructura no puede exceder una profundidad máxima de
        10, y se permite un máximo de 100 claves.
  examples:
    Error0009:
      summary: Missing Fields in Request
      value:
        code: 9
        title: Missing Fields in Request
        message: >-
          Your request is missing one or more required fields. Please refer to
          the documentation to ensure all necessary fields are included in your
          request.
        fields:
          metadataKey: metadataKey is a required field
    Error0032:
      value:
        code: '0032'
        title: Invalid Country Code
        message: >-
          The provided country code in the 'address.country' field does not
          conform to the ISO-3166 alpha-2 standard. Please provide a valid
          alpha-2 country code.
      summary: Invalid Country Code
    Error0047:
      summary: Bad Request
      value:
        code: '0047'
        title: Bad Request
        message: >-
          The server could not understand the request due to malformed syntax.
          Please check the listed fields and try again.
    Error0067:
      value:
        code: '0067'
        title: Invalid Metadata Nesting
        message: >-
          The metadata object cannot contain nested values. Please ensure that
          the value {{value}} is not nested and try again.
      summary: Invalid Metadata Nesting
    Error0041:
      summary: Token Missing
      value:
        code: '0041'
        title: Token Missing
        message: >-
          A valid token must be provided in the request header. Please include a
          token and try again.
    Error0042:
      summary: Invalid Token
      value:
        code: '0042'
        title: Invalid Token
        message: >-
          The provided token is expired, invalid or malformed. Please provide a
          valid token and try again.
    Error0043:
      summary: Insufficient Privileges
      value:
        code: '0043'
        title: Insufficient Privileges
        message: >-
          You do not have the necessary permissions to perform this action.
          Please contact your administrator if you believe this is an error.
    Error0007:
      value:
        code: '0007'
        title: Entity Not Found
        message: >-
          No entity was found for the given ID. Please make sure to use the
          correct ID for the entity you are trying to manage.
      summary: Entity Not Found
    Error0099:
      value:
        code: 99
        title: Invalid Transaction Status
        message: >-
          The transaction status does not allow the requested action. Only
          transactions in PENDING status can be committed or cancelled. Please
          check the transaction status.
      summary: Invalid Transaction Status
    Error0046:
      summary: Internal Server Error
      value:
        code: '0046'
        title: Internal Server Error
        message: >-
          The server encountered an unexpected error. Please try again later or
          contact support.

````