5.8 商户查询订单状态 5.8.1 查询当日订单状态(商户平台) 商户主动发起查询订单信息，只支持未过账期的订单，不支持对历史订单的查询。即可查询最近1-2天内的订单信息。 5.8.1.1 接口地址 http://pay.soopay.net/spay/pay/payservice.do 5.8.1.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 service 接口名称 变长 32 query_order Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 charset 参数字符编码集 变长 16 商户网站使用的编码格式，支持 UTF-8. GBK. GB2312. GB18030 Y 4 sign 签名 变长256 参见签名机制 Y 5 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 6 version 版本号 定长3 定值 4.0 Y 7 res_format 响应数据格式 变长 16 暂支持HTML，格式见附录(默认为HTML) N 业务参数 1 order_id 商户订单号 变长32
Y 2 mer_date 商户订单日期 定长8 商户生成订单的日期，格式YYYYMMDD Y 3 amount 订单金额 变长13 如果是人民币，则以分为单位 N 4 trade_no U付交易号 变长 16
N 5 goods_id 商品号 变长8 商户下单时提交的goods_id N 6 media_id 媒介标识 变长 32
N 7 mediatype 媒介类型 变长 16 取值范围： MOBILE（手机号） N 5.8.1.3 响应数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 2 sign 签名 变长256 参见签名机制 Y 3 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 4 version 版本号 定长3 定值 4.0 Y 业务参数 1 ret_code 返回码 定长4 详见《商户接入规范常见返回码列表文档》 Y 2 ret_msg 返回信息 变长128
N 3 order_id 商户唯一订单号 变长32
Y 4 mer_date 商户订单日期 定长8 商户生成订单的日期，格式YYYYMMDD Y 5 trade_no 联动交易号 变长 16
Y 6 pay_date 支付日期 定长8 用户对订单进行支付的日期，格式是YYYYMMDD Y 7 amount 付款金额 变长13 如果是人民币，则以分为单位 Y 8 amt_type 付款币种 变长 8 返回值范围： RMB Y 9 pay_type 支付方式 变长16 返回值范围： B2BBANK（B2B网银） B2CBANK（B2C网银） CREDITCARD（信用卡） DEBITCARD（借记卡） N 10 media_id 媒介标识 变长 32
N 11 media_type 媒介类型 变长 16 返回值范围： MOBILE（手机号） N 12 gate_id 支付工具标识 变长16 详见银行列表 5.4 N 13 trade_state 订单状态 变长 32 详见订单状态说明5.5 Y 14 settle_date 对账日期 定长8 商户的对账报表均以此日期为准，格式为YYYYMMDD Y 15 bank_check_state 银行对账状态 变长 2 0：初始状态 1：对账成功 -1：对账失败 N 16 mer_priv 商户私有域 变长64 联动优势支付平台按商户请求数据原样返回 N 17 user_ip 用户IP地址 变长 16 用户在创建交易时，该用户当前所使用机器的 IP。 N 18 expire_time 订单失效时间 变长 8 格式为YYYYMMDD N 19 pay_seq 银行流水 变长
N 20 errorcode 交易错误码 变长 32 详见《商户接入规范常见返回码列表文档》 N 21 product_id 产品号 变长 8
N 22 refund_amt 已退金额 变长13 已退费金额 N
5.8.1.4 样例 商户请求平台示例：
平台响应商户示例：
5.8.2 查询历史订单(商户平台) 根据商户原支付订单号. 原支付订单日期查询商户订单信息(订单金额. 已退费金额. 订单状态等信息)，仅支持针对商户12月内的订单进行查询。 由于每笔订单支持多次部分退，返回的退费金额是指针对该笔订单的所有已退金额。 支持查询的消费类订单包括：普通消费订单. 批量转账订单. 分账订单。 支付查询的预授权类订单包括：预授权申请. 预授权撤销. 预授权完成。 5.8.2.1 接口地址 http://pay.soopay.net/spay/pay/payservice.do 5.8.2.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 service 接口名称 变长 32 mer_order_info_query Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 charset 参数字符编码集 变长 16 商户网站使用的编码格式，支持UTF-8. GBK. GB2312. GB18030 Y 4 res_format 响应数据格式 变长 16 暂支持HTML，格式见附录(默认为HTML) N 5 sign 签名 变长256 参见签名机制 Y 6 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 7 version 版本号 定长3 定值 4.0 Y 业务参数 1 order_type 原订单类型 定长1 如果没有上送默认：1:消费 原订单类型： 1：消费 2：预授权 N 2 order_id 原商户订单号 变长32 原商户订单号 Y 3 mer_date 原商户订单日期 定长8 原商户订单日期 Y
5.8.2.3 响应数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 signtype 签名方式 定长 8 暂只支持RSA必须大写 Y 2 sign 签名 变长256 参见签名机制 Y 3 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 4 version 版本号 定长3 定值 4.0 Y 业务参数 1. amount 原订单金额 变长13 以分为单位。 Y 2. refund_amt 订单已退费金额 变长13 表示原订单的已退或正在退的金额。以分为单位。 预授权申请. 撤销订单因不支持退费故此值无意义 其他订单有值。 N 3. trade_state 原订单状态 变长 32 详见订单状态说明5.5 Y 4. ret_code 返回码 定长4 详见附录 0000:代表查询成功 订单是否成功需看原订单状态 返回码详看《商户接入规范常见返回码列表文档》 Y 5. ret_msg 返回信息 变长128
N
5.8.2.4 样例 商户请求平台示例：
平台响应商户示例：
5.8.3商户撤销交易 (商户平台) 针对交易当天（即对账前）的成功订单可以进行撤销，过了账期则需要走退费接口。 5.8.3.1 接口地址 http://pay.soopay.net/spay/pay/payservice.do 5.8.3.2 请求数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 service 接口名称 变长 32 mer_cancel Y 2 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 3 charset 参数字符编码集 变长 16 商户网站使用的编码格式，支持 UTF-8. GBK. GB2312. GB18030 Y 4 sign 签名 变长256 参见签名机制 Y 5 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 6 version 版本号 定长3 定值 4.0 Y 7 res_format 响应数据格式 变长 16 暂支持HTML，格式见附录(默认为HTML) N 业务参数 1 order_id 商户订单号 变长32
Y 2 mer_date 商户订单日期 定长8 商户生成订单的日期，格式YYYYMMDD Y 3 amount 订单金额 变长13 如果是人民币，则以分为单位 Y 5.8.3.3 响应数据列表 NO. 字段 名称 长度 说明 必填 协议参数 1 sign_type 签名方式 定长 8 暂只支持RSA必须大写 Y 2 sign 签名 变长256 参见签名机制 Y 3 mer_id 商户编号 变长8 由平台统一分配合作商户唯一标识 Y 4 version 版本号 定长3 定值 4.0 Y 业务参数 1 order_id 商户唯一订单号 变长32
Y 2 mer_date 商户订单日期 定长8 商户生成订单的日期，格式YYYYMMDD Y 3 trade_no U付交易号 变长 16
Y
trade_state 订单状态 变长 32 详见交易状态说明 Y 4 ret_code 返回码 定长4 详见附录 Y 5 ret_msg 返回信息 变长128
N
5.5.8.3 样例 商户请求平台示例：
平台响应商户示例：