~/VibeHandbook
免費 PDF

金流

stripe.com

Stripe

它是什麼

想像收銀臺上的刷卡機——它讀取顧客的卡、把錢轉走。Stripe 就是軟體版的刷卡機:一個支付處理服務。它是一套「(Application Programming Interface,應用程式程式設計介面,讓程式彼此對話的方式)」和控制台,讓你的應用能夠接受信用卡、電子錢包和銀行付款,然後管理訂閱、發票和打款。它是開發者的預設選擇,因為其 API 乾淨利落、文件出色,而且幾乎每篇教程和每個庫都預設使用它。你把它接入應用,客戶付款,錢就到了你的銀行賬戶。

優勢

  • 一流的開發者體驗——清晰的 API、測試模式和優秀的文件。
  • 龐大的生態系統:「SDK(Software Development Kit,軟體開發工具包,現成的程式碼包)」、預製的結賬頁、計費功能以及第三方整合。
  • 足夠靈活,能應對一次性收款、訂閱、平臺市場和按用量計費。
  • 強大的反欺詐工具(Radar),以及可靠且文件完善的「webhook(網路鉤子,支付事件發生時自動發來的通知)」。
  • 支援眾多國家和貨幣。

取捨

  • 它是支付處理服務,而非記錄商戶。記錄商戶「MoR()」是在法律上充當賣方、替你處理收據和稅務的公司;Stripe 不是這樣的角色。用 Stripe 時,才是法定賣方,因此徵收並上繳銷售稅和「VAT(Value Added Tax,增值稅,許多國家採用的一種銷售稅)」是你的責任(Stripe Tax 可幫你計算,但仍需你自己申報)。
  • 比託管店鋪需要更多設定;流程中更多部分要靠你自己搭建。
  • 隨著業務增長,合規、拒付(chargeback)和稅務登記都會落到你身上。

何時使用

當你想對支付流程擁有最大掌控權,並且願意自行承擔稅務合規時,就選 Stripe;或者當你要構建託管店鋪無法表達的東西時——平臺市場、計量計費、複雜訂閱,或深度定製的結賬流程。

與 vibe coding 的契合度

Stripe 是最適合 AI 的支付選項,因為 AI 助手見過成千上萬的 Stripe 示例,所以它能快速搭建結賬、webhook 和客戶門戶。這裡的 是 Stripe 在支付事件發生時自動發給你應用的訊息,於是你的應用能自行響應。問題在於,AI 助手會樂呵呵地接好收款邏輯,卻忘了你現在要在幾十個司法轄區繳稅。請明確告知:告訴它你是否想改用記錄商戶方案,並始終驗證 webhook 簽名。同時要以冪等方式處理事件——也就是說,確保同一個事件到達兩次也不會重複扣款或重複解鎖。上線前用 Stripe 的測試卡測試。

// Create a Checkout Session (server-side)
import Stripe from "stripe";
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);

const session = await stripe.checkout.sessions.create({
  mode: "payment",
  line_items: [{ price: "price_123", quantity: 1 }],
  success_url: "https://example.com/thanks",
  cancel_url: "https://example.com/cancel",
});
// redirect the customer to session.url