Stripe integration

Accept credit card payments for monthly subscriptions and one-time credit purchases. All plans are billed monthly — yearly billing is not available.

Accepted payment methods

Stripe checkout accepts the following payment methods:

Visa / Mastercard (credit and debit)
Apple Pay
Google Pay
PayPal

Crypto payments are not accepted through Stripe checkout. For USDC payments on Base, see the x402 integration. For per-request crypto payments via the Tempo blockchain, see MPP payments.

Setup

Step 1: Create Stripe account

Go to Stripe.com
Create a business account
Complete verification

Step 2: Get API keys

Go to Developers → API Keys
Copy:
- Publishable Key (starts with pk_)
- Secret Key (starts with sk_)

Step 3: Connect to Agentbot

Go to Settings → Payments → Stripe
Enter keys
Click Connect

Step 4: Configure webhooks

Two webhook endpoints handle Stripe events:

Subscription webhook — handles subscription lifecycle events
Wallet top-up webhook — handles wallet top-up payments

Subscription webhook

Go to Developers → Webhooks
Add endpoint: https://agentbot.raveculture.xyz/api/stripe/webhook
Select events:
- checkout.session.completed
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.deleted
- invoice.payment_succeeded
- invoice.payment_failed
Copy webhook secret and add to Agentbot

Wallet top-up webhook

Add a second endpoint: https://agentbot.raveculture.xyz/api/wallet/top-up
Select events:
- checkout.session.completed
Copy webhook secret and add to Agentbot as STRIPE_WEBHOOK_SECRET

The wallet top-up webhook only processes checkout.session.completed events where the session metadata type field is set to wallet_top_up. All other checkout events are ignored by this endpoint.

Pricing plans

All plans are billed monthly in GBP. A paid subscription is required to provision and use agents — there is no free tier.

Attempting to provision an agent without an active paid subscription returns 402 Payment Required. All users must subscribe to a plan before creating agents.

Plan	Price	Specs	Key features
Solo	£29/mo	1 Agent · Mistral 7B	Telegram, BYOK, A2A Bus Access, Basic Analytics
Collective	£69/mo	3 Agents · Llama 3.3	Everything in Solo + Royalty Split Engine, Mission Control Graph, WhatsApp, Priority support
Label	£149/mo	Unlimited · DeepSeek R1	Everything in Collective + Priority A2A Routing, 24/7 Signal Guard, White-glove staging, Custom integrations, Dedicated account manager
Network	£499/mo	Unlimited	Everything in Label + white-label reselling, 16GB RAM

The billing page displays the Solo, Collective, and Label plans as upgrade options. The Network plan is available by contacting sales.

Enterprise add-ons

Individual add-ons can be purchased on top of any subscription plan. All add-on prices are billed monthly in GBP. To purchase an add-on, contact sales at sales@agentbot.com.

Add-on	Price	Description
Audit Logs	£199/mo	Full traceability of every agent action and decision
Slack Integration	£149/mo	Agents work inside your Slack workspace
Salesforce Connector	£349/mo	Sync leads, contacts, and opportunities automatically
API Access	£249/mo	Programmatic access to your agents via REST API
Custom Integration	£499/mo	Custom connector built for your tools
Dedicated Account Manager	£399/mo	Priority support and personalized onboarding

Add-ons are not available for self-service purchase through Stripe checkout. Use the Contact Sales button on the billing page or email sales@agentbot.com to add any of these to your subscription.

Full Enterprise Suite

The Full Enterprise Suite bundles all add-ons and additional enterprise capabilities at a single price of £4,999/mo. It includes:

Unlimited AI Agents with hierarchical task delegation
Enterprise SSO/SAML and role-based access control (RBAC)
Credential isolation and zero-trust security
Full audit logging and compliance tooling
Pre-built connectors for Salesforce, Cisco, Google Cloud, Adobe, and CrowdStrike
Tool use framework for external APIs
Hardware agnostic deployment (NVIDIA, AMD, Intel support)
24/7 priority support with SLA guarantee
Mission Control dashboard and analytics

To purchase the Full Enterprise Suite, contact sales or use the billing page in the dashboard.

Payment methods

The billing page supports two payment methods:

Stripe — pay with card for instant activation
Tempo Wallet — pay with USDC for on-chain settlement

Card payments go through the Stripe checkout flow described below. For USDC payments, see the Wallet API reference and MPP payments.

Checkout

Start a checkout session

To start a subscription checkout, redirect the user to the checkout endpoint with a plan query parameter:

GET /api/stripe/checkout?plan={plan_id}

Parameters

Parameter	Type	Required	Description
`plan`	string	Yes	One of `solo`, `collective`, `label`, or `network`

The plan parameter uses internal plan IDs. The billing page maps these to display names: solo is shown as “Solo”, collective as “Collective”, and label as “Label”.

The endpoint redirects the user to Stripe’s hosted checkout page. On success, the user is redirected to the onboarding page. On cancellation, the user returns to the pricing page.

