Add Single Personal Fee

Adds a personalized-fee configuration.

Request parameters

Required: name (name), fee (fee-rate details)
Optional: aaid (securities account)
See the field descriptions for the format, value range, and business meaning of each field.

Risk warning

This operation changes live billing configuration and may affect how customers are actually charged. Verify the target record and parameters before calling.

Result

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

POSThttps://b-api.lbkrs.com/billing/single_item_package

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_charging.lb_hk_billingpackage_update

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

Request body application/json

namestringrequired

This field is required.

aaidstring

Specifies A/C No..

Pass the internal numeric ID of the customer's securities account (aaid), not the securities account number account_no (such as H00000000) or the customer ID member_id. One customer can have multiple aaid values.

feeobjectrequired

This field is required.

Child attributes

billing_item_idstring

Billing item (fee scenario) ID.

currencystring

Currency code, e.g. HKD.

cutoff_digitsinteger

Number of digits kept when cutting off.

cutoff_methodinteger

Rounding (cut-off) method code.

fee_rate_typeinteger

Fee rate type code.

granularityinteger

Metering granularity code.

calculation_methodinteger

Calculation method code.

maxstring

Fee cap (numeric string).

minstring

Fee floor (numeric string).

thresholdstring

Threshold (numeric string).

metric_typeinteger

Metering method code.

metric_cycle_typeinteger

Metering cycle type code.

max_metric_typeinteger

Cap metering method code; 0 means no cap.

min_metric_typeinteger

Floor metering method code; 0 means no floor.

max_metric_ratestring

Cap rate.

min_metric_ratestring

Floor rate.

metric_type_bill_amount_item_idsarray<string>

Secondary billing item IDs.

special_feesarray<object>

Custom fee list; pass an empty array when none.

ratesarray<object>

Rate bands, at least one.

Child attributes

gtstring

Band lower bound (exclusive).

ltestring

Band upper bound (inclusive); 0 means no upper bound.

fee_ratestring

Fee rate for this band.

minstring

Minimum fee for this band.

Responses

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