Obtener un movimiento del balance
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.
Path parameters
ID público del movimiento del balance
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