API 接口文档

订单查询
现代化接入指南

根据平台订单号或商户订单号查询支付状态与订单金额。你可以根据页面说明配置请求参数、签名字段、回调地址，并完成支付业务闭环。

返回文档首页支付测试

接入流程

1. 获取商户ID和密钥控制台

2. 组装接口参数参数

3. 生成签名并请求签名

4. 接收回调并验签通知

订单查询接口参数

以下内容来自原开发文档，已保留请求地址、请求参数、返回参数和示例说明。

订单查询

请求地址：

https://www.17yf.cn/api/pay/query

请求方式：

POST

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
商户ID	pid	是	Int	1001
平台订单号	trade_no	特殊	String	20160806151343349	与商户订单号必传其一
商户订单号	out_trade_no	特殊	String	20160806151343351	与平台订单号必传其一
当前时间戳	timestamp	是	String	1721206072	10位整数，单位秒
签名字符串	sign	是	String		参考签名规则
签名类型	sign_type	是	String	RSA	默认为RSA

返回参数说明：

字段名	变量名	类型	示例值	描述
返回状态码	code	Int	0	0为成功，其它值为失败
错误信息	msg	String		失败时返回原因
平台订单号	trade_no	String	20160806151343349
商户订单号	out_trade_no	String	20160806151343351
接口订单号	api_trade_no	String	40001249985198893	微信支付宝返回的单号
支付方式	type	String	alipay	支付方式列表
支付状态	status	Int	1	支付状态列表
商户ID	pid	Int	1001
订单创建时间	addtime	String	2024-07-01 16:47:32
订单完成时间	endtime	String	2024-07-01 16:49:24	仅完成才返回
商品名称	name	String
商品金额	money	String	1.00
已退款金额	refundmoney	String		仅部分退款情况才返回
业务扩展参数	param	String
支付用户标识	buyer	String		一般为openid
支付用户IP	clientip	String
当前时间戳	timestamp	String	1721206072	10位整数，单位秒
签名字符串	sign	String		参考签名规则
签名类型	sign_type	String	RSA	默认为RSA

支付状态列表

状态值	描述
0	未支付
1	已支付
2	已退款
3	已冻结
4	预授权

更多接口

快速切换到其他文档模块。

支付提交订单查询异步通知 SDK 示例