Skip to content

Commit 5e506da

Browse files
MrEdwardoMrEdwardo
authored
Add details of new optional lifecycle emails (#961)
1 parent 5e9c998 commit 5e506da

File tree

1 file changed

+27
-17
lines changed

1 file changed

+27
-17
lines changed

‎docs/web/web-billing/lifecycle-emails.mdx

Lines changed: 27 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,11 @@ hidden: false
66
---
77

88
:::info California requirements for auto-renewing subscriptions
9-
Beginning July 1, 2025, new rules apply for customers in California related to auto-renewing subscriptions, including wording changes at the time of purchase and renewal notification emails for subscriptions. RevenueCat is implementing changes that will automatically apply in this state, to comply with the updated rules. If you're using RevenueCat Web Billing, you do not need to take any action.
10-
11-
Read more:
12-
[Legal ruling](https://leginfo.legislature.ca.gov/faces/codes_displayText.xhtml?lawCode=BPC&division=7.&title=&part=3.&chapter=1.&article=9.) | [Explanation](https://www.arnoldporter.com/en/perspectives/advisories/2025/01/new-california-requirements-for-subscriptions-in-2025)
9+
Beginning July 1, 2025, new rules apply for customers in California related to auto-renewing subscriptions, including wording changes at the time of purchase and renewal notification emails for subscriptions. RevenueCat has implemented new lifecycle emails to comply with the updated rules: [see below](#optional-lifecycle-emails-for-auto-renewing-subscriptions).
1310
:::
1411

12+
# Lifecycle emails
13+
1514
Customers purchasing through Web Billing (formerly RevenueCat Billing) will receive emails related to their subscriptions and other purchases on the web.
1615

1716
Emails sent to customers:
@@ -28,20 +27,31 @@ Only the `Page background` and `Primary button` colors are used to brand emails.
2827

2928
![](/docs_images/web/web-billing/customization_in_emails.png)
3029

30+
## \[optional\] Lifecycle emails for auto-renewing subscriptions
31+
32+
Two lifecycle emails can be enabled to comply with the latest (as of July 1st, 2025) California requirements for auto-renewing subscriptions. These emails can be enabled in: the **Payment provider** tab of your Web Billing configuration:
33+
34+
1. Upcoming renewal notifications for yearly subscriptions
35+
1. Upcoming free trial expiry notifications for trials longer than 1 month
36+
37+
Read more: [Legal ruling](https://leginfo.legislature.ca.gov/faces/codes_displayText.xhtml?lawCode=BPC&division=7.&title=&part=3.&chapter=1.&article=9.), [explanation](https://www.arnoldporter.com/en/perspectives/advisories/2025/01/new-california-requirements-for-subscriptions-in-2025)
38+
3139
## All emails, triggers, and calls to action
3240

3341
You can find a complete list of customer emails below, in addition to the triggers that are used to send them.
3442

35-
| Email | Trigger | Call to action |
36-
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
37-
| Free trial start | The customer started a free trial | n/a |
38-
| Initial purchase | The customer made a successful purchase (either a subscription or one-time purchase) | Redeem purchase (when [Redemption Links](/web/web-billing/redemption-links) enabled) |
39-
| Redemption link refresh | The customer attempted to use an expired redemption link, so a new one was sent to them | Redeem purchase (when [Redemption Links](/web/web-billing/redemption-links) enabled) |
40-
| Customer portal login | The customer initiated access to the [customer portal](/web/web-billing/customer-portal) | Manage subscription in [customer portal](/web/web-billing/customer-portal) |
41-
| Subscription renewal | The customer's subscription automatically renewed at the end of their billing period | n/a |
42-
| Failed payment | A renewal payment failed (after several retries) | Manage subscription in [customer portal](/web/web-billing/customer-portal) |
43-
| Subscription cancelation | The customer canceled their subscription | Renew subscription in [customer portal](/web/web-billing/customer-portal) |
44-
| Subscription renewed (after cancelation) | The customer renewed their subscription after previously canceling, before it expired | n/a |
45-
| Subscription expiry | The customer's subscription expired and will not be renewed | n/a |
46-
| Chargeback detected | RevenueCat detected a chargeback from the customer, and the subscription was immediately canceled as a result | n/a |
47-
| Refund issued | A refund was issued to the customer | n/a |
43+
| Email | Trigger | Call to action |
44+
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
45+
| Free trial start | The customer started a free trial | n/a |
46+
| Initial purchase | The customer made a successful purchase (either a subscription or one-time purchase) | Redeem purchase (when [Redemption Links](/web/web-billing/redemption-links) enabled) |
47+
| Redemption link refresh | The customer attempted to use an expired redemption link, so a new one was sent to them | Redeem purchase (when [Redemption Links](/web/web-billing/redemption-links) enabled) |
48+
| Customer portal login | The customer initiated access to the [customer portal](/web/web-billing/customer-portal) | Manage subscription in [customer portal](/web/web-billing/customer-portal) |
49+
| Subscription renewal | The customer's subscription automatically renewed at the end of their billing period | n/a |
50+
| Failed payment | A renewal payment failed (after several retries) | Manage subscription in [customer portal](/web/web-billing/customer-portal) |
51+
| Subscription cancelation | The customer canceled their subscription | Renew subscription in [customer portal](/web/web-billing/customer-portal) |
52+
| Subscription renewed (after cancelation) | The customer renewed their subscription after previously canceling, before it expired | n/a |
53+
| Subscription expiry | The customer's subscription expired and will not be renewed | n/a |
54+
| Chargeback detected | RevenueCat detected a chargeback from the customer, and the subscription was immediately canceled as a result | n/a |
55+
| Refund issued | A refund was issued to the customer | n/a |
56+
| \[optional\] Upcoming yearly subscription renewal | A yearly subscription is soon to renew (must be enabled in dashboard, see [above](#optional-lifecycle-emails-for-auto-renewing-subscriptions)) | Manage subscription in [customer portal](/web/web-billing/customer-portal) |
57+
| \[optional\] Upcoming free trial expiry | A free trial (longer than 1 month) is soon to expire (must be enabled in dashboard, see [above](#optional-lifecycle-emails-for-auto-renewing-subscriptions)) | Manage subscription in [customer portal](/web/web-billing/customer-portal) |

0 commit comments

Comments
 (0)