# Payment Kit 清理任务清单（2026-05）

> 2026-04-13 与叶小芳走查 + 2026-05-14 CF 迁移 staging 测试发现的问题汇总。每一条都对应一个 GitHub issue，做完打勾。

## 🔴 Bug

- [x] [#1357](https://github.com/blocklet/payment-kit/issues/1357) Customer Search 选择器输入 'a'/'w' 等字符触发下拉关闭 — TextField 加 `onKeyDown stopPropagation`，team `1ae68ff6` / 个人 `690c1ef6`
- [x] [#1344](https://github.com/blocklet/payment-kit/issues/1344) **P0** Off-chain credits 退款后 grant 未回滚 — 已修复 commit `6b96a8b9`，已部署
- [x] [#1349](https://github.com/blocklet/payment-kit/issues/1349) CF staging GET /api/tax-rates 500 — 已修复 commit `6b96a8b9`（同上），已部署
- [x] [#1345](https://github.com/blocklet/payment-kit/issues/1345) 退款 UI "最大可退"金额四舍五入 — 已修复（floor 替代 round），部署 team `f3464352` / 个人 `e2584c83`
- [x] [#1351](https://github.com/blocklet/payment-kit/issues/1351) CF Workers runtime hang 偶发 — 已部分缓解（getTokenLimits/getTokenRequirements 并行化）team `530b3bec` / 个人 `c5f2ee68`；监控冷启动 hang 是否还出现
- [x] [#1356](https://github.com/blocklet/payment-kit/issues/1356) 一次性支付显示成功但页面展示失败 — parseChainError 加 `GAS_PAYER_NOT_ON_CHAIN` 分支，team `1c17d48e` / 个人 `db0d13fd`；待用户复现验证

## 🟠 功能缺口

- [ ] [#1358](https://github.com/blocklet/payment-kit/issues/1358) 欠费账单允许切换支付方式 — P2
- [ ] [#1359](https://github.com/blocklet/payment-kit/issues/1359) 滑点配置展示"最坏情况下要付多少 TBA" — P3
- [ ] [#1360](https://github.com/blocklet/payment-kit/issues/1360) 滑点超出后主动告警通知 — P3

## 🟡 历史代码清理（CF Workers bundle 瘦身）

- [ ] [#1361](https://github.com/blocklet/payment-kit/issues/1361) 砍掉通行证 / Passport 功能
- [ ] [#1362](https://github.com/blocklet/payment-kit/issues/1362) 评估并砍掉定价表 (Pricing Table)
- [ ] [#1363](https://github.com/blocklet/payment-kit/issues/1363) 砍掉计量服务 (Metering Service)
- [ ] [#1364](https://github.com/blocklet/payment-kit/issues/1364) 砍掉 DID Names 批量订阅 (group subscription)
- [ ] [#1365](https://github.com/blocklet/payment-kit/issues/1365) 评估 setup 支付类型是否还需要

## ⚠️ 产品决策类

- [ ] [#1366](https://github.com/blocklet/payment-kit/issues/1366) 税费组件半成品：做完含税计算或砍掉

## 🧹 运维 / 数据清理

- [ ] [#1367](https://github.com/blocklet/payment-kit/issues/1367) 清理 staging 上 0 ABT 旧版按量订阅僵尸数据

## 🟢 文档

- [ ] [#1368](https://github.com/blocklet/payment-kit/issues/1368) Payment Kit 数据表 ER 关系图
- [ ] [#1369](https://github.com/blocklet/payment-kit/issues/1369) 订阅变更流程 (Change Plan/Currency/Payer) 详细文档
- [ ] [#1370](https://github.com/blocklet/payment-kit/issues/1370) 各业务方 past_due 状态处理规则文档
- [ ] [#1371](https://github.com/blocklet/payment-kit/issues/1371) Gas-payer JWT / Stake-for-gas 机制文档

## ✅ 已完成 / 已关闭（追溯）

- ✅ 钱包侧 hash mismatch bug（ArcWallet Android `AuthPresenter.kt:1716`）—— 钱包团队已修
- ✅ Payment Kit `getGasPayerExtra` 临时 merchant 自签 fix —— 已 revert (`f6aaf7f6`)，钱包修好后不需要
- ✅ [#1178](https://github.com/blocklet/payment-kit/issues/1178) 快捷支付未考虑 gas 资金 — 关闭（链上机制设计正确，钱包侧已修，详见关闭评论）

## 推荐处理顺序

1. **P0**：#1344（钱出错）
2. **CF 阻塞性 P1**：#1349、#1345、#1351
3. **看起来好修的 P2**：#1357（搜索框）、#1358（切支付方式）
4. **清理减包体**（CF 包大小敏感）：#1361 → #1362 → #1363 → #1364 → #1365 顺序做
5. **产品决策**：#1366（税费），决定后顺手关 #1349 如果决定砍税费
6. **文档** + 运维数据：#1367、#1368、#1369、#1370、#1371

## 维护说明

- 做完一项把 `[ ]` 改成 `[x]` 并附 commit / PR 链接
- 新发现的问题先建 GitHub issue 再加到本文件
- 本文件存活到所有上面任务关闭，然后可删
