409 Conflict
The balance would pass the maximum
- Code
wallet_balance_over_maximum- Status
409Conflict- Type
https://errors.clavian.io/wallet-balance-over-maximum
What it means
The top-up, with any bonus it earns, would take the wallet over the most it may hold at this organisation (wallet.maxBalanceAmount).
What to do
Offer a smaller amount, or none until the player has spent some of their balance.
Example
The API answers with status 409 and this body, as application/problem+json. A detail may be added, saying what went wrong this time; it is for people, and changes.
{
"type": "https://errors.clavian.io/wallet-balance-over-maximum",
"title": "The balance would pass the maximum",
"status": 409,
"code": "wallet_balance_over_maximum",
"requestId": "req_01k5znw4hmfay8vvr14d2pf2db"
}
Endpoints that return it
From the OpenAPI document, every endpoint that names it among its answers:
POST /v1/organizations/{organizationId}/wallet/top-up-requests/{requestId}/completeTake a kiosk top-up’s money at the deskPOST /v1/station/wallet/top-upsAsk for a wallet top-up from the kiosk