Stripe 完全读取权限

使用本地存储的 Stripe API 密钥直接访问 Stripe API。

要求

• - Stripe API 密钥本地存储，位于 git 之外
• 查询 Connect 账户或应用费用时，优先使用平台级密钥
• 使用此技能进行面向读取的 Stripe 分析与报告

本工作区使用的本地密钥路径：

• - /home/clawd/.config/stripe/api_key

身份验证

text
Authorization: Bearer $STRIPEAPIKEY

Shell 配置示例：

bash
export STRIPEAPIKEY=$(cat /home/clawd/.config/stripe/api_key)

基础 URL

text
https://api.stripe.com/v1/

快速检查

获取平台账户

bash
curl -sS https://api.stripe.com/v1/account \
-H Authorization: Bearer $(cat /home/clawd/.config/stripe/api_key)

列出已关联账户

bash
curl -sS https://api.stripe.com/v1/accounts?limit=10 \
-H Authorization: Bearer $(cat /home/clawd/.config/stripe/api_key)

获取余额

bash
curl -sS https://api.stripe.com/v1/balance \
-H Authorization: Bearer $(cat /home/clawd/.config/stripe/api_key)

常用端点

• - 账户：/v1/account
• 余额：/v1/balance
• 已关联账户：/v1/accounts
• 费用：/v1/charges
• 客户：/v1/customers
• 支付意向：/v1/paymentintents
• 提现：/v1/payouts
• 账单：/v1/invoices
• 订阅：/v1/subscriptions
• 余额交易：/v1/balancetransactions
• 应用费用：/v1/application_fees
• 转账：/v1/transfers

实用模式

统计已关联账户数量

使用分页直到 has_more 为 false。

bash
python3 - < import json, urllib.request, urllib.parse
from pathlib import Path
key = Path(/home/clawd/.config/stripe/apikey).readtext().strip()
count = 0
starting_after = None
while True:
params = {limit: 100}
if starting_after:
params[startingafter] = startingafter
req = urllib.request.Request(https://api.stripe.com/v1/accounts? + urllib.parse.urlencode(params))
req.add_header(Authorization, fBearer {key})
with urllib.request.urlopen(req, timeout=60) as r:
data = json.load(r)
items = data.get(data, [])
count += len(items)
if not data.get(has_more) or not items:
print(count)
break
starting_after = items[-1][id]
PY

列出近期应用费用

bash
curl -sS https://api.stripe.com/v1/application_fees?limit=10 \
-H Authorization: Bearer $(cat /home/clawd/.config/stripe/api_key)

列出近期提现

bash
curl -sS https://api.stripe.com/v1/payouts?limit=10 \
-H Authorization: Bearer $(cat /home/clawd/.config/stripe/api_key)

列出近期费用

bash
curl -sS https://api.stripe.com/v1/charges?limit=10 \
-H Authorization: Bearer $(cat /home/clawd/.config/stripe/api_key)

Connect 注意事项

• - 使用直接 Stripe 认证进行平台级 Connect 报告。
• 此设置可访问 /v1/accounts，确认平台可见性。
• 对于费用收入问题，需同时检查 applicationfees、balancetransactions 和 transfers。
• 部分金额字段为整数最小单位。对于英镑，需除以 100。
• 明确说明数字是总费用、应用费用、净余额变动、待处理还是可用余额。

安全

• - 切勿提交 Stripe API 密钥。
• 切勿将 Stripe API 密钥写入内存文件。
• 除非用户明确要求写入操作，否则优先使用只读分析。
• 谨慎处理可创建退款、提现、转账或账户变更的端点。