diff --git a/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/DaxpayUnipayApp.java b/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/DaxpayUnipayApp.java
index 985075610..240e43a92 100644
--- a/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/DaxpayUnipayApp.java
+++ b/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/DaxpayUnipayApp.java
@@ -5,7 +5,7 @@ import org.springframework.context.annotation.ComponentScan;
 
 /// # 开放支付端装配入口
 ///
-/// 扫描 unipay 模块（trade / gateway / client），注册开放 API 与公开 H5 控制器。
+/// 扫描 unipay 模块（trade 商户开放 API / client 公开 H5），注册控制器。
 /// 支付编排在 daxpay-payment-core（trade.runtime.service.pay.*）；本模块不反向被内核依赖。
 @AutoConfiguration
 @ComponentScan
diff --git a/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/gateway/controller/UniGatewayPayController.java b/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/trade/controller/UniGatewayPayController.java
similarity index 86%
rename from daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/gateway/controller/UniGatewayPayController.java
rename to daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/trade/controller/UniGatewayPayController.java
index a75643043..766c27efa 100644
--- a/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/gateway/controller/UniGatewayPayController.java
+++ b/daxpay-payment/daxpay-payment-unipay/src/main/java/cn/daxpay/open/payment/unipay/trade/controller/UniGatewayPayController.java
@@ -1,4 +1,4 @@
-package cn.daxpay.open.payment.unipay.gateway.controller;
+package cn.daxpay.open.payment.unipay.trade.controller;
 
 import cn.daxpay.open.payment.unipay.aop.PaymentVerify;
 import cn.daxpay.open.payment.common.result.DaxResult;
@@ -19,6 +19,9 @@ import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 /// # 网关支付开放接口
+///
+/// 商户签名 API（`@PaymentVerify`），与 [UniTradeController] 等同属 trade 开放层；
+/// 产品语义「网关支付」体现在 URL `/unipay/gateway` 与 param/result.gateway，而非独立 controller 包。
 @PaymentVerify
 @IgnoreAuth
 @Tag(name = "网关支付接口")