跳转至

统一下单

请求方式 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}]} 交易信息(JSON字符串)
goodsDetails String(1024) N [{"goodsId":"gId1","goodsName":"gName1","price":100,"quantity":1}] 交易信息(JSON字符串)
goodsId String(32) N goodsId1 商品id
goodsName String(32) N goodsIName1 商品名称
price int N 100 商品单价
quantity int N 1 商品数量
tradeType String(20) Y UPIWEB 交易方式
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) N 附加信息
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":"{\"memo\":\"test\"}",
    "tradeType":"UPIWEB",
    "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 https://anntest.shengpay.com/h5pay?prepayId=WP2018080116535234056089817260601344&pkg=213124581926597126 支付跳转链接
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",
  "nonceStr": "CKDjdKqSkPUfWmuOFCXOmTkWtgVklZNF",
  "prepayId": "WP2018080116535234056089817260601344",
  "mwebUrl":"https://anntest.shengpay.com/h5pay?prepayId=WP2018080116535234056089817260601344&pkg=213124581926597126",
  "resultCode": "SUCCESS",
  "returnCode": "SUCCESS",
  "returnMsg": "OK",
  "sign": "IW93NZkqfLxTgA2eHoKdq/qd4BhCAMniSZU5riF1yb7UxQEj5sdolwHW4h8nSM279hXfCDSA8Oca/26XsChRG1WzbFgkjDkd3glBr5E3cGKmCOSpi0v1UkFeIAW8V2kTD1keUOXWgvlLkjVV/T2pfyKYr9xebEUwbU6r+rCnqos=",
  "signType": "RSA",
  "tradeType": "UPIWEB"
}
Back to top