跳转至

预收单接口-直连

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

请求参数

变量名 类型 必填 示例值 描述
mchId String(16) Y 93751497 商户号
subMchId String(16) N 子商户号
sdpAppId String(32) Y 盛付通分配的APPID-直连服务需要
mchMemberInfo String(256) N {"deviceId":s001","deviceName":"清河一店"} 商户终端信息(JSON字符串)
deviceId String(32) N s001 终端号
deviceName String(256) N 清河一店 终端名称
outTradeNo String(64) Y 1602835300345 商户订单号
timeExpire String(16) Y 20201017160140 交易结束时间(格式为yyyyMMddHHmmss)
notifyUrl String(128) Y http://10.241.80.32:8082/payNotify 商户通知回调地址
nonceStr String(32) Y JtxlJ6aV06gaPbOojRuiN4L3vmqOs9dB 随机字符串
pageUrl String(128) N 同步跳转地址
totalFee int Y 订单总金额(单位分)
tradeType String(32) Y 支付方式(详见支付渠道属性列表)
isNeedShare String(8) N FALSE 是否需要分账，如果需要分账，请先开通分账合同
TRUE-是，需要分账
FALSE-否，不分账
extra String(1024) Y {"openId":"sjdfiasofjow1082038014lsjdf","appId":""} 支付要素扩展参数(JSON字符串)
微信 tradeType = wx_lite 或 wx_jsapi
openId String(64) N sjdfiasofjow1082038014lsjdf 微信openid
appId String(64) N 公众号或者小程序的appid
支付宝 tradeType = alipay_jsapi 或 alipay_lite
openId String(64) N 2888234932829739232 支付宝的userId
appId String(64) N 支付宝的appid
支付宝分期 支付金额≥100元时
installmentNum String(64) N 3 花呗分期数(值为3,6,12)
installmentSellerPercent String(64) N 0 手续费承担方
商家承担收费比例，只支持传0或100.
0: 用户付息
100: 商户贴息
扫码点餐 该参数不填，同步点单无效
foodOrderType String(64) N qr_order 场景码
qr_order: 店内扫码点餐
pre_order: 预点到店自提
home_delivery: 外送到家
direct_payment: 直接付款
other: 其他
微信H5支付 tradeType =wx_wap
sceneInfo String(256) N json字符串
wap_name String(64) N 连信读书
wap_url String(64) N WAP网站URL地址域名
type String(64) N 场景，固定值
微信代扣-支付中签约 tradeType =wx_app
agreementNo String(256) N 外部协议号
planId String(64) N 协议模板ID
signDisplayName String(64) N 签约显示名称
agreementMerchantNotifyUrl String(128) N 协议异步通知地址
支付宝代扣-支付中签约 tradeType =alipay_app
agreementNo String(256) N 外部协议号
signScene String(64) N 代扣场景
externalLogonId String(64) N 签约用户名称
subMerchantServiceName String(64) N 子商户的服务名称
subMerchantServiceDescription String(64) N 子商户的服务描述
agreementMerchantNotifyUrl String(128) N 协议异步通知地址
微信代扣 tradeType =wx_period
instAgreementNo String(256) N 微信代签协议号(微信官方通知)
支付宝代扣 tradeType =alipay_period
instAgreementNo String(256) N 支付宝代签协议号(支付宝官方通知)
body String(64) Y 商品描述
detail String(128) N 交易信息
attach String(1024) N 附加信息
currency String(8) Y CNY 标准币种
clientIp String(256) Y 127.0.0.1 用户IP(H5支付时请传用户真实地址 ,支持IPV6)
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
{
    "attach": "",
    "body": "聚合支付",
    "clientIp": "127.0.0.1",
    "currency": "CNY",
    "detail": "",
    "extra": "{\"openId\":\"\",\"appId\":\"\"}",
    "isNeedShare": "false",
    "mchId": "93751497",
    "nonceStr": "JtxlJ6aV06gaPbOojRuiN4L3vmqOs9dB",
    "notifyUrl": "http://10.241.80.32:8082/payNotify",
    "outTradeNo": "1602835300345",
    "sign": "hLfGoUV7xEF7YSPdtbrzCuhFTOg1dovV0X/XArO2L8zr39juoyPhA8ZF9WP2QPJ7hf7IhcbM7F8tCPUcCHParN+bMLaDATl4+9AHmhck6MhBr1Zd65KJDge+uUCEoEZ2wI4ukfkxPD4lJVPTd5Y6dNr7gaH0w29jc1PU/4cx9IXkNtyiEG+X6lBCXRxMVOvKBLLxOKvkB+Fpi1K02qlczoY6wfHSmBKldoD30I+C4ukgmOWj1XCkQBuzUNIx/TzKPQPhoq+pHCPVi5qx+WWqIySFORsddkLyp4r/Mdxla0wNITwi8/qaJi0Qg6KaFnygLExPGg9SKEuN6G1F5Ql2Bg==",
    "signType": "RSA",
    "timeExpire": "20201017160140",
    "totalFee": 10,
    "tradeType": "wx_native"
}

响应参数

变量名 类型 必填 示例值 描述
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 Y 商户号
subMchId String Y 商户订单号
outTradeNo String Y 商户订单号
transactionId String Y 盛付通订单号
totalFee int Y 订单金额（单位分）
paidAmount int Y 支付金额（单位分）
payInfo String N 支付信息
status String Y 订单状态(见订单状态说明)
payTime String N 20201016160142 支付时间(格式为yyyyMMddHHmmss)
attach String N 附加信息
sftInstOrderNo String N 银行提交单号，成功交易才会返回
officOrderNum String N 官方订单号，成功交易才会返回
feeAmount String N 优惠券金额，成功交易才会返回
settlementTotalFee String N 结算金额，成功交易才会返回
openid String N 付款用户标识，成功交易才会返回
subOpenid String N 付款用户子标识，成功交易才会返回
nonceStr String Y 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍)

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
    "mchId": "93751497",
    "payTime": "20201016160142",
    "resultCode": "SUCCESS",
    "sign": "D93b54cbND5p7WVf2dPsGve0vmTAI7RI4uSRYbCQtYnaHDI3xhawyar2ri+mg/RrOaZOxa1dz+B2i0kchRsHk6miO2AbyY9Xoo94SPoCKGe4XZOUZngQWyisYf3kG2rvsBE/PgxyOe9eU0/2zujDiNvF3u4ltgJ32CE7u0UMeVY=",
    "transactionId": "M20201016348523693586173952",
    "nonceStr": "OlnsDwQpogsfDdMYfZnzkYpMiKdiAGoU",
    "returnCode": "SUCCESS",
    "totalFee": 10,
    "outTradeNo": "1602835300345",
    "signType": "RSA",
    "attach": "",
    "paidAmount": 0,
    "payInfo": "weixin://wxpay/bizpayurl?pr=DuDBouh00",
    "status": "PAY_ING"
}
Back to top