diff --git a/docs/content/docs/(guides)/apps/emails.mdx b/docs/content/docs/(guides)/apps/emails.mdx
index 5250e49df9..8a94e6559a 100644
--- a/docs/content/docs/(guides)/apps/emails.mdx
+++ b/docs/content/docs/(guides)/apps/emails.mdx
@@ -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
 - **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.
 
diff --git a/docs/content/docs/(guides)/apps/payments.mdx b/docs/content/docs/(guides)/apps/payments.mdx
index ccb2b41f15..2b7e617884 100644
--- a/docs/content/docs/(guides)/apps/payments.mdx
+++ b/docs/content/docs/(guides)/apps/payments.mdx
@@ -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
+
+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: