Skip to content

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.”

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.”

  • 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.”

“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.”

“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 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 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.”