收呗

开放接口


获取SDK调用凭证

<p><strong>接口描述:</strong> </p> <ul> <li>用于刷脸设备通过SDK获取到的<code>rawdata</code>换取<code>authinfo</code>调用凭证</li> </ul> <p><strong>接口URL:</strong> </p> <ul> <li>` <a href="https://open.51shoubei.com/openpay/v3/authinfo">https://open.51shoubei.com/openpay/v3/authinfo</a></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;">device_no</td> <td style="text-align: center;">string</td> <td style="text-align: center;">是</td> <td style="text-align: left;">刷脸设备机器号</td> <td>QKNL00017122</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;">rawdata</td> <td style="text-align: center;">string</td> <td style="text-align: center;"></td> <td style="text-align: left;">初始化数据,由人脸SDK的接口返回,authinfo在有效期内可不传</td> <td>H0kvnUgGHKuqflNwtNqCdOVpbO4F</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> <td>390b711df7b6ff92ddd1cf34ca6036a4</td> </tr> </tbody> </table> <p><code>备注:</code> sign 字段传递参数按照字典序用&amp;符号连接最后拼接机构key,UTF-8编码,32位md5加密转换, 示例:a=1&amp;b=1&amp;c=1&amp;d=1&amp;key=51c7d68424e5492199cf7f4734a2b977,详细见 <a href="https://www.showdoc.cc/shoubei?page_id=2361130764227691" title="接入指引">接入指引</a></p> <p><strong>请求示例:</strong></p> <pre><code class="language-json">{ "inst_no":"900024", "device_no":"QKNL000171", "pay_type":"400", "rawdata":"H0kvnUgGHKuqflNwtNqCdOVpbO4Fd4u2NRS2uJz5/n080cOlYF5nNnuyVc+UsX0+q3nVrEYAhJFyxeG8MBxcmZSicjI8UipaehhfFiIHnBZndrCSeGizNs6PSowudTG", "sign":"390b711df7b6ff92ddd1cf34ca6036a4" }</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;">是</td> <td style="text-align: center;">string</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;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">返回信息提示,“查询成功”,“操作失败”等</td> <td>查询成功</td> </tr> <tr> <td style="text-align: left;">inst_no</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">机构号,收呗分配</td> <td>900024</td> </tr> <tr> <td style="text-align: left;">merchant_no</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">设备绑定的商户号</td> <td>851811270001</td> </tr> <tr> <td style="text-align: left;">merchant_name</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">设备绑定的商户名称</td> <td>花木兰花店</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;">851811270001</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> </tr> <tr> <td style="text-align: left;">terminal_no</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">设备对应的终端号</td> <td>70000399</td> </tr> <tr> <td style="text-align: left;">terminal_token</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">设备令牌,暂无作用</td> <td>a5c9bedb5151421d8721e82b661ac4ac</td> </tr> <tr> <td style="text-align: left;">device_no</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">刷脸设备机器号</td> <td>QKNL000171</td> </tr> <tr> <td style="text-align: left;">authinfo</td> <td style="text-align: center;">string</td> <td style="text-align: center;">SDK调用凭证。用于调用SDK的人脸识别接口</td> <td style="text-align: left;">q3OPhFtQBf6KZGqmZhejKCRy5K/ch0kwS11YSsEj9XmUGqcsT2QPHt</td> </tr> <tr> <td style="text-align: left;">expires_in</td> <td style="text-align: center;">string</td> <td style="text-align: center;">authinfo的有效时间, 单位秒。</td> <td style="text-align: left;">7200</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获取face_code使用</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: center;">是</td> <td style="text-align: center;">string</td> <td style="text-align: left;">签名参数</td> <td>390b711df7b6ff92ddd1cf34ca6036a4</td> </tr> </tbody> </table> <p><strong>返回示例:</strong></p> <pre><code class="language-json">{ "return_code": "SUCCESS", "return_msg": "查询成功", "inst_no": "900024", "merchant_no": "851811270001", "merchant_name": "花木兰花店", "shop_no": "", "shop_name": "", "terminal_no": "70000399", "terminal_token": "a5c9bedb5151421d8721e82b661ac4ac", "device_no": "QKNL00017122", "authinfo":"q3OPhFtQBf6KZGqmZhejKCRy5K/ch0kwS11YSsEj9XmUGqcsT2QPHt0Oa7xaCMCoSZTWMmShCo4dOiO5tU+OJEsvSxXzn5m3Nkh747tinNlbpJmVq1zOPj+FJNndkzanxoiAddO8p1EfrmUhJs/aNf0pDfrPoVfkAapK+ZY6blwyaDQ9bB7+KkZq29kObsXOZ3thg+bxP4RAqC0oxNS4JiyP0uA1Euzxtkc9lCTebloFied8stILrMehUKukeMGkZ1SzTyc8/HFHApzHahNPX6yD8ttzYnhe+IRMFJgpuTlIvEOYZUxenPXE1A5clrPvOBeJDszX/OvZl4fpYWPpXAcVQlw+gfYhblt+rT6ALMsD73w/rT4NRriQEEraC4Pfb5yua4qAqv4TVo04", "expires_in":"7200", "out_trade_no":"20000116064119072317350280022", "sign":"390b711df7b6ff92ddd1cf34ca6036a4" }</code></pre>

页面列表

ITEM_HTML