huifu-order-query

面向 Java 后端项目的汇付托管支付订单查询接口接入指引：先检查 pom.xml 中的 dg-java-sdk 依赖并执行 Maven 安装，再按 /hfpay/queryorderinfo 接口传入商户号与原交易日期、流水号，调用汇付 API 查询订单支付状态，可用于异步通知后的二次确认。

yangyubin1

热度 63.34

最近更新 2026-05-11 17:31:16

分类：开发依赖：代码执行 / 读写文件 / 第三方 API应用场景：API 集成 / 代码生成 / 财务

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add huifu-order-query

Metadata

name: huifu-order-query
description: [后端项目使用]汇付托管交易订单查询接口技能。用于查询订单支付状态和详细信息。当用户提到订单查询、支付查询、/hfpay/queryorderinfo时触发。

汇付订单查询接口

引导词

当开发者提到以下关键词时，本技能将被触发：

订单查询、支付查询、查询订单
/hfpay/queryorderinfo
汇付订单状态、支付状态查询
托管支付查询

前置检查（重要）

在开始编写代码之前，必须先检查项目是否已安装汇付SDK依赖。

步骤1：检查依赖

检查项目的 pom.xml 文件中是否包含 dg-java-sdk 依赖：

<dependency>
    <groupId>com.huifu.bspay.sdk</groupId>
    <artifactId>dg-java-sdk</artifactId>
    <version>${dg-java-sdk.version}</version>
</dependency>

步骤2：安装依赖（如未安装）

如果项目中没有该依赖，需要先在 pom.xml 中添加上述依赖，然后执行 Maven 安装：

mvn clean install

或在 IDE 中刷新 Maven 项目。

步骤3：验证依赖

确认以下类可以正常导入：

com.huifu.bspay.sdk.opps.core.BasePay
com.huifu.bspay.sdk.opps.core.config.MerConfig
com.huifu.bspay.sdk.opps.core.net.BasePayRequest
com.huifu.bspay.sdk.opps.core.utils.DateTools
com.huifu.bspay.sdk.opps.core.utils.SequenceTools

只有完成以上前置检查后，才能继续按照 reference 目录中的示例代码进行开发。

接口说明

属性	值
接口路径	`/hfpay/queryorderinfo`
请求方式	POST
Content-Type	application/json
汇付API端点	`v2/trade/hosting/payment/queryorderinfo`

功能说明

查询订单支付状态和详细信息，包括交易状态、金额、时间等。

请求参数

参数名	类型	必填	说明
huifuId	String	是	商户号
org_req_date	String	是	原交易请求日期（格式：yyyyMMdd）
org_req_seq_id	String	是	原交易请求流水号

实现步骤

初始化商户配置（MerConfig）
组装请求参数（包含原交易信息）
调用汇付API
返回结果

注意事项

需要传入原交易的请求日期和请求流水号
可用于确认支付状态后再进行业务处理
建议在异步通知处理时同步调用查询接口进行二次确认