跳转至

订单查询

请求方式 body 编码 接口地址
POST application/json UTF-8 集测：https://mchapitest.shengpay.com/olbank/query
生产：https://mchapi.shengpay.com/olbank/query

请求参数

变量名 类型 必填 示例值 描述
appId String(32) Y djgeiq978y933 应用标识
mchId String(16) Y 93751497 商户号
mchOrderNo String(50) Y 商户订单号
nonceStr String(32) Y pWUVWVYWNQhnTXpQzhIzMGCwqBkZclzg 随机字符串
signType String(8) Y RSA 签名类型
sign String (1024) Y 签名

请求示例

1
2
3
4
5
6
7
{
    "mchId":"93744866",
    "mchOrderNo":"1592818623421",
    "nonceStr":"OISHJHFXAMIT",
    "sign":"HO4o05pKSUyA76r+fJNxSFvyOBAFfYPZ1g9VkNmBie00xX5HKe4qYBW3AP0GZIKKU8r7fPkMmUDvAhrBfcf7MdwL7jNPPLq2YEsL+5IAdeKNFtyEo7bDkdrnQVYj1cnQ8tR8gE/g0nOZ8Ry+IGhPVIA4D109kcLl7EkMllvWn1Q=",
    "signType":"RSA"
}

响应参数

变量名 类型 必填 示例值 描述
returnCode String Y SUCCESS 返回码(SUCCESS/FAIL)
returnMsg String N 返回消息(当returnCode为FAIL时使用)
resultCode String Y SUCCESS 业务结果(SUCCESS/FAIL)
errorCode String N 错误代码(当resultCode为FAIL时使用)
errorCodeDes String N 错误描述(当resultCode为FAIL时使用)
version String(32) Y V5.0.0 版本号,默认属性值为: V5.0.0
charset String(32) Y UTF-8 字符集,默认属性值为:UTF-8
mchId String(16) Y 93751497 商户号
instCode String(8) Y ICBC 机构编码
payChannel String(8) Y 19 支付渠道(借记卡:19,贷记卡:20,B2B)
mchOrderNo String(50) Y 商户订单号(只允许使用数字、字母,确保在商户系统唯一)
orderAmount int Y 支付金额(单位:分)
transAmount int Y 交易金额(单位:分)
orderType String(14) Y 订单类型(支付:PAYMENT,退款:REFUND)
transactionId String(32) Y 盛付通订单号
transTime String(14) Y 20110808112233 交易完成时间(格式：yyyyMMddHHmmss)
payeeFee int Y 应付手续费(单位:分)
orderStatus String(16) N SUCCESS 订单状态, SUCCESS("成功"),FAIL("失败"),ING("处理中")
bankSerialNo String(32) N 银行流水号
ext String(128) N 扩展
nonceStr String Y nGBXiNhZjBaFrMGIJAKJQQpfNiSGVjzy 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍)

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
    "buyerIp":"10.132.97.21",
    "charset":"UTF-8",
    "currency":"CNY",
    "depositId":"93744866",
    "ext":"备注1",
    "instCode":"ICBC",
    "mchId":"93744866",
    "mchOrderNo":"1592818623421",
    "nonceStr":"BHfQBrKbhtUCpXuDEEyYhvNdlFhusGug",
    "orderAmount":"1000",
    "orderType":"PAYMENT",
    "payChannel":"19",
    "payeeFee":"0",
    "orderStatus":"SUCCESS",
    "resultCode":"SUCCESS",
    "returnCode":"SUCCESS",
    "sign":"HO4o05pKSUyA76r+fJNxSFvyOBAFfYPZ1g9VkNmBie00xX5HKe4qYBW3AP0GZIKKU8r7fPkMmUDvAhrBfcf7MdwL7jNPPLq2YEsL+5IAdeKNFtyEo7bDkdrnQVYj1cnQ8tR8gE/g0nOZ8Ry+IGhPVIA4D109kcLl7EkMllvWn1Q=",
    "signType":"RSA",
    "transAmount":"1000",
    "transTime":"20200622173729",
    "transactionId":"T481879595827068929",
    "version":"V5.0.0"
}
Back to top