1. 维护代码健壮

2. 更新项目结构文档

app/http/admin/controller/trade/PayOrderController.php

@@ -11,7 +11,7 @@ use support\Response;
 /**
  * 支付订单管理控制器。
  *
- * 当前先提供列表查询，后续可以继续扩展支付单详情、关闭、重试等管理操作。
+ * 当前提供列表查询和详情查看，便于后台直接排查支付链路。
  *
  * @property PayOrderService $payOrderService 支付订单服务
  */
@@ -42,6 +42,24 @@ class PayOrderController extends BaseController
 
         return $this->success($this->payOrderService->paginate($data, $page, $pageSize));
     }
+
+    /**
+     * 查询支付订单详情。
+     *
+     * @param Request $request 请求对象
+     * @param string $payNo 支付单号
+     * @return Response 响应对象
+     */
+    public function show(Request $request, string $payNo): Response
+    {
+        $this->validated(
+            array_merge($request->all(), ['pay_no' => $payNo]),
+            PayOrderValidator::class,
+            'show'
+        );
+
+        return $this->success($this->payOrderService->detail($payNo));
+    }
 }