Skip to main content
Recommended: use CLI setup with npx solvapay init.
This page covers the manual setup path.

​
Prerequisites

  • Node.js version 18.17 or higher
  • npm, yarn, or pnpm
  • TypeScript 5.0+ (recommended)

​
Install packages by use case

​
Server-side protection

npm install @solvapay/server

​
React checkout components

npm install @solvapay/react

​
Next.js integration

npm install @solvapay/next

​
Auth adapters

npm install @solvapay/auth

​
Supabase adapter for React

npm install @solvapay/react-supabase @supabase/supabase-js

​
Core types only

npm install @solvapay/core

​
Environment variables

Required for production: 
SOLVAPAY_SECRET_KEY=sk_live_...
Optional: 
SOLVAPAY_API_BASE_URL=https://api.solvapay.com

​
Stub mode

If SOLVAPAY_SECRET_KEY is not set, SDK calls run in stub mode for local testing. 
import { createSolvaPay } from '@solvapay/server'

const solvaPay = createSolvaPay()

​
Next steps