01客戶同意
帶有清晰目的嘅訪問
客戶明白佢哋係連接、使用 AI 定係批准購買。
你可以喺以下情況驗證：
構建授權流程 Token 同操作使用目標帳戶同範圍。
你將設計嘅體驗
用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。
使用「估算」比較所選模型嘅網絡成本、附加費同Builder收益。將審核過嘅草稿作為下一個合同版本發布。客戶喺授權期間接受嗰個版本；已發布嘅優惠唔等於已接受嘅客戶協議。
如果你只需要產品payments，使用可用嘅免費付款訪問合同流程，而唔係創建Builder加價。固定訂閱價格同間隔唔係由現時嘅使用優惠編輯器配置；唔好將AI優惠解釋為自動定期收費。
當你準備好繼續嘅時候
你嘅offer準確描述咗加到AI成本嘅內容。面向客戶嘅同意畫面會顯示相同嘅已發佈條款。
需要詳細資料？不可更改嘅收費協議 ↗
讓客戶選擇新條款
你會引入一份新合約，同時追蹤每個帳戶已接受嘅條款。
你將會工作嘅地方 訂閱 → 合約
喺下一份合約草稿中準備更改。現有授權會保留佢哋已接受嘅訂閱同版本，直到客戶接受替代版本為止。喺訂閱概覽中比較帳戶數量同分佈，而唔好假設每個帳戶都使用最新版本。
訂閱 · 合約 放大截圖 ↗
- 查看已發佈嘅合約版本。
告訴客戶更改內容，並喺需要時通過同意流程讓佢哋接受新版本。一個刷新嘅token唔可以製造接受。保留已接受嘅合約係默認過渡。選擇要求重新同意先至進行進一步操作會有意中斷現有訪問，直到客戶批准新條款；喺發佈之前檢查呢個影響。任何允許嘅減少都必須遵循已接受合約嘅規則；費用增加需要客戶批准。
保持應用層面嘅視圖同身份邊界分開。平台特定嘅客戶標識符即使喺商業概覽中聚合咗整個應用，仍然限制喺佢哋嘅客戶端上下文中。
當你準備好繼續嘅時候
你可以識別每個帳戶接受咗邊份合約，並解釋點樣轉移到下一份合約。
喺完成購買前確認
你會創建一個預期購買，獲得確認並喺交付之前驗證付款。
你將會工作嘅地方 你嘅後端 → ShareAI 結帳 → 付款驗證
呢章會擴展預約示例，加入一個單獨嘅產品購買。只喺啟用付款並獲得具有該範圍嘅客戶token之後運行。喺你嘅後端保持訂單同付款狀態。
# 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返回嘅checkout URL，並根據你嘅集成允許嘅目標政策進行驗證。返回應用程序嘅成功消息唔係付款證據。付款人唔可以用佢自己嘅Builder帳戶購買。
如果你支持現有嘅固定價格訂閱合同，支付API可以使用其接受嘅條款進行明確確認嘅期間。唔好發送虛構嘅定期價格或者靜默收取新嘅期間費用。JamZY嘅可下載預約樣本冇實現嗰個擴展。
當你準備好繼續嘅時候
喺你嘅後端驗證已付款之前，唔會交付任何訂單，並且重複確認流程唔可以交付或者重複扣款同一個訂單。
需要詳細資料？支付端點&響應參考 ↗
幫助客戶從賬單問題中恢復
你需要處理信用限額同斷開連接，避免重複收費或者意外嘅帳戶更改。
你將會工作嘅地方 你嘅應用程序 → 賬單恢復
AI使用同產品購買有唔同嘅合資格信用規則。一個帳戶可能有AI合資格信用，但唔可以用嚟支付產品。使用API錯誤同客戶賬單目標處理資金不足同每個應用程序嘅支出限額。
向客戶展示所選嘅支付帳戶、失敗嘅操作同管理信用或者限額嘅路徑。客戶控制佢自己嘅上限；應用程序擁有者唔可以提高佢。唔好靜默切換由組織帳戶到個人帳戶嚟令收費成功。
客戶 放大截圖 ↗
- 客戶管理係為應用程式聚合嘅。
斷開連接應該撤銷相關授權並清除本地會話。佢會停止未來嘅授權請求；但唔會撤銷已確認嘅購買或者自動取消單獨嘅付費承諾。刷新失敗、授權撤銷同支付過期需要獨立嘅恢復消息。
當你準備好繼續嘅時候
資金不足同限額錯誤會令客戶知情並控制，避免意外重複訂單或者付款人更改。
驗證完整嘅付款流程
你會喺發佈之前測試成功路徑同其失敗情況。
你將會工作嘅地方 OAuth設置 → 驗證
使用應用程序範圍內嘅測試人員名單同一個唔同於Builder嘅合資格支付帳戶。最多有五個測試人員名額，包括待處理邀請。完成每個發佈中包含平台嘅真實端點同範圍驗證。
網頁 · 驗證 放大截圖 ↗
- Console 記錄實際端點成功。
- 每個請求嘅範圍都必須被使用。
- 測試接受同取消嘅授權；確認所選客戶/帳戶邊界。
- 測試成功嘅範圍AI請求
inference或monetization_gateway，以及payments所需嘅成功付款API調用。付款請求可能處於待處理狀態而無扣款；完整嘅結帳測試額外驗證明確確認同已付款。 - 測試重複請求、被拒同過期嘅checkout、資金不足嘅合資格信用、帳戶支出限額、過期嘅令牌、刷新輪換同撤銷嘅授權。
- 喺客戶、訂閱同分析中檢查結果客戶、接受條款同歸因活動。確認敏感憑據同內部組織ID唔會出現喺面向客戶嘅UI中。
- 只包括配置同埋記錄檢查通過嘅平台。排除未完成嘅平台或者移除佢哋；然後喺Dashboard提交應用程式。
當你準備好繼續嘅時候
你嘅整合會區分接受嘅訪問、接受嘅條款、請求嘅付款同確認嘅付款，並處理每個失敗路徑。
組織驗證同計劃訪問
選擇個人或者組織帳戶嚟擁有項目註冊資格，喺申請之前。組織可以喺驗證之前提交申請，但僅僅員工批准唔會激活訪問權限。喺Console嘅入門清單完成組織電郵同公司驗證。一個已批准嘅組織會保持「待驗證」狀態，直到兩個檢查都完成。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 加價同可計費事件引入一齊計算。呢個唔係一個總加價津貼、單獨嘅免費事件配額或者免費嘅 AI inference。賬戶嘅首 1,000 個免費事件唔會消耗呢個津貼。
剩餘嘅事件引入費用會從請求嘅新 Builder 收益中支付，然後係可用嘅 Builder AI 收益同無限制嘅 AI 信用額度中扣除。客戶 AI 收費同產品 payments 會保持分開。
ShareAI 可以批准應用特定嘅費用或者費用支持，係固定時期內或者直到更改為止。請喺 Console 中檢視應用當前嘅定價同特別計劃，了解其批准條款、有效性同已消耗嘅津貼。層級更改或者定價覆蓋唔會重置應用每月嘅使用量。
Launch 保持 ShareAI 登錄為可選。Growth 同 Momentum 要求必須使用；Momentum 仲要求應用頁腳顯示官方嘅 ShareAI for Startups 標誌。ShareAI 每周檢查標誌。確認試圖繞過要求嘅行為可能導致降級、從 Startup Program 移除或者根據接受嘅計劃條款退出 Marketplace。
企業費率由 ShareAI 團隊為 Builder 帳戶配置，並喺達成個性化協議後生效。分配嘅百分比同事件費率適用於未來請求。
查看 Monetization Gateway 價格 · 探索 ShareAI for Startups · 範圍同權限