Edit Financing Interest Config

Creates or edits a financing-interest revenue-sharing configuration; both reuse the same endpoint, distinguished by action_in and whether id is supplied.

Request parameters

Required: action_in (operation type), currency, standard_financing_rate, min_interest_spread (fallback interest spread), year_fee_days (annual-rate day count), rounding_method, rounding_decimals, begin_month (effective start month), end_month (effective end month).
Optional: id (configuration ID, passed when editing).
currency cannot be changed when editing an existing record; begin_month and end_month use the YYYYMM format.
See the field definitions for format, value ranges, defaults, and business meaning.

Risk warning

This operation changes real billing configuration and directly affects financing-interest calculation and revenue sharing. Confirm the target record and parameters before calling.

Result

On success the configuration is created or updated. Refer to the 200 response definition for returned data.

POSThttps://b-api.lbkrs.com/ob_file/edit_financing_interest_config

Authorization

AuthorizationstringheaderRequired

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

Permission

settlement.financing_interest_allocation_config

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

Request body application/json

idnumber

Included only when editing an existing record; not passed on creation.

action_instringrequired

Enum values: 1 = create, 2 = edit, 3 = delete; send 2 when a record id is present, otherwise 1.

Values

1: Add
2: Edit
3: Delete

currencystringrequired

A three-letter currency code. Read-only when editing an existing record.

Values

USD: USD
HKD: HKD
SGD: SGD
CNY: CNY
AUD: AUD
JPY: JPY
GBP: GBP
EUR: EUR
CAD: CAD
MYR: MYR
AMD: AMD
BGN: BGN
BTN: BTN
BWP: BWP
BZD: BZD
CDF: CDF
CHF: CHF
DKK: DKK
GHS: GHS
GMD: GMD
GNF: GNF
HRK: HRK
HUF: HUF
ILS: ILS
INR: INR
IQD: IQD
IRR: IRR
ISK: ISK
LRD: LRD
LYD: LYD
MOP: MOP
RUB: RUB
UAH: UAH
UGX: UGX
UYI: UYI
UYU: UYU
UZS: UZS
XAF: XAF
XOF: XOF
XSU: XSU
YER: YER
IDR: IDR
TWD: TWD
THB: THB
KRW: KRW
NZD: NZD

standard_financing_ratestringrequired

A percentage value; the client validates the range > 0 and ≤ 9999, with at most 10 decimal places.

min_interest_spreadstringrequired

A percentage value; validated with the same rules as standard_financing_rate.

year_fee_daysnumberrequired

Enum comes from ref settlement_year_fee_days; submitted as a number.

Allowed values: 360, 365, 366

Values

360: 360
365: 365
366: 366

rounding_methodnumberrequired

Rounding method.

Allowed values: 1 Normal round, 2 Round up, 3 Round down

Values

1: Round
2: Round Up
3: Round Down

rounding_decimalsnumberrequired

Number of decimal places to retain, submitted as a number.

Values

0: 0
1: 1
2: 2
3: 3

begin_monthstringrequired

Format YYYYMM, generated by splitting the caller "validity period" month-range picker.

end_monthstringrequired

Format YYYYMM, generated by splitting the caller "validity period" month-range picker.

Responses

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