Register a balance for an interest-bearing account using a previously configured interest plan to determine applicable interest rates.

This endpoint generates an Interest balance succeeded event when the balance is created successfully.
This endpoint generates an Interest balance failed event when balance operation fails.

The event payload includes: program_id, balance_id, account_id, interest_plan_id, balance, start_cycle_date, value_date, maturity_date, and trigger_reason. The optional field external_account_id is included in the event only when present in the request. The division fields division_id and division_code are included in the event only when a non-default division is provided. They are omitted when division_id is DEFAULT_DIVISION or the value is null.

The optional field external_account_id is only returned in the response when present in the request.

The optional field trigger_reason indicates why the balance registration is being triggered. When omitted or null, it defaults to CYCLE_CLOSING. RETROACTIVE_CYCLE_CLOSING is only valid when value_date is before the current date. Otherwise, the request is rejected with a 400 error.

balance_id must be a valid UUID. Alphabetical characters are accepted in either case on input, but are converted to lowercase in the response.