Skip to content
Client-side Display

Update Billing Account Fee Info Item

Edit the content of a client-side fee display item.

A client-side fee display item shows the name, description, and applicable conditions of a fee to users in the client app.

Request parameters

  • Required: name (multilingual name object keyed by zh-CN/zh-HK/en), conditions (array of { field, value } applicability conditions).
  • id is supplied in the path; desc is an optional description. See the field descriptions for each field's format, value range, and business meaning.
  • The path id is the record ID of the fee-display item. Take id from a row of POST /v1/datasets/booking_account_fee_info_items.
  • An item with a pending approval ticket (non-zero ticket_id) cannot be edited, enabled, or disabled until the ticket is processed.

Business notes

Locates the display item by the path id and updates its name, description, and applicable conditions. After saving, the latest content is shown in the client.

Risk warning

This operation changes customer-facing fee display content. Verify the name and condition configuration before saving.

Result

On success, the item is updated; subsequent state and returned data follow the 200 response definition.

PUThttps://b-api.lbkrs.com/v1/billing/account_fee_info_item/{id}

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.

Parameters

idstringRequired

Item ID

Request body application/json

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