Listar movimientos del balance
Lista el ledger de la cuenta, del movimiento más reciente al más antiguo: es la forma API del estado de cuenta descargable. Los montos son firmados: positivo acredita el balance y negativo lo debita.
amount_in_cents es el bruto y net_amount_in_cents es lo que efectivamente movió el balance; sumar fee_in_cents al bruto siempre da el neto. En un cobro, fee_details desglosa esa diferencia en la comisión y el IVA retenido, las mismas columnas del reporte descargable. balance_after_in_cents corresponde a la columna Balance de ese reporte.
Para conciliar un mes, filtra con from_time + until_time y sube items hasta 100. Cada par de fechas se envía completo: enviar solo una mitad devuelve 400 en vez de ignorar el rango.
No existe forma de preguntar qué cobros financiaron un retiro: Recurrente registra el débito del retiro y nada más, así que esa relación habría que inventarla. El camino inverso sí existe — cada movimiento en GET /api/transfers trae balance_transaction_id, la fila de ledger que registró.
Authentication
Tu clave secreta de API.
Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.
Query parameters
Inicio del rango de creación. Si se envía como fecha sin hora, se interpreta como el inicio del día. Se aplica solo junto con until_time.
Fin del rango de creación. Si se envía como fecha sin hora, se interpreta como el final del día. Se aplica solo junto con from_time.
Tipo contable del movimiento, por ejemplo charge, payout, refund o dispute.
Página a devolver. La respuesta trae los encabezados link, current-page, total-pages y total-count.
Elementos por página.
Response
ID público del movimiento del balance. Los movimientos registrados antes de que el ledger fuera público conservan el prefijo ba_; trata el ID como opaco.
Cuenta cuyo balance cambió
Monto bruto firmado en centavos; positivo acredita y negativo debita
Monto firmado que efectivamente movió el balance
Recurso que originó el movimiento, cuando existe
Lo retenido sobre el bruto, firmado. Sumado a amount_in_cents da net_amount_in_cents
Desglose de fee_in_cents con los componentes que registramos en la moneda del movimiento. Lo que no aparezca aquí sigue contando dentro del total
Descripción opcional del movimiento
Snapshot del balance antes del movimiento, cuando está disponible
Snapshot del balance después del movimiento; equivale a la columna Balance del reporte descargable