功能说明

此接口用于平台型商家处理客户跨门店消费时,对多笔跨店订单进行合并支付,避免客户逐笔付款影响消费体验,彰显平台品质与专业!

您只需要在网站或者APP中组装请求参数,将自己的业务参数包含在TradeCustomParam中,直接打开支付入口页面即可.待用户完成支付后,支付回调会通过TradeCustomParam携带您的业务参数通知到您的服务器,您相应处理回调通知即可.
无需再进行底层接口调用,渲染显示,状态监测等繁琐的底层逻辑.无需添加任何繁琐模块,一个链接即可完成支付!

您只需要做2件事情: 1拼接请求参数, 2处理通知回调.

接口HOST地址

取决于您原力支付服务部署所在的主机网络地址.
请注意确保防火墙设置已经允许通过该网络地址端口进行访问.
如果要修改此接口地址请通过<原力支付控制台>-<系统设置>进行设置

接口Action路径: /tradecombinepayment

请求方法: POST方法

请求参数

MerchantID	必填,最大长度12,字符串格式,大小写敏感. 平台型商户的标识,标识了该交易订单的所属平台商家. 更多商户标识可以在控制台<获得产品支付入口>中查看.
TradeProduct	必填,最大长度500,字符串格式,大小写敏感. 产品的标识,标识了该笔交易订单的对应平台商家产品. 更多产品标识可以在控制台<获得产品支付入口>中查看.
TradePayMethod	必填,字符串格式 指定了此交易采用的支付方式,可用值如下: SELECT--由用户选择支付方式 ALP--使用支付宝支付 WXP--使用微信支付
TradePayMode	必填,字符串格式 指定了此交易的付款模式 AUTO--当TradePayMethod为SELECT<由用户选择支付方式>时必须指定此参数. QR --通过线上二维码扫码付款(电脑网站场景) H5W --通过H5外部拉起支付宝或微信付款(手机网站,APP场景) H5N --通过H5在支付宝微信内部直接付款(公众号,微信支付宝(群)内场景) MAP --通过支付宝微信小程序进行付款(小程序场景)
TradeNo	选填,最大长度18,字符串格式,大小写敏感 此交易的唯一标识,如果不设置此值,那么原力支付服务会自动 根据内部时间戳规则生成此标识并且保证此标识的唯一性. 例如:T20190429161256258
TradeName	选填,最大长度100,字符串格式.UTF8+URL格式编码 此交易的名称文本描述,显示在用户支付界面的交易名称 建议采用尽量简短的文本描述信息. 如果未设置则会根据购买产品自动生成相应合适的交易名称
TradeSubOrderList	必填,字符串格式.UTF8+URL编码JSON格式 该笔合并付款订单中子单的明细信息数组,子单对象具体格式如下: [ --JSON对象数组开始     { --子单对象信息         MerchantID="M06329AFD1" --子单的商户标识         ProductID="P06329AFD2" --子单的产品标识         TradeNo="SUBORDER8135" --子单的交易标识         TradeName="子单1测试" --子单的交易名称         TradeDesc="子单1描述" --子单的交易描述         TradePrice="0.01" --子单的交易价格         TradeCurrency="CNY" --子单的交易货币         TradeCustomParam="AAAA" --子单的交易成功后回调至对应商家参数     },     {...},{...}{多个} ] --JSON对象数组结束
TradeStage	选填,最大长度50,字符串格式. 此交易是否允许使用分期付款,此参数目前仅在使用支付宝付款时有效.如果未设置此参数表示不允许分期 格式:<分期手续费承担方><下划线><分期期数>. 分期手续费承担方:         AUTO表示由买家承担手续费并由买家选择分期数.         MCH表示由商家承担分期手续费.         GST表示由买家承担分期手续费. 分期期数:目前支持3,6,12期分期. 例子1:TradeStage=AUTO表示由买家承担手续费,在界面由买家选择分期期数 例子2:TradeStage=MCH_3表示交易分3期付款,由商家承担手续费 例子3:TradeStage=GST_6表示交易分6期付款,由买家承担手续费
SubMerchantID	选填,最大长度12,字符串格式,大小写敏感. 发起此交易的子级商户的标识,交易成功后会对该子级商户进行分账. 如果您没有使用子级商户分账功能则无需填写此参数. 子级商户标识可以在控制台<获得产品支付入口>中查看.
TradeGuestMobile	选填,最大长度20,字符串格式.URL格式编码 买家的手机号码,用于在交易时通过发送短信通知买家结果. 如果需要使用短信联动通知交易结果则此参数为必填.
TradeGuestAddress	选填,最大长度100,字符串格式,URL格式编码 买家的交易地址,用于在交易付款成功后通过此地址进行发货. 当交易成功后,此地址可以在交易记录查询中被找到并显示
TradeGuestRemarks	选填,最大长度200,字符串格式 买家的交易备注,用于在交易付款成功后通过此了解交易备注 当交易成功后此备注可以在交易记录查询中被找到并显示
TradeGuestInput	选填,字符串格式 仅当<由用户选择支付方式>时有效.指示了是否需要填写订单备注信息 可用值: null --无需填写订单备注信息,且界面不显示订单备注信息选项 optional --可选,界面默认隐藏订单备注信息选项可展开,用户可不填写 required --必填,界面默认显示订单备注信息选项已展开,用户必须填写
TradeCustomParam	选填,最大长度500,字符串格式. 交易的自定义数据,您可以在这个参数中保存您的业务参数. 如果您设置了交易完成时使用HTTP联动通知,则此参数会在 HTTP联动通知回调中进行回传,请用URLENCODE对此参数编码, 否则可能会造成此参数的意外截断,此为平台商家的回调参数
TradeReturnURL	选填,最大长度200,字符串格式. 指定了交易完成后跳转返回的URL地址.
TradeConfirm	选填,字符串格式. 可选值:Need 指示了该笔交易完成后需要平台方确认后才会进行结算到商家.可用于实现类似于淘宝的交易担保模式.卖家交易收款,买家确认收货,平台确认结算
ShowDetail	选填,字符串格式 指示了交易完成后是否要向买家显示详细信息. 此参数作用是为了向买家显示自己的唯一标识. 此客户唯一标识将在转账或分账操作中被使用. 另外此客户唯一标识也会在回调通知中被返回. 如有需要您应该维护此唯一标识与用户的对应关系 *可以创建一个0.1元的支付链接,当客户支付后即可获取自己唯一标识. 支付宝的唯一标识是2088开头的,微信的唯一标识是28位字符串
TS	选填,字符串格式 交易请求的时间戳,从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数. 需要转换为北京时间(+8:00时区).JS可以通过Date.parse(new Date())/1000+8*60*60计算. 支付系统会根据当前系统时间来拒绝严重超时的交易请求. 支付系统后台可设置是否要求交易签名,如果启用了交易签名,那么此参数为必填项.
Sign	选填,字符串格式 交易请求的签名,用于一定程度防止请求阶段交易参数被恶意更改. 支付系统后台可设置是否要求交易签名,如果启用了交易签名,那么此参数为必填项. 签名算法: (1)对所有请求参数进行ASCII顺序排序(含TS参数,除Sign参数) (2)将所有请求的参数用&符号连接起来(AAA=1&BBB=2&CCC=3...) (3)对连接后的字符串进行MD5-16计算(小写),结果即为交易请求签名Sign.

