测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
生产地址：https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码（transCode）：2085
订单调用说明：
商户业务系统需将业务订单与支付订单（云商通）以分层的方式处理，即在业务订单需支付时才向云商通请求订单申请
(1) 支付失败可重试：可实现业务系统商品订单用户支付失败时，可以再次对商品订单发起支付；
(2) 自定义有效期：可实现业务系统商品订单的自定义有效期；云商通未支付的订单，每天日终批量关闭已创建未支付，且创建时间大于24小时的订单。
(3) 支持多次支付：可实现业务系统商品订单多次多笔支付。
(4) 避免渠道依赖：避免渠道端因支付时效控制关闭支付订单后，影响原业务订单的支付。
(5)支付连续性：用户不会因为一次支付超时或失败，就必须重新下单。只要在业务有效期内，用户可以随时继续支付，提升了支付转化率。
| 业务场景 | 商户系统 | 云商通 |
| 1笔业务订单全部支付 | 业务订单号 | 支付订单号（reqTraceNum） |
| 1笔业务订单多次部分支付 | 业务订单号 | 支付订单号1（reqTraceNum） 支付订单号2（reqTraceNum）... |
| 多笔业务订单合并支付（多收款人） | 业务订单号1 业务订单号2 业务订单号3 ... | 支付订单号（reqTraceNum） |
功能说明：
- 综合支付产品：
（1）无需上送“付款会员编号”及“收款会员编号”。
（2）订单类型及子类型说明：订单类型“消费”，对应订单子类型为“商户收款”。
- 新增支持收银宝微信订单预消费：
（1）若请求上送的支付模式为：“收银宝微信小程序支付-WECHATPAY_MINIPROGRAM”，则需根据收银宝“响应的交易类型处理：
|
收银宝响应的交易类型 |
云商通处理 |
|
VSP681：微信订单预消费
|
更新订单支付模式为：微信订单预消费-WECHAT_PRECONSUME 更新订单子类型为：微信订单预消费 订单不动账 |
|
其他 |
原流程，正常更新订单状态、动账 |
（2）并在同步响应中增加响应字段isPreConsume。
业务请求参数
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
|
reqTraceNum |
String |
是 |
商户订单号 |
||
|
orderAmount |
Long |
是 |
订单金额 |
单位：分 |
|
|
payAmount |
Long |
否 |
支付金额 |
单位：分 渠道实际需支付金额 |
|
|
payMode |
JSONObject |
否 |
支付模式 |
详见支付模式字典 |
|
|
reqsUrl |
String |
否 |
前台通知地址 |
||
|
respUrl |
String |
否 |
后台通知地址 |
||
|
orderValidTime |
String |
否 |
订单过期时间 |
格式：yyyy-MM-dd HH:mm:ss，除特殊说明外，默认过期时间为1小时
|
|
|
goodsName |
String |
否 |
商品名称 |
||
|
summary |
String |
否 |
摘要 |
||
|
extendParams |
String |
否 |
扩展参数 |
||
|
txDistrictCode |
String |
否 |
交易所在省市 |
仅智能路由时需要上送， 上送2位的地区码，如：11为北京 |
|
|
goodsDesc |
String |
256 |
否 |
商品描述 使用云商通收银台时，可展示商品信息 |
按照：商品名称1#金额##商品名称2#金额 的格式上送，则收银台界面可展示商品（金额为元） |
业务响应参数
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
result |
String |
否 |
订单状态 |
仅交易验证方式为“0”时返回 订单成功时会发订单结果通知商户。 |
|
respTraceNum |
String |
是 |
通联订单号 |
|
|
reqTraceNum |
String |
是 |
商户订单号 |
|
|
extendParams |
String |
否 |
扩展参数 |
|
|
channelParamInfo |
JSON |
否 |
渠道参数信息（支付详情） |
渠道返回时有值 |
|
chnlFrontParamInfo |
JSON |
否 |
渠道参数信息（前端支付参数） |
渠道返回时有值 （1）扫码支付信息/ JS支付串信息（微信、支付宝、QQ钱包） 客户对接提醒：前端调用方法不要用取字段的方式，避免加字段后签名失败。 |
|
respCode |
String |
是 |
业务返回码 |
00000：代表成功 66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。 其他返回码：均代表失败 |
|
respMsg |
String |
是 |
业务返回说明 |
|
|
isPreConsume |
String |
否 |
是否微信订单预消费 |
目前仅支持在订单子支付模式为微信订单预消费时返回 枚举值： 0：否 1：是 |
“reqsUrl-前台通知地址”页面跳转返回的数据
|
字段名 |
字段类型 |
必填 |
字段中文 |
说明 |
|
result |
String |
是 |
订单状态 |
订单成功时会发订单结果通知商户。 |
|
reqTraceNum |
String |
是 |
商户订单号 |
|
|
respTraceNum |
String |
是 |
通联订单号 |
|
|
orderAmount |
Long |
是 |
订单金额 |
单位：分 |
|
payAmount |
Long |
是 |
支付金额 |
支付金额=订单金额-营销金额 |
|
promotionAmount |
Long |
否 |
营销金额 |
|
|
finishTime |
String |
否 |
订单支付完成时间 |
云商通订单支付完成时间 |
|
extendParams |
String |
否 |
|
接口将原样返回，不可包含“|”特殊字符 |