结算账户-生成
<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>