Stripe Subscription

Tech Stack

• Backend: Express.js
• Payments: Stripe Checkout + Customer Portal
• Language: JavaScript
• Package Manager: npm
• Port: 4242

Setup

1. Clone the Template

git clone --depth 1 https://github.com/Eng0AI/stripe-subscription.git .

git clone --depth 1 https://github.com/Eng0AI/stripe-subscription.git _temp_template
mv _temp_template/* _temp_template/.* . 2>/dev/null || true
rm -rf _temp_template

2. Remove Git History (Optional)

rm -rf .git
git init

3. Install Dependencies

npm install

4. Setup Environment Variables

cp .env.example .env

• STRIPE_SECRET_KEY

  - Your Stripe secret key (sk_test_xxx)

• STRIPE_PUBLISHABLE_KEY

  - Your Stripe publishable key (pk_test_xxx)

• BASIC_PRICE

  - Price ID for Starter plan ($12/month default)

• PRO_PRICE

  - Price ID for Professional plan ($18/month default)

5. Start the Server

npm start

Deploy to Vercel

Step 1: Create Serverless API Wrapper

api/index.js

Step 2: Create Vercel Config

vercel.json

{
  "version": 2,
  "buildCommand": "",
  "outputDirectory": "client/html",
  "rewrites": [
    { "source": "/config", "destination": "/api" },
    { "source": "/checkout-session", "destination": "/api" },
    { "source": "/create-checkout-session", "destination": "/api" },
    { "source": "/customer-portal", "destination": "/api" }
  ]
}

Step 3: Set Environment Variables

printf "YOUR_SECRET_KEY" | vercel env add STRIPE_SECRET_KEY production -t $VERCEL_TOKEN
printf "YOUR_PUBLISHABLE_KEY" | vercel env add STRIPE_PUBLISHABLE_KEY production -t $VERCEL_TOKEN

Step 4: Deploy

vercel --prod -t $VERCEL_TOKEN --yes

Deploy to Netlify

netlify/functions/api.js

netlify.toml

netlify deploy --prod

Testing

• Success: 4242 4242 4242 4242
• Decline: 4000 0000 0000 0002

Customer Portal Configuration

• Enable: Update payment method, Cancel subscription, Switch plans

Going Live

1. Replace test keys with live keys (sk_live_/pk_live_)
2. Create subscription products in Stripe Dashboard Live mode
3. Complete Stripe account verification (KYC)
4. Configure Customer Portal for live mode
5. Test with a real subscription