diff --git a/docker/.env.example b/docker/.env.example
index 1b86f7e6c..fc0b0de6d 100644
--- a/docker/.env.example
+++ b/docker/.env.example
@@ -127,6 +127,20 @@ EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2
 # Supports TLS: rediss://:password@host:6380/0
 # REDIS_URL=redis://redis:6379/0
 
+# ------------------------------------------------------------------------------
+# Stripe (pay-as-you-go page packs — disabled by default)
+# ------------------------------------------------------------------------------
+
+# Set TRUE to allow users to buy additional page packs via Stripe Checkout
+STRIPE_PAGE_BUYING_ENABLED=FALSE
+# STRIPE_SECRET_KEY=sk_test_...
+# STRIPE_WEBHOOK_SECRET=whsec_...
+# STRIPE_PRICE_ID=price_...
+# STRIPE_PAGES_PER_UNIT=1000
+# STRIPE_RECONCILIATION_INTERVAL=10m
+# STRIPE_RECONCILIATION_LOOKBACK_MINUTES=10
+# STRIPE_RECONCILIATION_BATCH_SIZE=100
+
 # ------------------------------------------------------------------------------
 # TTS & STT (Text-to-Speech / Speech-to-Text)
 # ------------------------------------------------------------------------------