Skip to content

docs: Document payment email templates #1133

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
madster456 merged 2 commits into from
Feb 24, 2026
Merged

docs: Document payment email templates #1133

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ff913cd
Document payment email templates
promptless[bot] Jan 23, 2026
5f55367
Merge branch 'dev' into promptless/document-payment-email-templates
madster456 Feb 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/content/docs/(guides)/apps/emails.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,6 +118,8 @@ Stack Auth provides several built-in email templates for common authentication f
- **Magic Link**: `magic_link` - Sent for passwordless authentication
- **Team Invitation**: `team_invitation` - Sent when users are invited to teams
Copy link
Copy Markdown
Contributor Author

@promptless promptless Bot Jan 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: New payment_receipt and payment_failed template IDs added in packages/stack-shared/src/helpers/emails.ts. Template definitions show they're used for transactional payment notifications.
View source

- **Sign-in Invitation**: `sign_in_invitation` - Sent to invite users to sign up
- **Payment Receipt**: `payment_receipt` - Sent when a payment succeeds (one-time or subscription)
- **Payment Failed**: `payment_failed` - Sent when a payment fails (one-time or subscription)

These templates can be customized through the admin interface or programmatically.

Expand Down
9 changes: 9 additions & 0 deletions docs/content/docs/(guides)/apps/payments.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,6 +155,15 @@ Click the refund button in a transaction row to issue a refund. Refunds are only

For USD transactions, you can issue full or partial refunds—just specify an amount greater than zero and up to the original charge. Non-USD transactions only support full refunds.

### Payment Emails
Copy link
Copy Markdown
Contributor Author

@promptless promptless Bot Jan 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Email sending logic in apps/backend/src/app/api/latest/integrations/stripe/webhooks/route.tsx shows templates are sent for both one-time purchases (payment_intent.succeeded/failed) and subscriptions (invoice.payment_succeeded/failed).
View source


Email notifications are sent automatically when payments are processed:

- **Payment Receipt**: Sent on successful payment with product details, amount, and receipt link
- **Payment Failed**: Sent on failed payment with product name, amount, and failure reason

These emails apply to both one-time purchases and subscription renewals. Customize them in the dashboard under **Emails → Templates**.

## Customer Types

Stack Auth supports three types of payment customers:
Expand Down
Loading