托管賬戶接口的功能介紹

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

　　一、用戶管理類接口

　　1.用戶開戶

　　（1）.用戶在進(jìn)行交易之前，商戶需要調(diào)用此接口開通匯付的托管賬戶

　　（2）.用戶的登錄名會(huì)自動(dòng)加上商戶的前綴（商戶上線前，匯付工作人員會(huì)為每個(gè)商戶進(jìn)行配置）

　　（3）.開戶完成后，匯付會(huì)將用戶的用戶名（UsrId）和用戶客戶號(hào)（UsrCustId）返回給商戶，商戶需要特別記錄下這兩個(gè)字段，用于識(shí)別用戶的身份以及完成后續(xù)的交易。

　　注：開戶過程中，匯付會(huì)對(duì)用戶的姓名、身份證作實(shí)名驗(yàn)證；對(duì)用戶的手機(jī)號(hào)做真實(shí)性校驗(yàn)

　　2.用戶綁卡

　　（1）.用戶在取現(xiàn)之前，必須綁定至少一張銀行賬戶

　　（2）.用戶在平臺(tái)上設(shè)置、添加取現(xiàn)銀行卡時(shí)，商戶調(diào)用此接口，用戶將在匯付的頁(yè)面中完成選卡的操作

　　（3）.綁卡完成后，匯付會(huì)將銀行代碼、銀行卡號(hào)、綁定結(jié)果返回給商戶，商戶可根據(jù)業(yè)務(wù)需要決定是否記錄這些信息

　　3.用戶登錄

　　（1）.平臺(tái)可在網(wǎng)站上放置類似于第三方托管賬戶的入口，供用戶點(diǎn)擊，然后調(diào)用此接口，登錄成功后即可查看到其在匯付的專屬托管賬戶

　　（2）.請(qǐng)求參數(shù)中必須包含MerCustId與UsrCustId

　　二、用戶管理類接口

　　1.網(wǎng)銀充值

　　每個(gè)銀行可支持的業(yè)務(wù)類型不同，具體見充值網(wǎng)關(guān)支持列表

　　如商戶希望讓用戶在平臺(tái)上先選擇銀行，則需要根據(jù)匯付的銀行支持列表的變動(dòng)調(diào)整平臺(tái)的顯示，以防止業(yè)務(wù)無常進(jìn)行

　　2.主動(dòng)投標(biāo)

　　（1）.投資人在平臺(tái)上進(jìn)行投標(biāo)，投標(biāo)金額等信息在網(wǎng)站上完成填寫后，商戶調(diào)用此接口，用戶將在匯付頁(yè)面中對(duì)投標(biāo)的信息進(jìn)行確認(rèn)

　　（2）商戶調(diào)用接口時(shí)，需將該筆投標(biāo)的還款信息同時(shí)傳送，匯付記錄此信息作為今后扣款的依據(jù)

　　（3）接口中MaxTenderRate及BorrowerRate均為向投資人/借款人收取的最大手續(xù)費(fèi)費(fèi)率值，此費(fèi)率包含各平臺(tái)向投資人/借款人收取的管理費(fèi)、、風(fēng)險(xiǎn)金等除額外費(fèi)用的總和（為控制風(fēng)險(xiǎn)，匯付會(huì)為每家商戶配置可以收取的最大手續(xù)費(fèi)費(fèi)率以控制上限）

　　（4）在用戶投標(biāo)成功后，商戶可根據(jù)業(yè)務(wù)需要自行調(diào)用凍結(jié)接口將投資人賬戶的該筆資金凍結(jié)

　　3.自動(dòng)扣款（放款）

　　（1）.此接口為后臺(tái)接口，商戶可調(diào)用此接口用于滿標(biāo)審核完成后的放款操作

　　（2）.放款的資金流向?yàn)椋篢ransAmt（投資人借款人）；Fee（投資人商戶擔(dān)保賬戶、專屬賬戶）

　　（3）.如商戶之前對(duì)投資人賬戶資金做過凍結(jié)，則放款之前需要先調(diào)用解凍接口解凍相應(yīng)的資金

　　（4）.支持商戶分多次進(jìn)行放款，匯付會(huì)比對(duì)投標(biāo)訂單中的信息，并記錄下每次放款的金額累計(jì)進(jìn)行比對(duì)

　　（5）.IsDefault字段表示是否需要在放款后發(fā)起自動(dòng)取現(xiàn)，此時(shí)將會(huì)取現(xiàn)到用戶的默認(rèn)取現(xiàn)卡中（如果商戶沒有開通墊資服務(wù)，則當(dāng)日取現(xiàn)可能會(huì)失敗）

　　4.自動(dòng)扣款（還款）

　　（1）.此接口為后臺(tái)接口，商戶可調(diào)用此接口到期后的借款人還款、擔(dān)保還款等還款操作

　　（2）.還款的資金流向?yàn)椋篢ransAmt（借款人投資人、商戶擔(dān)保賬戶投資人、借款人商戶擔(dān)保賬戶）；Fee（借款人商戶擔(dān)保賬戶、專屬賬戶）

　　（3）.支持借款人分多次進(jìn)行還款，匯付會(huì)比對(duì)投標(biāo)訂單中的信息，并記錄下每次放款的金額累計(jì)進(jìn)行比對(duì)

　　5.轉(zhuǎn)賬（商戶用）

　　（1）.本接口支持商戶從自身子賬戶中將資金轉(zhuǎn)出至商戶的其他子賬戶或商戶下用戶的專屬賬戶

　　（2）.出賬賬戶（OutAcctId）必須為商戶的子賬戶（保證金賬戶除外）

　　（3）.入賬賬戶（InAcctId）為商戶子賬戶時(shí)必須填寫，如為用戶專屬賬戶時(shí)可為空

　　注：商戶子賬號(hào)可以通過商戶子賬戶信息查詢接口進(jìn)行查詢

　　6.取現(xiàn)

　　（1）.用戶可在平臺(tái)上發(fā)起取現(xiàn)，商戶調(diào)用取現(xiàn)接口，用戶需要在匯付頁(yè)面進(jìn)行交易密碼的確認(rèn)

　　（2）.銀行卡（OpenAcctId）可選，用戶可在匯付頁(yè)面選擇已綁定的銀行卡進(jìn)行取現(xiàn)

　　（3）.取現(xiàn)金額（TransAmt）必填

　　注：商戶可先調(diào)用余額查詢接口，查詢出用戶的可取金額

　　三、查詢類接口

　　1.余額查詢(后臺(tái))

　　此接口供商戶查詢其用戶在專屬賬戶的余額情況，包括可用余額、凍結(jié)余額等

　　2.商戶子賬戶信息查詢

　　此接口供商戶查詢自身賬戶的子賬戶號(hào)信息

　　3.交易狀態(tài)查詢

　　此接口供商戶查詢放款、還款交易的狀態(tài)

　　此接口供商戶查詢放款/還款交易記錄、商戶轉(zhuǎn)賬對(duì)賬、取現(xiàn)對(duì)賬、充值對(duì)賬

　　4.對(duì)賬