為產品同訂閱付款
建立一個錢包結算，讓客戶喺 ShareAI 確認，再驗證支付結果先執行。
喺呢頁面
喺使用場景中啟用「用 ShareAI 付款」。喺訂閱計劃中，揀「免費發佈」畀一次性購買，無需訂閱或者 AI 附加費。或者發佈你嘅訂閱計劃。客戶連接佢哋嘅錢包時接受呢份合約；每次付款都會單獨確認。
啟用「用 ShareAI 付款」並獲取客戶 OAuth token payments。對於訂閱，發佈一個訂閱計劃，並讓客戶接受。金額係準確嘅以歐元為單位嘅錢包信用字符串；唔好傳送浮點數計算。
POST
https://api.shareai.now/api/v1/console/builder/payments創建一個待處理嘅結帳請求
- 基礎 URL
https://api.shareai.now- 認證
- 客戶 OAuth Bearer token
- 必需範圍
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 會顯示應用程式、購買內容、金額同付款人。只有明確授權嘅確認先會扣除錢包金額。打開連結唔會扣款。
- 用相同嘅客戶 token 再次讀取付款。只有喺狀態係「已付款」後先履行；唔好單憑瀏覽器嘅成功消息。
GET
https://api.shareai.now/api/v1/console/builder/payments?id={payment_id}讀取你客戶嘅付款
- 基礎 URL
https://api.shareai.now- 認證
- 客戶 OAuth Bearer token
- 必需範圍
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 賬戶。信用不足會令付款未扣款；客戶可以喺充值後重試，只要結帳同授權仍然有效。
每次續訂都需要新嘅結帳同客戶確認。活躍嘅訂閱周期唔可以重複收費。確認時原始授權必須仍然有效；如果 token 過期，請刷新並創建新請求。
請求範圍限於 OAuth 客戶端同客戶。產品同訂閱收益會同 AI 附加費收益分開記錄，並有 45 日嘅審核期。Builder 嘅默認 1.5% 費用只適用於 AI 附加費收益。
控制台分析 → 付款 列出付款狀態、每日總額同釋放狀態。 混合計劃條款.
最後更新日期：2026 年 9 月 18 日