1.重新设置Token验证接口

docs/PlayX-对接文档（积分商城）.md

@@ -71,15 +71,18 @@ flowchart LR
 
 1. 用户在 playX 内打开积分商城入口（iframe）。
 2. playX 前端通过 postMessage 将 **playX 下发的 token**（及必要上下文）传给商城 H5。
-3. 商城 H5 调用商城后端 **`POST /api/v1/mall/verifyToken`**（前端只传 `token`），由商城后端向 playX 的 **Token Verification API**（`PLAYX_ANGPOW_IMPORT_BASE_URL` + `PLAYX_TOKEN_VERIFY_URL`）发起校验。
-4. **前提**：配置 **`playX.verify_token_local_only = false`**，且 **`PLAYX_ANGPOW_IMPORT_BASE_URL`** 已配置为可访问的 playX 基地址。
+3. 商城 H5 调用商城后端 **`POST /api/v1/mall/verifyToken`**（前端只传 `token`），由商城后端向 **Token Verification API** 发起校验。
+4. **前提**：配置 **`playX.verify_token_local_only = false`**，且 **`PLAYX_TOKEN_VERIFY_URL`** 已配置：
+   - **完整 `https://...` URL**（如回调：`https://callback-mallsys.superior3.net/callback/api/mallsys/plx/auth/verify-token`）：商城对该地址 `POST`，Body 仅 **`request_id` + `token`**，无需 `PLAYX_ANGPOW_IMPORT_BASE_URL`。
+   - **相对路径**（如 `/api/v1/auth/verify-token`）：需同时配置 **`PLAYX_ANGPOW_IMPORT_BASE_URL`**，并按商户约定附带 **`merchant_code` / `request_date` / `X-Request-Signature`** 等。
 5. playX 返回 **`user_id`、`username`**（及可选会话过期时间等）。
 6. 商城写入 **`mall_playx_session`**（`session_id` + 上述 `user_id`/`username` + 过期时间），后续 H5 可用 **`session_id`** 或 **`token`（商城临时 token，见模式 B）** 调用资产/领取等接口。
 
 幂等与安全：
 
 - H5 **不要**把 playX 的 `user_id` 当作唯一可信凭据直传下单；**以 token 换 session** 或由商城签发 token 的流程为准。
-- playX 侧 Token Verification API 的鉴权/签名由商城后端完成（`merchant_code/request_date/request_id` + `X-Request-Signature`）；H5 不参与签名计算。
+- 若 `PLAYX_TOKEN_VERIFY_URL` 为**完整 https URL**：对端按回调文档校验，商城后端只组 **`request_id` + `token`**，H5 不参与。
+- 若为**相对路径 + 基地址**商户网关：鉴权/签名由商城后端完成（`merchant_code/request_date/request_id` + `X-Request-Signature`）；H5 不参与签名计算。
 
 #### 4.1.3 模式 B：本地 / 无 playX 环境（商城自校验，不请求 playX）
 
@@ -211,26 +214,46 @@ flowchart LR
 
 ### 5.2 Mall → playX：Token Verification API
 
-- **目的**：商城后端校验 token/session，获取可信 `user_id` 与 `username`。
+- **目的**：商城后端校验 token，获取可信 `user_id` 与 `username`。
 - **Method**：`POST`
-- **Base URL**：`PLAYX_ANGPOW_IMPORT_BASE_URL`（当前联调：`https://plx-uat2.ttwd3.com/en-my/mall`）
-- **Path**：`/api/v1/auth/verify-token`
-- **完整 URL**：`{PLAYX_ANGPOW_IMPORT_BASE_URL}/api/v1/auth/verify-token`
-- **签名 Header**：`X-Request-Signature`（`Base64(HMAC-SHA1(canonical, key))`）
-- **签名明文 canonical**：`merchant_code={merchant_code}&request_date={request_date}&request_id={request_id}&token={token}`
-- **request_date 格式**：Unix 时间戳字符串（秒）
+- **Content-Type**：`application/json`
 
-请求字段说明（当前实现）：
+#### 5.2.1 回调网关（推荐当前联调）
+
+- **完整 URL**：由环境变量 **`PLAYX_TOKEN_VERIFY_URL`** 填完整地址，例如：  
+  `https://callback-mallsys.superior3.net/callback/api/mallsys/plx/auth/verify-token`
+- **请求 Body**：
 
 | 字段名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `merchant_code` | String | 是 | 商户编码，默认 `plx`。 |
-| `request_date` | String | 是 | 请求时间戳（秒）。 |
-| `request_id` | String | 是 | 商城系统生成的唯一请求流水号。 |
-| `token` | String | 是 | 从带有商城的 Iframe `postMessage` 接收到的用户登录凭证。 |
+| `request_id` | String | 是 | 商城生成的请求追踪号。 |
+| `token` | String | 是 | 前端传入的 playX 临时凭证。 |
 
 请求示例：
 
+```json
+{
+  "request_id": "mall_20260319_9f1b6d",
+  "token": "eyJhbGciOi..."
+}
+```
+
+#### 5.2.2 商户网关（相对路径 + HMAC）
+
+- **Base URL**：`PLAYX_ANGPOW_IMPORT_BASE_URL`
+- **Path**：`PLAYX_TOKEN_VERIFY_URL`（相对路径，如 `/api/v1/auth/verify-token`）
+- **完整 URL**：`{PLAYX_ANGPOW_IMPORT_BASE_URL}{PLAYX_TOKEN_VERIFY_URL}`
+- **签名 Header**：`X-Request-Signature`（`Base64(HMAC-SHA1(canonical, key))`）
+- **签名明文 canonical**：`merchant_code={merchant_code}&request_date={request_date}&request_id={request_id}&token={token}`
+- **request_date**：Unix 时间戳字符串（秒）
+
+| 字段名 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `merchant_code` | String | 是 | 商户编码。 |
+| `request_date` | String | 是 | 请求时间戳（秒）。 |
+| `request_id` | String | 是 | 商城系统生成的唯一请求流水号。 |
+| `token` | String | 是 | 用户登录凭证。 |
+
 ```json
 {
   "merchant_code": "plx",