首页 › 龙虾技能列表 › Chargebee — 技能工具

Chargebee — 技能工具

v1.0.5

[自动翻译] Chargebee API integration with managed OAuth. Manage subscriptions, customers, invoices, and hosted checkout pages. Use this skill when users want to ...

3· 5,064·1 当前·1 累计
by @byungkyu·MIT-0
下载技能包
License
MIT-0
最后更新
2026/2/26
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
The skill is an instruction-only wrapper describing how to call a Maton-managed Chargebee gateway and only requests a single MATON_API_KEY environment variable — the requirements align with the stated purpose.
评估建议
This skill is an instruction-only adapter that routes Chargebee API calls through Maton (gateway.maton.ai / ctrl.maton.ai). Before installing, confirm you trust Maton as a proxy for your Chargebee data and are willing to provide MATON_API_KEY (this key grants Maton access to perform API actions on your behalf). Verify the Maton endpoints and account pages listed in the SKILL.md, consider using a scoped/rotatable API key, and limit access to only the connections you intend. Note the package/sourc...
详细分析 ▾
✓ 用途与能力
The name/description (Chargebee integration) matches the instructions: all example calls target Maton endpoints (gateway.maton.ai, ctrl.maton.ai) and describe managing Chargebee resources. Requesting a Maton API key is coherent with using a Maton-managed proxy/OAuth flow.
✓ 指令范围
SKILL.md only instructs the agent to make HTTP calls to Maton-managed endpoints and to open an OAuth URL in a browser. It does not instruct reading unrelated files, scanning system state, or exfiltrating data to unexpected endpoints.
✓ 安装机制
No install spec or code is included (instruction-only), so nothing is written to disk or downloaded. This is the lowest-risk install posture and consistent with the simple API-proxy purpose.
✓ 凭证需求
The only required environment variable is MATON_API_KEY, which is appropriate for authenticating to the Maton gateway described. There are no additional unrelated credentials or config paths requested.
✓ 持久化与权限
always is false and the skill is user-invocable; autonomous invocation is allowed (platform default). The skill does not request persistent system modifications or permissions beyond network access and the API key.
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.52026/2/2

- 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.

● 无害

安装命令 点击复制

官方npx clawhub@latest install chargebee
镜像加速npx clawhub@latest install chargebee --registry https://cn.clawhub-mirror.com

技能文档

Access the Chargebee API with managed OAuth authentication. Manage subscriptions, customers, invoices, and billing workflows.

Quick Start

# List customers
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/chargebee/api/v2/customers?limit=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://gateway.maton.ai/chargebee/{native-api-path}

Replace {native-api-path} with the actual Chargebee API endpoint path. The gateway proxies requests to {subdomain}.chargebee.com (automatically replaced with your connection config) and automatically injects authentication.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Connection Management

Manage your Chargebee connections at https://ctrl.maton.ai.

List Connections

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=chargebee&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'chargebee'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response: 

{
  "connection": {
    "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
    "status": "ACTIVE",
    "creation_time": "2025-12-08T07:20:53.488460Z",
    "last_updated_time": "2026-01-31T20:03:32.593153Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "chargebee",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple Chargebee connections, specify which one to use with the Maton-Connection header:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/chargebee/api/v2/customers')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

Customers

List Customers

GET /chargebee/api/v2/customers?limit=10

Get Customer

GET /chargebee/api/v2/customers/{customerId}

Create Customer

POST /chargebee/api/v2/customers
Content-Type: application/x-www-form-urlencoded
first_name=John&last_name=Doe&email=john@example.com

Update Customer

POST /chargebee/api/v2/customers/{customerId}
Content-Type: application/x-www-form-urlencoded
first_name=Jane

Subscriptions

List Subscriptions

GET /chargebee/api/v2/subscriptions?limit=10

Get Subscription

GET /chargebee/api/v2/subscriptions/{subscriptionId}

Create Subscription

POST /chargebee/api/v2/subscriptions
Content-Type: application/x-www-form-urlencoded
plan_id=basic-plan&customer[email]=john@example.com&customer[first_name]=John

Cancel Subscription

POST /chargebee/api/v2/subscriptions/{subscriptionId}/cancel
Content-Type: application/x-www-form-urlencoded
end_of_term=true

Item Prices (Product Catalog 2.0)

List Item Prices

GET /chargebee/api/v2/item_prices?limit=10

Items

List Items

GET /chargebee/api/v2/items?limit=10

Invoices

List Invoices

GET /chargebee/api/v2/invoices?limit=10

Download Invoice PDF

POST /chargebee/api/v2/invoices/{invoiceId}/pdf

Hosted Pages

Checkout New Subscription

POST /chargebee/api/v2/hosted_pages/checkout_new_for_items
Content-Type: application/x-www-form-urlencoded
subscription[plan_id]=basic-plan&customer[email]=john@example.com

Portal Sessions

Create Portal Session

POST /chargebee/api/v2/portal_sessions
Content-Type: application/x-www-form-urlencoded
customer[id]=cust_123

Filtering

GET /chargebee/api/v2/subscriptions?status[is]=active
GET /chargebee/api/v2/customers?email[is]=john@example.com
GET /chargebee/api/v2/invoices?date[after]=1704067200

Code Examples

JavaScript

const response = await fetch(
  'https://gateway.maton.ai/chargebee/api/v2/customers?limit=10',
  {
    headers: {
      'Authorization': Bearer ${process.env.MATON_API_KEY}
    }
  }
);

Python

import os
import requests
response = requests.get(
    'https://gateway.maton.ai/chargebee/api/v2/customers',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
    params={'limit': 10}
)

Notes

  • Uses form-urlencoded data for POST requests
  • Nested objects use bracket notation: customer[email]
  • Timestamps are Unix timestamps
  • List responses include next_offset for pagination
  • Product Catalog 2.0: use item_prices and items
  • IMPORTANT: When using curl commands, use curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsing
  • IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.

Error Handling

StatusMeaning
400Missing Chargebee connection
401Invalid or missing Maton API key
429Rate limited (10 req/sec per account)
4xx/5xxPassthrough error from Chargebee API

Troubleshooting: API Key Issues

  • Check that the MATON_API_KEY environment variable is set:
echo $MATON_API_KEY
  • Verify the API key is valid by listing connections:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Troubleshooting: Invalid App Name

  • Ensure your URL path starts with chargebee. For example:
  • Correct: https://gateway.maton.ai/chargebee/api/v2/customers
  • Incorrect: https://gateway.maton.ai/api/v2/customers

Resources

数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务