托管账户接口的功能介绍

　　托管账户系统的出现很大程序上保证投资者的资金安全。投资者可以通过平台对托管账户系统进行一些交易，例如充值，投资，等。这些功能是如何实现的呢？下面我们以汇付天下（简称汇付）为例，介绍托管账户接口的功能所必须的一些功能。

　　一、用户管理类接口

　　1.用户开户

　　（1）.用户在进行交易之前，商户需要调用此接口开通汇付的托管账户

　　（2）.用户的登录名会自动加上商户的前缀（商户上线前，汇付工作人员会为每个商户进行配置）

　　（3）.开户完成后，汇付会将用户的用户名（UsrId）和用户客户号（UsrCustId）返回给商户，商户需要特别记录下这两个字段，用于识别用户的身份以及完成后续的交易。

　　注：开户过程中，汇付会对用户的姓名、身份证作实名验证；对用户的手机号做真实性校验

　　2.用户绑卡

　　（1）.用户在取现之前，必须绑定至少一张银行账户

　　（2）.用户在平台上设置、添加取现银行卡时，商户调用此接口，用户将在汇付的页面中完成选卡的操作

　　（3）.绑卡完成后，汇付会将银行代码、银行卡号、绑定结果返回给商户，商户可根据业务需要决定是否记录这些信息

　　3.用户登录

　　（1）.平台可在网站上放置类似于第三方托管账户的入口，供用户点击，然后调用此接口，登录成功后即可查看到其在汇付的专属托管账户

　　（2）.请求参数中必须包含MerCustId与UsrCustId

　　二、用户管理类接口

　　1.网银充值

　　每个银行可支持的业务类型不同，具体见充值网关支持列表

　　如商户希望让用户在平台上先选择银行，则需要根据汇付的银行支持列表的变动调整平台的显示，以防止业务无常进行

　　2.主动投标

　　（1）.投资人在平台上进行投标，投标金额等信息在网站上完成填写后，商户调用此接口，用户将在汇付页面中对投标的信息进行确认

　　（2）商户调用接口时，需将该笔投标的还款信息同时传送，汇付记录此信息作为今后扣款的依据

　　（3）接口中MaxTenderRate及BorrowerRate均为向投资人/借款人收取的最大手续费费率值，此费率包含各平台向投资人/借款人收取的管理费、、风险金等除额外费用的总和（为控制风险，汇付会为每家商户配置可以收取的最大手续费费率以控制上限）

　　（4）在用户投标成功后，商户可根据业务需要自行调用冻结接口将投资人账户的该笔资金冻结

　　3.自动扣款（放款）

　　（1）.此接口为后台接口，商户可调用此接口用于满标审核完成后的放款操作

　　（2）.放款的资金流向为：TransAmt（投资人借款人）；Fee（投资人商户担保账户、专属账户）

　　（3）.如商户之前对投资人账户资金做过冻结，则放款之前需要先调用解冻接口解冻相应的资金

　　（4）.支持商户分多次进行放款，汇付会比对投标订单中的信息，并记录下每次放款的金额累计进行比对

　　（5）.IsDefault字段表示是否需要在放款后发起自动取现，此时将会取现到用户的默认取现卡中（如果商户没有开通垫资服务，则当日取现可能会失败）

　　4.自动扣款（还款）

　　（1）.此接口为后台接口，商户可调用此接口到期后的借款人还款、担保还款等还款操作

　　（2）.还款的资金流向为：TransAmt（借款人投资人、商户担保账户投资人、借款人商户担保账户）；Fee（借款人商户担保账户、专属账户）

　　（3）.支持借款人分多次进行还款，汇付会比对投标订单中的信息，并记录下每次放款的金额累计进行比对

　　5.转账（商户用）

　　（1）.本接口支持商户从自身子账户中将资金转出至商户的其他子账户或商户下用户的专属账户

　　（2）.出账账户（OutAcctId）必须为商户的子账户（保证金账户除外）

　　（3）.入账账户（InAcctId）为商户子账户时必须填写，如为用户专属账户时可为空

　　注：商户子账号可以通过商户子账户信息查询接口进行查询

　　6.取现

　　（1）.用户可在平台上发起取现，商户调用取现接口，用户需要在汇付页面进行交易密码的确认

　　（2）.银行卡（OpenAcctId）可选，用户可在汇付页面选择已绑定的银行卡进行取现

　　（3）.取现金额（TransAmt）必填

　　注：商户可先调用余额查询接口，查询出用户的可取金额

　　三、查询类接口

　　1.余额查询(后台)

　　此接口供商户查询其用户在专属账户的余额情况，包括可用余额、冻结余额等

　　2.商户子账户信息查询

　　此接口供商户查询自身账户的子账户号信息

　　3.交易状态查询

　　此接口供商户查询放款、还款交易的状态

　　此接口供商户查询放款/还款交易记录、商户转账对账、取现对账、充值对账

　　4.对账