Bläddra i källkod

docs(汇安融): 260924 版上游规范入库,设计文档记这次变更

- docs/ 下新增 260924 版接入规范(与已在库的 260915 版并列)。
- 设计文档 §3.2 记这次变更:两版 docx 的实测对撞读数(2 处改值 + 新增 1 行 7 格,
  其余 978 格逐字未动)、删除线与红字的分布(唯一被划的一行 6 格 / 20 个 run;
  红字共 3 行 13 格)、由此留下 A/B 两种读法、为什么按超集两个都发,以及新文档
  自己不自洽的地方(pay 参数表、query 参数表、异步通知参数表里 alipay_payment
  一字未动)。

同一份文档里原先按「表N 行N」指的几处位置也换成了按内容可解析的锚点 —— 那份 docx
没有任何表格编号,序号是我编的,两支脚本还编出了不同的号,读者无法复现。
alphaH 3 veckor sedan
förälder
incheckning
e1be6a89d8

+ 21 - 2
docs/superpowers/specs/2026-09-16-har-alipay-channel-design.md

@@ -90,12 +90,30 @@
 
 文档 §5.1/§5.2 的 `method` 备注写成 `kf.jh.stage.trade.*`,与 §4 接口声明表的 Application 列矛盾。demo(`Main.java:13`)传的是 `kf.alipay.trade.query`,故以 `kf.alipay.trade.*` 为准。
 
-> **2026-09-24 订正**:门店创建的 url 上游口头澄清为 `/api/merchant/shop/create`,规范 docx 表 1 的 URL 列(`/api/shop/create`)是上游写错了——上表该行已按澄清值更新。
+> **2026-09-24 订正**:门店创建的 url 上游口头澄清为 `/api/merchant/shop/create`,规范 docx 接口声明表的 URL 列(`/api/shop/create`)是上游写错了——上表该行已按澄清值更新。
 >
 > 同一张表的另四行 method 与 url 严格同构(`kf.X.Y.Z` ↔ `/api/X/Y/Z`),只有门店那行两列同时破例;按同构推 method 本该是 `kf.merchant.shop.create`。但上游**只更正了 url、没提 method**,故 `kf.har.shop.create` 暂留原值——**这是未验证项**,由联调读数判(见 `HarClient#createShop` 的注释与 `HarClientOutboundUrlTest`)。
 >
 > 这是这份 docx 第三次被证实与线上不一致(前两次:URL 列漏 `/kf-alipay-api` 前缀、§58 示例漏 `alipay` 段)。读它的任何一列前先假设可能是旧版。
 
+**业务参数(2026-09-24 第二版规范 260924)**
+
+上游新给了一份《支付宝支付接口接入规范260924.docx》,与 260915 逐格对撞后**只有两处**文本差异:上面那条门店 url,以及下表这处枚举:
+
+| 位置 | 260915 | 260924 |
+|---|---|---|
+| 订单创建参数表 `trade_type` 行 | `alipay_stage:花呗分期 alipay_payment:支付宝支付` | `alipay_stage:花呗分期 alipay_un_stage:支付宝支付` |
+| 订单创建参数表 `biz` 行(新增) | —— | `biz` 业务类型 `varchar(16)`,备注「非分期传:`har_ali_un_stage`」 |
+
+两处标注格式**不同**,所以第二处的范围判不出来:`trade_type` 整行(参数名/描述/类型/必填/备注五格)都被划了红删除线 `<w:strike/>`+`EE0000`,而新增的 `biz` 行是红字**不划线**;全文档共 3 行带红字(这行 6 格、`biz` 行 6 格、门店 url 1 格),带删除线的只有这 1 行(6 格 / 20 个 run)。手工格式,不是修订标记(两份文档 `w:ins`/`w:del` 均为 0)。
+
+- 读法 A:`trade_type` 整行作废,`biz` 取而代之(非分期传 `har_ali_un_stage`)
+- 读法 B:`trade_type` 保留、非分期值改名 `alipay_un_stage`,另加**选填** `biz`
+
+判不出来 ⇒ **两个都发**(`trade_type=alipay_un_stage` 与 `biz=har_ali_un_stage` 并存),哪一半不被认由联调读数指出。`biz` 是**纯透传**字段,后端不推导;非分期的那一个取值由下单表单补上(`order/index.vue`)。
+
+> ⚠️ 新文档**自己不自洽**:`alipay_payment` 在 `kf.alipay.trade.pay` 参数表、`kf.alipay.trade.query` 参数表、异步通知参数表里一字未动,仍是 3 处。跟 `title`/`subject` 那次一样,**以线上为准,不以文档为准**。
+
 ### 3.3 响应
 
 - `response_code`:`10000` 表示成功
@@ -180,7 +198,8 @@
 | `shop_code` / `third_shop_code` | VARCHAR(32) | 平台门店编号 / 商户门店编号 |
 | `price` | NUMERIC(12,2) | 交易金额(元) |
 | `title` | VARCHAR(64) | 商品名称 |
-| `trade_type` | VARCHAR(32) NOT NULL | `alipay_stage`(花呗分期)/ `alipay_payment`(支付宝支付) |
+| `trade_type` | VARCHAR(32) NOT NULL | `alipay_stage`(花呗分期)/ `alipay_un_stage`(支付宝支付) |
+| `biz` | VARCHAR(16) | 业务类型。非分期传 `har_ali_un_stage`(260924 新增,见 §3.2 末) |
 | `stage_num` / `percent` | VARCHAR(8) | 分期期数 / 手续费承担方 |
 | `pay_timeout` | INTEGER | 支付过期时间 |
 | `extra_params` | TEXT | 额外参数 JSON |

BIN
docs/支付宝支付接口接入规范260924.docx