Assign Wallet Tariff

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

Assigns a tariff to a wallet by copying values from a template. If the wallet already has a tariff configuration, returns the existing tariff.

Authentication

Requires a valid JWT token and Turnstile verification.

Request Parameters

Name	Type	Required	In	Description
walletId	string	Required	body	Target wallet ID
templateBizId	string	Required	body	Source template business ID

Success Response

Created 201

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

Error Responses

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

Notes

• Tariff values are copied from the template at assignment time. Subsequent template changes do not affect this wallet.
• If the wallet already has a tariff, the existing tariff is returned (idempotent behavior).