Balance

/v1/balance — tu saldo prepago y el ledger de movimientos. Ver también el concepto Saldo prepago.

Consultar el saldo

GET /v1/balance

curl

curl https://api.rekurra.dev/v1/balance \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

JavaScript (fetch)

const res = await fetch("https://api.rekurra.dev/v1/balance", {
  headers: { Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" },
});
const balance = await res.json();

Python (requests)

import requests
 
res = requests.get(
    "https://api.rekurra.dev/v1/balance",
    headers={"Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"},
)
balance = res.json()

Response — `200 OK`

{
  "balance_cents": 1250000,
  "currency": "COP",
  "updated_at": "2026-08-20T14:32:00Z"
}

Ledger de movimientos

GET /v1/balance/transactions

Paginación estándar (?limit=, ?starting_after=).

curl

curl https://api.rekurra.dev/v1/balance/transactions \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

JavaScript (fetch)

const res = await fetch("https://api.rekurra.dev/v1/balance/transactions", {
  headers: { Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" },
});
const { data } = await res.json();

Python (requests)

import requests
 
res = requests.get(
    "https://api.rekurra.dev/v1/balance/transactions",
    headers={"Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"},
)
body = res.json()

El objeto BalanceTransaction

{
  "id": "btx_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  "type": "fee_debit",
  "amount_cents": -25000,
  "balance_after_cents": 1225000,
  "ref_type": "Charge",
  "ref_id": "ch_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  "description": "Fee por cobro aprobado ch_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  "created_at": "2026-09-01T00:05:01Z"
}

Campo	Tipo
`id`	string
`type`	`topup` \| `fee_debit` \| `adjustment` \| `refund`
`amount_cents`	integer (con signo)
`balance_after_cents`	integer
`ref_type`	`Charge` \| `WompiTopup` \| `Manual`
`ref_id`	string \| null
`description`	string
`created_at`	datetime

Errores posibles

Status	`error.type`	Causa
`401`	`authentication_error`	API key inválida o ausente

El top-up (recargar saldo) se inicia desde el dashboard (/dashboard/balance/topup) usando Wompi con las llaves de Rekurra — no está disponible en la API pública.

Charges Webhook endpoints