Update Wallet Settings
Configure the low-balance alert threshold. When your balance drops below the threshold, a wallet.funded event is dispatched to your registered webhook endpoint.
Endpoint
POST
/v1/wallet/settingsRequired permission: wallet:settings:update
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
threshold | Integer | ✅ | Balance level in ₦ that triggers the alert. |
enabled | Boolean | ✅ | Set to true to activate low-balance notifications, false to silence them. |
Response
Returns the updated wallet record.
| Field | Type | Description |
|---|---|---|
balance | Integer | Current wallet balance in ₦. |
lowThreshold | Integer | The updated alert threshold in ₦. |
lowBalanceAlert | Boolean | Current alert active state. |
{
"threshold": 10000,
"enabled": true
}