01客户同意
具有明确目的的访问
客户了解他们是否正在连接、使用AI或批准购买。
您可以在以下情况下验证它
构建授权流程 令牌和操作使用目标账户和范围。
您将设计的体验
使用ShareAI支付清晰的访问。接受的条款。确认的购买。
您的实施
一个您可以解释和验证的付款流程。
在您的产品和实施中明确授权、接受条款和确认付款。
将其带入您的编辑器
与您的代理一起构建。
复制完整指南，包括实施目标、所需输入和验收检查。保持代码示例、表格和文档链接在一起。
完整指南实施上下文验证检查
为您的项目准备好，以您需要的格式提供。
更新
手动复制参考
选择客户支付的内容
您将区分连接账户、支付AI使用费用和确认产品购买。
您的工作地点 您的产品 → 支付体验
Pay with ShareAI 允许客户在您的应用程序中使用其选定的 ShareAI 账户。有两种不同的计费流程：客户资助的 AI 请求需在接受的授权下进行，以及客户在结账时确认的产品购买。可选的 Builder 加价是关于 AI 使用的额外协议。
| 客户操作 | 发生了什么 | 所需访问权限 |
|---|---|---|
| 连接钱包 | 为选定账户和已接受条款创建授权。点击“连接”不会购买任何产品。 | openid 加上您的应用使用的功能。 |
| 发送 AI 请求 | 使用授权账户的符合条件的 AI 额度和已接受的使用条款。 | 适用的推理访问； monetization_gateway 针对已接受的 Builder 加价条款。 |
| 确认产品购买 | 仅在授权确认后扣除特定购买费用。 | payments 以及成功的付款请求。 |
JamZY · 预约参考应用程序 放大截图 ↗
- 选择预约类型和时长。
- 选择一个可用的演示时间段。
- 连接 ShareAI 以使用可选的 AI 助手。
- AI 仅在此明确操作后运行；仅预订不会调用 ShareAI。
JamZY 的预约示例展示了 AI 使用路径。它没有商户结账、不请求付款范围，也不声称连接会购买订阅。在您添加该独立体验时，请使用剩余章节。
当您准备继续时
您的按钮和产品文案会说明客户是连接、使用 AI 还是确认购买。
获取客户的授权
在操作使用目标付费账户之前，您需要获得其许可。
您的工作地点 控制台 → 用例 → 客户授权
- 创建应用并完成入驻、公开信息和平台回调。在控制台中启用相关用例。
- 对于 Builder 加价，完成其访问请求并在需要时等待批准。对于购买，启用 Pay with ShareAI 并在订阅中配置所需的支付访问合同。
- 通过授权码 + S256 PKCE 请求启用的范围。使用
payments进行产品结账，使用inference进行网络成本的 AI 使用，使用monetization_gateway进行已批准的 AI 加价。仅请求应用程序实际使用的功能。 - 让客户选择正确的个人或组织账户并接受显示的条款。额外范围或更改条款需要重新授权；刷新不会授予它们。
用例 放大截图 ↗
- 使用 ShareAI 配置登录。
- 启用客户资助的使用。
客户端 ID 标识平台。访问令牌代表已接受的客户授权。合同版本记录计费条款。这些单独都不能证明某个特定产品付款已被确认。
当您准备继续时
令牌属于目标客户，并包含您即将执行的操作的权限。
在报价中解释您的AI费用
您将发布客户可以查看并接受的明确使用条款。
您的工作地点 应用程序 → 订阅
在订阅中创建清晰命名的优惠，并解释额外的 AI 费用。订阅 ID 是生成的、只读的，并限定于您的应用。这些优惠在应用的平台客户端之间共享，因此您无需为 Web 和 Android 维护不同的商业优惠。
订阅 · 概览 放大截图 ↗
- 在其专属编辑器中创建一个报价。
订阅 · 报价编辑器 放大截图 ↗
- 使用面向客户的报价名称。
- 为此报价设置 AI
surcharge。
使用“估算”比较所选模型的网络成本、附加费用和开发者收益。发布经过审核的草稿作为下一合同版本。客户在授权期间接受该版本；已发布的优惠与已接受的客户协议不同。
如果您只需要产品 payments，请使用可用的免费支付访问合同流程，而不是创建 Builder 加价。当前的使用报价编辑器未配置固定订阅价格和间隔；不要将 AI 报价解释为自动循环计费。
当您准备继续时
您的报价准确描述了添加到 AI 成本中的内容。面向客户的同意显示相同的已发布条款。
需要详细信息？不可变的计费协议 ↗
让客户选择新条款
您将在跟踪每个账户已接受的条款的同时引入新的合同。
您的工作地点 订阅 → 合同
在下一份合同草案中准备更改。现有授权保留其已接受的订阅和版本，直到客户接受替换版本。在订阅概览中比较账户数量和分布，而不是假设每个账户都使用最新版本。
订阅 · 合同 放大截图 ↗
- 查看已发布的合同版本。
告知客户更改内容，并在需要时通过同意流程让他们接受新版本。刷新令牌无法制造接受。保留已接受的合同是默认过渡。选择在进一步操作之前要求重新同意会故意中断现有访问，直到客户批准新条款；在发布之前审查其影响。任何允许的减少必须遵循已接受合同的规则；费用增加需要客户的批准。
保持应用程序级视图和身份边界分离。平台特定的客户标识符即使在商业概览汇总整个应用程序时，也仍然限定于其客户端上下文。
当您准备继续时
您可以识别每个账户接受了哪个合同，并解释如何将其迁移到下一个合同。
在履行购买前确认
您将创建一个预期购买，获得确认并在交付前验证付款。
您的工作地点 您的后端 → ShareAI 结账 → 付款验证
本章扩展了预约示例，增加了单独的产品购买。仅在启用付款并获得具有该范围的客户令牌后运行。将订单和付款状态保留在您的后端。
# Real payment request: use scoped test access and an intentional amount.
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: YOUR_UNIQUE_ORDER_REFERENCE' \
--data '{"title":"JamZY appointment preparation pack","amount":"1.00"}'- 使用返回的付款 ID 和结账 URL 保存订单。使用精确的十进制金额字符串；避免浮点货币计算。
- 打开返回的结账 URL。ShareAI 展示购买和付款人。客户必须使用授权您的应用的账户进行确认。打开结账不会扣款。
- 使用相同的客户授权从 API 读取付款。仅在验证状态为“已支付”后履行订单。
- 使用相同的幂等键重试相同的预期购买。不同的购买需要新的键。切勿为更改条款重复使用键。
curl --fail-with-body --get \
'https://api.shareai.now/api/v1/console/builder/payments' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
--data-urlencode "id=$SHAREAI_PAYMENT_ID"| 付款状态 | 您的产品应该做什么 |
|---|---|
| 待处理 | 显示仍需客户确认。尚未履行。 |
| 获得报酬 | 根据您的服务器订单进行验证，然后履行一次。 |
| 已拒绝 | 尊重决定；让客户选择是否尝试另一次购买。 |
| 已过期 | 当客户希望重试时，使用新的幂等键创建新的请求。 |
仅使用受信任的 API 返回的结账 URL，并根据您的集成允许的目标政策验证它。返回应用的成功消息不是付款凭证。付款人无法从其自己的 Builder 账户购买。
如果您支持现有的固定价格订阅合同，支付 API 可以使用其已接受的条款来明确确认的期限。请勿发送虚构的循环价格或默默收取新的期限费用。JamZY 的可下载预约示例未实现该扩展。
当您准备继续时
在您的后端验证已付款之前不会交付任何订单，并且重复确认流程无法重复交付或扣除同一订单两次。
需要详细信息？支付端点 & 响应参考 ↗
帮助客户从账单问题中恢复
您将处理信用额度和断开连接，而不会产生重复收费或意外账户更改。
您的工作地点 您的应用程序 → 账单恢复
AI 使用和产品购买具有不同的可用信用规则。一个账户可能拥有 AI 可用信用，但无法用于支付产品。使用 API 错误和客户账单目标处理资金不足和每应用支出限制。
向客户展示所选支付账户、失败的操作以及管理信用或限制的路径。客户控制自己的上限；应用所有者无法提高它。请勿默默地从组织账户切换到个人账户以使收费成功。
客户 放大截图 ↗
- 客户管理被汇总到应用程序中。
断开连接应撤销相关授权并清除本地会话。它停止未来的授权请求；它不会撤销已确认的购买或自动取消单独的付费承诺。刷新失败、授权撤销和付款过期需要不同的恢复消息。
当您准备继续时
信用不足和限制错误使客户知情并保持控制，避免意外重复订单或付款人更改。
验证完整的付款流程
您将在发布平台之前测试成功路径及其失败案例。
您的工作地点 OAuth 设置 → 验证
使用应用范围的测试人员名单和与 Builder 不同的合格支付账户。最多有五个测试人员名额，包括待处理的邀请。为发布中包含的每个平台完成真实端点和范围验证。
Web · 验证 放大截图 ↗
- 控制台记录实际端点成功。
- 每个请求的范围也必须被使用。
- 测试授权接受和取消；确认所选客户/账户边界。
- 测试
inference或monetization_gateway的成功范围 AI 请求，以及payments所需的成功支付 API 调用。支付请求可能处于待处理状态而未扣款；完整的结账测试还需验证明确的确认和支付。 - 测试重复请求、被拒绝和过期的结账、信用不足、账户支出限制、过期令牌、刷新轮换和撤销授权。
- 检查客户、订阅和分析以确认结果客户、已接受条款和归属活动。确认敏感凭据和内部组织 ID 不会出现在客户界面中。
- 仅包括配置和记录检查通过的平台。排除未完成的平台或将其移除；然后从 Dashboard 提交应用程序。
当您准备继续时
您的集成区分已接受的访问、已接受的条款、请求的付款和确认的付款，并处理每种情况的失败路径。
组织验证和计划访问
在申请之前，选择将拥有项目注册的个人或组织账户。组织可以在验证之前提交申请，但仅有员工批准并不能激活访问权限。通过控制台中的入职清单完成组织邮箱和公司验证。已批准的组织在两项检查完成之前仍处于“待验证”状态。Builder、Provider 和 Creator 项目遵循此规则。
查看 Monetization Gateway 定价 · 探索 ShareAI for Startups · 范围和权限
权限和接受的条款
您的公共条款和条件、隐私政策和删除说明必须与应用匹配，并且无需登录即可访问。ShareAI 计划接受、Monetization Gateway 批准、客户的 OAuth 权限和已接受的账单合同是独立的决策。刷新不能添加权限或接受新的商业条款。
旧版 surcharge 范围仍被现有集成接受。新示例使用 monetization_gateway。保持现有的线字段，例如 surcharge_bps 和 surcharge_percentage 不变。
查看 Monetization Gateway 定价 · 探索 ShareAI for Startups · 范围和权限
网关费用和Startup支持
标准收费 5% 的 Builder 加价。对于 €2.00 的 AI 网络成本和 10% 加价，客户支付 €2.20。ShareAI 接收 €0.01 的 €0.20 加价；Builder 在事件摄取前有 €0.19。
每个日历月（UTC），前 1,000 个已结算的生产 Monetization Gateway 请求是免费的，适用于整个 Builder 账户。额外的请求费用为每 1,000 €0.04，在适用折扣之前。一个已结算的请求会创建一个事件。
单独的 Pay with ShareAI，仅限 inference 访问，普通账户 API 密钥以及用于 Staging 或测试流量的请求不产生 Monetization Gateway 事件摄取费用。
ShareAI for Startups为批准的应用程序提供实际ShareAI费用的共享月度津贴。当前的Launch、Growth和Momentum层级分别列出€1,000、€5,000和€10,000每月。同一预算涵盖ShareAI在Builder加价上的百分比费用以及可计费的事件摄取。这不是总加价津贴、单独的免费事件配额或免费的AIinference。账户的前1,000个免费事件不会消耗它。
剩余的事件摄取费用从请求的新Builder收益中支付，然后是可用的Builder AI收益和无限制的AI积分。客户AI费用和产品payments保持独立。
ShareAI可以批准特定应用程序的费用或费用支持，期限固定或直到更改。请在控制台中查看应用程序的当前定价和特殊计划，以了解其批准条款、有效性和已消耗的津贴。层级更改或定价覆盖不会重置应用程序的月度使用量。
Launch保留“使用ShareAI登录”为可选项。Growth和Momentum要求使用；Momentum还要求在应用程序页脚中显示官方ShareAI for Startups徽章。ShareAI每周检查徽章。确认试图绕过要求的行为可能导致降级、从Startup Program中移除或根据接受的计划条款退出Marketplace。
企业费率由 ShareAI 团队为 Builder 账户配置，需在达成个性化报价后生效。分配的百分比和事件费率适用于未来的请求。
查看 Monetization Gateway 定价 · 探索 ShareAI for Startups · 范围和权限