Stripe with Epic Stack

Introduction

This project integrates Stripe payments with Epic Stack and is heavily inspired by stripe-stack

Clone the repo. In order to use Stripe Subscriptions and seed our database, we'll require to get the secret keys from our Stripe Dashboard.
Create a new Stripe Account.
Visit API Keys section and copy the Publishable and Secret keys.
Paste each one of them into your .env file as STRIPE_PUBLIC_KEY and STRIPE_SECRET_KEY respectively.
Install the Stripe CLI. Once installed run the following command in your console:

stripe listen --forward-to localhost:3000/api/webhook

This should give you a Webhook Secret Key. Copy and paste it into your .env file as DEV_STRIPE_WEBHOOK_ENDPOINT.

[!IMPORTANT] This command should be running in your console while developing and running the create-stripe-plan.ts script.

npx prisma db seed

Run the following script to programatically create Stripe Plans and populate the db.

npx tsx ./other/stripe/create-stripe-plans.ts

Warning Run the above script only once as it creates subscriptions related entities on Stripe platform.

This example implements a common SaaS subscription use case with monthly and yearly pricing. Each subscription variant can optionally be configured with a limit on number of units user can consume.
User subscription state is stored in the application db, so as not to fetch from Stripe when needed. The state will be kept in sync with Stripe using a webhook. See this article for details.
There are endpoints under /services/stripe/api and /resources/stripe/create-* within the application to manage Stripe calls. Communication with Stripe end point is managed by stacking redirects, if you need clean browser history, these endpoints can be converted to stacked asynchronous calls but in that case youy need to handle edge cases like when user cancels the page load while waiting for stacked async calls.

If you find this template useful, support it with a Star ⭐
It helps the repository grow and gives me motivation to keep working on it. Thank you!

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
.github		.github
.vscode		.vscode
app		app
other		other
prisma		prisma
public		public
server		server
tests		tests
types		types
.env.example		.env.example
.eslintrc.cjs		.eslintrc.cjs
.gitignore		.gitignore
.npmrc		.npmrc
.prettierignore		.prettierignore
.prettierrc.js		.prettierrc.js
README.md		README.md
components.json		components.json
fly.toml		fly.toml
index.js		index.js
package-lock.json		package-lock.json
package.json		package.json
playwright.config.ts		playwright.config.ts
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts
vitest.config.ts		vitest.config.ts