3.1 H5收银台支付
<h2>描述</h2>
<p>通过调用H5收银台页面，能聚合微信公众号支付、支付宝服务窗支付、银联二维码支付。
商户系统先调用此接口在PayCloud平台后台生成预支付交易单，返回正确的预支付交易会话标识后再跳转到PayCloud平台H5收银台地址，PayCloud平台H5收银台完成支付后，会跳转回商户页面。</p>
<h2>请求参数</h2>
<h4>公共参数</h4>
<p>参见【<a href="https://www.showdoc.com.cn/1724151917532295/8175841214113582">请求报文 - 公共参数</a>】</p>
<h4>业务参数</h4>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>请求方法</td>
<td>TEXT(128)</td>
<td>M</td>
<td>此接口固定值为：paycloud.pay.h5pay</td>
</tr>
<tr>
<td>merchant_no</td>
<td>商户号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>商户号，在PayCloud平台入驻后分配的商户号</td>
</tr>
<tr>
<td>store_no</td>
<td>门店编号</td>
<td>TEXT(16)</td>
<td>O</td>
<td>PayCloud分配的门店编号</td>
</tr>
<tr>
<td>outer_store_no</td>
<td>外部门店号</td>
<td>TEXT(32)</td>
<td>O</td>
<td>商家自定义门店编号，商户可在PayCloud商户平台添加门店绑定商家自己的门店号store_no和outer_store_no同时存在时，以store_no为主</td>
</tr>
<tr>
<td>out_order_no</td>
<td>商户订单号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>商户系统内部订单号，只允许数字或英文字母、下划线， 同一app_id下商户订单号不能重复</td>
</tr>
<tr>
<td>trans_amount</td>
<td>交易金额</td>
<td>AMOUNT</td>
<td>M</td>
<td>交易金额=商户订单金额 - 商户业务优惠最大值：100000000.00</td>
</tr>
<tr>
<td>discount_bmoa</td>
<td>商户业务优惠</td>
<td>AMOUNT</td>
<td>O</td>
<td>商户在特定业务中减免的金额，如会员权益业务优惠。这部分资金不结算给商家</td>
</tr>
<tr>
<td>payment_method</td>
<td>支付方式</td>
<td>TEXT(16)</td>
<td>M</td>
<td>目前支持的支付方式有： ALIPAY-支付宝 WECHATPAY-微信支付 UNIONPAY_QRCODE-银联二维码ICBC_EPAY-工银e支付(工行e生活)E-CNY - 数字人民币</td>
</tr>
<tr>
<td>description</td>
<td>订单描述</td>
<td>TEXT(128)</td>
<td>M</td>
<td>支付订单的简要描述例：Ipad mini 16G 白色</td>
</tr>
<tr>
<td>discountable_amount</td>
<td>参与优惠计算的金额</td>
<td>AMOUNT</td>
<td>O</td>
<td>参与优惠计算的金额，取值范围[0.01,100000000]，支付宝可传递该参数</td>
</tr>
<tr>
<td>goods_detail</td>
<td>订单包含的商品列表信息</td>
<td>TEXT(2048)</td>
<td>O</td>
<td>订单包含的商品列表信息，json格式请参考支付宝和微信对该参数的详细说明，此处PayCloud平台仅做透传微信文档内参数名称：detail，<a href="https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9_101&index=1">参考说明文档</a>支付宝文档内参数名称：goods_detail，<a href="https://docs.open.alipay.com/api_1/alipay.trade.create">参考说明文档</a></td>
</tr>
<tr>
<td>notify_url</td>
<td>后台通知地址</td>
<td>TEXT(256)</td>
<td>O</td>
<td>商户后台接收PayCloud平台支付异步通知回调地址</td>
</tr>
<tr>
<td>return_url</td>
<td>前台回调地址</td>
<td>TEXT(256)</td>
<td>O</td>
<td>商家H5页面接收支付成功回调的页面地址_由于微信关闭了JSAPI支付后页面调整，升级为“微信点金计划”，请按照微信规范进行开发，详细信息请参考_微信官方文档</td>
</tr>
<tr>
<td>attach</td>
<td>商户附加信息</td>
<td>TEXT(127)</td>
<td>O</td>
<td>附加数据，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据</td>
</tr>
<tr>
<td>longitude</td>
<td>经度</td>
<td>TEXT(32)</td>
<td>O</td>
<td>终端位置所在经度</td>
</tr>
<tr>
<td>latitude</td>
<td>纬度</td>
<td>TEXT(32)</td>
<td>O</td>
<td>终端位置所在纬度</td>
</tr>
<tr>
<td>effective_minutes</td>
<td>订单有效分钟数</td>
<td>NUMBER</td>
<td>O</td>
<td>设置订单有效分钟数，超出有效时长不支付，订单将被关闭，不能再进行支付,默认为5分钟</td>
</tr>
<tr>
<td>extension_parameters</td>
<td>扩展参数</td>
<td>JSONObject</td>
<td>O</td>
<td>扩展输入参数，后续定义增加的参数存储于此JSON可变结构中</td>
</tr>
<tr>
<td>biz_discount</td>
<td>业务优惠明细</td>
<td>JSONArray</td>
<td>O</td>
<td>业务优惠详情放入该字段中</td>
</tr>
</tbody>
</table>
<p>extension_parameters（扩展参数）结构如下：</p>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>trans_instalments</td>
<td>交易分期数</td>
<td>NUMBER</td>
<td>M</td>
<td>花呗交易分期数，可选值：3：3期;6：6期;12：12期每期间隔为一个月。例如，选择3期，所垫付的资金及利息按3个月等额本息还款，每月还款一笔。注：1.花呗及花呗分期须在商户进驻后发生真实收单交易一天后方能使用2.仅部分通道支持支付宝花呗分期，使用前请咨询您的商务负责人是否支持</td>
</tr>
<tr>
<td>user_info</td>
<td>用户信息</td>
<td>TEXT</td>
<td>C</td>
<td>工银e生活登录后返回的JSON格式的用户信息。JSON明文格式：{"cust_id":"XXXXXXX"}当payment_method=ICBC_EPAY时必须</td>
</tr>
<tr>
<td>h5_cashier_desk_type</td>
<td>H5收银台类型</td>
<td>TEXT</td>
<td>C</td>
<td>JSAPI : 微智金服自建收银台，默认值MWEB: 收单机构支付通道自建收银台</td>
<td>biz_discount（业务优惠明细）数组结构如下：</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>discount_serivce_provider</td>
<td>活动提供方</td>
<td>TEXT</td>
<td>O</td>
<td>如：煌上煌、天府银行、意美世家等</td>
</tr>
<tr>
</tr>
<tr>
<td>discount_type</td>
<td>优惠类型</td>
<td>NUMBER</td>
<td>M</td>
<td>1：优惠券</td>
</tr>
<tr>
<td>coupon_id</td>
<td>优惠券ID</td>
<td>TEXT</td>
<td>C</td>
<td>多个使用逗号分隔</td>
</tr>
<tr>
<td>amount</td>
<td>优惠金额</td>
<td>AMOUNT</td>
<td>M</td>
<td>单位：元</td>
</tr>
<tr>
<td>note</td>
<td>备注</td>
<td>TEXT</td>
<td>O</td>
<td></td>
</tr>
</tbody>
</table>
<h2>响应参数</h2>
<h4>公共参数</h4>
<p>参见【<a href="https://www.showdoc.com.cn/1724151917532295/8175841214113582">响应报文 - 公共参数</a>】</p>
<h4>业务参数</h4>
<p>当 code=0 时，data[0] 返回如下参数：</p>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>out_order_no</td>
<td>商户订单号</td>
<td>TEXT(32)</td>
<td>M</td>
<td></td>
</tr>
<tr>
<td>merchant_no</td>
<td>商户号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>商户号，在PayCloud平台入驻后分配的商户号</td>
</tr>
<tr>
<td>store_no</td>
<td>门店编号</td>
<td>TEXT(16)</td>
<td>M</td>
<td>PayCloud分配的门店编号</td>
</tr>
<tr>
<td>trans_status</td>
<td>交易状态</td>
<td>TEXT</td>
<td>M</td>
<td>交易状态:PROCESSING-交易创建，等待买家付款</td>
</tr>
<tr>
<td>h5pay_url</td>
<td>H5收银台支付地址</td>
<td>TEXT(128)</td>
<td>M</td>
<td>PayCloud平台返回的支付地址，商家H5页面跳转到该地址，完成支付</td>
</tr>
</tbody>
</table>