Payment Plans
If you want to allow your payers to pay in installments, you need to agree the available payment plans with your acquirer and Payment Service Provider (PSP) to have them configured for the merchant profile. For more information on the payment plans supported by the Mastercard Gateway, see Payment Plans.
Limiting Available Payment Plans
By default, the Hosted Checkout displays all the payment plans configured on your merchant profile to the payer on the Hosted Payment Page. However, the list of displayed payment plans is always filtered based on the payer's card number and order currency.
You can further limit the payment plans on offer by specifying payment plan constraints for individual transactions. This is useful if you want to ensure that payment options offered to the payer conform to predefined criteria, thereby preventing payment processing if the payer tampers with the payment plan data. You can use the following fields in an INITIATE CHECKOUT request to specify constraints on payment plans for the current transaction:
-
constraints.paymentPlans.supported[n]
Payment plans offered for this transaction.
-
constraints.paymentPlans.numberOfPayments
Allowed number of installments for the payment plan.
-
constraints.paymentPlan.numberOfDeferrals
Allowed number of deferral months for the payment plan.
Displaying Payment Terms for a Payment Plan
By default, the payment terms of a payment plan, if available, are displayed on the Hosted Payment Page. You can hide them by setting interaction.displayControl.paymentTerms=HIDE
in Checkout.configure()
.