Skip to content
Client-side Display

Add Billing Account Fee Info Item

Adds a client-facing fee-display item that shows special fee notes on the client, grouped by business-line/market tab.

Request parameters

  • Required: tab (business-line or market identifier), name (multilingual name object keyed by zh-CN/zh-HK/en), conditions (list of trigger conditions, each { field, value })
  • Optional: desc (multilingual description object)
  • See the field descriptions for the format, value range, and business meaning of each field.

Business notes

The candidate values for tab come from GET /v1/billing/myrates/markets. A fee-display item only affects the fee notes shown on the client; it does not change the actual billing rules.

Result

On success, the operation completes; the resulting state and returned data follow the 200 response definition.

POSThttps://b-api.lbkrs.com/v1/billing/account_fee_info_item

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

billing.account_fee_info_manage

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

tabstringrequired

Business-line or market identifier. The caller derives it from the target market and includes it in the request.

nameobjectrequired

A multilingual name object keyed by zh-CN/zh-HK/en.

Child attributes
zh-CNstring

Name (Simplified Chinese).

zh-HKstring

Name (Traditional Chinese).

enstring

Name (English).

descobject

A multilingual description object keyed by zh-CN/zh-HK/en.

Child attributes
zh-CNstring

Description (Simplified Chinese).

zh-HKstring

Description (Traditional Chinese).

enstring

Description (English).

conditionsarray<object>required

Each array element is a { field, value } object.

  • field: the condition-item ID (rate-condition field) identifying which business dimension the condition applies to, e.g. '3' for an account/counter condition.
  • value: the array of selected values (strings) for that condition item.
Child attributes
fieldstringrequired

Condition-item ID (rate-condition field). For example, 3 is the security (counter ID) condition.

valuearray<string>required

Selected values for the condition item, as an array of strings. A single selection is still sent as a one-element array.

Responses

HTTP 200The request was processed successfully. The response data does not contain additional business fields.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs