💰 Payless

Accept Crypto Payments Without Accounts

The simplest way to monetize your APIs using the x402 protocol on Solana. Zero fees, instant settlements, one line of code.

Contract Address (CA): FDgSegoxrdpsct21YVeAbC9dWeTwTxA8Cceeh8BPpump

🎯 What is Payless?

Payless is a serverless payment platform built on the x402 protocol. It lets developers monetize any API with crypto payments in minutes—no accounts, no subscriptions, no complexity.

🌐 Multi-Chain Support: Solana, BSC (Binance Smart Chain), Ethereum, with Polygon coming soon!

Perfect for:

🤖 AI Agent APIs - Let agents pay for your services autonomously
💰 Micropayments - Accept payments as low as $0.01
⚡ Instant Settlement - Money in your wallet in 2 seconds
🚀 Serverless APIs - Deploy anywhere (Vercel, AWS, Netlify)
🌐 Multi-Chain - Users choose their preferred blockchain

🌟 Features

💰 Zero Protocol Fees - Keep 100% of your revenue
⚡ Instant Settlement - Money in your wallet in 2 seconds
🔐 Privacy First - No accounts, emails, or OAuth required
🌐 Multi-Chain Support - Solana + BSC + Ethereum (Polygon coming soon!)
🚀 Serverless Ready - Deploy to Vercel, Netlify, or AWS Lambda
🤖 Perfect for AI Agents - Autonomous payments without human intervention
📊 Built-in Analytics - Track payments, revenue, and API usage
🔔 Webhook Support - Real-time payment notifications

🚀 Quick Start

Prerequisites

Node.js 18+ installed
Wallet addresses for supported chains:
- Solana: Phantom, Solflare, etc.
- BSC: MetaMask, Trust Wallet, Binance Wallet
- Ethereum: MetaMask, Coinbase Wallet, etc.
(Optional) x402 facilitator endpoint

Installation

Clone the repository

git clone https://github.com/Payless2025/PayLess.git
cd payless

Install dependencies

npm install

Configure environment variables

cp .env.example .env

Edit .env and add your Solana wallet address:

# Solana wallet address (base58 format)
WALLET_ADDRESS=YourSolanaWalletAddressHere1111111111111111
FACILITATOR_URL=https://facilitator.x402.org
NETWORK=mainnet-beta
RPC_URL=https://api.mainnet-beta.solana.com
USDC_MINT=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# Enable demo payments (set to 'true' for playground/testing)
ENABLE_DEMO_PAYMENTS=true

Run development server

npm run dev

Open your browser

http://localhost:3000

📖 Usage

Adding Payment to Your API Endpoint

It's as simple as wrapping your handler with withX402Payment:

import { NextRequest, NextResponse } from 'next/server';
import { withX402Payment } from '@/lib/x402/middleware';

async function handler(req: NextRequest) {
  // Your API logic here
  const result = await yourBusinessLogic(req);
  return NextResponse.json({ result });
}

// Add payment requirement - that's it!
export const POST = withX402Payment(handler, "0.01");

Configure Endpoint Pricing

Edit lib/x402/config.ts:

export const ENDPOINT_PRICING: EndpointConfig = {
  '/api/ai/chat': '0.05',        // $0.05 per request
  '/api/ai/image': '0.10',       // $0.10 per request
  '/api/data/weather': '0.01',   // $0.01 per request
  '/api/your-endpoint': '0.25',  // Add your custom pricing
};

Making Payment Requests (Client-Side)

import { makePaymentRequest } from '@/lib/x402/client';

// The SDK handles payment automatically
const response = await makePaymentRequest(
  '/api/ai/chat',
  {
    method: 'POST',
    body: JSON.stringify({ message: 'Hello!' })
  },
  walletAddress,      // Your wallet
  recipientAddress,   // Merchant wallet
  '0.05'             // Payment amount
);

const data = await response.json();
console.log(data);

🏗️ Project Structure

