Introduction to ArcenPay

ArcenPay gives your team a complete Web3 billing and entitlement stack: add subscription plans and pricing from the dashboard, embed checkout and customer portals in your app, gate features by plan entitlement, receive signed webhook events, and settle payments across EVM (BOT Chain, Base, Arc, Sepolia), Stellar, and Solana.

Quickstart

Set up the SDKs in minutes — wrap your app, identify your customer, and render ArcenEmbed.

Core concepts

Understand plans, subscriptions, entitlements, feature flags, sessions, companies, and checkout.

React SDK

Use @arcenpay/react to embed billing, identify customers, and gate features in the browser.

Node.js SDK

Use @arcenpay/node for server-side access checks, webhook verification, and subscription management.

Agent SDK

Empower AI agents with x402 micropayments, agentic checkout, ArcenAuth mandates, and commit-reveal escrow.

15 MCP Tools

Equip Claude Desktop, Cursor, and LLM swarms with autonomous payment and authorization tools.

What’s included

Surface	What it does
Subscription plans	Recurring billing with monthly and annual intervals, activated on-chain.
Embedded billing	`ArcenEmbed` drops checkout, portal, plan management, and unsubscribe flows into your app.
Agentic payment links	Hosted URLs with dual-mode content negotiation (human UI + machine `/spec`) for one-time charges, add-ons, and AI agent checkouts.
ArcenAuth & Mandates	Autonomous Agent Mandates (AAM), monotonic delegation chains, deterministic policy rules, on-chain revocation, and optional x401 identity.
Verify-Then-Settle Escrow	Autonomous commit-reveal escrow locking funds until deliverables match cryptographic commitments, with automated dispute refunds.
Model Context Protocol (MCP)	15 tools for autonomous agent payment and authorization, plus a hosted read-only MCP server for account data.
Entitlements & feature flags	Gate features with React hooks or server-side checks, with usage limits and metered billing.
Multi-chain settlement	Unified billing across BOT Chain, Solana, Base, Stellar, and Arc — production settlement live on BOT Chain Mainnet (`677`) and Solana Mainnet (`9100000`). Arc, Base Sepolia, Stellar Testnet, and Solana Devnet are testnets; Base and Stellar mainnet are not deployed yet.
Webhooks & Invoices	Signed outbound events for every billing lifecycle action, plus automatic PDF invoice generation.

How an integration works

Configure your catalog in the dashboard

Create subscription plans, add-ons, credits, and billing components. Generate your API key and publishable key from Settings → API Keys.

Add the React SDK to your frontend

Wrap your app with ArcenPayProvider, identify the logged-in customer, and render ArcenEmbed.

Add the Node.js SDK to your backend

Use ArcenClient to check entitlements, activate subscriptions, manage companies, and verify webhooks.

Equip AI agents with @arcenpay/agent

Use ArcenAgent or connect ArcenPay MCP tools to Claude Desktop/Cursor for autonomous micropayments, payment link checkouts, and escrowed data purchases.

Install the SDKs

npm install @arcenpay/react
npm install @arcenpay/node

# For autonomous agent workflows and MCP tools
npm install @arcenpay/agent

Get started

Core concepts

Guides

Integrations

Introduction to ArcenPay

Quickstart

Core concepts

React SDK

Node.js SDK

Agent SDK

15 MCP Tools

What’s included

How an integration works

Install the SDKs

Quickstart

Core concepts

React SDK

Node.js SDK

Agent SDK

15 MCP Tools

​What’s included

​How an integration works

​Install the SDKs

What’s included

How an integration works

Install the SDKs