Billing API Key

Chargebee REST API

Subscription billing and revenue management API

Chargebee is a subscription billing and revenue management platform that automates recurring billing, invoicing, and subscription lifecycle management. Developers use it to build flexible subscription models, handle complex pricing scenarios, manage customer billing, process payments across multiple gateways, and generate revenue analytics for SaaS and subscription-based businesses.

Base URL https://{site}.chargebee.com/api/v2

API Endpoints

Method	Endpoint	Description
POST	`/customers`	Create a new customer with billing details and contact information
GET	`/customers/{customer_id}`	Retrieve detailed information about a specific customer
POST	`/subscriptions`	Create a new subscription for a customer with plan and billing cycle
GET	`/subscriptions/{subscription_id}`	Retrieve subscription details including status, billing period, and items
POST	`/subscriptions/{subscription_id}/cancel`	Cancel a subscription immediately or at end of billing period
POST	`/invoices/{invoice_id}/collect_payment`	Attempt to collect payment for an invoice using stored payment method
GET	`/invoices`	List all invoices with optional filters for customer, status, and date range
POST	`/payment_sources`	Add a payment source (card, bank account) to a customer
GET	`/plans`	Retrieve all subscription plans with pricing and billing frequency
POST	`/subscriptions/{subscription_id}/change_term_end`	Modify the subscription term end date for billing adjustments
GET	`/credit_notes`	List credit notes issued for refunds, adjustments, or account credits
POST	`/hosted_pages/checkout_new`	Generate a hosted checkout page for customer subscription signup
GET	`/events`	Retrieve webhook events for subscription and billing changes
POST	`/unbilled_charges`	Add one-time or usage-based charges to a customer's upcoming invoice
GET	`/transactions`	List payment transactions with gateway responses and settlement status

Code Examples

curl https://yoursite.chargebee.com/api/v2/customers \
  -u your_api_key: \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "billing_address": {
      "line1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "country": "US"
    }
  }'

const response = await fetch('https://yoursite.chargebee.com/api/v2/customers', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic ' + btoa('your_api_key:'),
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    first_name: 'John',
    last_name: 'Doe',
    email: 'john.doe@example.com',
    billing_address: {
      line1: '123 Main St',
      city: 'San Francisco',
      state: 'CA',
      zip: '94105',
      country: 'US'
    }
  })
});
const data = await response.json();
console.log(data.customer);

import requests
from requests.auth import HTTPBasicAuth

response = requests.post(
    'https://yoursite.chargebee.com/api/v2/customers',
    auth=HTTPBasicAuth('your_api_key', ''),
    json={
        'first_name': 'John',
        'last_name': 'Doe',
        'email': 'john.doe@example.com',
        'billing_address': {
            'line1': '123 Main St',
            'city': 'San Francisco',
            'state': 'CA',
            'zip': '94105',
            'country': 'US'
        }
    }
)
data = response.json()
print(data['customer'])

Use Chargebee from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for Chargebee. Paste your Chargebee API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls Chargebee directly with your credentials — no local install, works on mobile.

create_subscription Create and manage customer subscriptions with plans, pricing, and billing cycles automatically

manage_billing Handle invoicing, payment collection, refunds, and credit note generation for customers

track_revenue Retrieve revenue metrics, MRR, ARR, churn data, and subscription analytics for reporting

handle_dunning Manage failed payment retries, customer notifications, and subscription suspension workflows

sync_customer_data Synchronize customer information, payment methods, and subscription status across systems

Connect in 60 seconds

Paste your Chargebee key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect Chargebee to your AI →

Chargebee REST API

API Endpoints

Sponsor this page

Code Examples

Use Chargebee from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs