Create User Wallet Event
API operation: Open the endpoint in the API reference
Use POST /users/{user_id}/wallets/{wallet_id}/events to create a manual wallet movement. The current public operation is WalletEvent.register.
If available, the operation requires administrator authentication. amount is required and can be positive or negative; description is optional. The wallet must belong to the selected user, be enabled by project settings, and not be locked. A successful movement changes the wallet balance and records the authenticated author and audit fingerprint.
Wallet movements affect stored value. Validate authorization, amount, currency/value type, and business intent before use. See Wallet event model.
OpenAPI reference
Operation: POST /users/{user_id}/wallets/{wallet_id}/events
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_id | integer | Yes | — |
wallet_id | integer | Yes | — |
Header parameters
| Name | Type | Required | Description |
|---|---|---|---|
User-Agent | string | No | — |
X-Forwarded-For | string | No | — |
X-Internal-Product-X | string | No | — |
Request body fields
| Name | Type | Required |
|---|---|---|
amount | number | Yes |
description | any | No |
Responses
| Code | Description |
|---|---|
| 200 | OK (Envelope) |
| 400 | Bad Request (ErrorResponse) |
| 401 | Unauthorized |
| 404 | Not Found |
| 429 | Too Many Requests (ErrorResponse) |
| 500 | Internal Server Error (ErrorResponse) |
| 503 | Service Unavailable (ErrorResponse) |