27.H5收银台下单

<p><strong>使用场景：</strong> </p> <ul> <li>获取访问通企付H5收银台的链接，用户通过对应链接打开通企付H5收银台，通企付H5收银台负责渠道下单支付，并返回交易结果。。</li> </ul> <p><strong>请求URL：</strong> </p> <p>/h5Cash/getH5Url</p> <p><strong>请求参数：</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">orgId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>服务商id，用于服务商模式，传了此参数需要用服务商秘钥进行验签</td> </tr> <tr> <td style="text-align: left;">mchNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户号</td> </tr> <tr> <td style="text-align: left;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>应用ID</td> </tr> <tr> <td style="text-align: left;">reqTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求时间，13位时间戳</td> </tr> <tr> <td style="text-align: left;">version</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>版本（默认为1.0）</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名</td> </tr> <tr> <td style="text-align: left;">signType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名类型（MD5/RSA/SM2）</td> </tr> <tr> <td style="text-align: left;">mchOrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户订单号</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>金额（单位：分）</td> </tr> <tr> <td style="text-align: left;">body</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>描述</td> </tr> <tr> <td style="text-align: left;">notifyUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>通知地址</td> </tr> <tr> <td style="text-align: left;">frontUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>微信点金计划跳转地址，仅微信浏览器内打开有效，点金计划改造参照页面下方链接说明</td> </tr> <tr> <td style="text-align: left;">jumpUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>前端跳转地址，支付完成后会带参跳转到该地址，微信内打开的时候此跳转地址无效</td> </tr> <tr> <td style="text-align: left;">validTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>链接有效期，单位秒，不传默认120秒，最小120秒，最大支持72小时</td> </tr> <tr> <td style="text-align: left;">expiredTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>订单失效时间,单位秒,默认1小时.订单在(创建时 间+失效时间)后失效</td> </tr> <tr> <td style="text-align: left;">extParam</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>备注，商户扩展参数，回调时原样返回</td> </tr> <tr> <td style="text-align: left;">goodsInfo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品备注,JSONArray格式，例如：goodsInfo=[{“goodsnm”:”TEST_PAY”,”goodsnum”:”1”,”goodsamt”:”2”}]，使用转账汇款时必填</td> </tr> <tr> <td style="text-align: left;">channelExtra</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>渠道参数，JSON字符串，特定渠道发起的额外参数，例：收银宝子商户号cusid,集团商户号orgid；使用转账汇款时，merUserId(商户用户标识)必填</td> </tr> <tr> <td style="text-align: left;">payTypeInfo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>收银台展示的付款方式，多个以英文逗号(,)隔开；注释：WX_PAY：微信 ALI_PAY：支付宝 ZZHK_PAY：转账汇款</td> </tr> <tr> <td style="text-align: left;">directPayType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>直接支付的支付方式，仅支持上送一种支付方式，填入该参数则自动使用该支付方式下单并拉起支付，当前支持：WX_JSAPI：微信公众号支付 ALI_QR：支付宝支付（微信侧支付宝支付为吱口令）</td> </tr> </tbody> </table> <table> <thead> <tr> <th style="text-align: left;">Goods参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">goodsnm</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商品简称</td> </tr> <tr> <td style="text-align: left;">goodsamt</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>商品金额（单位：元）</td> </tr> <tr> <td style="text-align: left;">goodsnum</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>商品数量</td> </tr> </tbody> </table> <p><strong>响应参数</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>success：支付成功；cancel：取消支付；fail：支付失败</td> </tr> <tr> <td style="text-align: left;">errmsg</td> <td style="text-align: left;">string</td> <td>响应内容（当code为cancel、fail有值）</td> </tr> </tbody> </table> <p><strong>返回示例</strong> { “code”: 0, “data”: { “H5Url”: “<a href="https://xxxx?cashCdoe=xxxx">https://xxxx?cashCdoe=xxxx</a>“, }, “msg”: “SUCCESS”, “sign”: “713B50182CAFC8B7B71CEE94D1D0A1B7” }</p> <p><strong>jumpUrl返回参数</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">orgId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>服务商id，用于服务商模式，传了此参数需要用服务商秘钥进行验签</td> </tr> <tr> <td style="text-align: left;">mchNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户号</td> </tr> <tr> <td style="text-align: left;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>应用ID</td> </tr> <tr> <td style="text-align: left;">reqTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求时间，13位时间戳</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名</td> </tr> <tr> <td style="text-align: left;">signType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名类型（MD5/RSA/SM2）</td> </tr> <tr> <td style="text-align: left;">mchOrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户订单号</td> </tr> <tr> <td style="text-align: left;">payOrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>通企付支付订单号</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单金额</td> </tr> <tr> <td style="text-align: left;">state</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单状态 2-支付成功</td> </tr> </tbody> </table> <p><strong>frontUrl参数说明</strong> 微信参考资料：<a href="https://doc.weixin.qq.com/doc/w3_AEQALQY-AEkevAiG0OvRI0Os06P5s?scode=AJEAIQdfAAopFJmXniAEQALQY-AEk">https://doc.weixin.qq.com/doc/w3_AEQALQY-AEkevAiG0OvRI0Os06P5s?scode=AJEAIQdfAAopFJmXniAEQALQY-AEk</a></p>