Skip to content

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

退款與爭議

退款由你主動發起;chargeback / dispute 由持卡人向銀行提出,Stripe 會發 webhook 要你應答。

退款

用 PaymentIntent id 或 Charge id:

stripe.Refund.create(payment_intent="pi_...")

部分退款加 amount=(同樣是最小貨幣單位整數)。退款是非同步的,聽 charge.refunded 或查 Refund 物件狀態,再把你資料庫的訂單標成已退款。

已出貨的實體商品,先在你自己的流程決定能不能退,再呼叫 API。Stripe 不會幫你收回實體貨物。

爭議(Dispute)

事件例如 charge.dispute.created。Dashboard 可上傳物流證明。程式端至少要:

  • 暫停該訂單的加值服務
  • 通知內部人員
  • 依時限在 Dashboard 或 API 提交證據

輸了爭議,錢會被扣回,且可能有爭議費用。預防方式是清楚的商品說明、可查的顧客 email,以及 webhook 準時履約(避免收款了卻沒出貨)。

不要用「再收一筆」當退款

更正金額請用 Refund 或新的調整流程,不要請顧客再刷一筆負向交易。