(30 hackdays day 13) Bancbox - 只是金錢的搬運工

今天介紹一個無法測試的API，Bancbox Invest。按照官網的說法

Bancbox builds apps that move money.

Bancbox不創造錢，Bancbox只作金錢的搬運工

Bancbox是一個2008年建立的公司，作事兒很專一："把錢挪來挪去"。一共有三個服務：投資託管，減稅代理（我也不知道是啥...），自動交易。與其餘服務最大的區別呢，就是他們提供API！（btw 網頁作的很漂亮，字體也不錯，Egyptienne URW Light）

爲啥"搬運工"要提供API呢？按照Techcrunch去年的文章裏提到的創始人的話

the first independent escrow service aimed at crowdfunding portals that operate on equity, debt or revenue share models

Bancbox的第一個獨立產品瞄準的是股權，債券和收入分紅（？？）類的衆籌平臺。

當時已經跟三個如上類產品進行合做了99Funding, SoMoLend, Localstake。做爲一個純小白，根據文章描述看起來彷佛是Bancbox能夠幫助原來那些受法律規定，必須提供第三方擔保帳戶的衆籌項目，減小大量的paper work，從而更加關注在自己的業務上（就是「騙錢」）。

$$$

讓咱們來看看一個例子（若是理解錯誤請見諒，若是以爲不煩的話請指教哈）。

假設有個衆籌平臺，好比蝌蚪衆籌～，想爲一堆項目（Issuer是那些找投資的公司）作股權衆籌。這時候確定會須要每一個項目有一個銀行帳戶來保存這些衆籌來的錢。彷佛因爲一些政策緣由，這些錢不能流過衆籌平臺自己。那這個帳號就須要由一個第三方來保管（除去Crowd funding platform和Issuer之外）。
另外，每一個衆籌項目都要經由Issuer和衆籌平臺的一些文書籤名確認就能夠建立一個第三方託管帳號。這個過程結束以後，託管帳號會被激活。衆籌平臺就能夠開始爲項目募款了。

下面的圖講的是一個天使投資人如何投資一個項目。每一個方塊表明了一個或多個API。建立天使投資人，轉移投資款到託管帳號，建立投資項目，投資，收回投資。

APIs

看看人家文檔，直接給程序員curl...

curl -k -v https://sandbox-api.bancboxcrowd.com/crowd/v0/cfp/withdrawFunds \
-d api_key=someApiKey \
-d secret=someSecret \
-d method=ACH \
-d investor_id=someInvestorId \
-d investor_reference_id=someInvestorReferenceId \
-d amount=50 \
-d text="I authorize Bancbox to make this transaction" \
-d client_ip_address=127.0.0.1 \
-d submit_timestamp="2013-11-10 01:31:00" \
-d bank_account_number=someBankAccountNumebr \
-d bank_account_type=SAVING \
-d bank_account_holder=John \
-d bank_account_routing=someBankRoutingNumber

建立投資人，建立投資項目，開戶啥的都有API。咱們要看什麼呢...嗯...看看API設計吧...

POST https://sandbox-api.bancboxcrowd.com/crowd/v0/cfp/createInvestor

在二級域名區分的sandbox-api下（這樣比AVOS那樣在API的body裏更方便一些，切BaseURL就行了），crowd是產品名，而後是API版本，而後是cfp, crowd founding platform，（這麼看來還有給其餘終端的API，好比後臺管理，統計之類的吧），行爲。不過，createInvestor這顯然不RESTful哈，作成POST .../investors會不會更好些呢。

再看看Response

{
    "request_id": 85748180313,
    "status": 1,
    "api_status": 1,
    "id": 99909063016,
    "event_id": 641159
}

status指的是業務層面的狀態，api_status是指的本次API調用的狀況（我喜歡這個）。若是遇到Warning或者Error（我不多見過HTTP API裏面設計Warning的，你知道這幫傢伙不鳥那玩意兒的...），會在結果根下添加。errorCode這類東西變成了一個W-014這樣的string。

"warning": {
    "type": "W-014",
    "message": "BBX admin will need to manually verify this Investor. Please check your email."
}

固然Bancbox也支持Webhook來得到各類事件（也就是相似ping++的回調）。

好啦，Bancbox就介紹這麼多，由於不少流程都是美國的，因此基本在中國用不了。但鑑於中國各類衆籌如此蓬勃，明年又傳說是「投資冬天」，還有目前衆籌方面的各類風險。中國版的Bancbox也許是個不錯的方向。