Aller au contenu
← Retour aux projets

Zoneless

Zoneless, an open-source payments platform

Zoneless

Your own open-source payments platform.
Accept payments, manage subscriptions, and pay sellers globally in USDC from infrastructure you control. No middlemen and no fees.

Docs · Website · Demo · Discord

CI License: Apache 2.0


Zoneless is an open-source payments stack for stablecoins.

It includes checkout, subscriptions, marketplace accounts, and payouts through a Stripe-compatible API. Use the full platform or add it alongside your current payment setup.

#Features

#Platform dashboard

Manage payments, customers, products, subscriptions, connected accounts, and balances from one place.

Zoneless platform dashboard

#Checkout

Create products and payment links, then let customers pay with USDC through hosted checkout.

Zoneless hosted checkout

#Payments

Manage payments, subscription charges, payouts, refunds, and other balance activity.

Payment activity in the Zoneless dashboard

#Subscriptions

Manage recurring payments, invoices, and subscription status.

Subscriptions in the Zoneless dashboard

#Seller onboarding

Onboard sellers to your marketplace via a hosted flow where they can enter their details and connect a wallet.

Zoneless connected account onboarding

#Identity verification

Set verification rules and review sellers who need an identity check.

Seller identity verification in Zoneless

#Seller dashboard

Give each seller an Express-style dashboard for viewing earnings, payouts, and account details.

Zoneless dashboard for connected accounts

#A familiar API

Zoneless uses familiar resources such as Checkout Sessions, Payment Links, Customers, Products, Subscriptions, Accounts, Transfers, and Payouts. It also follows Stripe's object shapes, webhook patterns, and idempotency model.

If you have worked with Stripe before, the SDK should feel familiar:

import { Zoneless } from '@zoneless/node';
const client = new Zoneless('sk_live_z_YOUR_API_KEY', 'https://api.zoneless.com');

const session = await client.checkout.sessions.create({
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel',
  line_items: [
    {
      price_data: {
        currency: 'usdc',
        unit_amount: 1000,
        product_data: { name: 'My first product' },
      },
      quantity: 1,
    },
  ],
  mode: 'payment',
});

The API covers checkout, subscriptions, and marketplace payouts. See the API reference for the full list of resources and endpoints.

#Running in production

Zoneless was built for PromptBase, an AI marketplace with more than 500,000 users, and runs its seller payout infrastructure in production.

#Quick start

git clone https://github.com/zonelessdev/zoneless.git
cd zoneless
docker compose up -d

Open localhost/setup to create your platform account and API key.

See the self-hosting guide for configuration, credentials, and deployment options.

#Guides and documentation

The full API reference is at docs.zoneless.com. These guides are good places to start:

For a product overview, see marketplace payouts or USDC checkout and subscriptions.

#Local development

npm install
docker compose up -d        # MongoDB
npx nx serve api            # API on :3333
npx nx serve web            # Dashboard on :4203
npx nx serve docs           # Docs on :4205

Or run everything at once:

npm run dev

#Running tests

npx nx test api
npx nx test web
npx nx test docs
npx nx test node-sdk

#Project structure

zoneless/
├── apps/
│   ├── api/              # Express.js API backend
│   ├── web/              # Angular dashboard, checkout and onboarding
│   ├── docs/             # Public product docs and API reference
│   └── cli/              # Cli for humans and agents
├── libs/
│   ├── shared-types/     # Shared TypeScript interfaces
│   └── shared-schemas/   # Shared Zod schemas
├── sdks/
│   └── node/             # @zoneless/node
├── docker-compose.yml    # Full-stack Docker setup
└── nx.json

#Contributing

See CONTRIBUTING.md for development setup, style guidelines, and the pull request process.

#Security

See SECURITY.md to report vulnerabilities.

#License

Apache License 2.0


If Zoneless is useful to you, give the repository a star. It helps more people find the project.

Nouvelle version disponible.