Bladeren bron

docs(开放文档): 章节与通道名去门店,响应接口删门店键

隐藏门店(2026-10-09)的文档与前端接入面。

- har-openapi.md:10/11 两章标题去「门店与订单」;概述行内举例「多门店
  主体」改「多经营主体」。⚠️ 标题与 harDoc.ts 的 parts 逐字耦合(切片器
  精确匹配),改标题必须同步,否则该条在侧边栏静默消失——本提交已同步;
- collection-openapi.md:通道名改「支付宝收单通道」(通道一览与交叉引用
  两处)、删「创建门店」表行;「五类能力,共 11 个接口」改「四类能力,
  共 10 个接口」。开放 API /shop/create 端点保留活体、文档从简(B 批
  先例);收款链接一节的「固定门店」是银联通道泛化业务用语,保留;
- har.ts:HarOrderVO 响应接口删两键(原位留注释:自 2026-10-09 起响应
  不含这两键;请求侧仍可传,见 HarOrderCreateParams);index.vue 无日期
  的现状注释同步通道名(带日期的历史记录注释不动)。

锚点核对(logs/_doc-anchor-check.py):harDoc 2 条 + collectionDoc 16 条
parts 与 md 标题逐字全中。dist 词普查(logs/_dist-finalize-shophide.py):
门店与订单/门店主体/共 11 个接口/门店表行 1→0,「本章接口路径前缀」与
merchant_code 句保留(正控)。
alphaH 5 dagen geleden
bovenliggende
commit
c2ca495c1b

+ 1 - 2
frontend/src/api/module_payment/har.ts

