用途:该技能面向 Stripe API 的支付相关操作,当用户提到 Stripe、Link by Stripe、payment、subscription、billing、invoice、Checkout 等场景时使用。
主要能力:覆盖账户信息查询、客户增删改查、产品与价格管理、订阅创建与取消、发票查询、PaymentIntent 创建与查询、Checkout Session 创建与查询、Payment Link 创建与列表、Charge 查询、退款创建与列表、SetupIntent 创建、客户支付方式列表、余额与余额交易、事件查询等。
使用方式:所有调用使用 STRIPE_TOKEN 进行 HTTP Basic Auth,格式为 -u "$STRIPE_TOKEN:"(密钥后带冒号,无密码)。密钥可为 secret key(sk_test_* / sk_live_)或 restricted key(rk_test_ / rk_live_*)。POST 请求体必须使用 application/x-www-form-urlencoded 格式,而非 JSON,先写入 /tmp/stripe_request.txt,再用 -d @/tmp/stripe_request.txt 发送;嵌套参数使用方括号语法,如 items[0][price]=price_xxx。金额以最小货币单位表示(如美元为美分)。动态 ID 用 <placeholder> 占位。
Link 与 Checkout:Link by Stripe 没有独立 API 密钥,它是 Stripe 的支付方式/客户钱包,仍使用 STRIPE_TOKEN 创建卖家侧 Checkout Session 或 PaymentIntent,由客户在浏览器完成 Link。沙箱 Link 结账为浏览器流程,用测试模式密钥创建会话后打开返回的 url,用六位验证码认证;未列出的六位码可通过,000001 无效、000002 过期、000003 超出尝试次数,沙箱 Link 账户不要存真实用户数据。Payment Links(plink_*)是可复用的托管支付 URL,与 Link by Stripe 不同。
限制与排障:请求失败时可运行 zero doctor check-connector --env-name STRIPE_TOKEN 或 zero doctor check-connector --url https://api.stripe.com/v1/account --method GET。测试模式账户返回空列表属正常。具体收费、价格与平台支持情况暂未提供。