跳转至

统一下单

请求方式 body 编码 接口地址
POST application/json UTF-8 集测：https://wpawtest.shengpay.com/api/v1/payment/unifiedorder
生产：https://wpaw.shengpay.com/api/v1/payment/unifiedorder

请求参数

变量名 类型 必填 示例值 描述
unionId String(32) N hadjhawgdwa9d8897d9wd 账户体系内用户唯一标识
openId String(32) N 2398724h98y912 应用内用户标识ID
appId String(32) Y djgeiq978y933 应用标识
appName String(32) Y **商城 商户应用名称
mchId String(16) Y 93751497 商户号
subMchId String(16) N 子商户号
outTradeNo String(32) Y 1602835300345 商户订单号
timeStart String(14) N 20180801160000 交易起始时间
timeExpire String(14) N 20180801180000 交易结束时间
totalFee int Y 1000 订单总金额(单位:分)
body String(128) Y xx商品 商品描述
detail String(1024) N {"goodsDetails":[{"goodsId":"gId1","goodsName":"gName1","price":100,"quantity":1}]} 交易信息
goodsDetails String(1024) N [{"goodsId":"gId1","goodsName":"gName1","price":100,"quantity":1}] 交易信息
goodsId String(32) N goodsId1 商品id
goodsName String(32) N goodsIName1 商品名称
price int N 100 商品单价
quantity int N 1 商品数量
tradeType String(20) Y UNJWEB 交易方式
notifyUrl String(300) Y https://notify.shengpay.com/notify 商户通知回调地址
goodsTag String(32) N WIFI_DISCOUNT_001 优惠tag
profitSharing String(2) Y Y 是否需要分账，如果需要分账，请先开通分账合同
Y-是，需要分账
N-否，不分账
attach String(1024) Y {"returnUrl":"http://merchantRetuen.xxx.com"} 附加信息(returnUrl为支付完成用户点击跳转商户页面地址)
nonceStr String(32) Y pWUVWVYWNQhnTXpQzhIzMGCwqBkZclzg 随机字符串
signType String(8) Y RSA 签名类型
sign String (1024) Y 签名

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
    "openId":"2398724h98y912",
    "appId":"djgeiq978y933",
    "appName":"2324424214124124",
    "mchId":"93745648",
    "outTradeNo":"hiuhei09023j12j40206",
    "timeStart":"20180801160000",
    "timeExpire":"20180801180000",
    "totalFee":1000,
    "notifyUrl":"https://notify.shengpay.com/notify",
    "nonceStr":"pWUVWVYWNQhnTXpQzhIzMGCwqBkZclzg",    
    "goodsTag":"WIFI_DISCOUNT_001",
    "body":"抓娃娃机-游戏充值",
    "detail":"{\"goodsDetails\":[{\"goodsId\":\"gId1\",\"goodsName\":\"gName1\",\"price\":100,\"quantity\":1}]}",
    "attach":"{\"returnUrl\":\"http://merchantRetuen.xxx.com\"}",
    "tradeType":"UNJWEB",
    "signType":"RSA",
    "sign":"ZdNjNnZL2EMsDvX9C/2ap8uKk18x8ungs42u9y96PrWCQ7flMDePcLL61eG0bgBJdJzd88N54NLzprPa5CSIrI0+FZTWPDDmVMoXz74dyxqFzub9aag0uoyJvD8LDI4bIF6skHuJr6j4tQUPugJ5MtNPJOWG7aHjY4I9HXdN9iw="
}

响应参数

变量名 类型 必填 示例值 描述
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时使用)
mchId String(16) Y 商户号
appId String(32) Y djgeiq978y933 应用标识
prepayId String(32) Y 预支付交易会话标识
mwebUrl String(128) N http://anntest.shengpay.com/pages-ued/no-card-pay/jump.html?prepayId=WP1030102601485784223012302848&pkg=485784227743477760&returnUrl=http%3A%2F%2FmerchantRetuen.xxx.com 支付跳转链接
nonceStr String(32) Y 随机字符串
signType String(8) Y RSA 签名方式
sign String (1024) Y 签名

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
    "appId": "djgeiq978y933",
    "mchId": "93745648",
    "mwebUrl": "http://anntest.shengpay.com/pages-ued/no-card-pay/jump.html?prepayId=WP1030102601485784223012302848&pkg=485784227743477760&returnUrl=http%3A%2F%2FmerchantRetuen.xxx.com",
    "nonceStr": "UOf09SptexJN1K",
    "prepayId": "WP1030102601485784223012302848",
    "resultCode": "SUCCESS",
    "returnCode": "SUCCESS",
    "returnMsg": "OK",
    "sign": "WxgMJBBD4GHp3X1MAiuyDFvC7C5K0H7r3knEgsS66cPOXZbE2iILqnVVPRUqR723NYmm9hAcWb7aOFvwTqNBX/uSajDrAt711w9Bzb/NLGf4h3lrjLbTpS3xNNdTNvGyMhyqQp6ijPtxFAVFoUJVgjJ8+9ckM83YZmZ2hX0pwB4=",
    "signType": "RSA",
    "tradeType": "UNJWEB"
}
Back to top