File contents 汇付订单查询接口
引导词
当开发者提到以下关键词时,本技能将被触发:
订单查询、支付查询、查询订单
/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
返回结果
注意事项
需要传入原交易的请求日期和请求流水号
可用于确认支付状态后再进行业务处理
建议在异步通知处理时同步调用查询接口进行二次确认
1 --- 2 name: huifu-order-query 3 description: Huifu Order Query 4 --- 5 6 # 汇付订单查询接口 7 8 ## 引导词 9 10 当开发者提到以下关键词时,本技能将被触发: 11 12 - 订单查询、支付查询、查询订单 13 - /hfpay/queryorderinfo 14 - 汇付订单状态、支付状态查询 15 - 托管支付查询 16 17 ## 前置检查(重要) 18 19 在开始编写代码之前,必须先检查项目是否已安装汇付SDK依赖。 20 21 ### 步骤1:检查依赖 22 23 检查项目的 pom.xml 文件中是否包含 `dg-java-sdk` 依赖: 24 25 ```xml 26 <dependency> 27 <groupId>com.huifu.bspay.sdk</groupId> 28 <artifactId>dg-java-sdk</artifactId> 29 <version>${dg-java-sdk.version}</version> 30 </dependency> 31 ``` 32 33 ### 步骤2:安装依赖(如未安装) 34 35 如果项目中没有该依赖,需要先在 pom.xml 中添加上述依赖,然后执行 Maven 安装: 36 37 ```bash 38 mvn clean install 39 ``` 40 41 或在 IDE 中刷新 Maven 项目。 42 43 ### 步骤3:验证依赖 44 45 确认以下类可以正常导入: 46 - `com.huifu.bspay.sdk.opps.core.BasePay` 47 - `com.huifu.bspay.sdk.opps.core.config.MerConfig` 48 - `com.huifu.bspay.sdk.opps.core.net.BasePayRequest` 49 - `com.huifu.bspay.sdk.opps.core.utils.DateTools` 50 - `com.huifu.bspay.sdk.opps.core.utils.SequenceTools` 51 52 **只有完成以上前置检查后,才能继续按照 reference 目录中的示例代码进行开发。** 53 54 ## 接口说明 55 56 | 属性 | 值 | 57 |-----|-----| 58 | 接口路径 | `/hfpay/queryorderinfo` | 59 | 请求方式 | POST | 60 | Content-Type | application/json | 61 | 汇付API端点 | `v2/trade/hosting/payment/queryorderinfo` | 62 63 ## 功能说明 64 65 查询订单支付状态和详细信息,包括交易状态、金额、时间等。 66 67 ## 请求参数 68 69 | 参数名 | 类型 | 必填 | 说明 | 70 |-------|------|-----|------| 71 | huifuId | String | 是 | 商户号 | 72 | org_req_date | String | 是 | 原交易请求日期(格式:yyyyMMdd) | 73 | org_req_seq_id | String | 是 | 原交易请求流水号 | 74 75 ## 实现步骤 76 77 1. 初始化商户配置(MerConfig) 78 2. 组装请求参数(包含原交易信息) 79 3. 调用汇付API 80 4. 返回结果 81 82 83 ## 注意事项 84 85 1. 需要传入原交易的请求日期和请求流水号 86 2. 可用于确认支付状态后再进行业务处理 87 3. 建议在异步通知处理时同步调用查询接口进行二次确认
dvcrn/openclaw-skills-marketplace/tree/main/plugins/yangyubin1--huifu-order-query/skills/huifu-order-query commit d0051a148c
Frequently asked questions How do I install the Huifu Order Query skill? Run npx skillmds@latest add dvcrn/huifu-order-query in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Huifu Order Query skill do? Huifu Order Query It is listed under Coding & Dev Tools on SkillMD.
Is Huifu Order Query safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Huifu Order Query? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Huifu Order Query free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Huifu Order Query? dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.