跳至正文
TurnitPass
開發者中心API v1管理金鑰
瀏覽文件

開發者帳單

串接結帳與方案額度限制

結帳流程、客戶入口網頁、Webhook 與方案字數上限皆已接通,正式上線時設定 Stripe 金鑰即可。

REST API v1

開發者平台

總覽

工作台
POST/api/billing/checkout
依帳戶隔離
結帳請求範例
POST /api/billing/checkout
fetch('/api/billing/checkout', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ plan: 'pro', cycle: 'monthly' })
})

說明

01

結帳流程

設定金鑰與價格 ID 後,選取方案即可發起結帳。

02

客戶入口

已訂閱用戶可進入專屬的 Stripe 客戶入口管理帳務。

03

Webhook

帳單事件即時儲存,確保與工作台訂閱狀態同步。

帳務流程

使用者完成升級後的自動處理機制

1

選取方案

價格頁面決定訂閱方案、計費週期、額度、API 權限與結帳說明。

2

前往結帳

設定完成後將引導至 Stripe Checkout 建立付款工作階段。

3

接收 Webhook

Stripe 發送訂閱事件通知,系統自動更新帳戶方案與可用字數。

4

入口維護

訂閱用戶可隨時回到客戶入口更換信用卡、下載發票、取消或調整方案。

上線設定

正式上線前需確認的各項配置

結帳金鑰
結帳必備伺服器端用於建立結帳與入口網頁階段的金鑰。
Webhook 簽章金鑰
Webhook 必備用於在更新帳戶權限前校驗帳單事件的真實性。
價格 ID
依方案配置月繳與學期方案的價格識別碼於頁面文案之外獨立設定。
網站 URL
標準網址用於結帳完成後的跳轉、網站地圖與線上連結。
實作說明。 Stripe 認證與登入憑證皆保持外部環境變數設定,前端絕不包含伺服器端金鑰。
下一步,把它接到你的工作流程。繼續閱讀