API Reference
Wallet API
Check your sandbox wallet balance and top up test funds via the Orchestrator API. Useful for playground development and Flaura integration testing.
GET /api/v1/wallet
Returns the current balance and account name for the authenticated merchant's Moolre wallet. Works in both sandbox and live environments.
Request
GET /api/v1/wallet Authorization: Bearer mkr_...
Balance Response
200 OK
{
"balance": 10.67,
"accountName": "MerchantName"
}Response Fields
| Field | Type | Description |
|---|---|---|
| balance | number | Current wallet balance in GHS (float) |
| accountName | string | Name associated with the Moolre account |
POST /api/v1/wallet
Credits the merchant's sandbox wallet via internal transfer from the platform master wallet. Only available in sandbox mode — returns an error for live merchants.
Request Body
POST /api/v1/wallet
Authorization: Bearer mkr_...
Content-Type: application/json
{
"amountInPesewas": 500000
}Top-up Request Fields
| Field | Type | Description |
|---|---|---|
| amountInPesewas | integer | Amount to top up in pesewas. Positive integer. Max GHS 100,000.00 (10,000,000 pesewas) |
200 OK
{
"success": true
}Error Responses
| Status | Condition |
|---|---|
| 400 | Invalid or missing amountInPesewas |
| 401 | Malformed authorization header |
| 403 | Invalid API key, merchant suspended, or top-up attempted in live mode |
| 413 | Request body too large |
| 415 | Expected Content-Type: application/json |
| 500 | Internal error — balance check or top-up failed |
Use Cases
- Playground — top up sandbox wallet before testing split executions
- Flaura dev — verify wallet balance after collection events without logging into the dashboard
- Automated sandbox testing — programmatically fund accounts before running integration tests