HuiPay-development_one

开发中的文档


创建企业用户

<h5>简要描述</h5> <p>商户需要保证 member_id 在应用 id 下唯一。 创建企业用户对象实际是发起企业用户申请,同步返回 pending 状态表示申请已受理,人工审核后,审核成功或失败结果会 异步消息通知 告知。</p> <p>审核成功,则创建企业用户对象成功;审核失败,您可根据审核失败原因修改对应要素,重新调用创建企业用户对象发起申请。</p> <p>创建企业用户对象若上送了银行代码、银行账户类型、银行卡号、银行卡开户姓名要素时,人工审核成功后,系统自动创建企业用户结算账户对象;若未上送,则不会自动创建结算账户对象,但您可调用 结算账户-生成 单独创建结算账户。</p> <p>注:当银行账户类型为2-对私时,请务必绑定一张 Ⅰ类 银行卡,若绑定了一张 Ⅱ类 银行卡时,当结算金额超过10000元时,银行会提示金额超限导致结算失败。</p> <ul> <li><a href='https://www.showdoc.com.cn/p/771ffd5460dbefeed31e5f7e5b402fbb'>异步通知</a> <h5>请求URL</h5></li> <li><code>https://pay.bjtdba.com/v1/HuiPay/crate_merber_enterprise</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>参数</h5> <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;">union_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>用户id 在平台注册后产生的用户唯一标识</td> </tr> <tr> <td style="text-align: left;">app_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>应用的ID</td> </tr> <tr> <td style="text-align: left;">order_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求订单号,只能为英文、数字或者下划线的一种或多种组合,保证在app_id下唯一</td> </tr> <tr> <td style="text-align: left;">member_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户下的用户id,只能为英文、数字或者下划线的一种或多种组合,保证在app_id下唯一</td> </tr> <tr> <td style="text-align: left;">name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>企业名称</td> </tr> <tr> <td style="text-align: left;">prov_code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>省份编码 (省市编码)</td> </tr> <tr> <td style="text-align: left;">area_code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>地区编码 (省市编码)</td> </tr> <tr> <td style="text-align: left;">social_credit_code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>统一社会信用码</td> </tr> <tr> <td style="text-align: left;">social_credit_code_expires</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>统一社会信用证有效期</td> </tr> <tr> <td style="text-align: left;">business_scope</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经营范围</td> </tr> <tr> <td style="text-align: left;">legal_person</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人姓名</td> </tr> <tr> <td style="text-align: left;">legal_cert_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人身份证号码</td> </tr> <tr> <td style="text-align: left;">legal_cert_id_expires</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人身份证有效期</td> </tr> <tr> <td style="text-align: left;">legal_mp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人手机号</td> </tr> <tr> <td style="text-align: left;">address</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>企业地址</td> </tr> <tr> <td style="text-align: left;">zip_code</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>邮编</td> </tr> <tr> <td style="text-align: left;">telphone</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>企业电话</td> </tr> <tr> <td style="text-align: left;">email</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>企业邮箱</td> </tr> <tr> <td style="text-align: left;">attach_file</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>上传附件 base64 格式 内容须包含三证合一证件照、法人身份证正面照、法人身份证反面照、开户银行许可证照。 压缩 zip包后上传,最大限制为 9 M 对私则开户银行许可证照可不传</td> </tr> <tr> <td style="text-align: left;">bank_code</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>银行代码,如果需要自动开结算账户,本字段必填(详见附录 银行代码)</td> </tr> <tr> <td style="text-align: left;">bank_acct_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>银行账户类型:1-对公;2-对私;如果需要自动开结算账户,本字段必填</td> </tr> <tr> <td style="text-align: left;">card_no</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>银行卡号,如果需要自动开结算账户,本字段必填</td> </tr> <tr> <td style="text-align: left;">card_name</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>银行卡对应的户名,如果需要自动开结算账户,本字段必填;<br>若银行账户类型是对公,必须与企业名称一致</td> </tr> <tr> <td style="text-align: left;">notify_url</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>异步通知地址,url为http/https路径,服务器POST回调,URL 上请勿附带参数</td> </tr> <tr> <td style="text-align: left;">api_key</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>api_key</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{ "app_id":"app_bd46cc29-6b15-4bd2-a70f-65187485f468", "order_no":"163781969628342", "member_id":"Member_enterprise_16378196966159", "name":"\u5317\u4eac\u5929\u5730\u535a\u7231\u79d1\u6280\u6709\u9650\u516c\u53f8", "prov_code":"0011", "area_code":"1100", "social_credit_code":"91110105697724649E", "social_credit_code_expires":"20991231", "business_scope":"\u6280\u672f\u5f00\u53d1\u3001\u6280\u672f\u54a8\u8be2\u3001\u6280\u672f\u670d\u52a1\u3001\u6280\u672f\u8f6c\u8ba9\uff1b\u7ffb\u8bd1\u670d\u52a1\uff1b\u7ecf\u6d4e\u8d38\u6613\u54a8\u8be2", "legal_person":"\u7fc1\u96e8\u5a77", "legal_cert_id":"321183199403191327", "legal_cert_id_expires":"20261103", "legal_mp":"18532307264", "address":"\u5317\u4eac\u5e02\u671d\u9633\u533a\u671b\u4eac\u4e1c\u56ed\u56db\u533a13\u53f7\u697c-4\u81f333\u5c42101\u518516\u5c4216B116\u5ba4", "zip_code":"000000", "telphone":"4000000000", "email":"15456456456@qq.com", "attach_file":"data:application\/x-zip-compressed;base64,UEsDBAoAAAAAANWIeFMA", "bank_code":"03080000", "bank_acct_type":"1", "card_no":"6214831049598235", "card_name":"\u5317\u4eac\u5929\u5730\u535a\u7231\u79d1\u6280\u6709\u9650\u516c\u53f8", "notify_url":"pay39.cn\/jishujifgsigsdgui\/ashag", "api_key":"api_live_d996bd55-5ba9-4abc-a4a7-ec0574a24516", "union_id":"0001" }</code></pre> <h5>返回示例</h5> <pre><code>{ "code":200, "message":"success", "data":{ "app_id":"app_bd46cc29-4bd2-a70f-65187485f468", "created_time":"20211125140832", "member_id":"Member_entese_16378205061860", "order_no":"163782050632348", "status":"pending", "prod_mode":"true" } }</code></pre> <h5>返回参数说明</h5> <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;">status</td> <td style="text-align: left;">sting</td> <td>pending处理中<br>succeeded成功<br>failed失败</td> </tr> </tbody> </table>

页面列表

ITEM_HTML