Get service wallet balance
Service Wallet
Get Service Wallet Balance
Check the current balance of your service wallet.
GET
Get service wallet balance
Know your balance before payments fail. Monitor this proactively.
Recommended approach:
Service wallet
The service wallet holds pre-funded tokens used to pay PalPluss transaction fees. A fee is deducted each time you initiate an STK Push or B2C payout. If balance reaches zero, payment requests return402 INSUFFICIENT_SERVICE_BALANCE — no payments process until you top up.
availableBalance vs ledgerBalance
These values are identical in most cases. They may differ briefly during high-throughput periods when multiple fee deductions are processing simultaneously.
Monitoring
- Check balance before each batch of payments
- Alert when balance drops below your minimum threshold (e.g. KES 500)
- Trigger an automated top-up or notify your team when the threshold is breached
Authorizations
Paste your PalPluss API key in the username field and leave the password field empty — it is ignored.
Get your key from console → Settings → API Keys (starts with pk_live_ or pk_test_).
In your own code, send the key directly:
Authorization: Basic YOUR_API_KEY