Admin users (configured via ADMIN_EMAILS) skip the Stripe checkout flow entirely and are redirected straight to onboarding. No payment is required for admin accounts.

The onboarding flow enforces payment before agent deployment. If the user has not completed payment, the deploy button is replaced with a checkout redirect. Attempting to deploy without a confirmed payment redirects the user to GET /api/stripe/checkout?plan={plan} to complete checkout first.

Example

# Redirect user to checkout
window.location.href = '/api/stripe/checkout?plan=collective'

The legacy POST /api/checkout endpoint is deprecated and returns a 410 Gone status. Use GET /api/stripe/checkout instead.

Buy credits

To purchase additional credits, redirect the user to the credits checkout endpoint:

GET /api/stripe/credits?price={stripe_price_id}

Parameters

Parameter	Type	Required	Description
`price`	string	Yes	A valid Stripe price ID from the allowed credit price list

The endpoint redirects the user to a Stripe checkout page for the selected credit pack. On success, credits are added to the account automatically. Example

# Redirect user to credit purchase
window.location.href = '/api/stripe/credits?price=price_xxx'

Billing API

Manage billing, subscriptions, and usage programmatically. All billing endpoints require authentication with a valid JWT token.

curl -X GET https://agentbot.raveculture.xyz/api/billing \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Get billing info

Retrieve your current plan, subscription status, and usage.

GET /api/billing

Response

{
  "plans": {
    "starter": {
      "name": "Starter",
      "price": 19,
      "dailyUnits": 600,
      "features": ["1 AI Agent", "2GB RAM", "Telegram", "Basic skills"]
    },
    "pro": {
      "name": "Pro",
      "price": 39,
      "dailyUnits": 1000,
      "features": ["1 AI Agent", "4GB RAM", "All channels", "All skills", "Priority support"]
    },
    "scale": {
      "name": "Scale",
      "price": 79,
      "dailyUnits": 2500,
      "features": ["3 AI Agents", "8GB RAM", "All channels", "All skills", "Analytics"]
    }
  },
  "currentPlan": "starter",
  "subscriptionStatus": "active",
  "byokEnabled": false,
  "usage": {
    "dailyUnits": 600,
    "used": 245,
    "remaining": 355
  }
}

The billing API returns plan tiers as starter, pro, and scale with USD pricing. These correspond to the subscription plans available through the billing dashboard. The Stripe checkout endpoint uses a separate set of plan identifiers (solo, collective, label, network) for direct checkout flows.

Billing actions

Use POST /api/billing with an action field to manage your subscription.

Action	Description
`create-checkout`	Create a Stripe checkout session for a plan
`enable-byok`	Enable Bring Your Own Key mode for AI usage
`disable-byok`	Disable BYOK and return to platform credits
`get-usage`	Get current daily usage stats
`buy-credits`	Purchase a credit pack

Create checkout

Start a new Stripe checkout session for a subscription plan. The billing API accepts starter, pro, or scale as plan values.

{
  "action": "create-checkout",
  "plan": "starter"
}

Response

{
  "url": "https://checkout.stripe.com/..."
}

Redirect the user to the returned url to complete payment.

Enable BYOK

Enable Bring Your Own Key mode so AI requests use your own API keys instead of platform credits.

{
  "action": "enable-byok",
  "apiKey": "your-provider-api-key",
  "provider": "openrouter"
}

Field	Type	Required	Description
`action`	string	Yes	Must be `enable-byok`
`apiKey`	string	Yes	Your API key for the AI provider
`provider`	string	Yes	AI provider name (for example `openrouter`, `anthropic`, `openai`)

Response

{
  "success": true,
  "message": "BYOK enabled with openrouter. You'll pay openrouter directly for AI usage."
}

Disable BYOK

Switch back to platform credits for AI usage.

{
  "action": "disable-byok"
}

Response

{
  "success": true,
  "message": "BYOK disabled. Using platform credits."
}

Get usage

Retrieve your current daily usage statistics.

{
  "action": "get-usage"
}

Response

{
  "dailyUnits": 600,
  "used": 245,
  "remaining": 355
}

Buy credits

Purchase a credit pack to top up your account balance. Pass one of the available pack sizes.

{
  "action": "buy-credits",
  "pack": "200"
}

Field	Type	Required	Description
`action`	string	Yes	Must be `buy-credits`
`pack`	string	Yes	Credit pack size: `50`, `200`, or `500`

Response

{
  "success": true,
  "credits": 15,
  "price": "$15"
}

Pack size	Credits	Price
`50`	5	$5
`200`	15	$15
`500`	30	$30

Storage upgrade

Upgrade to the Pro plan with 50GB storage via a dedicated checkout endpoint.

POST /api/stripe/storage-upgrade

This endpoint requires authentication. No request body is needed — the upgrade is a fixed Pro plan at £39/mo with 50GB storage, WhatsApp support, and a custom domain. Response

{
  "url": "https://checkout.stripe.com/..."
}

