支付产品和订阅费用
创建钱包结账,让客户在 ShareAI 中确认,然后在履行之前验证支付结果。
本页面内容
在使用案例中启用“使用 ShareAI 支付”。在订阅计划中,选择发布免费支付访问权限,用于一次性购买,无需订阅或 AI 附加费。或者发布您的订阅计划。客户在连接钱包时接受此合同;每笔付款都需单独确认。
启用“使用 ShareAI 支付”并获取客户 OAuth 令牌 payments。对于订阅,请发布订阅计划并让客户接受。金额为精确的以欧元计价的钱包信用字符串;请勿发送浮点计算。
POST
https://api.shareai.now/api/v1/console/builder/payments创建待处理的结算请求
- 基础 URL
https://api.shareai.now- 身份验证
- 客户 OAuth Bearer 令牌
- 必需范围
payments
cURL
curl --fail-with-body 'https://api.shareai.now/api/v1/console/builder/payments' -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" -H 'Content-Type: application/json' -H 'Idempotency-Key: order-2026-09-example-001' --data '{"title":"Research report","amount":"12.50"}'
订阅结算#
使用相同的端点和新的幂等键为预期的计费周期处理 {"subscription":true}。ShareAI 从已接受的不可变计划中获取价格、标题和周期。您提交的产品金额无法覆盖订阅价格。
确认并验证#
- 保存返回的支付 ID 和 checkout_url。重复相同的请求和幂等键将返回相同的支付结果。使用不同条款重复使用键会被拒绝。
- 为客户打开 checkout_url。他们登录并选择授权期间使用的相同个人或组织账户。
- ShareAI 显示应用程序、购买内容、金额和付款人。只有明确授权的确认才会扣除钱包金额。打开链接不会扣款。
- 使用相同的客户令牌再次读取支付信息。仅在状态为“已支付”后履行订单;不要仅依赖浏览器的成功消息。
GET
https://api.shareai.now/api/v1/console/builder/payments?id={payment_id}读取您的客户支付信息
- 基础 URL
https://api.shareai.now- 身份验证
- 客户 OAuth Bearer 令牌
- 必需范围
payments
cURL
curl --fail-with-body --get 'https://api.shareai.now/api/v1/console/builder/payments' -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" --data-urlencode "id=$PAYMENT_ID"
| 状态 | 含义 |
|---|---|
| 待处理 | 等待确认;结算在 15 分钟后过期。 |
| 获得报酬 | 已确认并扣款一次。订阅包括其支付周期结束日期。 |
| 已拒绝 | 客户拒绝支付。 |
| 已过期 | 确认窗口已结束。使用新键创建新的请求。 |
只有已购买、未受限制且未过期的钱包信用可以支付产品和订阅费用。促销信用和仅限推理的收入无法支付。付款人无法支付其自己的 Builder 账户。信用不足不会扣款;客户可以在充值后重试,同时结算和授权仍然有效。
每次续订都需要新的结算和客户确认。活动订阅周期不能重复收费。确认时原始授权必须仍然有效;如果令牌已过期,请刷新并创建新的请求。
请求范围限定为 OAuth 客户端和客户。产品和订阅收益与 AI 附加费收入分开记录,并有 45 天的审核期。Builder 的默认 1.5% 费用仅适用于 AI 附加费收入。
控制台分析 → 支付列出支付状态、每日总额和发布状态。 混合计划条款.
最后更新日期 2026 年 9 月 18 日