查询支付订单

3. 查询支付订单

接口描述

业务系统通过查询支付订单接口获取最新的支付订单状态,并根据状态结果进一步处理业务逻辑。

接口链接

URL地址:{payUrl}/api/pay/query_order

请求参数

字段名 变量名 必填 类型 示例值 描述
平台ID platId String(30) 1000 支付中心分配的平台ID
支付订单号 payOrderId String(30) P20160427210604000490 支付中心生成的订单号,与mchOrderNo二者传一即可
商户订单号 mchOrderNo String(30) 20160427210604000490 商户生成的订单号,与payOrderId二者传一即可
请求时间 reqTime String(30) 20190723141000 请求接口时间, yyyyMMddHHmmss格式
接口版本 version String(3) 1.0 接口版本号,固定:1.0
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法

响应结果

字段名 变量名 必填 类型 示例值 描述
返回状态码 code String(16) 0 0-处理成功,其他-处理有误,详见错误码
返回信息 msg String(128) 签名失败 具体错误原因,例如:签名失败、参数格式校验错误
以下字段在code=0 时有返回
字段名 变量名 必填 类型 示例值 描述
平台ID platId String(30) 1000 支付中心分配的平台ID
支付订单号 payOrderId String(30) P01201907231119090520000 返回支付系统订单号
商户订单号 mchOrderNo String(30) 20160427210604000490 商户生成的订单号
下单金额-RMB amountRmb int 100 下单金额-RMB,单位分
下单金额-USDT amountUsdt String 0.156 下单金额-USDT,单位个
实际付款金额-RMB realAmountRmb int 100 实际付款金额-RMB,单位分
实际付款金额-USDT realAmountUsdt String 0.156 实际付款金额-USDT,单位个
签名信息 sign String(128) CCD9083A6DAD9A2DA9F668C3D4517A84 签名信息
订单状态 status String(3) 2 当前订单状态: -2:订单超时已关闭,1-支付中,2-支付成功
支付成功时间 paySuccTime Long 1505049094262 支付成功时间,精确到毫秒
请求时间 reqTime String(30) 20190723141000 请求接口时间, yyyyMMddHHmmss格式
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法