Navigation:

Installments

An overview of Pay by card installments offered by Smart Checkout.

Pay by card installments

The option to pay by card installments is enabled if the following three conditions are met:

The maxInstallments request body parameter within the Create payment order API call is set to greater than 1 and up to 36
The merchant account is Greek and set up in Greece. Accounts originating in other countries do not support this
The customer’s card supports installments

Please note: If offering installments, the value provided by the merchant is not the number of installments the customer will select, and it is not mandatory for the customer to select installments at all. The process is as follows:

The merchant indicates the maximum number of installments they wish to offer to the customer
It is then up to the customer whether they pay with or without installments
If the customer decides to pay with installments, they are able to select the number of installments (up to the maximum specified by the merchant)

Forcing installments

The merchant also has the option to force a specific number of installments on a payment order by using the forceMaxInstallments parameter and setting it to true. When used, please note that the following conditions apply:

It is mandatory for the customer to pay with installments and with the specific number indicated
Only cards supporting installments can be used for the payment
The value set within the maxInstallments parameter dictates the number of installments that will be forced to the customer. It should be >0, otherwise the call will return an error

More information on payment by card installments can be found on our tutorial page.

Card installments are not available with recurring payments or pre-authorizations

Get Support

If you would like to integrate with Viva, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!