Bablo ResourcesDocs

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

LUA
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 },
}
SettingMeaning
PaymentsNumber of instalments for a purchase in the showroom.
MaxPaymentsMost instalments staff can set when they sell on finance.
DownPaymentShare of the total that is paid at the dealership (0.1 is 10 %).
InterestShare added to the price (0.1 is 10 %). It is added once, not per instalment.
IntervalHoursHours between two instalments.
GraceHoursHours to pay a missed instalment before the vehicle is taken back.
MaxActiveFinanced vehicles one player can have at the same time, over all dealerships.
BankThe 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 up12 × $ 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 your Config.PaymentMethods has 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

LUA
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).

ButtonWhat it does
Pay instalmentPays the next instalment ahead of schedule. The one after it is due IntervalHours from now.
Pay offPays everything that is left and ends the agreement. There is no discount for paying early.
Pay final instalmentShown 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.

  1. 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.
  2. While you are online, a reminder follows every 30 minutes.
  3. 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.
  4. If the grace period runs out, the vehicle is taken back. This also happens while you are offline.
WhatWhen a vehicle is taken back
VehicleRemoved from your garage, and from the world if it is out.
MoneyWhat you paid is not returned. Nothing more is owed.
DealershipA player-owned dealership gets one unit of that model back into its stock.
MessageYour … (47KDM912) was taken back because the missed payment was not settled.

Limits

LimitDetail
Financed vehiclesConfig.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-backA vehicle that is still financed cannot be traded in or sold to a dealership, see Trade-ins, Buy-back & Pre-owned.
Company purchasesFinancing is only offered on personal purchases.
Payment methodOnly 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:

FieldRange
Payments1 to Config.Finance.MaxPayments
Down payment0 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.

SettingEffect
EnabledEvery 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.
RequireScoreFinancing 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.
RateFromTierThe 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.