Skip to content
Client-side Display

Update Billing Account Fee Info Item State

Enable or disable a client-side fee display item.

Request parameters

  • Required: state (the target state to set in this request), id (record id, supplied in the path).
  • 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 switches its state to the value given in state. Once disabled, the item is no longer shown in the client.

Risk warning

This operation changes whether customer-facing fee display content is visible. Verify the target state before switching.

Result

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

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

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

statestringrequired

Target display state to set (enable / disable). Required.

Allowed values: 1 Enabled, 2 Disabled

Values
1
Enabled
2
Disabled

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