Fintech Starter App

Table of contents

• Introduction
• Deploy
• Setup
• Using another chain
• Using in production
  • Enabling Withdrawals

Introduction

Create your own Fintech app in minutes using Crossmint wallets and onramp.

Key features

• Login with email or social media
• Automatically create non-custodial wallets for your users
• Top up with USDC using a credit or debit card
• Transfer USDC to another wallet or email address
• Save contacts for one-tap Quick Send (persisted per wallet in localStorage)
• Issue and fund a Rain virtual card (base-sepolia only, requires RAIN_API_KEY)
• Device signers for transaction approval
• View your wallet activity
• Withdraw USDC to your bank account
• Support for +40 chains (Solana, EVM, etc)
• Leverage more than +200 onchain tools integrating GOAT

New: Yield Integration

• Earn yield on your USDC through DeFi protocols (Aave, Morpho, Compound)
• Powered by Yield.xyz - the unified yield infrastructure for Web3
• The wallets in this demo use testnet tokens to interact with mainnet yield protocols. Testnet deposits won't actually earn yield — this is for demonstration purposes only.

Coming soon

• Currency conversion

Get in touch with us to get early access to these features!

Join our Telegram community to stay updated on the latest features and announcements.

Deploy

Easily deploy the template to Vercel with the button below. You will need to set the required environment variables in the Vercel dashboard.

Setup

1. Clone the repository and navigate to the project folder:

git clone https://github.com/crossmint/fintech-starter-app.git && cd fintech-starter-app

2. Install all dependencies:

npm install
# or
yarn install
# or
pnpm install
# or
bun install

3. Set up the environment variables:

cp .env.template .env

4. Login to the Crossmint staging console and get the client API key from the overview page:

NEXT_PUBLIC_CROSSMINT_CLIENT_API_KEY=your_client_side_API_key

5. Run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Using another chain

To use another chain, you'll need to:

1. Update the chain environment variable to the chain you want to use.

NEXT_PUBLIC_CHAIN_ID=solana

2. Update the USDC locator to the USDC of the chain you want to use.

# For solana 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
NEXT_PUBLIC_USDC_MINT=your_USDC_mint

Optional integrations

# Rain virtual cards — only rendered when NEXT_PUBLIC_CHAIN_ID=base-sepolia
RAIN_API_KEY=
# HubSpot sign-in tracking — no-op unless set
HUBSPOT_PRIVATE_APP_TOKEN=
NEXT_PUBLIC_HUBSPOT_PORTAL_ID=

Using in production

This starter app is designed for rapid prototyping and testing in a staging environment. To move to production you'll need to:

1. Login to the Crossmint production console and create a client side API key with the following scopes: users.create, users.read, wallets.read, wallets.create, wallets:transactions.create, wallets:transactions.sign, wallets:transactions.read, wallets:balance.read, wallets.fund.
2. Update the chain environment variable to a mainnet chain.
   • Note ⚠️: Non custodial signers for solana are not available in production yet since they are undergoing a security audit. Reach out to us on Telegram to be the first to know when they are available.
3. Update the USDC locator to the USDC of the mainnet chain you want to use.
4. Customize your email template for login and signup in the Crossmint console under the Settings tab in the Branding section.
5. For using onramp in production reach out to us on Telegram.

Enabling Withdrawals

Withdrawals are powered by Coinbase and only work in production. For enabling withdrawals you'll need to:

1. Create a Coinbase developer account
2. Create a Server API Key
3. Add the NEXT_PUBLIC_COINBASE_APP_ID, COINBASE_API_KEY_ID, and API_KEY_SECRET to the .env file.
4. In the Onramp configuration add your domain to the domain allowlist