New to OFFER-HUB? Read the Architecture Overview first to understand the self-hosted, per-marketplace, non-custodial design before diving into integration.
Learn how OFFER-HUB works and how to integrate it into your marketplace in minutes.
OFFER-HUB Orchestrator is a self-hosted payments and escrow backend for service marketplaces. It handles the financial plumbing — escrow, balance management, dispute resolution, and USDC transactions on Stellar — so you can focus on building your marketplace product.
New to OFFER-HUB? Read the Architecture Overview first to understand the self-hosted, per-marketplace, non-custodial design before diving into integration.
OFFER-HUB solves the hardest problems in marketplace payments:
| Challenge | Orchestrator Solution |
|---|---|
| Holding buyer funds securely | Non-custodial escrow via Trustless Work smart contracts |
| Preventing double-spending | Atomic balance operations + idempotency keys |
| Handling "seller didn't deliver" | Built-in dispute workflow with SPLIT resolution |
| Managing crypto wallets for non-crypto users | Invisible Stellar wallets (Web2 UX) |
| Tracking payment state | State machine with full audit log |
| Real-time notifications | SSE event stream |
Without the Orchestrator, building all of this could take 6-12 months. With it, you can integrate in a few days.
Before you begin, ensure you have the following installed:
| Requirement | Version | Purpose |
|---|---|---|
| Node.js | 20+ | Runtime environment |
| npm or pnpm | Latest | Package management |
| PostgreSQL | 14+ | Database |
| Redis | 6+ | Caching and queues |
| Git | Latest | Version control |
You'll also need:
For production, you'll need a Stellar mainnet account with USDC trustline and a Trustless Work API key.
Follow the Installation guide to get a running Orchestrator. The fastest path is the one-command setup wizard:
npx create-offer-hub-orchestratorIt configures your .env, runs migrations, and bootstraps the platform user automatically. For a complete walkthrough of every prompt and generated file, see the Scaffolder Guide. A manual Docker-based setup is also available for custom environments.
The setup wizard takes about 2 minutes. You'll have a running API at http://localhost:4000 when you're done.
After installation, you need an API key to make API calls. The fastest way is with the CLI:
npm install -g @offerhub/cli && offerhub keys createYou can also create keys with curl — see the Installation guide for both methods.
Once the Orchestrator is running, explore these guides:
create-offer-hub-orchestrator)Need help? Join our Discord community or open an issue on GitHub.