Transacciones de cuenta de ledger

Cuando se crea una nueva transacción de cuenta de ledger, se envía un evento de webhook a una URL específica con los detalles de la transacción y su contexto de origen. Esto permite a los clientes recibir actualizaciones en tiempo real sobre movimientos de ledger dentro de sus subcuentas.

Tipos de evento

ledger_account_transaction_created: Este evento se dispara cuando se registra una nueva transacción de cuenta de ledger para una subcuenta. Incluye los detalles de la transacción y la entidad de origen que la causó.

Detalles por origen

El campo details contiene la entidad de origen que causó la transacción de ledger. Su estructura varía según el valor de origin:

Origin	Descripción
`subaccount_operation`	Una operación de subcuenta (recarga, retiro, transferencia entre cuentas, etc.).
`payout`	Una dispersión a una cuenta bancaria externa.
`card_transaction`	Una transacción de tarjeta (compra, retiro en ATM, etc.).
`card_presentment_payment`	Settlement final de una transacción internacional de tarjeta.
`fee`	Un cobro de comisión.
`synced_bank_transaction`	Una transacción bancaria sincronizada desde un banco externo.

Cuando el origen es desconocido, details será null.

Campos nullable

Los siguientes campos pueden ser null dependiendo de la transacción:

reverts_id: null cuando la transacción no revierte otra transacción.
reverted_by_id: null cuando la transacción no ha sido revertida.
details: null cuando la entidad de origen es desconocida o no está disponible.

Ejemplo de payload

Operación de subcuenta (crédito):

{
  "event": {
    "data": {
      "id": "ltx_5tgliBmzjZ6mpQPRbQjfKj",
      "operation_type": "credit",
      "origin": "subaccount_operation",
      "id_in_origin": "sao_3RJ9CbZLYq7r1MxH8vAm7Y",
      "amount": {
        "value": "150000000",
        "currency": "COP"
      },
      "transaction_at": "2025-01-15T14:30:00.000000Z",
      "origin_transaction_at": "2025-01-15T14:29:55.000000Z",
      "description": "Transfer to savings account",
      "reverts_id": null,
      "reverted_by_id": null,
      "details": {
        "id": "sao_3RJ9CbZLYq7r1MxH8vAm7Y",
        "state": "successful",
        "state_reason": null,
        "operation_type": "topup",
        "origin_account_id": "lac_7MkWDrqvfosB8fzHhb1Eql",
        "destination_account_id": null,
        "amount": {
          "value": "150000000",
          "currency": "COP"
        },
        "source_amount": {
          "value": "150000000",
          "currency": "COP"
        },
        "target_amount": null,
        "fx_rate": null,
        "external_id": "ext-transfer-12345",
        "description": "Transfer to savings account",
        "reference": "REF-2025-001",
        "metadata": {},
        "calculated_fees": []
      }
    },
    "type": "ledger_account_transaction_created"
  },
  "timestamp": "2025-01-15T14:30:05.000000Z"
}

Dispersión (débito):

{
  "event": {
    "data": {
      "id": "ltx_2PVWOx9dZKJMBZw7opjrrs",
      "operation_type": "debit",
      "origin": "payout",
      "id_in_origin": "pay_5NYRqKnE17nE0MswylZzq1",
      "amount": {
        "value": "50000000",
        "currency": "COP"
      },
      "transaction_at": "2025-01-15T16:00:00.000000Z",
      "origin_transaction_at": "2025-01-15T15:59:50.000000Z",
      "description": "Payout to external bank",
      "reverts_id": null,
      "reverted_by_id": null,
      "details": {
        "id": "pay_5NYRqKnE17nE0MswylZzq1",
        "account_id": "lac_7MkWDrqvfosB8fzHhb1Eql",
        "external_id": "ext-payout-789",
        "state": "approved",
        "state_reason": null,
        "method": "co_ach",
        "source_amount": {
          "value": "50000000",
          "currency": "COP"
        },
        "target_amount": {
          "value": "50000000",
          "currency": "COP"
        },
        "description": "Payout to external bank",
        "reference": "PAY-2025-001",
        "metadata": {},
        "calculated_fees": [],
        "inserted_at": "2025-01-15T15:59:50.000000Z",
        "updated_at": "2025-01-15T16:00:00.000000Z"
      }
    },
    "type": "ledger_account_transaction_created"
  },
  "timestamp": "2025-01-15T16:00:05.000000Z"
}

Transacción de tarjeta (débito):

