发起刷脸支付接口
<p><strong>接口描述:</strong></p>
<ul>
<li>用于商户的app在获取人脸支付凭证后,调用此接口发起支付</li>
</ul>
<p><strong>接口URL:</strong></p>
<ul>
<li><code>https://open.51shoubei.com/openpay/v3/facepay</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求头部:</strong></p>
<table>
<thead>
<tr>
<th>标签</th>
<th>必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>是</td>
<td>application/json</td>
</tr>
</tbody>
</table>
<p><strong>请求参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">inst_no</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">收呗机构号</td>
<td>900024</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">商户号</td>
<td>851811270001</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">门店号,非必传</td>
<td style="text-align: left;">861811270001</td>
</tr>
<tr>
<td style="text-align: left;">terminal_no</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">终端号</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">支付类型,400微信</td>
<td>400</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">流水号</td>
<td>9e228b7298234e968cd66bf0884613ab</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">支付时间</td>
<td>20190719120735</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">金额,单位分</td>
<td>1</td>
</tr>
<tr>
<td style="text-align: left;">open_id</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">用户在商户appid下的唯一标识</td>
</tr>
<tr>
<td style="text-align: left;">face_code</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">人脸凭证,用于刷脸支付</td>
</tr>
<tr>
<td style="text-align: left;">out_trade_no</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">SDK授权生成的订单号</td>
<td style="text-align: left;">20000116064119072317350280022</td>
</tr>
<tr>
<td style="text-align: left;">appid</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">商户appid</td>
</tr>
<tr>
<td style="text-align: left;">order_body</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">订单描述</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">附加数据</td>
</tr>
<tr>
<td style="text-align: left;">goods_detail</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">商品信息</td>
</tr>
<tr>
<td style="text-align: left;">notify_url</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">回调地址</td>
</tr>
<tr>
<td style="text-align: left;">invoice_entry</td>
<td style="text-align: center;">string(256)</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">商户开发票链接</td>
<td>开发票连接地址</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">签名检验串</td>
</tr>
</tbody>
</table>
<p><code>备注:</code> sign 字段传递参数按照字典序用&符号连接最后拼接机构key,UTF-8编码,32位md5加密转换, 示例:a=1&b=1&c=1&d=1&key=51c7d68424e5492199cf7f4734a2b977,详细见 <a href="https://www.showdoc.cc/shoubei?page_id=2361130764227691" title="接入指引">接入指引</a></p>
<p><strong>请求示例:</strong></p>
<pre><code class="language-json">{
"face_code": "ecc799dc-1327-412f-8d0d-2775bf307602",
"inst_no": "900024",
"mch_no": "851811270001",
"open_id": "orxYXv7xrRR0SPDGhb7xgmSmPWHY",
"out_trade_no":"20000116064119072317350280022",
"pay_time": "20190724180824",
"pay_trace_no": "2019072418161577620",
"pay_type": "400",
"sign": "0cf9d3299f4ff4eddd35f18c6f0380ac",
"terminal_no": "70000399",
"total_amount": "1"
}</code></pre>
<p><strong>返回参数:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">响应码:SUCCESS成功,FAIL失败,响应码仅代表通信或参数</td>
<td>SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">返回信息提示,“支付成功”,“签名失败” 等</td>
<td>支付成功</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">业务结果:PAY_SUCCESS 支付成功 ,PAY_IN_PROCESS 支付中 ,PAY_FAIL 支付失败,只有在return_code为SUCCESS时才会返回。</td>
<td>PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">商户号</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">门店号</td>
<td>86000033007</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">商户名称</td>
<td>休休4D</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">门店名称</td>
<td>1号店</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">支付类型:300支付宝,400微信</td>
<td>400</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">请求流水号(必须在商户系统内唯一;且长度不超过64字节)</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">请求交易时间,yyyyMMddHHmmss</td>
<td>20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">end_time</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">支付完成时间,yyyyMMddHHmmss</td>
<td>20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">支付金额,单位:分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">receipt_amount</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">商户实收金额,单位:分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">收呗订单号</td>
<td>20000002814118090716435200001</td>
</tr>
<tr>
<td style="text-align: left;">td_trade_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">微信或支付宝订单号</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">qd_trade_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">渠道订单号,支付渠道订单号 可以用于扫码退款</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">扩展字段原样返回</td>
<td>1234</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">签名字符串</td>
<td style="text-align: left;">51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>返回示例:</strong></p>
<pre><code class="language-json">{
"end_time": "20190724175124",
"mch_name": "花木兰花店",
"mch_no": "851811270001",
"pay_time": "20190724175433",
"pay_trace_no": "2019072417576113356",
"pay_type": "400",
"result_code": "PAY_SUCCESS",
"return_code": "SUCCESS",
"return_msg": "支付成功",
"shop_name": "",
"shop_no": "",
"sign": "6bd0468ff2972cb995a4e05fa36a4890",
"td_trade_no": "4200000393201907248409820538",
"total_amount": "1",
"trade_no": "20000033464119072417543380003",
"user_id": "orxYXv7xrRR0SPDGhb7xgmSmPWHY"
}</code></pre>