This sample demonstrates a basic web application with multi-region embedded finance and expense management features built on Stripe's Issuing and Treasury APIs.
Note: this directory contains a demo application showcasing a wide range of Banking-as-a-Service products at Stripe. You can use it today at https://baas.stripe.dev. If you are beginning an integration with Stripe's Banking-as-a-Service APIs, we recommend you instead read and use sample application code that is focussed on the financial product you want to build. See the non-_base
directories in the root of this repository (for example: embedded-finance
, expense-management
).
See the sample app live at https://baas.stripe.dev
If you choose not to skip onboarding with prefilled info, then follow these steps when redirected to the Stripe Connect Onboarding form:
- Enter “000 000 0000” for phone number and any fake email address
- Click “Use test code” when prompted for SMS verification
- Click “Skip this step” when prompted to verify your identity
- Onboard and verify business customers 🔍
- Issue cards 💳
- Display full card numbers with PCI compliance 🔢
- Create financial accounts 🏦
- Simulate test payments ⚡
- Review transactions 📃
For details of more features see the Issuing and Treasury sample app documentation.
- Activate Stripe Issuing and Treasury in test mode through this link: https://dashboard.stripe.com/setup/treasury/activate?a=1
- Obtain your Stripe API keys at https://dashboard.stripe.com/test/apikeys
You can immediately deploy this sample app to a unique, public URL with no coding required. Choose from Vercel or Render by clicking a button below:
Click the button below to get started on Vercel:
Click the button below to get started on Render:
You can also clone this repo and run it locally by following the steps below.
Clone this repo and then run these steps inside it.
git clone https://github.com/stripe-samples/issuing-treasury.git && cd issuing-treasury
Install the required Node.js runtime. You can install it directly from the Node.js website
but we recommend using a Node version manager. Most version managers can read the required version off of .node-version
and install it.
If you're using the nodenv
Node version manager (setup instructions for nodenv), use:
nodenv install
If you're using the popular nvm
Node version manager (setup instructions for Node Version Manager), use:
nvm install
Once Node.js is installed and activated, install the application's dependencies using:
npm install
Replicate .env.example
as .env
using:
cp .env.example .env
Update .env
to reflect:
- NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: Your Stripe publishable test mode API key (starts with
pk_test_...
). - STRIPE_SECRET_KEY: Your Stripe secret test mode API key (starts with
sk_test_...
). - NEXTAUTH_SECRET: For JWT encryption by NextAuth.js (learn more). Use
openssl rand -base64 32
to obtain a new one. - NEXTAUTH_URL: Your application URL, for local use you can keep the default "http://localhost:3000".
- CONNECT_ONBOARDING_REDIRECT_URL: Your application URL, for local use you can keep the default "http://localhost:3000".
On Mac, follow these instructions to install Postgres:
brew install postgresql@14
createuser -s postgres
createdb "$(whoami)"
You'll find more about the why you need the createuser
step here.
Next, create the database with:
npx prisma migrate dev
If it errors out (perhaps due to permission issue running the Prisma CLI), simply run the included script:
./db/setup-database.postgres.sh
This script creates a local Postgres issuing_treasury
database.
After necessary setups, launch the application with npm run dev
.
Note: This application serves as an example and should not proceed to production deployment as it is.
This sample uses the free Devias UI kit under an MIT license, which seamlessly integrates with Material UI and React.
You can easily customize aspects of the theme like the color palette by modifying the code in /src/theme
.
To build a full-featured, production-ready application we recommend the Devias Pro version, which offers additional layouts, advanced React components, pre-built dashboards, and essential TypeScript support that ensures your code remains clean, robust, and scalable.