# Subscription renewal reminder event In the bustling world of subscription-based services, keeping customers engaged and informed is crucial for maintaining ongoing relationships and ensuring a steady revenue stream. The `subscription.renewal_reminder` event plays a pivotal role in this dynamic by serving as a timely nudge to subscribers, prompting them to take action on their upcoming subscription renewals. Designed with precision, this event is an integral component of Digital River's subscription management ecosystem, aimed at enhancing the customer experience through personalized and efficient communication. As subscribers approach the end of their current subscription period, the `subscription.renewal_reminder` event is automatically triggered, sending out a reminder to renew their subscription. This not only aids in preventing service interruptions but also supports customer retention strategies by ensuring that users are well-informed about their subscription status. This event ensures a comprehensive approach to subscription renewal notifications, catering to diverse user preferences and business models by encompassing various renewal types, such as auto-renewal, manual renewal, and SEPA auto-renewal. Understanding the mechanism and effectiveness of the `subscription.renewal_reminder` event is crucial for developers, system integrators, and businesses leveraging Digital River's robust subscription services. It enables them to tailor their systems and customer communication strategies, ensuring a seamless and proactive renewal process. The `subscription.renewal_reminder` event is designed to trigger when the subscription reaches the renewal notification date (`nextRenewalDate`) in the [subscription lifecycle](https://docs.digitalriver.com/commerce-api-references/commerce-api-reference-guide/admin-apis-reference/subscriptions#subscription-lifecycle), ensuring subscribers receive timely notifications about upcoming subscription product renewals. Here’s a closer look at how and when this event is activated: * **Pre-renewal timing:** The event is scheduled to trigger based on the `nextRenewalDate` field, commonly set to a predefined period before the actual renewal date. This period allows subscribers ample time to decide on their subscription renewal actions. * **Subscription status:** The event targets subscriptions in the `"Subscribed"` state, as indicated in the `state` attribute. It ensures that only active and potentially renewing subscriptions receive renewal reminders. * **Manual vs. auto-Rrenewal:** Despite the `autoRenewal` flag being set to `false` in the example, the system is designed to support auto-renewal and manual renewal subscriptions. This flexibility caters to different customer preferences and business models. * **Comprehensive notification system:** By integrating with Digital River's unified notification system, the event leverages a sophisticated mechanism for dispatching reminders. This system considers customer locale, subscription details, and personalized information for a tailored reminder experience. Understanding these trigger conditions helps developers and system integrators better anticipate the event's activation and prepare their systems to process renewal reminders efficiently. {% tabs %} {% tab title="Request" %} ``` { "type":"subscription.renewal_reminder", "data":{ "object":{ "id":"6310199", "creationDate":"2022-03-28T16:51:10.000Z", "activationDate":"2022-03-28T05:00:00.000Z", "nextRenewalDate":"2022-05-28T05:00:00.000Z", "nextBillingDate":"2022-05-28T05:00:00.000Z", "expirationDate":"2022-05-28T05:00:00.000Z", "graceDate":"2022-06-04T05:00:00.000Z", "currentQuantity":1, "renewalQuantity":1, "autoRenewal":false, "locale":"en_US", "state":"Subscribed", "duration":61, "frequency":30, "currentBillingCycleNumber":2, "totalNumberOfBillingCycle":2, "siteId":"sub2test", "shopper":{ "id":"25448437760199" }, "renewalPrice":{ "unitPrice":19.0, "locked":true, "currency":"USD" }, "term":{ "termUnit":"MONTHS", "termLength":1 }, "product":{ "id":"5403551500", "displayName":"APM_2_months_manual", "sku":"SUBS_COMMITMENT" }, "shipToAddress":{ "id":"405367800199", "firstName":"Digital", "lastName":"River QA", "line1":"10380 Bren Rd.", "city":"Minnetonka", "postalCode":"55343", "countrySubdivision":"MN", "country":"US", "countryName":"United States", "phoneNumber":"9525559519", "emailAddress":"Auto_112203282022115010AM@digitalriver.com" }, "paymentOption":{ "nickName":"Default", "id":"4018890199", "isDefault":"true", "type":"CreditCardMethod", "creditCard":{ "expirationMonth":"6", "expirationYear":"2026", "displayableNumber":"************1111", "type":"visa", "displayName":"Visa" }, "address":{ "id":"405367320199", "firstName":"Digital", "lastName":"River QA", "line1":"10380 Bren Rd.", "city":"Minnetonka", "postalCode":"55343", "countrySubdivision":"MN", "country":"US", "countryName":"United States", "phoneNumber":"9525559519", "emailAddress":"Auto_112203282022115010AM@digitalriver.com" } }, "addOns":[ ] } }, "clientIds":{ "site_id":"sub2test" }, "searchableData":{ "subscriptionId":"6310199" } } ``` {% endtab %} {% tab title="Response" %} ```json { "id": "a5ea6200-f95e-4317-82b7-0080f3c20ab9", "type": "subscription.renewal_reminder", "data": { "object": { "id":"6310199", "creationDate":"2022-03-28T16:51:10.000Z", "activationDate":"2022-03-28T05:00:00.000Z", "nextRenewalDate":"2022-05-28T05:00:00.000Z", "nextBillingDate":"2022-05-28T05:00:00.000Z", "expirationDate":"2022-05-28T05:00:00.000Z", "graceDate":"2022-06-04T05:00:00.000Z", "currentQuantity":1, "renewalQuantity":1, "autoRenewal":false, "locale":"en_US", "state":"Subscribed", "duration":61, "frequency":30, "currentBillingCycleNumber":2, "totalNumberOfBillingCycle":2, "siteId":"sub2test", "shopper":{ "id":"25448437760199" }, "renewalPrice":{ "unitPrice":19.0, "locked":true, "currency":"USD" }, "term":{ "termUnit":"MONTHS", "termLength":1 }, "product":{ "id":"5403551500", "displayName":"APM_2_months_manual", "sku":"SUBS_COMMITMENT" }, "shipToAddress":{ "id":"405367800199", "firstName":"Digital", "lastName":"River QA", "line1":"10380 Bren Rd.", "city":"Minnetonka", "postalCode":"55343", "countrySubdivision":"MN", "country":"US", "countryName":"United States", "phoneNumber":"9525559519", "emailAddress":"Auto_112203282022115010AM@digitalriver.com" }, "paymentOption":{ "nickName":"Default", "id":"4018890199", "isDefault":"true", "type":"CreditCardMethod", "creditCard":{ "expirationMonth":"6", "expirationYear":"2026", "displayableNumber":"************1111", "type":"visa", "displayName":"Visa" }, "address":{ "id":"405367320199", "firstName":"Digital", "lastName":"River QA", "line1":"10380 Bren Rd.", "city":"Minnetonka", "postalCode":"55343", "countrySubdivision":"MN", "country":"US", "countryName":"United States", "phoneNumber":"9525559519", "emailAddress":"Auto_112203282022115010AM@digitalriver.com" } }, "addOns":[ ] } }, "liveMode": false, "createdTime": "2021-07-01T06:19:02.725277Z" } ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.digitalriver.com/commerce-api/events/event-types/subscription-event-types/subscription-renewal-reminder-event.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.