{
  "event": {
    "data": {
      "id": "ltx_4kRtaBmzjZ6mpQPRbQjfKj",
      "operation_type": "debit",
      "origin": "card_transaction",
      "id_in_origin": "ctx_6WnYqKnE17nE0MswylZzq1",
      "amount": {
        "value": "25000000",
        "currency": "COP"
      },
      "transaction_at": "2025-01-15T18:00:00.000000Z",
      "origin_transaction_at": "2025-01-15T17:59:45.000000Z",
      "description": "Card purchase",
      "reverts_id": null,
      "reverted_by_id": null,
      "details": {
        "id": "ctx_6WnYqKnE17nE0MswylZzq1",
        "type": "authorization_approved",
        "state": "approved",
        "amount": {
          "value": "25000000",
          "currency": "COP"
        },
        "merchant_amount": {
          "value": "6250",
          "currency": "USD"
        },
        "declination_reason": null,
        "transaction_at": "2025-01-15T17:59:45.000000Z",
        "card_id": "car_5tgliBmzjZ6mpQPRbQjfKj",
        "merchant_name": "Almacenes Exito",
        "merchant": {
          "id": "merchant_789012345",
          "name": "Almacenes Exito",
          "mcc": "5411",
          "country": "COL"
        },
        "card": {
          "id": "car_5tgliBmzjZ6mpQPRbQjfKj",
          "last_four": "4952"
        }
      }
    },
    "type": "ledger_account_transaction_created"
  },
  "timestamp": "2025-01-15T18:00:05.000000Z"
}

Card presentment payment (débito):

{
  "event": {
    "data": {
      "id": "ltx_8rTsaBmzjZ6mpQPRbQjfKj",
      "operation_type": "debit",
      "origin": "card_presentment_payment",
      "id_in_origin": "cpp_3WnYqKnE17nE0MswylZzq1",
      "amount": {
        "value": "25000000",
        "currency": "COP"
      },
      "transaction_at": "2025-01-16T10:00:00.000000Z",
      "origin_transaction_at": "2025-01-15T18:00:00.000000Z",
      "description": "Card presentment settlement",
      "reverts_id": null,
      "reverted_by_id": null,
      "details": {
        "id": "cpp_3WnYqKnE17nE0MswylZzq1",
        "fx_rate": "4000.00",
        "paid_at": "2025-01-16T10:00:00.000000Z"
      }
    },
    "type": "ledger_account_transaction_created"
  },
  "timestamp": "2025-01-16T10:00:05.000000Z"
}

Comisión (débito):

{
  "event": {
    "data": {
      "id": "ltx_7pQWOx9dZKJMBZw7opjrrs",
      "operation_type": "debit",
      "origin": "fee",
      "id_in_origin": "fee_2DpSchlriwoCuyGMOoIuwp",
      "amount": {
        "value": "1500000",
        "currency": "COP"
      },
      "transaction_at": "2025-01-15T18:00:01.000000Z",
      "origin_transaction_at": "2025-01-15T18:00:00.000000Z",
      "description": "Transaction fee",
      "reverts_id": null,
      "reverted_by_id": null,
      "details": {
        "id": "fee_2DpSchlriwoCuyGMOoIuwp",
        "type": "transaction",
        "amount": {
          "value": "1500000",
          "currency": "COP"
        },
        "processing_type": "card",
        "processing_subtype": "authorization",
        "tx_description": "Transaction fee",
        "state": "successful",
        "transaction_at": "2025-01-15T18:00:00.000000Z",
        "origin": "card_transaction",
        "id_in_origin": "ctx_6WnYqKnE17nE0MswylZzq1"
      }
    },
    "type": "ledger_account_transaction_created"
  },
  "timestamp": "2025-01-15T18:00:05.000000Z"
}

Transacción bancaria sincronizada (crédito):

{
  "event": {
    "data": {
      "id": "ltx_6kRtaBmzjZ6mpQPRbQjfKj",
      "operation_type": "credit",
      "origin": "synced_bank_transaction",
      "id_in_origin": "sbt_4NYRqKnE17nE0MswylZzq1",
      "amount": {
        "value": "200000000",
        "currency": "COP"
      },
      "transaction_at": "2025-01-15T20:00:00.000000Z",
      "origin_transaction_at": "2025-01-15T19:55:00.000000Z",
      "description": "External bank deposit",
      "reverts_id": null,
      "reverted_by_id": null,
      "details": {
        "id": "sbt_4NYRqKnE17nE0MswylZzq1"
      }
    },
    "type": "ledger_account_transaction_created"
  },
  "timestamp": "2025-01-15T20:00:05.000000Z"
}

Transacciones de cuenta de ledger

En esta página