托管賬戶(hù)接口的功能介紹

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

　　一、用戶(hù)管理類(lèi)接口

　　1.用戶(hù)開(kāi)戶(hù)

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

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

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

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

　　2.用戶(hù)綁卡

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

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

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

　　3.用戶(hù)登錄

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

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

　　二、用戶(hù)管理類(lèi)接口

　　1.網(wǎng)銀充值

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

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

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

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

　　（2）商戶(hù)調(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ì)為每家商戶(hù)配置可以收取的最大手續(xù)費(fèi)費(fèi)率以控制上限）

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

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

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

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

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

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

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

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

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

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

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

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

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

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

　　（3）.入賬賬戶(hù)（InAcctId）為商戶(hù)子賬戶(hù)時(shí)必須填寫(xiě)，如為用戶(hù)專(zhuān)屬賬戶(hù)時(shí)可為空

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

　　6.取現(xiàn)

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

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

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

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

　　三、查詢(xún)類(lèi)接口

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

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

　　2.商戶(hù)子賬戶(hù)信息查詢(xún)

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

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

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

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

　　4.對(duì)賬