易码付-查询订单

应用场景

商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。查询订单状态可通过[易码付平台订单号]或[商户订单号]两种方式查询。

接口链接

请求方式：POST

URL地址：{BASE_URL}/v1/transactions/orderid.html

请求参数

字段名	变量名	必填	类型	示例值	描述
应用ID	app_id	是	String	app_9ba59abbe56e057f20f	由易码付平台生成的应用ID，全局唯一。
商户订单号	out_trade_no	是	String	1217752501201407	商户订单号参数必传，值可以传空商户订单号和易码付平台订单号不能同时为空，out_trade_no,trade_no如果同时存在优先取out_trade_no
易惠平台订单号	trade_no	是	String	YH2307190009507085358	该交易在易码付系统中的交易流水号。商户订单号商户订单号和易码付平台订单号不能同时为空，out_trade_no,trade_no如果同时存在优先取out_trade_no
签名串	sign	是	String	e10adc3949ba59abbe56e057f20f883e	待签名字符串进行MD5加密得出的32位签名值，参考签名规则

举例如下：

{BASE_URL}/v1/transactions/orderid.html?app_id=app_159f7a1756bf8b08&out_trade_no=&trade_no=YH2307190009507085358&sign=f74e3b4a9e2bcb971c3a68c80286bc8e

返回结果

字段名	变量名	必填	类型	示例值	描述
业务状态码	resultCode	是	Int	200	200/201/500 此字段是业务标识状态码，200代表业务处理成功，并成功返回
业务状态描述	message	是	String	成功	当resultCode非200时返回信息为错误原因，例如 app_id错误或不存在
数据集	Data	否	String	-	当resultCode为200时，数据会装入该字段一并返回
	out_trade_no	是	String	1217752501201407	Data内的字段：商户订单号
	trade_no	是	String	YH2307190011178361713	Data内的字段：易码付平台订单号
	create_time	是	String	2021-07-19 00:09:50	Data内的字段：订单创建时间
	notify_url	是	String	http://api.qdoto.com/transactions/notify.html	Data内的字段：通知URL
	time_expire	是	String	60	Data内的字段：订单超时时长，单位为分钟
	description	是	String	苹果13Pro	Data内的字段：商品描述
	app_id	是	String	app_9ba59abbe56e057f20f	Data内的字段：应用ID
	platform_trade_no	是	String	2021080121001004890293599497	Data内的字段：第三方支付平台订单号
	channel	是	String	alipay_qr	Data内的字段：支付渠道
	attach	是	String	{"userId":888,"level":3}	Data内的字段：附加数据，创建订单时由商户上传，查单和异步通知时原样返回
	trade_state	是	String	success	Data内的字段：支付状态 success：支付成功 closed：订单关闭 wait：等待付款
	client_ip	是	String	127.0.0.1	Data内的字段：发起支付请求客户端的 IP地址
	notify_state	是	String	success	Data内的字段：异步回调通知状态 success：通知成功 failed：通知失败 none：未通知
	pay_time	是	String	2021-07-19 00:09:58	Data内的字段：付款时间
	amount	是	String	100	Data内的字段：订单金额，单位为分。

举例如下：

{
    "resultCode":200,
    "message":"成功",
    "Data":{
        "amount":2,
        "time_expire":0,
        "trade_state":"wait",
        "create_time":"2023-08-25 17:15:57",
        "channel":"alipay_app",
        "description":"iPhone+13+Pro",
        "notify_url":"http://notify.qdoto.com/payment/callback.html",
        "pay_time":"2023-08-25 17:15:57",
        "out_trade_no":"MER1692954956218",
        "notify_state":"none",
        "platform_trade_no":"",
        "trade_no":"YH2308251715577476213",
        "client_ip":"0:0:0:0:0:0:0:1",
        "attach":"%7B%22channel%22%3A%22alipay_app%22%7D",
        "app_id":"app_7ca649d7cef5deb2"
    }
}

状态码

状态码	描述
200	成功
201	业务错误，具体错误信息请参照message字段
500	系统错误

API接口文档

查询订单

应用场景

接口链接

请求参数

返回结果

状态码