台灣注意事項
Stripe 支援 TWD。能否開正式帳號、款項如何撥到台灣銀行,以你申請當下的 Stripe 支援國家 與 Dashboard 指引為準,本頁只記寫程式時一定會碰到的差異。
TWD 是零小數幣別
unit_amount=199 就是 NT$199,不要再乘 100。細節與程式範例見 金額與幣別。
3D Secure(SCA)
台灣發卡行常要求額外驗證。Checkout 與 Payment Element 會自動跳出銀行畫面。你需要:
- 提供正確的
return_url/success_url - 用測試卡
4000 0025 0000 3155演練一次 - 履約仍聽 webhook,因為使用者可能在銀行頁面關掉視窗
不要自己實作 3DS 跳轉邏輯,交給 Stripe.js。
付款方式
信用卡是預設。Apple Pay / Google Pay 等需在 Dashboard 開啟,並滿足網域驗證與 HTTPS。Payment Element 開了 automatic_payment_methods 後,Dashboard 勾選即可出現在表單,不必改 Python。
稅與發票
Stripe Tax 是否涵蓋台灣加值型營業稅,請查當前 Stripe Tax 支援地區。許多台灣賣家在自己系統開立發票,只把統編放在 Checkout custom_fields 或 metadata。不要假設 Stripe 收據等於財政部電子發票。
測試與正式
先用測試模式把 TWD 金額、成功/失敗/3DS 都跑過。切 live 金鑰前走完 上線檢查清單。