Saldo prepago
Rekurra no recauda dinero de tus clientes — el cobro siempre ocurre en
tu propia cuenta de Wompi. Lo que Rekurra cobra es una comisión (fee)
por cada cobro recurrente aprobado, que se descuenta automáticamente de
tu saldo prepago (PrepaidBalance).
Cómo se calcula el fee
El fee depende del plan de Rekurra que tengas contratado (Hobby / Builder /
Scale) y se aplica sobre cada ChargeAttempt con estado approved:
| Plan de Rekurra | Fee por cobro aprobado |
|---|---|
| Hobby | $200 COP fijos + 0,9% del monto cobrado |
| Builder | 0,5% del monto cobrado (sin fijo) |
| Scale | 0,2% del monto cobrado (sin fijo) |
Ejemplo
Un cobro aprobado de $50.000 COP (5.000.000 centavos) en el plan
Hobby:
fee = 200 + (5.000.000 * 0.009 / 100)
= 200 + 45.000
= 45.200 centavos ($452 COP)El fee se calcula sobre cada charge.approved, se descuenta atómicamente
de tu PrepaidBalance en la misma transacción que registra el cobro, y
queda registrado en el ledger BalanceTransaction con type: fee_debit.
Saldo insuficiente
Si tu saldo prepago es menor al fee proyectado de los próximos cobros,
Rekurra pausa las nuevas suscripciones afectadas
(status: paused_insufficient_balance) y te notifica. Los cobros que ya
estaban vencidos reciben un periodo de gracia de 3 días antes de
pausarse definitivamente.
Recargar el saldo (top-up) reanuda automáticamente el procesamiento de
cobros. El top-up se hace desde el dashboard (/dashboard/balance/topup)
usando las llaves de Wompi de Rekurra — no forma parte de la API pública.
Consultar el saldo y el ledger
curl https://api.rekurra.dev/v1/balance \
-H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"{
"balance_cents": 1250000,
"currency": "COP",
"updated_at": "2026-08-20T14:32:00Z"
}Ver la referencia completa de endpoints, incluyendo el ledger de transacciones, en API → Balance.