HuiPay-development_one

开发中的文档


结算账户-生成

<h5>简要描述</h5> <p>创建结算账户对象是为一个已创建用户对象创建结算账户,用于对用户分账金额的结算,目前仅支持绑定银行卡结算账户。</p> <p>用户创建对私结算账户时,会对银行卡号、银行卡开户姓名、身份证号三要素认证,若认证失败,则创建结算账户失败。</p> <p>每个结算账户对象系统会生成一个唯一的 id,可用于查询结算账户对象,或者删除结算账户对象。</p> <p>注:当银行账户类型为2-对私时,请务必绑定一张 Ⅰ类 银行卡,若绑定了一张 Ⅱ类 银行卡时,当结算金额超过10000元时,银行会提示金额超限导致结算失败。</p> <p>注:若创建结算账户对象是在22:30分之后创建成功的,那么该用户的结算会延后一个结算日结算;若是在22:30分之前,用户会正常结算。</p> <p>注:若用户想更新银行卡,则需要先调用删除结算账户对象,再使用原 member_id 重新创建结算账户对象,且必须与原创建结算账户使用的身份证和银行卡户名保持一致。</p> <h5>请求URL</h5> <ul> <li><code>https://pay.bjtdba.com/v1/HuiPay/create_settleAccount</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;"></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</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> <tr> <td style="text-align: left;">account_info</td> <td style="text-align: left;">是</td> <td style="text-align: left;">object</td> <td></td> </tr> <tr> <td style="text-align: left;">account_info.card_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>银行卡号</td> </tr> <tr> <td style="text-align: left;">account_info.card_name</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>银行卡对应的户名</td> </tr> <tr> <td style="text-align: left;">account_info.cert_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">否</td> <td>证件号,银行账户类型为对私时,必填</td> </tr> <tr> <td style="text-align: left;">account_info.cert_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">否</td> <td>证件类型,仅支持:00-身份证,银行账户类型为对私时,必填</td> </tr> <tr> <td style="text-align: left;">account_info.tel_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>手机号</td> </tr> <tr> <td style="text-align: left;">account_info.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;">account_info.bank_name</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>开户银行名称</td> </tr> <tr> <td style="text-align: left;">account_info.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;">account_info.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;">account_info.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;">channel</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>目前仅支持:bank_account(银行卡)</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{ "app_id":"app_bd46cc29-6b15-4bd2-a70f-65187485f468", "member_id":"Member_personal16377252002152", "api_key":"api_live_d996bd55-5ba9-4abc-a4a7-ec0574a24516", "account_info":{ "card_id":"6217000210012362017", "card_name":"林烁鸿", "cert_id":"445221199412155018", "cert_type":"00", "tel_no":"15622104601", "bank_code":"01050000", "bank_acct_type":"2", "prov_code":"0013", "area_code":"1307" }, "channel":"bank_account", "union_id":"0001" }</code></pre> <h5>返回示例</h5> <pre><code>{ "code":200, "message":"success", "data":{ "object":"settle_account", "status":"succeeded", "prod_mode":"true", "id":"0288473137030912", "create_time":"163718884", "app_id":"app_bd46cc29-6-4bd2-a70f-65187485f468", "member_id":"Member_personal18124625334", "channel":"bank_account", "account_info":{ "card_id":"621483104******2", "card_name":"伟", "cert_type":"00", "cert_id":"1304351995******39", "tel_no":"1853230****", "bank_code":"03080000", "bank_name":"", "bank_acct_type":"2", "prov_code":"0011", "area_code":"1100" } } }</code></pre>

页面列表

ITEM_HTML