退款與爭議
退款由你主動發起;chargeback / dispute 由持卡人向銀行提出,Stripe 會發 webhook 要你應答。
退款
用 PaymentIntent id 或 Charge id:
部分退款加 amount=(同樣是最小貨幣單位整數)。退款是非同步的,聽 charge.refunded 或查 Refund 物件狀態,再把你資料庫的訂單標成已退款。
已出貨的實體商品,先在你自己的流程決定能不能退,再呼叫 API。Stripe 不會幫你收回實體貨物。
爭議(Dispute)
事件例如 charge.dispute.created。Dashboard 可上傳物流證明。程式端至少要:
- 暫停該訂單的加值服務
- 通知內部人員
- 依時限在 Dashboard 或 API 提交證據
輸了爭議,錢會被扣回,且可能有爭議費用。預防方式是清楚的商品說明、可查的顧客 email,以及 webhook 準時履約(避免收款了卻沒出貨)。
不要用「再收一筆」當退款
更正金額請用 Refund 或新的調整流程,不要請顧客再刷一筆負向交易。