409 Conflict
Top-up outside the wallet’s limits
- Code
wallet_limit- Status
409Conflict- Type
https://errors.clavian.io/wallet-limit
What it means
The top-up is below the minimum, above the maximum per top-up, or would take the balance over the maximum the organisation allows (wallet.minTopupAmount, maxTopupAmount, maxBalanceAmount) — or a sale refunded to the wallet would take it over that maximum. detail says which.
What to do
Show the limit detail names and offer an amount within it, or refund to the original tender instead. The same amount is refused every time.
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-limit",
"title": "Top-up outside the wallet’s limits",
"status": 409,
"code": "wallet_limit",
"requestId": "req_01k5znw4hmfay8vvr14d2pf2db"
}
Endpoints that return it
From the OpenAPI document, every endpoint that names it among its answers:
POST /v1/me/venues/{venueId}/wallet/online-top-upsTop your wallet up online at a caféPOST /v1/organizations/{organizationId}/players/{playerId}/wallet/online-top-upsTop up a player’s wallet onlinePOST /v1/organizations/{organizationId}/players/{playerId}/wallet/top-upsTop up a player’s wallet at the counterPOST /v1/organizations/{organizationId}/venues/{venueId}/sales/{saleId}/paymentsTake a tender against a salePOST /v1/organizations/{organizationId}/venues/{venueId}/sales/{saleId}/refundsRefund a salePOST /v1/organizations/{organizationId}/venues/{venueId}/sales/{saleId}/refunds/{refundId}/approveApprove a pending refund