Card installments for bookings
Card installments for bookings is at /settings/payments/booking-installments and needs the
payments.manage permission. The screen is reached from a card on the payments settings that
appears only for a store the booking API serves; for any other store the screen says “Card
installments are only available for stores served by the booking API.” The card describes the
feature as: “Let customers split a booking paid by card into installments, and set who pays the
surcharge.”
Turning it on
Section titled “Turning it on”Offer card installments is “Off by default. Turn it on only after the go-live checks have passed, because customers are charged the surcharge.” While off, “the booking page shows no installment options.”
Counts and minimums
Section titled “Counts and minimums”- Allowed counts — “Leave all unselected to offer every count the bank returns, up to the maximum.”
- Maximum count — a whole number from 2 to 12 (limit as the screen states it, read 2026-11-11).
- Minimum booking total — “Below this total no installments are offered.”
- Minimum per installment — “Counts that would make an installment smaller are hidden.”
Who pays the surcharge
Section titled “Who pays the surcharge”“The bank adds a fee for installments. Choose how it reaches the customer.” The Surcharge policy has three choices:
| Policy | What the screen says |
|---|---|
| Pass through | “The customer pays the bank’s surcharge as quoted.” |
| Absorb | “The store pays the surcharge. The customer pays the base price.” |
| Fixed rates | “The customer pays the rate you set for each count, whatever the bank charges.” |
With fixed rates, Rate per count takes a percent added to the base price; “A count left empty is not offered.” Maximum surcharge hides any count whose surcharge exceeds that percent of the base price.
Allowed banks limits installments to some banks; empty offers every bank the gateway returns. A name “matches any gateway bank that contains it, ignoring case.”
Surcharge product
Section titled “Surcharge product”“The surcharge is booked on the reservation under this product, so the payment balances.” It takes a Product number (required when the customer pays any surcharge), a Product name (shown on the reservation) and Calculate tax on the surcharge, which the screen calls “An accounting decision. Confirm it before going live.”
Quote validity and texts
Section titled “Quote validity and texts”Quote validity sets how long a bank answer is reused and a chosen option stays valid, between 30 and 3600 seconds (read 2026-11-11). Texts changes the wording on the booking page per language; an empty box uses the default text, each text is up to 400 characters (read 2026-11-11), and placeholders must be kept exactly as written. The editable texts include the heading, card number hint and label, Show options button, Single payment, Installment option, Surcharge line, No surcharge, Total to pay, Base price and Disclosure.
Amount mode
Section titled “Amount mode”Amount mode shows how the card amount is sent to the bank: Gateway adds the surcharge, Gateway adds, reports base price or Store adds the surcharge. It is read-only here: “The platform operator changes it after the sandbox test; it cannot be changed here.”