托管賬戶接口的功能介紹

　　托管賬戶系統的出現很大程序上保證投資者的資金安全。投資者可以通過平臺對托管賬戶系統進行一些交易，例如充值，投資，等。這些功能是如何實現的呢？下面我們以匯付天下（簡稱匯付）為例，介紹托管賬戶接口的功能所必須的一些功能。

　　一、用戶管理類接口

　　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.對賬