For Agents
Manage subscriptions, customers, products, invoices, components, and payment profiles for usage-based and B2B SaaS billing. Useful for finance ops, billing automation, and revenue management agents.
Get started with Chargify API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create a chargify subscription"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Chargify API API.
Manage the subscription lifecycle through the /subscriptions.json endpoints, including create, update, retrieve, and cancel operations
Maintain customer records with /customers.json (list, create, retrieve, update, delete) and tie them to subscriptions
Define products and product families via /products.json so subscriptions can reference a priced offering
Pull invoice history with /invoices.json and retrieve a single invoice by ID for finance reporting
GET STARTED
Use for: Create a new subscription for an existing customer, List all active subscriptions on the account, Get a specific customer record by ID, Add a one-off charge to an active subscription
Not supported: Does not handle card processing on the network rails, fraud scoring, or chargeback representment — use for subscription, component, customer, and invoice billing logic only.
Chargify (now branded as Maxio Advanced Billing) is a subscription billing and revenue management platform aimed at B2B SaaS companies with complex pricing models. The API exposes subscriptions, customers, products, invoices, components (metered usage and on-off entitlements), one-off charges, and payment profiles. Resources are subdomain-scoped per merchant and use Chargify's longstanding .json suffix path style. It is a strong fit for usage-based billing, hybrid pricing, and SaaS workflows that need component-level granularity.
Read and report metered usage components per subscription via /subscriptions/{subscription_id}/components.json
Apply one-off charges to a subscription with POST /subscriptions/{subscription_id}/charges.json
Manage stored payment methods through /payment_profiles.json including create, retrieve, and delete
Patterns agents use Chargify API API for, with concrete tasks.
★ Usage-Based SaaS Billing
B2B SaaS companies with metered or hybrid pricing use Chargify components to bill on units consumed (API calls, seats, GB processed). The /subscriptions/{subscription_id}/components.json endpoint exposes per-subscription usage and component allocations, letting finance teams report and reconcile usage against the underlying subscription term.
GET /subscriptions/{subscription_id}/components.json for each active subscription and report the current usage totals
Subscription Lifecycle Management
Finance and customer success teams manage subscriptions over their full life: POST /subscriptions.json to start, PUT /subscriptions/{subscription_id}.json to change plan or seat count, DELETE /subscriptions/{subscription_id}.json to cancel. Chargify handles proration and invoicing so the integrator does not have to compute partial-period adjustments manually.
PUT /subscriptions/{subscription_id}.json to change the plan and let Chargify generate the proration invoice
One-Off Charges and Account Adjustments
Sales and support teams add one-off line items — onboarding fees, professional services, overage true-ups — to a subscription via POST /subscriptions/{subscription_id}/charges.json. The charge appears on the subscription's next invoice (or immediately, depending on settings) and is included in revenue reporting alongside recurring components.
POST /subscriptions/{subscription_id}/charges.json with an amount of 250.00 USD for a customer onboarding fee
Payment Profile Hygiene
When a customer rotates cards or asks for their payment data to be removed, finance ops uses /payment_profiles.json to manage stored payment methods. POST creates a new profile, GET inspects the current state, and DELETE /payment_profiles/{payment_profile_id}.json removes the record cleanly so future charges fall back to a different method or fail predictably.
DELETE /payment_profiles/{payment_profile_id}.json when a customer requests their card on file be removed
Agent-Driven Billing via Jentic
An AI agent given an instruction like 'add a $500 services charge to subscription 12345' can resolve the workflow through Jentic. It searches for the one-off charge operation, loads the schema for POST /subscriptions/{subscription_id}/charges.json, and submits the charge — without ever holding the merchant's Chargify credential directly.
Search Jentic for 'add a one-off charge to a subscription' and POST the charge with the agreed amount and description
20 endpoints — chargify (now branded as maxio advanced billing) is a subscription billing and revenue management platform aimed at b2b saas companies with complex pricing models.
METHOD
PATH
DESCRIPTION
/subscriptions.json
Create a subscription
/subscriptions/{subscription_id}.json
Update a subscription
/subscriptions/{subscription_id}.json
Cancel a subscription
/subscriptions/{subscription_id}/charges.json
Add a one-off charge
/subscriptions/{subscription_id}/components.json
List components and usage for a subscription
/customers.json
Create a customer
/invoices.json
List invoices
/payment_profiles.json
Create a stored payment profile
/subscriptions.json
Create a subscription
/subscriptions/{subscription_id}.json
Update a subscription
/subscriptions/{subscription_id}.json
Cancel a subscription
/subscriptions/{subscription_id}/charges.json
Add a one-off charge
/subscriptions/{subscription_id}/components.json
List components and usage for a subscription
Three things that make agents converge on Jentic-routed access.
Credential isolation
Chargify uses HTTP Basic with the API key as the username. Jentic stores the credential encrypted in the MAXsystem vault, isolating it from the agent context, and injects it only at execution time.
Intent-based discovery
Agents query Jentic with intents like 'create a subscription' or 'add a one-off charge', and Jentic returns the matching Chargify operation with the subscription, customer, and product schema resolved.
Time to first call
Direct Chargify integration: 3-5 days to model subscriptions, customers, components, and payment profiles. Through Jentic: under an hour — search, load, execute against the right resource ID.
Alternatives and complements available in the Jentic catalogue.
Recurly API
Recurly is a comparable SaaS subscription billing platform with broader native payment processor coverage; Chargify focuses on usage-based and B2B billing.
Choose Recurly when payment-processor breadth matters most; choose Chargify when component-level usage billing is central.
Zuora API
Zuora is enterprise subscription billing with deep revenue recognition; Chargify is mid-market with a faster integration path.
Pick Zuora for enterprise revenue ops; pick Chargify for mid-market SaaS with usage components.
Stripe API
Stripe processes the underlying card payments while Chargify orchestrates subscriptions, components, and invoices on top.
Pair Stripe and Chargify when Chargify owns subscription state and Stripe handles the payment capture rail.
Specific to using Chargify API API through Jentic.
What authentication does the Chargify API use?
Chargify uses HTTP Basic authentication: pass your API key as the username and the literal string 'x' as the password. Through Jentic, the API key is held in the MAXsystem vault and only injected server-side at execution time.
Can I add a one-off charge to an existing subscription with the Chargify API?
Yes. POST /subscriptions/{subscription_id}/charges.json with an amount and memo. Chargify adds the line item to the subscription's next invoice or processes it immediately depending on the merchant's settings.
How do I track metered usage for a subscription?
GET /subscriptions/{subscription_id}/components.json returns the components configured on the subscription with their current usage values. Chargify uses these counts at the next renewal to compute the metered portion of the invoice.
What are the rate limits for the Chargify API?
Chargify does not publish a fixed public rate limit; production limits depend on your plan. Cache /products.json and /customers.json reads where possible and back off on HTTP 429 responses, especially during end-of-billing-period bursts.
How do I create a subscription through Jentic?
Install jentic with pip install jentic, search for 'create a chargify subscription', load the schema for POST /subscriptions.json, and execute with the customer and product IDs. Sign up at https://app.jentic.com/sign-up to get an agent API key.
Does the Chargify API support storing multiple payment methods per customer?
Yes. POST /payment_profiles.json creates a new payment method tied to a customer, GET /payment_profiles/{payment_profile_id}.json inspects an individual record, and DELETE removes one. A customer can hold several stored profiles with one designated as the default for charges.
/customers.json
Create a customer
/invoices.json
List invoices
/payment_profiles.json
Create a stored payment profile