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