Installation

Installation

QZPay is distributed as multiple packages. Install only what you need.

Core Package

The core package is always required:

pnpm

pnpm add @qazuor/qzpay-core

npm

npm install @qazuor/qzpay-core

yarn

yarn add @qazuor/qzpay-core

bun

bun add @qazuor/qzpay-core

Payment Provider

Choose your payment provider:

Stripe

pnpm

pnpm add @qazuor/qzpay-stripe stripe

npm

npm install @qazuor/qzpay-stripe stripe

MercadoPago

pnpm

pnpm add @qazuor/qzpay-mercadopago mercadopago

npm

npm install @qazuor/qzpay-mercadopago mercadopago

Storage Adapter

For persisting billing data:

pnpm

pnpm add @qazuor/qzpay-drizzle drizzle-orm postgres

npm

npm install @qazuor/qzpay-drizzle drizzle-orm postgres

Framework Integrations

Hono

pnpm

pnpm add @qazuor/qzpay-hono hono

npm

npm install @qazuor/qzpay-hono hono

NestJS

pnpm

pnpm add @qazuor/qzpay-nestjs

npm

npm install @qazuor/qzpay-nestjs

React

pnpm

pnpm add @qazuor/qzpay-react

npm

npm install @qazuor/qzpay-react

Typical Setup

For a complete Stripe + Hono setup:

pnpm add @qazuor/qzpay-core @qazuor/qzpay-stripe @qazuor/qzpay-drizzle @qazuor/qzpay-hono stripe drizzle-orm postgres hono

Note

All QZPay packages are ESM-only and require Node.js 22+.

Peer Dependencies

Some packages have peer dependencies you need to install:

Package	Peer Dependencies
@qazuor/qzpay-stripe	stripe
@qazuor/qzpay-mercadopago	mercadopago
@qazuor/qzpay-drizzle	drizzle-orm, postgres
@qazuor/qzpay-hono	hono, zod
@qazuor/qzpay-nestjs	@nestjs/common, @nestjs/core
@qazuor/qzpay-react	react, react-dom

Next Steps

Continue to Quick Start to set up your first billing integration.