Financing
With financing a customer pays a down payment at the dealership and the rest in instalments, collected from their bank account. Until the last instalment is paid, a missed payment can cost them the vehicle.
Financing is offered when Financing is on for the dealership in the Dealership Creator and the dealership accepts at least one payment method with finance = true. It is for personal purchases only. A company purchase is always paid in full. The settings are also listed under Finance.
The terms
Config.Finance = {
Payments = 12,
MaxPayments = 20,
DownPayment = 0.1,
Interest = 0.1,
IntervalHours = 12,
GraceHours = 24,
MaxActive = 5,
Bank = { Enabled = true, RequireScore = true, RateFromTier = true },
}| Setting | Meaning |
|---|---|
Payments | Number of instalments for a purchase in the showroom. |
MaxPayments | Most instalments staff can set when they sell on finance. |
DownPayment | Share of the total that is paid at the dealership (0.1 is 10 %). |
Interest | Share added to the price (0.1 is 10 %). It is added once, not per instalment. |
IntervalHours | Hours between two instalments. |
GraceHours | Hours to pay a missed instalment before the vehicle is taken back. |
MaxActive | Financed vehicles one player can have at the same time, over all dealerships. |
Bank | The link to bablo-banking, see Bank loans and credit score. |
How the amounts are worked out
The price is what is left after a trade-in credit, with a paid colour and tuning included.
| Step | $ 149,900 with the default terms |
|---|---|
| Total payable: the price plus interest | $ 164,890 |
Down payment: the total × DownPayment | $ 16,489 |
Instalment: the rest ÷ Payments, rounded up | 12 × $ 12,367 |
The last instalment is whatever is still left, so it can be a little lower. The showroom shows the plan before you buy: the line or 12 × $ 12,367 with financing under the price, and Down payment today, Instalments, Collected, Interest and Total payable in the purchase dialog.
Paying the instalments
The first instalment is due IntervalHours after the purchase, and every next one IntervalHours after the payment before it.
- Instalments are collected by themselves. The server checks once a minute and tells you An instalment of $ 12,367 for your … was paid.
- The money comes from the payment method with the id
bank. If yourConfig.PaymentMethodshas none, the first method that allows financing is used. - An instalment is only collected while you are online. One that falls due while you are away is taken shortly after you are back. Instalments do not pile up.
- After the last one you are told Your … is paid off. It is fully yours now.
The finance window
Config.FinanceCommand = 'myfinance'/myfinance opens My finance, the list of vehicles you are still paying off. The top shows Left to pay over all of them and your Bank balance. Each vehicle shows its plate, the dealership it was bought from, On track or Payment missed, the payments made (3 of 12 payments), the Remaining balance, the Instalment and the time to the next one (Next payment in, Due now or Overdue).
| Button | What it does |
|---|---|
| Pay instalment | Pays the next instalment ahead of schedule. The one after it is due IntervalHours from now. |
| Pay off | Pays everything that is left and ends the agreement. There is no discount for paying early. |
| Pay final instalment | Shown instead of the other two when no more than one instalment is left. |
With Config.FinanceCommand = false the command does not exist, and it is the only way to settle a missed instalment. Leave it on if you use financing.
Missed payments
When the account cannot cover an instalment, the agreement turns to Payment missed and the grace period of GraceHours starts.
- You are told An instalment of $ 12,367 for your … could not be collected. Pay within 24 h 0 min or the vehicle is taken back. Use /myfinance to pay.
- While you are online, a reminder follows every 30 minutes.
- The instalment is not tried again by itself. Pay it with Pay instalment or Pay off in
/myfinance, which puts the agreement back On track. - If the grace period runs out, the vehicle is taken back. This also happens while you are offline.
| What | When a vehicle is taken back |
|---|---|
| Vehicle | Removed from your garage, and from the world if it is out. |
| Money | What you paid is not returned. Nothing more is owed. |
| Dealership | A player-owned dealership gets one unit of that model back into its stock. |
| Message | Your … (47KDM912) was taken back because the missed payment was not settled. |
Limits
| Limit | Detail |
|---|---|
| Financed vehicles | Config.Finance.MaxActive per player. At the limit the purchase dialog says Financing is unavailable because you have reached the limit of financed vehicles. Pay one off to finance another. |
| Trade-in and buy-back | A vehicle that is still financed cannot be traded in or sold to a dealership, see Trade-ins, Buy-back & Pre-owned. |
| Company purchases | Financing is only offered on personal purchases. |
| Payment method | Only methods with finance = true can pay the down payment. |
When staff sell on finance
In a staff sale the seller picks Finance and sets the terms for that customer:
| Field | Range |
|---|---|
| Payments | 1 to Config.Finance.MaxPayments |
| Down payment | 0 to 99 % |
Interest and the interval stay as configured. The customer sees the terms in the purchase offer, picks a payment method and signs. The limits above apply to the customer, and a trade-in may not cover the whole price: The trade-in covers the whole price, so there is nothing to finance. The down payment and every instalment go into the dealership account.
Bank loans and credit score
Config.Finance.Bank connects financing to the loans of bablo-banking. It only has an effect while bablo-banking is started and has its loans enabled.
| Setting | Effect |
|---|---|
Enabled | Every finance agreement is registered at the bank as a vehicle loan with the dealership as lender. Instalments, missed payments, pay-offs and repossessions (as a default) are reported to it. false switches the whole link off. |
RequireScore | Financing is refused when the bank would refuse the customer a loan: Your credit score is too low for financing., You already have the most loans the bank allows. or You have a defaulted bank loan, so financing is not offered. |
RateFromTier | The rate modifier of the customer’s credit tier is added to Interest, in percentage points. The rate never goes below 0. The purchase dialog shows the tier and score as Credit rating. |
Agreements that already exist are registered at the bank when the resource starts, and again when bablo-banking is started later.

