订单查询 - 19支付 API 开发文档

订单查询接口

用户发起支付后，可通过本接口发起订单查询来确认订单状态

请求地址

环境	HTTPS请求地址
正式环境	https://19zf.cn/api/query.html

请求参数

参数	类型	是否必填	描述	示例值
app_id	String	是	19支付平台分配和商户的APPID，19开头	191008821006
out_trade_no	String	特殊可选	商户订单号，与 pay_order_id 不能同时为空；如果同时存在优先级：pay_order_id > out_trade_no	20150320010101001
pay_order_id	String	特殊可选	19支付平台订单号，与 out_trade_no 不能同时为空；如果同时存在优先级：pay_order_id > out_trade_no	19开头
sign_type	String	否	商户生成签名字符串所使用的签名算法类型，默认支持MD5	MD5
sign	String	是	数据签名，详见签名算法	95AD5686E715127AA03F8324079673F0

请求响应参数

参数	类型	是否必填	描述	示例值
result_code	String	是	接口响应结果	SUCCESS:请求成功，FAIL:请求失败
result_msg	String	是	接口响应结果描述	请求成功、请求失败、签名验证失败等
app_id	String	是	19支付平台分配和商户的APPID，19开头	191008821006
mch_id	String	是	合作商户的商户号	1575500091
total_fee	int	是	订单总金额	单位：分
pay_order_id	String	是	19支付平台订单号	19开头
out_trade_no	String	是	商户订单号，需保证在商户端不重复	20150320010101001
transaction_id	String	否	微信系统交易单号	42000004652019110530698852419
trade_status	String	是	交易状态	0 — 未支付 1 — 支付成功 2 — 已关闭 3 — 已退款 4 — 已撤销
trade_status_desc	String	是	交易状态描述
time_end	String	否	支付成功时间，格式：yyyyMMddHHmmss	20191105220802
openid	String	否	用户OPENID标示，本参数没有实际意义，旨在方便用户端区分不同用户	oT_0R1etkSgOiwGgNve-tmd0h1h2
attach	String	否	商户自定义数据包，在查询API和异步通知中原样返回	主要用于商户携带订单的自定义数据
sign_type	String	否	默认MD5	MD5
sign	String	是	数据签名，详见签名算法	95AD5686E715127AA03F8324079673F0

请求响应结果示例（本示例仅供参考，具体参数以实际通知为准）

{"app_id":"191008821006","mch_id":"1575500091","openid":"oT_0R1etkSgOiwGgNve-tmd0h1h2","out_trade_no":"20150320010101001","pay_order_id":"1919110717036584","result_code":"SUCCESS","result_msg":"成功","sign":"0D07BD2D6B2C0B1F50A39C942D5DD0BF","time_end":"20150320010101","total_fee":"10","trade_status":"1","trade_status_desc":"支付成功","transaction_id":"42000004652019110530698852419"}

注意：

1.此接口用户订单状态的辅助查询，请勿直接使用此接口做订单状态的高频轮询，调用频率过高可能会导致IP进入黑名单。

2.正确的业务逻辑：商户侧服务器通过接收异步通知后更新自己订单状态，用户前端轮询应放在商户侧订单状态

19支付 - 文档中心

订单查询接口

请求地址

请求参数

请求响应参数