Atomically consume xusd (idempotent)
POST/wallet/consume
Atomically consume xusd (idempotent)
Request
Responses
- 200
- 401
- 402
- 403
- 404
- 409
- 429
Consumed (or idempotent replay of a prior success)
Unauthorized
Insufficient balance (hard cap)
Forbidden (realm/account mismatch, billing_account_id not derived from session/principal, or insufficient role)
Not Found
Conflict (idempotency body mismatch or duplicate adjustment)
Rate limited
Response Headers
Retry-After
Seconds to wait before retry.