Skip to content

建立 2026-09-14 更新 2026-09-14

Python SDK

官方套件是 stripe-python。它幫你組 HTTP 請求、處理分頁與錯誤，不必自己對 REST API 簽章。

安裝

pip install stripe

建議固定版本，例如 stripe>=11.0。本機開發可用虛擬環境或 uv。

設定金鑰

不要把金鑰寫死在原始碼。從環境變數讀取：

import os
import stripe

stripe.api_key = os.environ["STRIPE_SECRET_KEY"]

Windows PowerShell：

$env:STRIPE_SECRET_KEY = "sk_test_你的測試金鑰"

macOS / Linux：

export STRIPE_SECRET_KEY=sk_test_你的測試金鑰

較新的寫法是建立 StripeClient：

from stripe import StripeClient

client = StripeClient(os.environ["STRIPE_SECRET_KEY"])

本站範例以 stripe.api_key 為主，因為 Flask 教學與官方舊樣本都還在用，行為相同。

第一個 API 呼叫

確認金鑰有效：列出最近幾筆付款，或建立一個商品。

import os
import stripe

stripe.api_key = os.environ["STRIPE_SECRET_KEY"]

product = stripe.Product.create(name="線上課程體驗券")
price = stripe.Price.create(
    product=product.id,
    unit_amount=100,   # TWD 是零小數幣別，100 代表 NT$100
    currency="twd",
)
print(product.id, price.id)

若出現 No API key provided，代表環境變數沒設成功。若 Invalid API Key，檢查是否貼到空白或用了 live / test 混用。

本機還需要什麼

工具 用途
Python 3.9+（建議 3.12） 執行後端
Flask 或 FastAPI 提供 /create-checkout-session、/webhook
Stripe CLI 把 webhook 轉到 localhost
瀏覽器 打開 Checkout 或自己的付款表單

Stripe CLI 登入後，本機測試 webhook：

stripe listen --forward-to localhost:4242/webhook

終端機會印出 whsec_...，那是本機 webhook 簽章密鑰，和 Dashboard 上線用的密鑰不同。詳見 Webhook 履約。