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 https://api.rekurra.dev/v1/balance \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

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

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

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/balance"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .GET()
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var response = await http.GetAsync("https://api.rekurra.dev/v1/balance");
Console.WriteLine(await response.Content.ReadAsStringAsync());

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 https://api.rekurra.dev/v1/balance/transactions \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

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

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

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/balance/transactions"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .GET()
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var response = await http.GetAsync("https://api.rekurra.dev/v1/balance/transactions");
Console.WriteLine(await response.Content.ReadAsStringAsync());

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	Descripción
`id`	string	Identificador único del movimiento
`type`	string	`topup` · `fee_debit` · `adjustment` · `refund`
`amount_cents`	integer	Monto del movimiento, con signo, en centavos
`balance_after_cents`	integer	Saldo resultante tras el movimiento
`ref_type`	string	`Charge` · `WompiTopup` · `Manual`
`ref_id`	string \| null	ID del recurso relacionado
`description`	string	Descripción del movimiento
`created_at`	datetime	Fecha del movimiento

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