Installation - SolvaPay Documentation

Recommended: use CLI setup — npx solvapay init for existing projects, or npm create solvapay -- --type mcp | next-auth0 to scaffold a new one.
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 Edge Functions

For Deno-based Supabase Edge Functions, no npm install is needed. Use an import map in supabase/functions/deno.json instead. See the Supabase Edge Functions guide for setup.

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

CLI setup

Quick start

⌘I

​Prerequisites

​Install packages by use case

​Server-side protection

​React checkout components

​Next.js integration

​Auth adapters

​Supabase Edge Functions

​Supabase adapter for React

​Core types only

​Environment variables

​Stub mode

​Next steps