Update Tariff Template

POST/web/v1/transfer-tariff-templates/command/update JWT

Updates an existing transfer tariff template. Only the provided fields are updated; omitted fields remain unchanged.

Authentication

Requires a valid JWT token and Turnstile verification.

Request Parameters

Name	Type	Required	In	Description
bizId	string	Required	body	Template business ID
templateName	string	Optional	body	Template display name max 128 characters
description	string	Optional	body	Template description max 512 characters
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
amountScale	integer	Optional	body	Decimal precision for amounts
roundingMode	string	Optional	body	Rounding mode
bandsConfig	string	Optional	body	Tiered band configuration as JSON string
isDefault	boolean	Optional	body	Whether this is the default template
enabled	boolean	Optional	body	Whether the template is enabled

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "bizId": "TTL20260321000001",
    "templateCode": "STANDARD_FEE",
    "templateName": "Updated Fee",
    "description": "Updated description",
    "tariffModel": "PERCENTAGE",
    "fixedAmount": null,
    "rate": 0.03,
    "floorAmount": 1,
    "ceilingAmount": 150,
    "amountScale": 2,
    "roundingMode": "HALF_UP",
    "bandsConfig": null,
    "isDefault": true,
    "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	Template not found

Notes

• Partial updates are supported. Only include the fields you want to change.
• Changes to a template do not retroactively affect wallets that have already been assigned tariffs from this template.