Check Paystack Balance
Integration
Check Paystack Balance
Returns the workspace’s own Paystack balance, so a label can see what it can send before initiating a payout.
GET
Check Paystack Balance
This endpoint requires authentication. Include your Bearer token in the Authorization header.
Description
Proxied live from Paystack using the workspace’s stored secret key. Balances are returned in the lowest currency unit (kobo for NGN, cents for USD) — divide by 100 to display. Endpoint:/integrations/paystack/balance
Authorization:
- Required role:
adminor higher
GET
Error codes: the response carries a code when the workspace is
not set up — PAYSTACK_INTEGRATION_NOT_CONFIGURED (no enabled Paystack
integration) or PAYSTACK_SECRET_KEY_MISSING (row exists, no key).
There is no fallback to a platform-level Royalti key by design.