.env.example

# --- Stripe ---
# Restricted key with read access to: customers, subscriptions, invoices, charges,
# refunds, products, prices, plans, payment_intents, disputes, credit_notes
STRIPE_API_KEY=rk_live_xxx

# Webhook signing secret (only used by the webhook package)
# Get it from: Stripe Dashboard > Developers > Webhooks > [your endpoint] > Signing secret
STRIPE_WEBHOOK_SECRET=whsec_xxx

# --- Amplitude ---
AMPLITUDE_API_KEY=your_amplitude_project_api_key

# Optional: EU residency endpoint
# AMPLITUDE_ENDPOINT=https://api.eu.amplitude.com/2/httpapi

# --- User ID resolution ---
# Strategy to extract Amplitude user_id from a Stripe Customer.
# One of: metadata.<field>, email, id
# Examples:
#   metadata.user_id      -> uses customer.metadata.user_id
#   metadata.app_user_id  -> uses customer.metadata.app_user_id
#   email                 -> uses customer.email
#   id                    -> uses customer.id (cus_xxx)
USER_ID_STRATEGY=metadata.user_id

# Fallback chain when primary strategy returns nothing.
# Comma-separated, evaluated in order. Use "skip" to drop unmatched events.
USER_ID_FALLBACK=email,id

# --- Webhook server ---
PORT=3000
HOST=0.0.0.0
LOG_LEVEL=info

# --- Backfill ---
# Optional: only backfill data created after this Unix timestamp (seconds).
# Leave empty to backfill since Stripe account creation.
BACKFILL_SINCE=

# Optional: comma-separated list of entities to include.
# Default: all
# Available: customer,subscription,invoice,charge,refund,payment_intent,dispute,credit_note
BACKFILL_ENTITIES=

# Where to persist backfill state (resumability)
BACKFILL_STATE_DIR=./.backfill-state