(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也许是个不错的方向。