Skip to content
Interest Sharing On Financing

Edit Financing Interest Config

Create and edit operations share this endpoint. They are distinguished by action_in and whether id is included. This operation changes live billing configuration.

Request parameters

  • Required: action_in (Action Type), currency (Currency), standard_financing_rate (Standard Financing Rate), min_interest_spread (Minimum Interest Spread), year_fee_days (Annual Fee Rate Days), rounding_method (Rounding Method), rounding_decimals (Rounding Decimals), begin_month (Begin Month (Effective)), end_month (End Month (Effective))
  • Optional: id (Config ID)
  • See each field for its format, allowed values, default behavior, and business meaning.

Result

On success, the endpoint completes the described business operation. See the 200 response schema for returned data.

POSThttps://b-api.longbridge.xyz/ob_file/edit_financing_interest_config

Authorization

AuthorizationstringheaderRequired

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

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.

Allowed values:

  • 1 - Add
  • 2 - Edit
  • 3 - Delete

1 · Add2 · Edit3 · Delete

currencystringrequired

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

USD · USDHKD · HKDSGD · SGDCNY · CNYAUD · AUDJPY · JPYGBP · GBPEUR · EURCAD · CADMYR · MYRAMD · AMDBGN · BGNBTN · BTNBWP · BWPBZD · BZDCDF · CDFCHF · CHFDKK · DKKGHS · GHSGMD · GMDGNF · GNFHRK · HRKHUF · HUFILS · ILSINR · INRIQD · IQDIRR · IRRISK · ISKLRD · LRDLYD · LYDMOP · MOPRUB · RUBUAH · UAHUGX · UGXUYI · UYIUYU · UYUUZS · UZSXAF · XAFXOF · XOFXSU · XSUYER · YERIDR · IDRTWD · TWDTHB · THBKRW · KRWNZD · 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

360 · 360365 · 365366 · 366

rounding_methodnumberrequired

Rounding method.

1 · Round2 · Round Up3 · Round Down

rounding_decimalsnumberrequired

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

0 · 01 · 12 · 23 · 3

begin_monthstringrequired

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

end_monthstringrequired

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

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