# 使用 ShareAI 付款，从同意到结账

为客户提供关于AI使用、您的可选费用和每次购买的明确选择。构建一个他们可以理解和控制的付款流程。

25–35分钟 · 10 实用步骤 · 应用程序构建者 · 产品与工程

您的实施

## 一个您可以解释和验证的付款流程。

在您的产品和实施中明确授权、接受条款和确认付款。

### 具有明确目的的访问

客户了解他们是否正在连接、使用AI或批准购买。

**您可以在以下情况下验证它**

令牌和操作使用目标账户和范围。

### 您可以遵循的合同

发布可理解的报价并跟踪每位客户接受的版本。

**您可以在以下情况下验证它**

新条款不会默默地迁移现有客户。

### 交付前的确认

创建一个目标购买，验证其付款状态并在付款后履行。

**您可以在以下情况下验证它**

处理重试、取消、拒绝结账和限制。

## 选择客户支付的内容

您将区分连接账户、支付AI使用费用和确认产品购买。

您的工作地点 您的产品 → 支付体验

Pay with ShareAI 允许客户在您的应用程序中使用其选定的 ShareAI 账户。有两种不同的计费流程：客户资助的 AI 请求需在接受的授权下进行，以及客户在结账时确认的产品购买。可选的 Builder 加价是关于 AI 使用的额外协议。

| 客户操作 | 发生了什么 | 所需访问权限 |
| --- | --- | --- |
| 连接钱包 | 为选定账户和已接受条款创建授权。点击“连接”不会购买任何产品。 | `openid` 加上您的应用使用的功能。 |
| 发送 AI 请求 | 使用授权账户的符合条件的 AI 额度和已接受的使用条款。 | 适用的推理访问； `monetization_gateway` 针对已接受的 Builder 加价条款。 |
| 确认产品购买 | 仅在授权确认后扣除特定购买费用。 | `payments` 以及成功的付款请求。 |

JamZY · 预约参考应用程序 [放大截图 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LnBuZw.DZt_5dnvNF40T34-7MJsXw?v=219eca92cbe5)

本地预约安排和客户资助的 AI 准备是独立的操作。此演示不会发送日历邀请。

1. 选择预约类型和时长。
2. 选择一个可用的演示时间段。
3. 连接 ShareAI 以使用可选的 AI 助手。
4. AI 仅在此明确操作后运行；仅预订不会调用 ShareAI。

JamZY 的预约示例展示了 AI 使用路径。它没有商户结账、不请求付款范围，也不声称连接会购买订阅。在您添加该独立体验时，请使用剩余章节。

**当您准备继续时**

您的按钮和产品文案会说明客户是连接、使用 AI 还是确认购买。

