The payment form automatically recognizes cards that are eligible for installment payments. The specific installment range and terms will be defined by your merchant-acquirer agreement.
Force Installments
To mandate that a payment be made with installments, use the force_installments
option.
Supported values for this parameter are boolean true
and string 'true'
. If false
is provided, or if the parameter is omitted, it will default to false
.
When this option is enabled, the buyer is required to select one of the available installment options and is unable to make a single, one-off payment.
Forcing installments will only function if installments are already enabled on your merchant profile. Attempting to force installment payments for a merchant setup where installments are not enabled will result in an error.