Quickstart - Cheapay

Get started in three steps

Transform your API into a revenue stream with Solana micropayments in minutes.

Step 1: Install CheapPay

Choose your package manager

Available packages

Step 2: Set up payment middleware

Express.js setup

Add payment protection to your Express API in seconds:

import express from 'express';
import { solanaPaymentMiddleware } from '@cheapay/x402-express';
import { TokenMint } from '@cheapay/x402';

const app = express();

// Protect your premium endpoint with $0.01 USDC payment
app.use('/api/premium', solanaPaymentMiddleware({
  payTo: 'YourSolanaWalletAddressHere',
  routes: {
    '/*': {
      price: '$0.01',
      network: 'solana-devnet', // Use devnet for testing
      mint: TokenMint.USDC.devnet,
      description: 'Premium API access'
    }
  }
}));

// Your protected endpoint
app.get('/api/premium/data', (req, res) => {
  res.json({
    message: 'Premium content unlocked!',
    data: 'This cost $0.01 USDC to access'
  });
});

app.listen(3000, () => {
  console.log('💰 Payment-enabled API running on port 3000');
});

Next.js setup

For Next.js projects, create a middleware.ts file:

import { solanaPaymentMiddleware } from '@cheapay/x402-next';
import { TokenMint } from '@cheapay/x402';

export const middleware = solanaPaymentMiddleware(
  'YourSolanaWalletAddressHere',
  {
    '/api/premium/*': {
      price: '$0.01',
      network: 'solana-devnet',
      mint: TokenMint.USDC.devnet,
      description: 'Premium API access'
    }
  }
);

export const config = {
  matcher: ['/api/premium/:path*']
};

Your Next.js API routes are now payment-protected automatically!

Step 3: Test your integration

Start earning from API calls

Next steps

Now that you have payments working, explore these advanced features:

Configure wallets

Customize wallet options and user experience.

Custom pricing

Set up dynamic pricing and multiple payment tiers.

Analytics dashboard

Track earnings and monitor API usage.

Production deployment

Deploy your payment-enabled API to production.

Environment setup

For production use, set up these environment variables:

# Your Solana wallet address (receives payments)
CHEAPAY_WALLET_ADDRESS=YourSolanaWalletAddressHere

# Network configuration
SOLANA_NETWORK=solana-mainnet  # or solana-devnet for testing

# Optional: Custom facilitator URL
FACILITATOR_URL=https://api.cheappay.com/v1/x402

Security reminder: Never expose private keys in your code. CheapPay only needs your public wallet address to receive payments.

Need help?

Telegram Community

Get help from our community and team.

View examples

Browse working code examples and demos.

API Reference

Detailed documentation for all features.

GitHub Issues

Report bugs or request features.

Getting started

​Get started in three steps

​Step 1: Install CheapPay

​Step 2: Set up payment middleware

​Step 3: Test your integration

​Next steps

Configure wallets

Custom pricing

Analytics dashboard

Production deployment

​Environment setup

​Need help?

Telegram Community

View examples

API Reference

GitHub Issues

Get started in three steps

Step 1: Install CheapPay

Step 2: Set up payment middleware

Step 3: Test your integration

Next steps

Environment setup

Need help?