统一预下单
接口说明
长天优选预下单，返回预下单支付会话id，用于长天优选创建订单并拉起长天优选的收银台
注意：预下单支付会话有效期为 2 小时，过期无法使用，而且为临时一次性，使用后无法重复使用，第三方在需要拉起长天优选收银台时必须每次都调用此接口获取新的预下单id,避免由于重复使用导致无法正常拉起收银台。
请求方式：
- 请求方法：POST
- 请求地址：
/open/api/order/uniPreCreate
请求参数(Request Body)
请求body为json格式
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| outOrderNo | string | 是 | 外部第三方订单号 |
| totalFee | int | 是 | 第三方订单金额: 单位分 |
| thirdSkuTitle | string | 是 | 商品标题(用于长天优选APP订单展示，请务必正确填写) 注意：第三方平台可以填写用户其在平台购买的商品描述，例如：星巴克奶茶， 多个商品时可以展示一二个商品并使用顿号隔开并拼接等字，例如：胡萝卜、南丰蜜桔等。 |
| notifyUrl | string | 是 | 支付成功异步通知URL(必须是http或https开头的链接地址) |
| returnUrl | string | 否 | 支付成功后，长天优选小程序或APP将会从内部打开此跳转链接页面(可选) |
| payTypeWhiteList | array[int] | 否 | 支付方式白名单(可空)，当白名单和黑名单同时存在时优先使用白名单 |
| payTypeBlackList | array[int] | 否 | 支付方式黑名单(可空)，当白名单和黑名单同时存在时优先使用白名单 |
支付方式定义：
会员卡-饭票: 11
会员卡-积分: 15
会员卡-天宝: 16
支付宝：20
微信支付:30
湾里一卡通:40
示例：
{
"notifyUrl": "http://www.baidu.com",
"outOrderNo": "2023O11188113",
"returnUrl": "https://www.jxctmall.com",
"thirdSkuTitle": "优选卡密",
"totalFee": 1,
"payTypeWhiteList": [11,15]
}
返回数据(json格式)
| 字段名称 | 说明 |
|---|---|
| preOrderId | 预下单支付会话id，有效期2小时，请避免重复使用 |
| appJump.jumpUrl | 第三方App拉起长天优选App收银台方法：第三方App使用系统默认浏览器打开此链接页面，该页面会通过shema方式拉起长天优选App并进入收银台，如果当前长天优选用户未登录，会提示登录。 备注： 需要长天优选App 主版本号 ≥ 3.2.0 才可正常拉起。 |
| wxmpJump.appId wxmpJump.path |
第三方微信小程序拉起长天优选微信小程序收银台方法：使用微信小程序的 navigateToMiniProgram 方法直接跳转到长天优选微信小程序收银台页面，所需的参数为appid和path,入下图： |
| h5InnerJump.jumpUrl | 长天优选内部h5拉起长天优选收银台的方法：长天优选内部h5页面，需要拉起收银台时，可直接跳转此地址，将会自动拉起长天优选收银台，支持长天优选App和微信小程序 |
示例：
{
"success": true,
"code": "00000",
"message": null,
"data": {
"preOrderId": "MG0y0w8wDW5On",
"appJump": {
"jumpUrl": "https://www.jxctmall.com/openh5/jumptoapp.html?scene=preorder_to_cashier&data=%7B%22preorderid%22:%22MG0y0w8wDW5On%22,%22needlogin%22:%221%22%7D"
},
"wxmpJump": {
"appId": "wxc072d171d92c47a1",
"path": "/pages/tools/jump?preorderid=MG0y0w8wDW5On"
},
"h5InnerJump": {
"jumpUrl": "https://www.jxctmall.com/openh5/uniRedirect.html?scene=preorder_to_cashier&data=%7B%22preorderid%22:%22MG0y0w8wDW5On%22,%22needlogin%22:%221%22%7D"
}
}
}