付款與扣款流程
目的
這裡整理跨 API / 跨資料表的付款、扣款、交易與金流排查規則。
這類文件不應放在單一 API migration 文件裡，因為同一段扣款主線通常會被多支 API 共用。例如 quote_bids 的聯絡扣款會同時出現在：
- consumer 正式聯絡 provider
- provider 接受 narrow match invitation
- auto quote / new leads 聯絡流程
目前文件
| 文件 | 說明 |
|---|---|
| quote_bid_contact_charge | quote_bids 正式聯絡 provider 後的 provider 扣款、wallet、card、TapPay prime、transaction 與排查順序 |
適合放在這裡的內容
- wallet / credit card / TapPay / Stripe 這類付款分支
transactions寫入與 paid / unpaid 狀態轉換- 金流 response 與 API error mapping
- payment log / application log 的排查順序
- 多支 API 共用的扣款 helper 或 domain method
不適合放在這裡的內容
- 單支 API 的完整 guard 順序
- 單一 table 欄位定義
- queue / event payload 細節
- 一次性的 curl 測試紀錄
這些內容應該分別放在 API migration、資料表流程、Queue 與 Event 系統，或案例文件。