应答参数

原力支付会根据您设置的请求参数返回显示不同的支付入口页面,您无需对返回值进行分析,您只需要提交请求并监听交易完成后的回调通知即可.

应答状态

成功返回200,失败返回对应错误码与错误描述

备注

您只需要做2件事情:
1拼接请求参数:在网站或者APP中组装请求参数,这会直接打开支付入口页面
2处理通知回调:待用户完成支付后,在您的服务器上接收支付成功回调即可
无需再进行底层接口调用,渲染显示,状态监测等繁琐的底层逻辑.

您自己的业务参数可以通过TradeCustomParam来传输,在交易完成时回调通知会通过该参数回传给您.
如果您需要灵活的指定交易价格,可以通过TradePrice参数来灵活指定交易金额.
请求创建交易的产品必须已经存在,您可以在原力控制台创建相应产品.商户标识与产品标识是原力支付系统内部生成的.
如果您的交易需要用户提供收货地址可以通过TradeGuestInput选项控制,当支付成功后可以通过控制台查询到用户联系方式和收货地址
此接口仅完成交易订单的创建,要获得交易订单的支付结果,请参阅:交易支付HTTP联动通知文档

例子

http://pay.forcepay.cn/tradecombinepayment?MerchantID=M06165853A&TradeProduct=P06408BD9B&TradePayMethod=ALP&TradePayMode=H5W&TradeSubOrderList=%5B%7B%22MchAppID%22%3A%22NULL%22%2C%22MchUserID%22%3A%22NULL%22%2C%22MerchantID%22%3A%22M06329AFD1%22%2C%22ProductID%22%3A%22P06329AFD2%22%2C%22TradeBuyer%22%3A%22NULL%22%2C%22TradeCurrency%22%3A%22CNY%22%2C%22TradeCustomParam%22%3A%22AAAA%22%2C%22TradeDesc%22%3A%22%E5%AD%90%E5%8D%951%E6%8F%8F%E8%BF%B0%22%2C%22TradeName%22%3A%22%E5%AD%90%E5%8D%951%E6%B5%8B%E8%AF%95%22%2C%22TradeNo%22%3A%22SUBORDER8135%22%2C%22TradeOffer%22%3A%22NULL%22%2C%22TradePrice%22%3A%220.01%22%2C%22TradeSubsidy%22%3A%220%22%7D%2C%7B%22MchAppID%22%3A%22NULL%22%2C%22MchUserID%22%3A%22NULL%22%2C%22MerchantID%22%3A%22M063E516F3%22%2C%22ProductID%22%3A%22P063E51AA0%22%2C%22SubsidyAmount%22%3A%220%22%2C%22TradeBuyer%22%3A%22NULL%22%2C%22TradeCurrency%22%3A%22CNY%22%2C%22TradeCustomParam%22%3A%22BBBB%22%2C%22TradeDesc%22%3A%22%E5%AD%90%E5%8D%952%E6%8F%8F%E8%BF%B0%22%2C%22TradeName%22%3A%22%E5%AD%90%E5%8D%952%E6%B5%8B%E8%AF%95%22%2C%22TradeNo%22%3A%22SUBORDER8136%22%2C%22TradePrice%22%3A%220.01%22%7D%5D%0A