balanced-erlang: balancedpayments client. erlang flavored.
Status
balanced-erlang is a minimal balancedpayments client.
It currently only supports operations required to pay and get paid. Anything else you need can be handled from the balancedpayments console for now.
The operations we have so far: creating a new anonymous account, creating a new account as a person/merchant so they can receive payments, attaching a credit card to an account, attaching a bank account to an account, debiting a credit card, and crediting a bank account.
Usage
Overview
matt@nibonium:~/repos/balanced-erlang% erl -pa ebin deps/*/ebin
Erlang R16B (erts-5.10.1) [source] [64-bit] [smp:4:4] [async-threads:10] [hipe] [kernel-poll:false] [dtrace]
Eshell V5.10.1 (abort with ^G)
1> inets:start().
ok
2> ssl:start().
ok
3> application:start(balanced).
ok
4> application:set_env(balanced, auth_token, "da3da6de7c9311e288c9026ba7f8ec28").
ok
5> TestMarketId = "TEST-MP6E3EVlPOsagSdcBNUXWBDQ".
"TEST-MP6E3EVlPOsagSdcBNUXWBDQ"
6> balanced:account_create_anonymous(TestMarketId).
{success,[{'_type',<<"account">>},
{'_uris',[{holds_uri,[{'_type',<<"page">>},
{key,<<"holds">>}]},
{bank_accounts_uri,[{'_type',<<"page">>},
{key,<<"bank_accounts">>}]},
{refunds_uri,[{'_type',<<"page">>},{key,<<"refunds">>}]},
{customer_uri,[{'_type',<<"customer">>},
{key,<<"customer">>}]},
{debits_uri,[{'_type',<<"page">>},{key,<<"debits">>}]},
{transactions_uri,[{'_type',<<"page">>},
{key,<<"transactions">>}]},
{credits_uri,[{'_type',<<"page">>},{key,<<"credits">>}]},
{cards_uri,[{'_type',<<"page">>},{key,<<"cards">>}]}]},
{bank_accounts_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC1JATXa5jXeFRUKvC26Oobc/bank_ac"...>>},
{meta,[]},
{transactions_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC1JATXa5jXeFRUKvC26Oobc"...>>},
{email_address,null},
{id,<<"AC1JATXa5jXeFRUKvC26Oobc">>},
{credits_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC1JATXa5jXe"...>>},
{cards_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC1JATXa"...>>},
{holds_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC1J"...>>},
{name,null},
{roles,[]},
{created_at,<<"2013-05-14T16:27:51.640303Z">>},
{uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWB"...>>},
{refunds_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBN"...>>},
{customer_uri,<<"/v1/customers/AC1JATXa5jXeFRUKvC26Oo"...>>},
{debits_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPO"...>>}]}
7> balanced:account_create_as_person(TestMarketId, "My Name", "+15551234567", "11101", "320 Pioneer Way", "1983-06-21", "[email protected]").
{success,[{'_type',<<"account">>},
{'_uris',[{holds_uri,[{'_type',<<"page">>},
{key,<<"holds">>}]},
{bank_accounts_uri,[{'_type',<<"page">>},
{key,<<"bank_accounts">>}]},
{refunds_uri,[{'_type',<<"page">>},{key,<<"refunds">>}]},
{customer_uri,[{'_type',<<"customer">>},
{key,<<"customer">>}]},
{debits_uri,[{'_type',<<"page">>},{key,<<"debits">>}]},
{transactions_uri,[{'_type',<<"page">>},
{key,<<"transactions">>}]},
{credits_uri,[{'_type',<<"page">>},{key,<<"credits">>}]},
{cards_uri,[{'_type',<<"page">>},{key,<<"cards">>}]}]},
{bank_accounts_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC3YLJzg64VolwjSIXBO9YsG/bank_ac"...>>},
{meta,[]},
{transactions_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC3YLJzg64VolwjSIXBO9YsG"...>>},
{email_address,null},
{id,<<"AC3YLJzg64VolwjSIXBO9YsG">>},
{credits_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC3YLJzg64Vo"...>>},
{cards_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC3YLJzg"...>>},
{holds_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/accounts/AC3Y"...>>},
{name,<<"My Name">>},
{roles,[<<"merchant">>]},
{created_at,<<"2013-05-14T16:29:55.377273Z">>},
{uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWB"...>>},
{refunds_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBN"...>>},
{customer_uri,<<"/v1/customers/AC3YLJzg64VolwjSIXBO9Y"...>>},
{debits_uri,<<"/v1/marketplaces/TEST-MP6E3EVlPO"...>>}]}
8> CreatedAccountId = "AC3YLJzg64VolwjSIXBO9YsG".
"AC3YLJzg64VolwjSIXBO9YsG"
9> PublicDevCardURI = "/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/cards/CC7FHSFn8oRlSJSAjiBpRtLa".
"/v1/marketplaces/TEST-MP6E3EVlPOsagSdcBNUXWBDQ/cards/CC7FHSFn8oRlSJSAjiBpRtLa"
10> balanced:account_add_card(TestMarketId, CreatedAccountId, PublicDevCardURI).
{error,409,
[{status,<<"Conflict">>},
{category_code,<<"card-already-funding-src">>},
{additional,null},
{status_code,409},
{category_type,<<"logical">>},
{extras,[]},
{request_id,<<"OHMb2450608bcb311e2848c026ba7cac9da">>},
{description,<<"Card has already been associated with an account. Your request i"...>>}]}
11> PublicDevBankURI = "/v1/bank_accounts/BA7IU7MDWuhYHjlDID0WVXG".
"/v1/bank_accounts/BA7IU7MDWuhYHjlDID0WVXG"
12> balanced:account_add_bank(TestMarketId, CreatedAccountId, PublicDevBankURI).
{error,409,
[{status,<<"Conflict">>},
{category_code,<<"bank-account-already-associated">>},
{additional,null},
{status_code,409},
{category_type,<<"logical">>},
{extras,[]},
{request_id,<<"OHMc36d5408bcb311e2a260026ba7c1aba6">>},
{description,<<"Bank account has already been associated with an account. Your r"...>>}]}
13> balanced:credit_detail(TestMarketId, CreatedAccountId, "300000", "Test Transaction").
{error,409,
[{status,<<"Conflict">>},
{category_code,<<"no-funding-destination">>},
{additional,null},
{status_code,409},
{category_type,<<"logical">>},
{extras,[]},
{request_id,<<"OHMddc8920ebcb311e2a6a6026ba7cac9da">>},
{description,<<"Account AC3YLJzg64VolwjSIXBO9YsG has no funding destination. You"...>>}]}
14> balanced:debit(TestMarketId, CreatedAccountId, "65000000", "Test Debit", "Debit Note Internal").
{error,409,
[{status,<<"Conflict">>},
{category_code,<<"no-funding-source">>},
{additional,null},
{status_code,409},
{category_type,<<"logical">>},
{extras,[]},
{request_id,<<"OHMf7fca1ecbcb311e2ae3f026ba7c1aba6">>},
{description,<<"Account AC3YLJzg64VolwjSIXBO9YsG has no funding source. Your req"...>>}]}
Note: The last few errors above are normal. The balanced dev tokens/keys/URIs don't work properly for actual testing. Annoying.
Configuration
You must start inets and ssl before using balanced.
By default, erlang-balanced uses the global balanced API test token. You must change this to your private API key before you can receive payments:
inets:start(),
ssl:start(),
application:start(balanced),
application:set_env(balanced, auth_token, "da3da6de7c9311e288c9026ba7f8ec28").
Building
rebar get-deps
rebar compile
Testing
rebar eunit skip_deps=true suite=balanced
Next Steps
In no specific order:
- Flesh out remaining balanced API
- Add tests for error conditions
- Move from env-specified auth token to something more call specific
- Options:
- Per-call auth token (balanced:charge_card(AuthToken, ...))
- Leave env, but add per-auth token options
- Options:
Contributions
Want to help? Patches welcome.
- Find a bug. Fix a bug.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent