Enable Pay Later messaging on Solidus

DocsCurrentLast updated: April 8th 2022, @ 8:17:05 am

Promote PayPal Pay Later offers using messaging and buttons on your Solidus store.

PayPal offers short-term, interest-free payments and other special financing options that buyers can use to buy now and pay later. You get paid up-front, and there are no additional costs.

Pay Later messaging include the following Pay Later offers which are available to US customers only:

  • Pay in 4 - Eligible US buyers can pay in four interest-free payments for purchases of $30 to $1,500.
  • Pay Monthly - Eligible US buyers can pay in 6, 12, or 24 monthly installments for purchases of $199 to $10,000.

Know before you begin

  • Before you begin, learn more about Pay Later offers.
  • Before you enable Pay Later messaging, make sure you install and set up GitHub.
  • Decide whether to enable messaging using a PayPal integration or a Braintree integration.
  • Follow the Solidus GitHub integration steps to set up the Solidus PayPal Commerce Platform with PayPal or Braintree.
  • US-based consumers are eligible for Pay Later offers across most of our integrations. As a merchant, you're eligible to promote Pay Later offers if you are based in the US with a US-facing website and a one-time payment integration. Promoting Pay Later offers is not available if you're using vaulted payments or subscriptions.

How it works

These are sample checkout pages with Pay Later messaging and button enabled for webpages and mobile devices.

Pay Later messaging and button on a webpage


Pay Later messaging and button on a mobile device


Enable and customize the messaging and button

To enable the Pay Later messaging and button, choose either a PayPal set up or a Braintree set up.


Messaging is enabled by default. Make sure you already set up the Solidus PayPal Commerce Platform using a PayPal integration.


Note: Make sure you already set up the Solidus PayPal Commerce Platform using a Braintree integration.

PayPal offers messaging that notifies the customer that financing options are available. This component is included in both the cart and checkout pages, but is disabled by default. To enable messaging, use the checkout flow and set the PayPal button messaging option to true.

Alternatively, You can include this view partial to enable messaging anywhere on your site, such as the product page:

render "spree/shared/paypal_messaging, options: {total: @product.price, placement: "product", currency: 'USD'}"

Step result

Pay Later messaging and button displays on your Solidus store.

See also

See the Solidus PayPal documentation page on GitHub.

See the Solidus Braintree documentation page on GitHub.

Return to Commerce Platforms