汇付订单查询接口

引导词

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

• 订单查询、支付查询、查询订单
• /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 | 是 | 原交易请求流水号 |

实现步骤

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

注意事项

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