Update Wallet Tariff

POST/web/v1/wallet-tariffs/command/update JWT

Directly updates the tariff configuration for a specific wallet without using a template.

Authentication

Requires a valid JWT token and Turnstile verification.

Request Parameters

Name	Type	Required	In	Description
walletId	string	Required	body	Wallet ID
tariffModel	string	Optional	body	Fee calculation model (FIXED, PERCENTAGE, TIERED)
fixedAmount	number	Optional	body	Fixed fee amount
rate	number	Optional	body	Fee rate as decimal
floorAmount	number	Optional	body	Minimum fee amount
ceilingAmount	number	Optional	body	Maximum fee amount
roundingMode	string	Optional	body	Rounding mode
bandsConfig	string	Optional	body	Tiered band configuration as JSON string
enabled	boolean	Optional	body	Whether the tariff is enabled

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "WTF20260321000001",
    "walletId": "WLT-001",
    "workspaceId": "WS-001",
    "sourceTemplate": "TTL20260321000001",
    "tariffModel": "FIXED",
    "fixedAmount": 5,
    "rate": null,
    "floorAmount": null,
    "ceilingAmount": null,
    "amountScale": 2,
    "roundingMode": "HALF_UP",
    "bandsConfig": null,
    "enabled": true,
    "createdAt": "2026-03-21T10:00:00Z",
    "updatedAt": "2026-03-21T12:00:00Z"
  }
}

Error Responses

HTTP Status	Code	Description
400	4000	Validation error
401	4010	Unauthorized
404	4040	Wallet tariff not found

Notes

• Partial updates are supported. Only include the fields you want to change.
• The sourceTemplate field reflects the original template used for assignment and is not updated.