POST Update Wallet Tariff endpoint.
Endpoint
POST
/web/v1/system/tariffs/wallet/update WEBAuthentication
- Chain: WEB
- JWT Token: true
- API Key: false
- Permissions: ["tariff:write"]
Rate Limit
Standard rate limit applies.
Headers
Frontend Headers
| Header | Required | Description |
|---|---|---|
| X-LOCALE | Yes | 用户的 locale |
| Accept-Language | No | 语言偏好 |
Cloudflare Headers
| Header | Required | Description |
|---|---|---|
| CF-Connecting-IP | Yes | Client IP from Cloudflare |
| CF-IPCountry | Yes | Client country code |
| CF-Ray | Yes | Cloudflare Ray ID |
| CF-Visitor | Yes | Visitor scheme |
| CF-Worker | No | Cloudflare Worker indicator |
| CF-TCP-Port | No | Client TCP port |
| CF-Edge-Keep-Alive | No | Edge keep-alive status |
| CF-Cache-Status | No | Cache status |
| CDN-Loop | No | CDN loop detection |
| X-Real-IP | Yes | Real client IP |
Nginx Headers
| Header | Required | Description |
|---|---|---|
| X-PORTAL-ACCESS-CODE | Yes | Portal access code |
| X-Real-IP | Yes | 客户端真实 IP |
| X-Forwarded-For | Yes | 代理链 |
| X-Forwarded-Proto | Yes | 协议 |
Request Parameters
Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
| walletId | String | Yes | 钱包 ID (必填) |
| tariffModel | String | No | 费率模型 (可选) |
| fixedAmount | BigDecimal | Yes | 固定金额 (可选) |
| rate | BigDecimal | Yes | 费率比例 (可选) |
| floorAmount | BigDecimal | Yes | 费用下限 (可选) |
| ceilingAmount | BigDecimal | Yes | 费用上限 (可选) |
| roundingMode | String | No | 舍入模式 (可选) |
| bandsConfig | String | No | 分段配置 JSON (可选) |
| enabled | Boolean | No | 是否启用 (可选) |
Response
200 OK
| Field | Type | Description |
|---|---|---|
| data.bizId | String | 业务 ID |
| data.walletId | String | 钱包 ID |
| data.workspaceId | String | 工作空间 ID |
| data.sourceTemplate | String | 来源模板 ID |
| data.tariffModel | String | 费率模型 |
| data.fixedAmount | BigDecimal | 固定金额 |
| data.rate | BigDecimal | 费率比例 |
| data.floorAmount | BigDecimal | 费用下限 |
| data.ceilingAmount | BigDecimal | 费用上限 |
| data.amountScale | Short | 金额精度 |
| data.roundingMode | String | 舍入模式 |
| data.bandsConfig | String | 分段配置 JSON |
| data.enabled | Boolean | 是否启用 |
| data.createdAt | Instant | 创建时间 |
| data.updatedAt | Instant | 更新时间 |