Stripe Production Deployment Checklist

Phase 3 Sprint 5: Production Launch

Complete checklist for deploying Stripe billing integration to production at automation.keinar.com.

Pre-Deployment Requirements

Business Setup

Stripe Dashboard Configuration

Live API Keys Generated
- Live Secret Key (sk_live_...) created
- Live Publishable Key (pk_live_...) created
- Keys stored securely (NOT in git)

Products Created in Live Mode

# Create Team Plan
stripe products create \
  --name="Team Plan" \
  --description="Up to 20 users, 1,000 test runs/month, email support" \
  --api-key=sk_live_...

# Note product ID: prod_xxxxx

# Create Team Price
stripe prices create \
  --product=prod_xxxxx \
  --unit-amount=9900 \
  --currency=usd \
  --recurring[interval]=month \
  --api-key=sk_live_...

# Note price ID: price_xxxxx

# Create Enterprise Plan
stripe products create \
  --name="Enterprise Plan" \
  --description="Unlimited users and test runs, priority support, SSO" \
  --api-key=sk_live_...

# Note product ID: prod_yyyyy

# Create Enterprise Price
stripe prices create \
  --product=prod_yyyyy \
  --unit-amount=49900 \
  --currency=usd \
  --recurring[interval]=month \
  --api-key=sk_live_...

# Note price ID: price_yyyyy

Webhook Endpoint Configured
- Go to: https://dashboard.stripe.com/webhooks
- Click "Add endpoint"
- URL: https://automation.keinar.com/api/webhooks/stripe
- Select events:
  - customer.subscription.created
  - customer.subscription.updated
  - customer.subscription.deleted
  - invoice.payment_succeeded
  - invoice.payment_failed
- API version: Latest (2024-11-20 or newer)
- Copy webhook signing secret (whsec_...)
Billing Settings Configured
- Business name set
- Support email configured
- Statement descriptor set: "KEINAR AUTOMATION"
- Invoice footer added (optional)
Customer Portal Configured
- Go to: https://dashboard.stripe.com/settings/billing/portal
- Enable Customer Portal
- Configure features:
  - Update payment method
  - View invoices
  - Cancel subscription
  - Update billing information
- Set return URL: https://automation.keinar.com/settings?tab=billing
Email Notifications Configured
- Successful payment: Enabled
- Failed payment: Enabled
- Upcoming invoice: Enabled (7 days before)
- Subscription canceled: Enabled

Environment Configuration

Production .env File

Create .env file on production server with:

# ==========================================
# STRIPE BILLING (LIVE MODE)
# ==========================================
STRIPE_SECRET_KEY=sk_live_xxxxx
STRIPE_PUBLISHABLE_KEY=pk_live_xxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxx
STRIPE_TEAM_PRICE_ID=price_xxxxx
STRIPE_ENTERPRISE_PRICE_ID=price_yyyyy

# ==========================================
# CORS & API CONFIGURATION
# ==========================================
VITE_API_URL=https://automation.keinar.com
ALLOWED_ORIGINS=https://automation.keinar.com
FRONTEND_URL=https://automation.keinar.com

# ==========================================
# JWT & SECURITY
# ==========================================
JWT_SECRET=<64-char-random-string>
JWT_EXPIRY=24h
PASSWORD_SALT_ROUNDS=10

# ==========================================
# DATABASE
# ==========================================
MONGO_URI=mongodb://<username>:<password>@<host>:27017/automation_platform?authSource=admin

# ==========================================
# INFRASTRUCTURE
# ==========================================
RABBITMQ_URL=amqp://rabbitmq
REDIS_URL=redis://redis:6379
GEMINI_API_KEY=<your-key>

# ==========================================
# APPLICATION
# ==========================================
NODE_ENV=production
PORT=3000
REPORTS_DIR=/app/reports

Security Checklist

Deployment Steps

Step 1: Update Codebase

# On production server
cd /path/to/Agnostic-Automation-Center

# Pull latest code
git pull origin main

# Verify latest commit
git log --oneline -1
# Should be: Latest Phase 3 Sprint 5 commit

