Subscription Email Templates
Five subscription-specific email templates are available:Renewal Success
Sent after a successful subscription charge. Confirms the renewal and shows the next billing date.
Renewal Failed
Sent when a charge fails. Supports retry-aware messaging so the tone escalates with each attempt.
Pre-Renewal Reminder
Sent 3 days before the next charge. Gives customers time to update their card or make changes.
Subscription Paused
Confirms that billing has been paused. Shows the resume date if one is set.
Subscription Canceled
Confirms cancellation. Includes a soft win-back CTA.
Retry-Aware Dunning Emails
The renewal failed template can show different messaging based on how many retry attempts have occurred, using@if directives in the template editor:
Template Variables
All subscription email templates receive the standard purchase data (products, amounts, customer info) plus these subscription-specific fields:| Variable | Available In |
|---|---|
subscription.cycle_number | All templates |
subscription.next_charge_at | Renewal success, pre-renewal |
subscription.frequency_label | All templates |
subscription.retry_count | Renewal failed |
subscription.next_retry_date | Renewal failed |
subscription.card_last4 | Renewal failed |
subscription.paused_at | Paused |
subscription.resume_at | Paused |
subscription.canceled_at | Canceled |
subscription.cancel_reason | Canceled |
Setting Up Subscription Emails
Open your merchant settings
Go to Settings → Merchants and click to edit your NMI or Stripe merchant.
Go to the Email tab
Switch to the Email tab. You’ll see the standard order email section, plus two new sections: Subscription Emails and Dunning Configuration.
Create email templates
In the Subscription Emails section, click Create next to each template type. This generates a pre-built template you can customize in the email editor. Then select the template from the dropdown.
The Subscription Emails and Dunning Configuration sections only appear for NMI and Stripe merchants, since those are the gateways that support internal subscription billing.
Dunning Configuration
Dunning is the process of retrying failed subscription charges. When a renewal fails, the subscription enters a retry cycle according to your schedule.| Setting | Description | Default |
|---|---|---|
| Max Retries | Maximum retry attempts before auto-canceling | 6 |
| Retry Schedule | Day intervals between retries | 1, 3, 5, 7, 10, 14 |
| Callcenter Escalation After Retry # | Escalate to callcenter after this many retries | 3 (set to 0 to disable) |
| Send to Callcenter on Cancel | Route cancellation events to callcenter | Off |
How the Retry Schedule Works
The retry schedule defines the number of days after the initial failure for each retry attempt. With the default schedule1, 3, 5, 7, 10, 14:
- Day 1 — First retry
- Day 3 — Second retry
- Day 5 — Third retry (callcenter escalation triggers here if configured at 3)
- Day 7 — Fourth retry
- Day 10 — Fifth retry
- Day 14 — Sixth and final retry
Pre-Renewal Reminders
Pre-renewal emails are sent automatically 3 days before the next scheduled charge to customers with an active subscription and a valid email address.Pre-renewal emails are recommended for legal compliance in some jurisdictions (e.g., FTC negative-option guidelines in the US).