Bila← Docs

Refunds and balance

Refund any succeeded charge — full or partial. Balance and payouts mirror Stripe's mental model.

Refund a charge

curl https://api.bila.so/v1/refunds -u sk_live_xxx: \
  -d charge=ch_xxx \
  -d amount=2500 \
  -d reason=requested_by_customer

Omit amount for a full refund. Partial refunds can sum to at most the original amount.

Balance

GET /v1/balance returns the available balance per currency. The available balance is everything settled minus payouts in flight.

Payouts

Settlement is daily at v1 (initiated by Bila admin against your designated bank). Self-serve payout API arrives at slice 11 with the PSP licence.

Reconciliation

Bila's admin reconciles rail-side totals against the Bila ledger every 24h. If you see a mismatch in the dashboard, contact support@bila.so with the affected charge id — we hold the rail's response for 90 days.