Step 2: Update Environment Variables

# Edit .env file
nano .env

# Add/update Stripe live keys
# Save and exit (Ctrl+X, Y, Enter)

# Verify variables (don't expose secrets!)
grep -E "STRIPE_|VITE_API_URL|ALLOWED_ORIGINS" .env | sed 's/=.*/=***/'

Step 3: Run Database Migrations

# Check current migration status
node migrations/check.js

# Run pending migrations (especially 004-add-webhook-logs)
node migrations/004-add-webhook-logs.js

# Verify indexes created
docker exec -it automation-mongodb mongosh
> use automation_platform
> db.webhook_logs.getIndexes()
# Should show unique index on eventId
> exit

Step 4: Rebuild Docker Containers

# Stop all services
docker-compose -f docker-compose.prod.yml down

# Rebuild with NO cache (important for env vars)
docker-compose -f docker-compose.prod.yml build --no-cache dashboard producer

# Start all services
docker-compose -f docker-compose.prod.yml up -d

# Verify all containers running
docker-compose -f docker-compose.prod.yml ps
# All should show "Up" status

Step 5: Verify Services

# Check producer logs
docker-compose -f docker-compose.prod.yml logs -f producer | head -50

# Look for:
# ✅ Producer connected to MongoDB
# ✅ Billing routes registered
# ✅ Webhook routes registered
# ✅ CORS configured
# No errors

# Check dashboard logs
docker-compose -f docker-compose.prod.yml logs dashboard | tail -20

# Verify Nginx serving static files

Step 6: Test Webhook Endpoint

# From external machine (not server)
curl -X GET https://automation.keinar.com/api/webhooks/test

# Expected response:
{
  "status": "ok",
  "message": "Webhook endpoint is accessible",
  "stripeConfigured": true,
  "webhookSecretConfigured": true
}

Step 7: Test Stripe Webhook Delivery

# In Stripe Dashboard
# Go to: Webhooks → [Your Endpoint]
# Click "Send test webhook"
# Select: customer.subscription.created
# Click "Send test webhook"

# Check producer logs
docker-compose -f docker-compose.prod.yml logs producer | grep -i webhook

# Should see:
# ✅ Webhook verified: customer.subscription.created

Step 8: Smoke Test Full Flow

Test Free Plan:

Open: https://automation.keinar.com
Sign up with new account
Verify:
- Redirected to dashboard
- Settings → Billing shows Free plan
- Plan cards visible
- No errors in console

Test Upgrade Flow:

Click "Upgrade to Team"
Use test card: 4242 4242 4242 4242
Complete checkout
Verify:
- Redirected back to billing page
- Plan shows "Team"
- Usage limits updated
- No errors

Test Customer Portal:

Click "Manage Subscription"
Verify redirected to Stripe portal
Check subscription details visible
Return to billing page

