← Back to Skills Marketplace
byungkyu

chargebee

by byungkyu · GitHub ↗ · v1.2.5 · MIT-0
cross-platform ✓ Security Clean
6897
Downloads
3
Stars
0
Active Installs
15
Versions
Install in OpenClaw
/install chargebee
Description
Chargebee API integration with managed OAuth. Install only if you need Chargebee billing administration. Connect with least-privilege access, verify the intended connection ID before each request, and revoke unused connections promptly. This integration can mutate billing data — approve only specific write actions after checking the exact endpoint, account, resource ID, and consequence. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Chargebee connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Chargebee action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Chargebee examples; they add no Chargebee capability - Chargebee is not an event source, a trigger cannot read Chargebee data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
Usage Guidance
Install this only if you intend to manage Chargebee billing through Maton. Use read-only or least-privilege Chargebee access when possible, verify the connection ID before actions, and require explicit confirmation for any billing write, hosted function, trigger, or persistent destination.
Capability Assessment
ℹ Credentials
Network access, OAuth login, OS credential storage, and a raw API-key fallback are proportionate for an API integration, with clear warnings not to expose or persist secrets.
✓ Install Mechanism
Installation uses pinned Maton CLI package instructions through npm or Homebrew; the artifact contains Markdown documentation and no executable bundled scripts.
ℹ Instruction Scope
The package includes shared Maton trigger references for other event sources, including GitHub, but the instructions explicitly say they are optional platform catalogues and only apply when the user names and connects that source.
ℹ Persistence & Privilege
Maton connections, hosted functions, triggers, and destinations can persist and affect billing or forward event data, but the skill requires explicit approval, scoping, and cleanup/revocation guidance.
ℹ Purpose & Capability
The stated purpose is Chargebee billing administration via Maton, including reads, billing mutations, and optional automation; these are high-impact but coherent with the purpose and repeatedly disclosed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install chargebee
  3. After installation, invoke the skill by name or use /chargebee
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.5
Simplify the login instructions to the code flow (maton login prints a link; finish with maton login --code <CODE>), drop the API Key subsection, and pin the Maton CLI install to 0.4.0.
v1.2.4
Switch the login instructions to the device flow (maton login prints a link and a user code; the --oauth flag is gone) and pin the Maton CLI install to 0.3.5.
v1.2.3
Pin the Maton CLI install to 0.3.4, the current release.
v1.2.2
Add this skill's own trigger policy to the shared Triggers section: the only destination it sets up is its own hosted function inside the platform, it does not forward events to third-party hosts, and it does not use event watch --exec; each trigger reference now also says this skill configures no trigger from that source on its own.
v1.2.1
Bring the skill to the current api-gateway baseline and tell the connection-to-function-to-trigger story: the shared Functions and Triggers sections open with an example for this app (a hosted function that performs one action for it through the Maton SDK, and the trigger that runs it - its own event source where it has one, otherwise a time schedule), the description says these constructs turn the connection into automation and add no capability of their own, the passthrough is described by its enforced boundary, CLI and SDK installs are pinned to 0.3.1, absolute API URLs are placeholders, and multipart uploads use mktemp.
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.7
- The skill description and documentation now include prominent security warnings and least-privilege recommendations. - Added instructions to always verify the intended Chargebee connection ID before every request, especially for write operations. - Clarified that only the documented API endpoints may be used; arbitrary paths are not supported. - Required explicit user confirmation with clear resource details and consequences before any write, update, or cancel action. - Emphasized the default to read-only operations and the need to summarize financial impact for billing changes.
v1.0.6
- Updated all API and connection management endpoint URLs from `gateway.maton.ai` and `ctrl.maton.ai` to `api.maton.ai` - Clarified that multiple connections require explicit `Maton-Connection` header use - Added a section on security and user approval for write operations - Minor response example normalization and wording improvements - Removed the file LICENSE.txt
v1.0.5
- Added a new `clawdbot` metadata section with required environment variable declaration for `MATON_API_KEY` and an emoji indicator. - No changes to skill features or usage.
v1.0.4
- Minor documentation update to the troubleshooting and error handling sections. - Clarified troubleshooting steps for API key errors and invalid app names. - No changes made to code or functionality.
v1.0.3
- All shell (curl) code samples have been replaced with Python code using the standard library for API usage and connection management. - Added a new section for troubleshooting "Invalid API key" errors, with step-by-step diagnostic guidance. - Updated example commands throughout to demonstrate the recommended Python approach, instead of curl. - No changes to API endpoints or functionality—documentation update only.
v1.0.2
- Added a note in the description directing users to the api-gateway skill for third-party apps other than Chargebee. - Updated curl code examples to use the $MATON_API_KEY environment variable consistently. - Added important usage notes about using curl with globbing (`-g` flag) and environment variable expansion when piping output. - No functional or API changes. Documentation improvements only.
v1.0.1
- Clarified the base URL format, now using /chargebee/{native-api-path} and explaining dynamic subdomain replacement. - Added instructions for handling multiple Chargebee connections using the Maton-Connection header. - Expanded example API responses to include connection metadata and timestamps. - Minor improvements to authentication guidance (now mentions new user signup). - Documentation improved for clarity and accuracy across connection and usage examples.
v1.0.0
Initial release of Chargebee API integration. - Integrates Chargebee API with managed OAuth through Maton. - Manage subscriptions, customers, invoices, items, and hosted checkout pages. - Includes API reference, cURL and code examples, and environment variable setup. - Provides instructions for managing Chargebee connections and OAuth authorization. - Supports filtering, error handling, pagination, and Product Catalog 2.0 endpoints.
Metadata
Slug chargebee
Version 1.2.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 15
Frequently Asked Questions

What is chargebee?

Chargebee API integration with managed OAuth. Install only if you need Chargebee billing administration. Connect with least-privilege access, verify the intended connection ID before each request, and revoke unused connections promptly. This integration can mutate billing data — approve only specific write actions after checking the exact endpoint, account, resource ID, and consequence. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Chargebee connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Chargebee action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Chargebee examples; they add no Chargebee capability - Chargebee is not an event source, a trigger cannot read Chargebee data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe). It is an AI Agent Skill for Claude Code / OpenClaw, with 6897 downloads so far.

How do I install chargebee?

Run "/install chargebee" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is chargebee free?

Yes, chargebee is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does chargebee support?

chargebee is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created chargebee?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.5.

💬 Comments