Shop Pay Installments

Shop Pay Installments allows customers to pay for orders between 50 USD and 3,000 USD in 4 interest-free installments.

The Shop Pay Installments banner lets customers know that they have the option to pay in installments. It includes a Learn more link that opens a pop-up which shows how much the installment amount is, more information about installments, and any required disclosures.

In this tutorial, you'll learn how to add a Shop Pay Installments banner to the following locations:

• The product form
• The cart form

Anchor to RequirementsRequirements

Depending on where you want to add the Shop Pay Installments banner, you need to do one, or both, of the following:

• Add a product form to a template. A product form can be added to any template that can access the product object.
• Add a cart form to a template. A cart form can be added to any template that can access the cart object.

Anchor to ResourcesResources

To implement this feature, you'll use the following:

• The form object
• The payment_terms filter

Anchor to Implementing a Shop Pay Installments bannerImplementing a Shop Pay Installments banner

The Shop Pay Installments banner can be added to the following locations:

• The product form
• The cart form

Anchor to Add the banner to the product formAdd the banner to the product form

To add a Shop Pay installments banner to the product form, you need to add a reference to the form object, with the payment_terms filter applied, between the opening and closing form tags:

The reference should be below the product price so that price and payment information is grouped together.

If your theme doesn't include the price inside the product form, then you can create a second instance of the product form near the price display to host the installments banner. Inside this second form, you need to include a hidden <input /> that notes the currently selected variant. This hidden input needs to be updated as the variant selection changes.

The payment_terms filter can be used anywhere that you can use a product form. It's commonly used in the product template, or a section inside of the template.

Anchor to Add the banner to the cart formAdd the banner to the cart form

To add a Shop Pay installments banner to the cart form, you need to add a reference to the form object, with the payment_terms filter applied, between the opening and closing form tags:

The reference should be below the cart subtotal price so that price and payment information is grouped together.

The payment_terms filter can be used anywhere that you can use a cart form. It's commonly used in the cart template, or a section inside of the template.

Anchor to Updating the banner with cart total changesUpdating the banner with cart total changes

To stay updated with the cart total, the banner parses for the subtotal price based on the attribute data-cart-subtotal. Most free Shopify themes have this attribute on their subtotal display by default, so the banner will update automatically. If your banner doesn't update automatically, then you need to add the data-cart-subtotal attribute to your subtotal display.