Customise the Email and Landing Page used to take updated payment methods and authorisation from Subscription customers.
When a Stripe subscription changes status, a customer may need to update their payment details or carry out 3D Secure authorisation.
The email and landing page used in this flow can be customised and branded.
You can find the System Email under Site Manager > System Emails with the name Subscription User Action Required.
The purpose of this Email is to inform the User that the Subscription Order needs action from them before it can continue to be processed.
You must add a link to the Landing Page where your customer can take action. You can use the Liquid below:
Subscription Order Fields
Tip: Changes in the Pricing Plan It's possible to change the price and billing interval of a Subscription. This change will only affect new subscribers and existing customers will continue on the plan they signed up for originally. You can read more about this here: eCommerce Subscriptions - Changing the Price and Billing Interval When outputting fields in the email, Subscription Order fields beginning with the word "Plan" will normally be the appropriate choice. These will show the price that these Users will be paying- the original plan when they signed up. The other Price and Interval fields stored against the Subscription, could be used to show how much the User is saving on their current plan compared to the current price. In the different context of the Subscription Detail Page- we give a different recommendation as here it may not always be possible to identify immediately if the User is subscribed to a different plan.
Tip: Working with the Interval Fields As you can see below, there are multiple fields involved in storing the Interval of charges, which you can use to display the Interval in a user-friendly way. Here's one example of using Liquid to programmatically decide the format to display the Interval:
If the Interval Count is 1, it will use formatting like "per day". If the Interval Count is greater than 1, it will use formatting like "every 2 days". Check out all the available Liquid filters over on the platformOS Liquid docs.
You can find the System Page under Site Manager > System Emails with the name Subscription User Action Required.
The purpose of this Page is to provide a reliable URL where the above email can send Users to update their Payment Method. We'll provide the URL parameters to let the Page know which Subscription and Subscription Order to load. We'll also provide security to check that the User owns that Subscription Order before continuing.
This page may function very similarly to the standard Subscription Detail Page, however, you do have the option to use a different Layout or logic if you prefer.
The following Liquid will include a Subscription Detail Layout for the Subscription referenced in the link from the above Email. Note, this is different from the usual Liquid for including a Layout, because Siteglide will in this case be setting some of the parameters for you automatically.
If that Detail Layout contains a Form, we'll use the URL parameters to set the Form to edit the payment details for the correct Subscription Order referenced in the link from the Email.
You can add any other static content you like to this Page, but we recommend you use the Subscription Detail Layout itself to add any dynamic content and you can see available fields there.