跳转至

统一下单

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

请求参数

变量名 类型 必填 示例值 描述
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 Y 商品描述
detail String(1024) N {"goodsDetails":[{"goodsId":"goodsId1","goodsName":"goodsIName1","price":100,"quantity":1}]} 交易信息(JSON字符串)
goodsDetails String(1024) N [{"goodsId":"goodsId1","goodsName":"goodsIName1","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 APP 交易方式
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 附加信息
contractMchId String(16) Y 签约商户号(必须与mch_id一致)
contractAppId String(32) Y 签约appid(必须与appid一致)
planId String(32) Y 协议模板id
contractCode String(32) Y 签约协议号
requestSerial String(32) Y 请求序列号
contractDisplayAccount String(32) Y 用户账户展示名称
contractNotifyUrl String(128) Y 签约信息通知url
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
20
21
22
23
24
25
26
{
    "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\":\"goodsId1\",\"goodsName\":\"goodsIName1\",\"price\":100,\"quantity\":1}]}",
    "attach":"{\"memo\":\"test\"}",
    "tradeType":"APP",
    "contractMchId": "93745648",
    "contractAppId": "djgeiq978y933",
    "planId": "P12336747836584",
    "contractCode": "3545376577",
    "requestSerial": "342523538926938760267",
    "contractDisplayAccount": "mock账号123",
    "contractNotifyUrl": "https://notify.shengpay.com/notify/contract",
    "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 支付跳转链接tradeType为MWEB时返回
contractResultCode String(32) Y 预签约结果
contractErrorCode String(32) N 预签约错误代码
contractErrorCodeDes String(64) N 预签约错误描述
planId String(32) Y 协议模板id
contractCode String(32) Y 签约协议号
requestSerial String(32) Y 请求序列号
contractDisplayAccount String(32) Y 用户账户展示名称
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
14
15
16
17
{
  "appId": "djgeiq978y933",
  "mchId": "93745648",
  "nonceStr": "CKDjdKqSkPUfWmuOFCXOmTkWtgVklZNF",
  "prepayId": "WP2018080116535234056089817260601344",
  "mwebUrl":"",
  "resultCode": "SUCCESS",
  "returnCode": "SUCCESS",
  "returnMsg": "OK",
  "sign": "IW93NZkqfLxTgA2eHoKdq/qd4BhCAMniSZU5riF1yb7UxQEj5sdolwHW4h8nSM279hXfCDSA8Oca/26XsChRG1WzbFgkjDkd3glBr5E3cGKmCOSpi0v1UkFeIAW8V2kTD1keUOXWgvlLkjVV/T2pfyKYr9xebEUwbU6r+rCnqos=",
  "signType": "RSA",
  "contractResultCode": "SUCCESS",
  "planId": "P12336747836584",
  "contractCode": "3545376577",
  "requestSerial": "342523538926938760267",
  "contractDisplayAccount": "mock账号123"
}
Back to top