需要详细信息？[完整 JamZY 设置 ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/how-to-connect-an-application-to-shareai-builder-step-by-step/)[范围 ↗](https://shareai.now/docs/api/builders/auth/scopes/)

## 获取客户的授权

在操作使用目标付费账户之前，您需要获得其许可。

您的工作地点 控制台 → 用例 → 客户授权

1. 创建应用并完成入驻、公开信息和平台回调。在控制台中启用相关用例。
2. 对于 Builder 加价，完成其访问请求并在需要时等待批准。对于购买，启用 Pay with ShareAI 并在订阅中配置所需的支付访问合同。
3. 通过授权码 + S256 PKCE 请求启用的范围。使用 `payments` 进行产品结账，使用 `inference` 进行网络成本的 AI 使用，使用 `monetization_gateway` 进行已批准的 AI 加价。仅请求应用程序实际使用的功能。
4. 让客户选择正确的个人或组织账户并接受显示的条款。额外范围或更改条款需要重新授权；刷新不会授予它们。

用例 [放大截图 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3VzZS1jYXNlcy5wbmc.zRU3Lp1TsQuYD7ClWUWS-X?v=090d8c81e6da)

Log-in with ShareAI、Pay with ShareAI 和 Monetization Gateway 拥有独立的配置和审批状态。

1. 使用 ShareAI 配置登录。
2. 启用客户资助的使用。

客户端 ID 标识平台。访问令牌代表已接受的客户授权。合同版本记录计费条款。这些单独都不能证明某个特定产品付款已被确认。

**当您准备继续时**

令牌属于目标客户，并包含您即将执行的操作的权限。

需要详细信息？[客户授权 ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[已接受条款 ↗](https://shareai.now/docs/api/builders/auth/billing-agreements/)

## 在报价中解释您的AI费用

您将发布客户可以查看并接受的明确使用条款。

您的工作地点 应用程序 → 订阅

在订阅中创建清晰命名的优惠，并解释额外的 AI 费用。订阅 ID 是生成的、只读的，并限定于您的应用。这些优惠在应用的平台客户端之间共享，因此您无需为 Web 和 Android 维护不同的商业优惠。

订阅 · 概览 [放大截图 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbnMucG5n.1fAD7CKPa38_SZFh5zuI9P?v=f1ef4ee6680b)

新应用程序在开始时没有发布的合同。在发布条款之前添加一个报价。

1. 在其专属编辑器中创建一个报价。

订阅 · 报价编辑器 [放大截图 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbi1lZGl0b3IucG5n.ajS-FCMdefa7Br_i-9U6yV?v=028a19d93ad7)

一个示例性草稿报价。其生成的订阅 ID 是只读的，并限定于此应用程序。

1. 使用面向客户的报价名称。
2. 为此报价设置 AI `surcharge`。

使用“估算”比较所选模型的网络成本、附加费用和开发者收益。发布经过审核的草稿作为下一合同版本。客户在授权期间接受该版本；已发布的优惠与已接受的客户协议不同。

如果您只需要产品 `payments`，请使用可用的免费支付访问合同流程，而不是创建 Builder 加价。当前的使用报价编辑器未配置固定订阅价格和间隔；不要将 AI 报价解释为自动循环计费。

**当您准备继续时**

您的报价准确描述了添加到 AI 成本中的内容。面向客户的同意显示相同的已发布条款。

需要详细信息？[不可变的计费协议 ↗](https://shareai.now/docs/api/builders/auth/billing-agreements/)

## 让客户选择新条款

您将在跟踪每个账户已接受的条款的同时引入新的合同。

您的工作地点 订阅 → 合同

在下一份合同草案中准备更改。现有授权保留其已接受的订阅和版本，直到客户接受替换版本。在订阅概览中比较账户数量和分布，而不是假设每个账户都使用最新版本。

订阅 · 合同 [放大截图 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NvbnRyYWN0cy5wbmc.XbUHyTwHQDJk3rDHQe4-gs?v=a43ae1273eb9)

合同历史和已接受账户的分布将在发布和客户同意后显示。

1. 查看已发布的合同版本。

告知客户更改内容，并在需要时通过同意流程让他们接受新版本。刷新令牌无法制造接受。保留已接受的合同是默认过渡。选择在进一步操作之前要求重新同意会故意中断现有访问，直到客户批准新条款；在发布之前审查其影响。任何允许的减少必须遵循已接受合同的规则；费用增加需要客户的批准。

保持应用程序级视图和身份边界分离。平台特定的客户标识符即使在商业概览汇总整个应用程序时，也仍然限定于其客户端上下文。

**当您准备继续时**

您可以识别每个账户接受了哪个合同，并解释如何将其迁移到下一个合同。

需要详细信息？[合同过渡规则 ↗](https://shareai.now/docs/api/builders/auth/billing-agreements/)[客户身份边界 ↗](https://shareai.now/docs/api/builders/auth/pairwise-identities/)

## 在履行购买前确认

您将创建一个预期购买，获得确认并在交付前验证付款。

您的工作地点 您的后端 → ShareAI 结账 → 付款验证

本章扩展了预约示例，增加了单独的产品购买。仅在启用付款并获得具有该范围的客户令牌后运行。将订单和付款状态保留在您的后端。

```bash
# 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"}'
```

1. 使用返回的付款 ID 和结账 URL 保存订单。使用精确的十进制金额字符串；避免浮点货币计算。
2. 打开返回的结账 URL。ShareAI 展示购买和付款人。客户必须使用授权您的应用的账户进行确认。打开结账不会扣款。
3. 使用相同的客户授权从 API 读取付款。仅在验证状态为“已支付”后履行订单。
4. 使用相同的幂等键重试相同的预期购买。不同的购买需要新的键。切勿为更改条款重复使用键。

```bash
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 的可下载预约示例未实现该扩展。

**当您准备继续时**

在您的后端验证已付款之前不会交付任何订单，并且重复确认流程无法重复交付或扣除同一订单两次。

需要详细信息？[支付端点 & 响应参考 ↗](https://shareai.now/docs/api/builders/payments/)

## 帮助客户从账单问题中恢复

您将处理信用额度和断开连接，而不会产生重复收费或意外账户更改。

您的工作地点 您的应用程序 → 账单恢复

AI 使用和产品购买具有不同的可用信用规则。一个账户可能拥有 AI 可用信用，但无法用于支付产品。使用 API 错误和客户账单目标处理资金不足和每应用支出限制。

向客户展示所选支付账户、失败的操作以及管理信用或限制的路径。客户控制自己的上限；应用所有者无法提高它。请勿默默地从组织账户切换到个人账户以使收费成功。

客户 [放大截图 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2N1c3RvbWVycy5wbmc.qbIDq-R5JMA6K48ws4kWaB?v=cc0470083fec)

应用程序视图将关联账户汇总在一起，但不会显示内部组织数据库 ID。

1. 客户管理被汇总到应用程序中。

断开连接应撤销相关授权并清除本地会话。它停止未来的授权请求；它不会撤销已确认的购买或自动取消单独的付费承诺。刷新失败、授权撤销和付款过期需要不同的恢复消息。

**当您准备继续时**

信用不足和限制错误使客户知情并保持控制，避免意外重复订单或付款人更改。

需要详细信息？[账单错误 & 限制 ↗](https://shareai.now/docs/api/builders/billing-errors-and-spending-limits/)[撤销访问 ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)

## 验证完整的付款流程

您将在发布平台之前测试成功路径及其失败案例。

您的工作地点 OAuth 设置 → 验证

使用应用范围的测试人员名单和与 Builder 不同的合格支付账户。最多有五个测试人员名额，包括待处理的邀请。为发布中包含的每个平台完成真实端点和范围验证。

Web · 验证 [放大截图 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3ZlcmlmaWNhdGlvbi5wbmc.xLD6z4RV0ddX6p0qkaLhqc?v=d758a8f881d9)

新的集成在记录到实际成功调用之前显示为待检查状态。本参考草稿尚未通过审核。

1. 控制台记录实际端点成功。
2. 每个请求的范围也必须被使用。

1. 测试授权接受和取消；确认所选客户/账户边界。
2. 测试 `inference` 或 `monetization_gateway` 的成功范围 AI 请求，以及 `payments` 所需的成功支付 API 调用。支付请求可能处于待处理状态而未扣款；完整的结账测试还需验证明确的确认和支付。
3. 测试重复请求、被拒绝和过期的结账、信用不足、账户支出限制、过期令牌、刷新轮换和撤销授权。
4. 检查客户、订阅和分析以确认结果客户、已接受条款和归属活动。确认敏感凭据和内部组织 ID 不会出现在客户界面中。
5. 仅包括配置和记录检查通过的平台。排除未完成的平台或将其移除；然后从 Dashboard 提交应用程序。

**当您准备继续时**

您的集成区分已接受的访问、已接受的条款、请求的付款和确认的付款，并处理每种情况的失败路径。

需要详细信息？[应用程序启动检查清单 ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/how-to-connect-an-application-to-shareai-builder-step-by-step/#verify)[Builder API参考 ↗](https://shareai.now/docs/api/builders/)

## 组织验证和计划访问

在申请之前，选择将拥有项目注册的个人或组织账户。组织可以在验证之前提交申请，但仅有员工批准并不能激活访问权限。通过控制台中的入职清单完成组织邮箱和公司验证。已批准的组织在两项检查完成之前仍处于“待验证”状态。Builder、Provider 和 Creator 项目遵循此规则。

[查看 Monetization Gateway 定价](https://shareai.now/zh/%e6%9e%84%e5%bb%ba%e8%80%85/%e7%9b%88%e5%88%a9%e7%bd%91%e5%85%b3/#mg-pricing) · [探索 ShareAI for Startups](https://shareai.now/zh/%e5%88%9d%e5%88%9b%e8%ae%a1%e5%88%92/) · [范围和权限](https://shareai.now/zh/%e6%96%87%e6%a1%a3/api/%e6%9e%84%e5%bb%ba%e8%80%85/%e8%ae%a4%e8%af%81/%e8%8c%83%e5%9b%b4/)

## 权限和接受的条款

您的公共条款和条件、隐私政策和删除说明必须与应用匹配，并且无需登录即可访问。ShareAI 计划接受、Monetization Gateway 批准、客户的 OAuth 权限和已接受的账单合同是独立的决策。刷新不能添加权限或接受新的商业条款。

旧版 `surcharge` 范围仍被现有集成接受。新示例使用 `monetization_gateway`。保持现有的线字段，例如 `surcharge_bps` 和 `surcharge_percentage` 不变。

[查看 Monetization Gateway 定价](https://shareai.now/zh/%e6%9e%84%e5%bb%ba%e8%80%85/%e7%9b%88%e5%88%a9%e7%bd%91%e5%85%b3/#mg-pricing) · [探索 ShareAI for Startups](https://shareai.now/zh/%e5%88%9d%e5%88%9b%e8%ae%a1%e5%88%92/) · [范围和权限](https://shareai.now/zh/%e6%96%87%e6%a1%a3/api/%e6%9e%84%e5%bb%ba%e8%80%85/%e8%ae%a4%e8%af%81/%e8%8c%83%e5%9b%b4/)

## 网关费用和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加价上的百分比费用以及可计费的事件摄取。这不是总加价津贴、单独的免费事件配额或免费的AI`inference`。账户的前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 定价](https://shareai.now/zh/%e6%9e%84%e5%bb%ba%e8%80%85/%e7%9b%88%e5%88%a9%e7%bd%91%e5%85%b3/#mg-pricing) · [探索 ShareAI for Startups](https://shareai.now/zh/%e5%88%9d%e5%88%9b%e8%ae%a1%e5%88%92/) · [范围和权限](https://shareai.now/zh/%e6%96%87%e6%a1%a3/api/%e6%9e%84%e5%bb%ba%e8%80%85/%e8%ae%a4%e8%af%81/%e8%8c%83%e5%9b%b4/)

Source: https://shareai.now/zh/%E5%8D%9A%E5%AE%A2-2/%E4%BA%A7%E5%93%81/%E5%BB%BA%E9%80%A0%E8%80%85%E7%A8%8B%E5%BA%8F/%E6%8C%87%E5%8D%97-%E6%93%8D%E4%BD%9C%E6%96%B9%E6%B3%95/%E4%BD%BF%E7%94%A8-shareai-%E4%BB%98%E6%AC%BE%EF%BC%8C%E4%BB%8E%E5%90%8C%E6%84%8F%E5%88%B0%E7%BB%93%E8%B4%A6/