payless/
├── app/
│   ├── api/                  # API endpoints with x402 payment
│   │   ├── ai/
│   │   │   ├── chat/        # AI chat endpoint ($0.05)
│   │   │   └── image/       # AI image generation ($0.10)
│   │   ├── data/
│   │   │   ├── weather/     # Weather data ($0.01)
│   │   │   └── stock/       # Stock data ($0.02)
│   │   ├── premium/
│   │   │   └── content/     # Premium content ($1.00)
│   │   ├── health/          # Health check (free)
│   │   └── info/            # API info (free)
│   ├── playground/          # Interactive API playground
│   ├── globals.css          # Global styles
│   ├── layout.tsx           # Root layout
│   └── page.tsx             # Landing page
├── components/              # React components
│   ├── Hero.tsx            # Hero section
│   ├── Features.tsx        # Features grid
│   ├── CodeExample.tsx     # Code examples
│   ├── UseCases.tsx        # Use case cards
│   └── Footer.tsx          # Footer
├── lib/
│   └── x402/               # x402 protocol implementation
│       ├── types.ts        # TypeScript types
│       ├── config.ts       # Configuration
│       ├── middleware.ts   # Payment middleware
│       └── client.ts       # Client utilities
├── package.json
├── tsconfig.json
├── tailwind.config.js
└── next.config.js

🔧 API Endpoints

Free Endpoints

Endpoint	Method	Description
`/api/health`	GET	Health check
`/api/info`	GET	API information and pricing

Paid Endpoints

Endpoint	Method	Price	Description
`/api/ai/chat`	POST	$0.05	AI chat completion
`/api/ai/image`	POST	$0.10	AI image generation
`/api/data/weather`	GET	$0.01	Weather data
`/api/data/stock`	GET	$0.02	Stock market data
`/api/premium/content`	GET	$1.00	Premium content access

🎮 Try the Playground

Visit /playground to test all endpoints interactively:

npm run dev
# Open http://localhost:3000/playground

The playground allows you to:

Test all API endpoints
See payment flow in action (demo mode)
Inspect request/response payloads
Understand x402 protocol behavior

🚢 Deployment

Deploy to Vercel (Recommended)

Push to GitHub

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourusername/payless.git
git push -u origin main

Deploy to Vercel

npm install -g vercel
vercel

Set environment variables in Vercel Dashboard
- WALLET_ADDRESS - Your Solana wallet address
- FACILITATOR_URL - Facilitator endpoint
- NETWORK - Solana network (mainnet-beta, devnet)
- RPC_URL - Solana RPC endpoint
- USDC_MINT - USDC SPL token mint address

Deploy to Netlify

npm install -g netlify-cli
netlify deploy --prod

Deploy to AWS Lambda

Use Serverless Framework or AWS SAM.

🔐 Security Considerations

Production Checklist

Enable real facilitator verification (not demo mode)
Set up proper RPC endpoints for your network
Implement rate limiting
Add request validation
Set up monitoring and logging
Use HTTPS only
Implement webhook verification for payment confirmations
Add CORS restrictions
Enable API key authentication for sensitive endpoints (optional)

Environment Variables

Never commit these to version control:

WALLET_ADDRESS - Keep private
RPC_URL - Use secure providers
Private keys should NEVER be in your code

📚 Learn More

Documentation

Ethereum Support - How to accept Ethereum payments
Webhooks - Real-time payment notifications
Multi-Chain Guide - Complete multi-chain integration
API Configuration - Configure your API

x402 Protocol

Next.js

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Support

GitHub Issues: Report a bug
Documentation: Read the docs
Community: Join Discord

🙏 Acknowledgments

Built with x402 Protocol
Powered by Next.js
Styled with Tailwind CSS
Icons by Lucide

💪 Why Developers Choose Payless

Feature	What You Get
⚡ Lightning Setup	One line of code, < 5 minutes to production
💯 Keep 100%	Zero protocol fees. Every dollar is yours
🚀 True Serverless	Deploy anywhere - Vercel, AWS, Netlify
🔓 Fully Open Source	MIT license. Fork, modify, own it
🎯 Any Use Case	Monetize any API or service, no restrictions
🛝 Built-in Playground	Test all endpoints without writing code
🔐 Privacy First	No accounts, emails, or OAuth required
🤖 AI Agent Ready	Perfect for autonomous payments
💵 True Micropayments	Accept payments as low as $0.01 USDC
⚡ Instant Settlement	Money in your wallet in 2 seconds

The simplest, most developer-friendly way to monetize APIs with crypto. Zero fees, zero complexity, zero compromises.

Built with ❤️ by the Payless Team

🌟 GitHub | 🐦 X/Twitter | 📚 Documentation

⭐ Star this repo if you find it useful!

Name		Name	Last commit message	Last commit date
Latest commit History 48 Commits
app		app
components		components
docs		docs
lib		lib
public/assets		public/assets
sdk		sdk
.cursorrules		.cursorrules
.env.example		.env.example
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
PROJECT_STRUCTURE.md		PROJECT_STRUCTURE.md
README.md		README.md
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json
vercel.json		vercel.json

License

Payless2025/PayLess

Folders and files

Latest commit

History

Repository files navigation