@@ -145,8 +145,7 @@ export interface HarOrderVO {
   upstream_order_no?: string;
   platform_trade_no?: string;
   merchant_code?: string;
-  shop_code?: string;
-  third_shop_code?: string;
+  // 自 2026-10-09 起响应不含门店两键(shop_code / third_shop_code);请求侧仍可传,见 HarOrderCreateParams
   price: string;
   title?: string;
   /** alipay_stage=花呗分期 / alipay_un_stage=支付宝支付(260924 前叫 alipay_payment) */

+ 1 - 1
frontend/src/views/module_payment/apikey/collectionDoc.ts

@@ -2,7 +2,7 @@
  * 《收付款 OpenAPI 接入文档》的侧边栏条目定义(正文 `docs/collection-openapi.md`)。
  *
  * 切片逻辑在 `docSlicer.ts`,本文件只写「哪些标题拼成哪一条」。
- * 另一条通道(门店与订单)是独立产品、独立文档,见 `harDoc.ts` 与 `docs/har-openapi.md`。
+ * 另一条通道(支付宝收单)是独立产品、独立文档,见 `harDoc.ts` 与 `docs/har-openapi.md`。
  */
 import raw from "./docs/collection-openapi.md?raw";
 import { buildSections, type DocSectionDef } from "./docSlicer";

+ 1 - 1
frontend/src/views/module_payment/apikey/docSlicer.ts

@@ -3,7 +3,7 @@
  *
  * 两条通道各有一份 md、各有一组 SECTIONS,共用本文件:
  * 收付款见 `collectionDoc.ts`(`docs/collection-openapi.md`),
- * 门店与订单见 `harDoc.ts`(`docs/har-openapi.md`)。
+ * 支付宝收单见 `harDoc.ts`(`docs/har-openapi.md`)。
  *
  * md 是唯一真相,本文件不复制任何正文 —— 改 md,页面跟着变,不存在「文档改了页面没改」。
  */

+ 3 - 4
frontend/src/views/module_payment/apikey/docs/collection-openapi.md

@@ -9,7 +9,7 @@
 
 ## 1. 概述
 
-平台提供五类能力,共 11 个接口,分属**两条通道**。
+平台提供四类能力,共 10 个接口,分属**两条通道**。
 
 **收付款通道 —— 路径前缀 `/payment/openapi/pay`(详解见 5)**
 
@@ -24,11 +24,10 @@
 | 退款 | 退款查询 | `POST /payment/openapi/pay/refund/query` |
 | 收款 | 收款链接 —— 生成一条**顾客自填金额**的收款页链接(桌牌 / 菜单用) | `POST /payment/openapi/pay/checkout/link` |
 
-**门店与订单通道 —— 路径前缀 `/payment/openapi/alipay`(详解见 10)**
+**支付宝收单通道 —— 路径前缀 `/payment/openapi/alipay`(详解见 10)**
 
 | 能力 | 场景 | 接口 |
 |---|---|---|
-| 门店 | 创建门店 | `POST /payment/openapi/alipay/shop/create` |
 | 收款 | 下单收款(被扫 / 主扫由 `auth_code` 决定) | `POST /payment/openapi/alipay/order/create` |
 | 查询 | 订单查询 | `POST /payment/openapi/alipay/order/query` |
 
@@ -44,7 +43,7 @@
 |---|---|
 | `api_key` | 你的身份标识,放在 `Authorization` 头 |
 | `api_secret` | 签名密钥,**只用于本地计算签名,任何情况下都不上网传输** |
-| 商户号(`merchant_code`) | 该 `api_key` 名下可用的商户号。**一个租户可以有多个**:只有一个时什么都不用传,有多个时**下单**要用 `merchant_code` 指定用哪一个(收付款通道见 5.1;门店与订单通道见 10 章) |
+| 商户号(`merchant_code`) | 该 `api_key` 名下可用的商户号。**一个租户可以有多个**:只有一个时什么都不用传,有多个时**下单**要用 `merchant_code` 指定用哪一个(收付款通道见 5.1;支付宝收单通道见 10 章) |
 
 还需向平台方提供一个**回调地址**(`notify_url`),或在下单时逐笔传入。
 

+ 3 - 3
frontend/src/views/module_payment/apikey/docs/har-openapi.md

@@ -1,10 +1,10 @@
-## 10. 门店与订单接口
+## 10. 订单接口
 
 本章接口路径前缀 `/payment/openapi/alipay`;请求头与签名算法(3.2 / 3.3)逐字适用,错误处理总则(3.6)同样适用。
 
 **关于寻址**:本章三个接口都按**你这条 API Key 所属的租户账号**寻址,取该租户名下由平台运营报备好的商户配置。你不需要在请求里指定归属。
 
-**关于 `merchant_code`(新增,2026-09-24)**:平台**允许一个租户报备多个商户号**(例如你名下有多家门店主体,各自独立结算)。这时「这笔钱收进哪一个商户」必须由你在请求里说清楚,用 `merchant_code` 指定。
+**关于 `merchant_code`(新增,2026-09-24)**:平台**允许一个租户报备多个商户号**(例如你名下有多家经营主体,各自独立结算)。这时「这笔钱收进哪一个商户」必须由你在请求里说清楚,用 `merchant_code` 指定。
 
 - **不传** ⇒ 平台取你租户名下的商户配置。
 - **传了** ⇒ 一律以它为准,且必须是你租户名下已报备的编号,否则返回 404。
@@ -229,7 +229,7 @@ Content-Type: application/x-www-form-urlencoded
 
 ---
 
-## 11. 门店与订单通道的联调检查清单
+## 11. 订单通道的联调检查清单
 
 - [ ] 认证与签名复用 3.3 的实现,先跑通 3.4 的样例
 - [ ] `price` 用**元**、写成最简小数(不要 `1.50`、`0.010`)

+ 1 - 1
frontend/src/views/module_payment/apikey/harDoc.ts

@@ -19,7 +19,7 @@ const SECTIONS: DocSectionDef[] = [
   {
     key: "har_endpoints",
     title: "接口与联调",
-    parts: ["## 10. 门店与订单接口", "## 11. 门店与订单通道的联调检查清单"],
+    parts: ["## 10. 订单接口", "## 11. 订单通道的联调检查清单"],
   },
 ];
 

+ 1 - 1
frontend/src/views/module_payment/apikey/index.vue

@@ -1362,7 +1362,7 @@ echo "签名验证结果: " . ($isValid ? '有效' : '无效') . "\n";
               </div>
 
               <!--
-                md 切出来的条目(收付款 / 门店与订单两条通道)——
+                md 切出来的条目(银联收单 / 支付宝收单两条通道)——
                 正文由 MarkdownRenderer 渲染切片器切出的片段。
                 这里刻意不写任何接口细节:页面上的每个字段名都来自那份 md,
                 而 md 的签名样例与字段名由 Java 侧契约测试钉住。