Redirect the user to the returned url to complete the upgrade. On success, the user is redirected to the files dashboard. On cancellation, the user returns to the files dashboard with an error parameter.

Status	Description
200	Checkout URL returned
401	Unauthorized (authentication required)
500	Stripe not configured or checkout creation failed

Webhook events

Handle subscription events:

// /api/stripe/webhook
export async function POST(request) {
  const sig = request.headers.get('stripe-signature');
  const body = await request.text();
  
  let event;
  try {
    event = stripe.webhooks.constructEvent(body, sig, webhookSecret);
  } catch (err) {
    return new Response(`Webhook Error: ${err.message}`, { status: 401 });
  }
  
  switch (event.type) {
    case 'checkout.session.completed':
      // Grant access
      await grantAccess(event.data.object.customer_email);
      break;
    case 'customer.subscription.deleted':
      // Revoke access
      await revokeAccess(event.data.object.customer_email);
      break;
  }
  
  return new Response('OK');
}

Plan mapping

When processing checkout.session.completed events, the webhook maps the plan value from the session metadata to a subscription tier. The following plans are recognized:

Metadata value	Mapped plan
`underground`	`underground`
`solo`	`solo`
`collective`	`collective`
`label`	`label`
`network`	`network`

Any unrecognized plan value falls back to free. This means the user’s subscription is not activated for agent provisioning — they must complete checkout with a valid plan name.

If your Stripe product metadata uses a plan name that is not in the table above, the subscription will be recorded as free and the user will not be able to provision agents. Make sure your Stripe product metadata plan field matches one of the recognized values exactly.

Wallet top-up

In addition to subscriptions and credit packs, you can use Stripe to add funds directly to your wallet for agent calls. The wallet top-up flow uses a dedicated endpoint that creates a one-time Stripe checkout session.

Available amounts

Amount	Description
$5	5 agent calls
$10	10 agent calls
$25	25 agent calls
$50	50 agent calls

Start a wallet top-up

Redirect the user to the wallet top-up endpoint with amount and address query parameters:

GET /api/wallet/top-up?amount=1000&address=0x...

Parameters

Parameter	Type	Required	Description
`amount`	number	No	Amount in cents: `500`, `1000`, `2500`, or `5000`. Defaults to `1000`.
`address`	string	Yes	Wallet address to credit (0x-prefixed, 42 characters).

The endpoint returns a JSON response with the Stripe checkout URL and session ID. Redirect the user to the url to complete payment. No session authentication is required — the wallet address identifies the recipient. Example

# Redirect user to wallet top-up ($25)
window.location.href = '/api/wallet/top-up?amount=2500&address=0xd8fd...db56f'

On success, the user is redirected to /dashboard/wallet?top_up=success. On cancellation, the user is redirected to /dashboard/wallet?top_up=cancelled.

Wallet top-up payments are processed as one-time charges, not recurring subscriptions. The amount is credited to the user’s wallet after successful payment via the webhook at POST /api/wallet/top-up. See the Wallet API reference for full endpoint details.

Direct transfer

You can also fund your wallet by sending USDC directly to your wallet address on the Tempo network. Copy your wallet address from the wallet dashboard and transfer funds from any compatible wallet. No Stripe checkout is needed for direct transfers.

Troubleshooting

Payments not working

Verify API keys are correct
Check webhook is configured
Ensure products/prices are created in Stripe

Webhook errors

Verify webhook secret
Check webhook URL is accessible
Review Stripe logs in developer dashboard

410 error on /api/checkout

The legacy /api/checkout endpoint has been deprecated. Use GET /api/stripe/checkout?plan={plan_id} instead.

Getting Started

Core Concepts

Integrations

Core Services

Payments

API Reference

MCP

Security

​Stripe integration

​Accepted payment methods

​Setup

​Step 1: Create Stripe account

​Step 2: Get API keys

​Step 3: Connect to Agentbot

​Step 4: Configure webhooks

​Subscription webhook

​Wallet top-up webhook

​Pricing plans

​Enterprise add-ons

​Full Enterprise Suite

​Payment methods

​Checkout

​Start a checkout session

​Buy credits

​Billing API

​Get billing info

​Billing actions

​Create checkout

​Enable BYOK

​Disable BYOK

​Get usage

​Buy credits

​Storage upgrade

​Webhook events

​Plan mapping

​Wallet top-up

​Available amounts

​Start a wallet top-up

​Direct transfer

​Troubleshooting

Stripe integration

Accepted payment methods

Setup

Step 1: Create Stripe account

Step 2: Get API keys

Step 3: Connect to Agentbot

Step 4: Configure webhooks

Subscription webhook

Wallet top-up webhook

Pricing plans

Enterprise add-ons

Full Enterprise Suite

Payment methods

Checkout

Start a checkout session

Buy credits

Billing API

Get billing info

Billing actions

Create checkout

Enable BYOK

Disable BYOK

Get usage

Buy credits

Storage upgrade

Webhook events

Plan mapping

Wallet top-up

Available amounts

Start a wallet top-up

Direct transfer

Troubleshooting