Nueva transacción

Eventos

wallet.transaction.created

Se emite un evento por cada movimiento de saldo. Una sola operación puede generar varios: un cobro con tarjeta produce el abono (PAYIN), el cargo de la comisión (PAYIN_COMMISSION) y, si tu empresa tiene retención configurada, el crédito de retefuente (RETE_RENTA). Los tres comparten node_id.

Campos de `transaction`

string

ID del movimiento.

string

deposit o withdraw.

number

Monto en unidades mayores de la moneda, no en centavos.

string

Naturaleza del movimiento: PAYIN, PAYIN_COMMISSION, RETE_RENTA, PAYOUT, WALLET_TRANSFER, entre otros.

string

Tipo de la entidad que originó el movimiento: Charge, CashoutLine, Guest, etc.

string

ID de esa entidad. Para node_type: "Charge" es el mismo charge_id que devuelve POST /charges y que viaja en los webhooks charge.*.

object

La entidad completa. Para un cobro trae el mismo objeto que el webhook charge.paid, incluido customer, que es lo que te permite saber a qué cliente final corresponde el ingreso.

string

El identificador de tu sistema que enviaste al crear la operación. Se propaga a todos los movimientos que ésta genere, así que sirve para reconciliar el abono, la comisión y la retención contra el mismo registro de tu lado.

string

A pesar del nombre, este campo es el titular del balance, no el cliente final. En un cobro con tarjeta el dinero entra al balance de tu empresa, así que aquí verás el ID de tu empresa. Para saber a qué cliente se atribuye el ingreso usa node.customer, o consulta GET /charges?filter[customer_id]=.

Campos de `balance`

Es el saldo del balance después de aplicar el movimiento.

number

Saldo en unidades mayores de la moneda.

integer

El mismo saldo en centavos, por si prefieres aritmética entera.

Ejemplo: cobro con tarjeta

{
  "transaction": {
    "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
    "type": "deposit",
    "amount": 100000,
    "label": "$100.000",
    "concept": "Pago aprobado",
    "subtype": "PAYIN",
    "confirmed": true,
    "node_type": "Charge",
    "node_id": "019f85c3-60e2-71e4-bac1-b402b281e27e",
    "created_at": "2026-07-21T17:40:04.000000Z",
    "external_id": "invoice-2025-001",
    "customer_id": "9c0d49bb-7ae8-42fd-94a2-5a5c6702b40e",
    "node": {
      "id": "019f85c3-60e2-71e4-bac1-b402b281e27e",
      "amount": 100000,
      "amount_label": "$100.000",
      "status": "paid",
      "currency": "COP",
      "external_id": "invoice-2025-001",
      "customer": {
        "id": "01980ff3-4239-7351-9ba0-480a3cced430",
        "first_name": "Javier Enrique",
        "last_name": "Gonzalez Paz"
      }
    }
  },
  "balance": {
    "id": "268efd35-772c-41ef-bcf5-0028d9db7092",
    "amount": 100000,
    "amount_in_cents": 10000000,
    "label": "$100.000",
    "currency": "COP"
  },
  "event": {
    "type": "wallet.transaction.created",
    "timestamp": 1689262934,
    "environment": "live|test"
  }
}

Ejemplo: dispersión

{
  "transaction": {
    "id": "0194b42f-5515-7245-b9f4-193c92f37b8c",
    "type": "withdraw",
    "amount": 1000,
    "label": "$1.000",
    "concept": "Transferencia de fondos",
    "subtype": "PAYOUT",
    "confirmed": true,
    "node_type": "CashoutLine",
    "node_id": "9e16627d-1eb9-46c4-ba19-b229ea77d68e",
    "created_at": "2025-01-29T22:29:48.000000Z",
    "external_id": null,
    "customer_id": "9c0d49bb-7ae8-42fd-94a2-5a5c6702b40e",
    "node": {
      "id": "9e16627d-1eb9-46c4-ba19-b229ea77d68e",
      "customer_id": "9957858a-c2f1-4f18-a5c2-216b4127e278",
      "account_id": "9d005522-fad4-44c2-9012-1dbb871322b5",
      "is_test": false,
      "amount": 1000,
      "status": "processed",
      "scheduled_at": null,
      "created_at": "2025-01-29T22:29:48.000000Z",
      "external_id": null,
      "method": "TURBO",
      "discount_to_destination": false
    }
  },
  "balance": {
    "id": "268efd35-772c-41ef-bcf5-0028d9db7092",
    "amount": 100000,
    "amount_in_cents": 10000000,
    "label": "$100.000",
    "currency": "COP"
  },
  "event": {
    "type": "wallet.transaction.created",
    "timestamp": 1689262934,
    "environment": "live|test"
  }
}

API

Empresas

Métodos de pago

Recaudo

Balances

Webhooks

Fintech as a service

Eventos

Campos de `transaction`

Campos de `balance`

Ejemplo: cobro con tarjeta

Ejemplo: dispersión

​Eventos

​Campos de transaction

​Campos de balance

​Ejemplo: cobro con tarjeta

​Ejemplo: dispersión

Eventos

Campos de `transaction`

Campos de `balance`

Ejemplo: cobro con tarjeta

Ejemplo: dispersión