Roll Back Test (Don't complete):

Start upgrade to Enterprise
Cancel on Stripe checkout
Verify no changes to current plan

Post-Deployment Verification

Functional Tests

Security Tests

Performance Tests

Monitoring Setup

Rollback Plan

If critical issues found after deployment:

Quick Rollback (Emergency)

# Revert to previous version
git checkout <previous-commit-hash>

# Rebuild containers
docker-compose -f docker-compose.prod.yml down
docker-compose -f docker-compose.prod.yml up -d --build

# Monitor logs
docker-compose -f docker-compose.prod.yml logs -f

Database Rollback

# If migration needs rollback
node migrations/rollback-004.js  # Create if needed

# Restore from backup
mongorestore --uri="$MONGO_URI" --archive=backup-YYYYMMDD.gz --gzip

Stripe Webhook Rollback

In Stripe Dashboard: Disable webhook endpoint
Stop processing until issue resolved
Re-enable after fix deployed

Post-Launch Monitoring (First 24 Hours)

Every 2 Hours: Check Logs

# Check for errors
docker-compose -f docker-compose.prod.yml logs producer | grep -i error | tail -50

# Check webhook processing
docker-compose -f docker-compose.prod.yml logs producer | grep -i webhook | tail -50

# Check API errors
docker-compose -f docker-compose.prod.yml logs producer | grep " 500 " | tail -20

Daily: Check Metrics

// MongoDB - Check webhook health
use automation_platform

// Today's webhooks
db.webhook_logs.countDocuments({
  createdAt: {$gte: new Date(new Date().setHours(0,0,0,0))}
})

// Failed webhooks today
db.webhook_logs.countDocuments({
  status: 'error',
  createdAt: {$gte: new Date(new Date().setHours(0,0,0,0))}
})

// New subscriptions today
db.organizations.countDocuments({
  plan: {$in: ['team', 'enterprise']},
  'billing.currentPeriodStart': {$gte: new Date(new Date().setHours(0,0,0,0))}
})

Stripe Dashboard: Check Metrics

Go to: https://dashboard.stripe.com/dashboard
Check:
- Total revenue today
- Successful payments
- Failed payments (should be low)
- Webhook delivery success rate (should be >99%)
- Customer disputes (should be 0)

Common Issues & Solutions

Issue 1: Webhook Not Receiving Events

Symptoms:

Checkout completes but plan doesn't upgrade
Logs show no webhook received

Diagnosis:

# Check Stripe Dashboard
# Go to: Webhooks → [Your Endpoint] → Events
# See if events were sent

# Check endpoint accessibility
curl -X GET https://automation.keinar.com/api/webhooks/test
# Should return 200 OK

Solutions:

Verify webhook URL in Stripe Dashboard
Check firewall allows Stripe IPs
Verify HTTPS certificate valid
Check producer service running
Verify ALLOWED_ORIGINS includes Stripe

Issue 2: CORS Errors on Dashboard

Symptoms:

Browser console: "CORS policy: No 'Access-Control-Allow-Origin'"
API requests fail with status 0

Diagnosis:

# Check ALLOWED_ORIGINS
docker exec automation-producer env | grep ALLOWED_ORIGINS

# Expected:
ALLOWED_ORIGINS=https://automation.keinar.com

Solutions:

Update ALLOWED_ORIGINS in .env
Restart producer service
Verify dashboard built with correct VITE_API_URL

Issue 3: Dashboard Using Wrong API URL

Symptoms:

Dashboard tries to connect to localhost:3000
CORS errors

Diagnosis:

# Check what API URL is in dashboard bundle
docker exec automation-dashboard cat /usr/share/nginx/html/assets/index-*.js | grep -o 'http[s]*://[^"]*' | head -1

# Should output: https://automation.keinar.com

Solutions:

Verify VITE_API_URL in docker-compose.prod.yml
Rebuild dashboard with --no-cache
Verify build args passed correctly

Issue 4: Payments Not Processing

Symptoms:

Checkout session loads but payment fails
Stripe error in logs

Diagnosis:

# Check Stripe API key
docker exec automation-producer env | grep STRIPE_SECRET_KEY | sed 's/=.*/=***/'

# Should show sk_live_*** (not sk_test_***)

Solutions:

Verify live API keys (not test keys)
Check Stripe account activated
Verify Payoneer connected
Check business verification complete

Launch Communication

Internal Team

Subject: ✅ Phase 3: Billing Integration - LIVE

Team,

Billing integration deployed to production!

**What's Live:**
- Stripe subscription management
- Free, Team ($99/mo), Enterprise ($499/mo) plans
- Plan upgrade/downgrade flows
- Customer Portal for subscription management
- Usage limit enforcement
- Usage alerts at 50%, 80%, 90%

**URLs:**
- Dashboard: https://automation.keinar.com
- API: https://automation.keinar.com/api
- Stripe Dashboard: https://dashboard.stripe.com

**Monitoring:**
- Check logs every 2 hours (first 24h)
- Monitor Stripe dashboard for issues
- On-call: [Name] (first 48 hours)

**Known Issues:**
- None at this time

**Next Steps:**
- Monitor for 48 hours
- Collect user feedback
- Plan Phase 4: Email notifications

Questions? → #billing-support

Thanks!

Users (In-App Announcement)

🎉 New Feature: Team & Enterprise Plans!

We've launched paid plans with more resources:

**Team Plan ($99/mo):**
- 1,000 test runs/month
- Up to 20 users
- Email support

**Enterprise Plan ($499/mo):**
- Unlimited test runs
- Unlimited users
- Priority support
- SSO (coming soon)

View plans in Settings → Billing

Questions? Contact support@keinar.com

Success Criteria

Deployment considered successful when:

All smoke tests passed
No critical errors in logs
At least 1 successful test subscription created
Webhook delivery rate > 99%
Page load times acceptable
No user complaints in first 24 hours
All planned features working

Next Steps After Launch

Week 1:
- Daily log reviews
- Monitor Stripe metrics
- Collect user feedback
- Fix any minor issues
Week 2:
- Review conversion rates
- Analyze failed payments
- Optimize checkout flow
- Plan improvements
Phase 4 Planning:
- Email notifications (payment failed, subscription expiring)
- Usage reports
- Advanced analytics
- Team management features

docs/testing/billing-test-scenarios.md - Test scenarios
docs/testing/billing-edge-cases.md - Edge case handling
docs/testing/webhook-load-testing.md - Performance testing
docs/implementation/phase-3/ - Implementation details

Support Contacts

Stripe Support:

Dashboard: https://dashboard.stripe.com/support
Email: support@stripe.com
Phone: Check dashboard for regional number

Internal:

Slack: #billing-support
On-call: Check PagerDuty
Email: devops@keinar.com

Emergency Rollback Authority:

Primary: [Name]
Secondary: [Name]

Deployment Date: _____________ Deployed By: _____________ Verified By: _____________ Sign-off: _____________

Pre-Deployment Requirements​

Business Setup​

Stripe Dashboard Configuration​

Environment Configuration​

Production .env File​

Security Checklist​

Deployment Steps​

Step 1: Update Codebase​

Step 2: Update Environment Variables​

Step 3: Run Database Migrations​

Step 4: Rebuild Docker Containers​

Step 5: Verify Services​

Step 6: Test Webhook Endpoint​

Step 7: Test Stripe Webhook Delivery​

Step 8: Smoke Test Full Flow​

Post-Deployment Verification​

Functional Tests​

Security Tests​

Performance Tests​

Monitoring Setup​

Rollback Plan​

Quick Rollback (Emergency)​

Database Rollback​

Stripe Webhook Rollback​

Post-Launch Monitoring (First 24 Hours)​

Every 2 Hours: Check Logs​

Daily: Check Metrics​

Stripe Dashboard: Check Metrics​

Common Issues & Solutions​

Issue 1: Webhook Not Receiving Events​

Issue 2: CORS Errors on Dashboard​

Issue 3: Dashboard Using Wrong API URL​

Issue 4: Payments Not Processing​

Launch Communication​

Internal Team​

Users (In-App Announcement)​

Success Criteria​

Next Steps After Launch​

Related Documents​

Support Contacts​

Pre-Deployment Requirements

Business Setup

Stripe Dashboard Configuration

Environment Configuration

Production .env File

Security Checklist

Deployment Steps

Step 1: Update Codebase

Step 2: Update Environment Variables

Step 3: Run Database Migrations

Step 4: Rebuild Docker Containers

Step 5: Verify Services

Step 6: Test Webhook Endpoint

Step 7: Test Stripe Webhook Delivery

Step 8: Smoke Test Full Flow

Post-Deployment Verification

Functional Tests

Security Tests

Performance Tests

Monitoring Setup

Rollback Plan

Quick Rollback (Emergency)

Database Rollback

Stripe Webhook Rollback

Post-Launch Monitoring (First 24 Hours)

Every 2 Hours: Check Logs

Daily: Check Metrics

Stripe Dashboard: Check Metrics

Common Issues & Solutions

Issue 1: Webhook Not Receiving Events

Issue 2: CORS Errors on Dashboard

Issue 3: Dashboard Using Wrong API URL

Issue 4: Payments Not Processing

Launch Communication

Internal Team

Users (In-App Announcement)

Success Criteria

Next Steps After Launch

Related Documents

Support Contacts