balanced 0.8.2 → 1.0.beta1

data/scenarios/reversal_list/definition.rb

@@ -0,0 +1 @@
+Balanced::Reversal.all

data/scenarios/reversal_list/request.rb

@@ -0,0 +1,2 @@
+<%= boiler_plate %>
+reversals = Balanced::Reversal.all

data/scenarios/reversal_list/ruby.mako

@@ -0,0 +1,36 @@
+% if mode == 'definition':
+Balanced::Reversal.all
+
+% elif mode == 'request':
+require 'balanced'
+Balanced.configure('ak-test-1kvvievk0Qqw5wQPsrlM9g7wQwNe62cyc')
+
+reversals = Balanced::Reversal.all
+% elif mode == 'response':
+[#<Balanced::Reversal:0x007fdc9b129420
+  @attributes=
+   {"amount"=>3000,
+    "created_at"=>"2014-01-27T22:58:21.214829Z",
+    "currency"=>"USD",
+    "description"=>"Reversal for Order #1111",
+    "failure_reason"=>nil,
+    "failure_reason_code"=>nil,
+    "href"=>"/reversals/RV42n8M9XZWna427oPDDi4RG",
+    "id"=>"RV42n8M9XZWna427oPDDi4RG",
+    "links"=>{"credit"=>"CR40neytmVG2HDBp1opfF7sY", "order"=>nil},
+    "meta"=>
+     {"fulfillment.item.condition"=>"OK",
+      "merchant.feedback"=>"positive",
+      "user.refund_reason"=>"not happy with product"},
+    "status"=>"succeeded",
+    "transaction_number"=>"RV219-169-0008",
+    "updated_at"=>"2014-01-27T22:58:22.190749Z"},
+  @hyperlinks=
+   {"credit"=>
+     #<Proc:0x007fdc9b103c48/lib/balanced/resources/resource.rb:60 (lambda)>,
+    "events"=>
+     #<Proc:0x007fdc9b0aef68/lib/balanced/utils.rb:6 (lambda)>,
+    "order"=>
+     #<Proc:0x007fdc9b09f4c8/lib/balanced/utils.rb:6 (lambda)>}>]
+
+% endif

data/scenarios/reversal_show/definition.rb

@@ -0,0 +1 @@
+Balanced::Reversal.fetch

data/scenarios/reversal_show/request.rb

@@ -0,0 +1,2 @@
+<%= boiler_plate %>
+reversal = Balanced::Reversal.fetch('<%= request['uri'] %>')

data/scenarios/reversal_show/ruby.mako

@@ -0,0 +1,37 @@
+% if mode == 'definition':
+Balanced::Reversal.fetch
+
+% elif mode == 'request':
+require 'balanced'
+Balanced.configure('ak-test-1kvvievk0Qqw5wQPsrlM9g7wQwNe62cyc')
+
+reversal = Balanced::Reversal.fetch('/reversals/RV42n8M9XZWna427oPDDi4RG')
+
+% elif mode == 'response':
+#<Balanced::Reversal:0x007fdc9b047d18
+ @attributes=
+  {"amount"=>3000,
+   "created_at"=>"2014-01-27T22:58:21.214829Z",
+   "currency"=>"USD",
+   "description"=>"Reversal for Order #1111",
+   "failure_reason"=>nil,
+   "failure_reason_code"=>nil,
+   "href"=>"/reversals/RV42n8M9XZWna427oPDDi4RG",
+   "id"=>"RV42n8M9XZWna427oPDDi4RG",
+   "links"=>{"credit"=>"CR40neytmVG2HDBp1opfF7sY", "order"=>nil},
+   "meta"=>
+    {"fulfillment.item.condition"=>"OK",
+     "merchant.feedback"=>"positive",
+     "user.refund_reason"=>"not happy with product"},
+   "status"=>"succeeded",
+   "transaction_number"=>"RV219-169-0008",
+   "updated_at"=>"2014-01-27T22:58:22.190749Z"},
+ @hyperlinks=
+  {"credit"=>
+    #<Proc:0x007fdc9b03d2f0/lib/balanced/resources/resource.rb:60 (lambda)>,
+   "events"=>
+    #<Proc:0x007fdc9b02f510/lib/balanced/utils.rb:6 (lambda)>,
+   "order"=>
+    #<Proc:0x007fdc9b02efc0/lib/balanced/utils.rb:6 (lambda)>}>
+
+% endif

data/scenarios/reversal_update/definition.rb

@@ -0,0 +1 @@
+Balanced::Reversal.save

data/scenarios/reversal_update/request.rb

@@ -0,0 +1,7 @@
+<%= boiler_plate %>
+reversal = Balanced::Reversal.fetch('<%= request['uri'] %>')
+reversal.description = '<%= payload['description'] %>'
+reversal.meta = {
+<%= params_to_hash_for_args.call(payload['meta']).indent(2) %>
+}
+reversal.save

data/scenarios/reversal_update/ruby.mako

@@ -0,0 +1,44 @@
+% if mode == 'definition':
+Balanced::Reversal.save
+
+% elif mode == 'request':
+require 'balanced'
+Balanced.configure('ak-test-1kvvievk0Qqw5wQPsrlM9g7wQwNe62cyc')
+
+reversal = Balanced::Reversal.fetch('/reversals/RV42n8M9XZWna427oPDDi4RG')
+reversal.description = 'update this description'
+reversal.meta = {
+    'refund.reason' => 'user not happy with product',
+    'user.notes' => 'very polite on the phone',
+    'user.satisfaction' => '6'
+}
+reversal.save
+
+% elif mode == 'response':
+#<Balanced::Reversal:0x007fdc9e82cd50
+ @attributes=
+  {"amount"=>3000,
+   "created_at"=>"2014-01-27T22:58:21.214829Z",
+   "currency"=>"USD",
+   "description"=>"update this description",
+   "failure_reason"=>nil,
+   "failure_reason_code"=>nil,
+   "href"=>"/reversals/RV42n8M9XZWna427oPDDi4RG",
+   "id"=>"RV42n8M9XZWna427oPDDi4RG",
+   "links"=>{"credit"=>"CR40neytmVG2HDBp1opfF7sY", "order"=>nil},
+   "meta"=>
+    {"refund.reason"=>"user not happy with product",
+     "user.notes"=>"very polite on the phone",
+     "user.satisfaction"=>"6"},
+   "status"=>"succeeded",
+   "transaction_number"=>"RV219-169-0008",
+   "updated_at"=>"2014-01-27T22:58:27.354488Z"},
+ @hyperlinks=
+  {"credit"=>
+    #<Proc:0x007fdc9e827440/lib/balanced/resources/resource.rb:60 (lambda)>,
+   "events"=>
+    #<Proc:0x007fdc9e825078/lib/balanced/utils.rb:6 (lambda)>,
+   "order"=>
+    #<Proc:0x007fdc9e8245b0/lib/balanced/utils.rb:6 (lambda)>}>
+
+% endif

data/spec/balanced/error_spec.rb

@@ -1,7 +1,7 @@
 require 'spec_helper'
 
 describe Balanced::Error, '#response' do
-  it "sets the response in the initializer" do
+  it 'sets the response in the initializer' do
     response = {:status => 200}
     Balanced::Error.new(response).response.should == response
   end
@@ -14,13 +14,13 @@ describe Balanced::Error, '#body' do
     error.body.should == response[:body]
   end
 
-  it "defaults to an empty hash when no body is passed" do
+  it 'defaults to an empty hash when no body is passed' do
     Balanced::Error.new({}).body.should == {}
   end
 
-  describe "generating methods from response keys"  do
+  describe 'generating methods from response keys' do
     before do
-      response = {:body => {:foo => 'bar'}}
+      response = {:body => {:errors => [{:foo => 'bar'}]}}
       @error = Balanced::Error.new(response)
     end
 
@@ -44,13 +44,13 @@ describe Balanced::StandardError do
 end
 
 describe Balanced::UnassociatedCardError do
-  let(:card) { Balanced::Card.new(:uri => '/v1/marketplaces/123/cards/235') }
+  let(:card) { Balanced::Card.new(:href => '/v1/marketplaces/123/cards/235') }
 
   subject do
     Balanced::UnassociatedCardError.new(card)
   end
 
   its(:message) do
-    should == "The Balanced::Card with uri=#{card.attributes['uri']} is not associated to an account"
+    should == "The Balanced::Card with uri=#{card.attributes['uri']} is not associated to a customer"
   end
-end
+end

data/spec/balanced/pager_spec.rb

@@ -1,40 +1,40 @@
-require "spec_helper"
+require 'spec_helper'
 
 describe Balanced::Pager do
-  describe "#adjust_pagination_params" do
-    subject { Balanced::Pager.new 'a uri'}
+  describe '#adjust_pagination_params' do
+    subject { Balanced::Pager.new 'a uri' }
 
-    it "sets limit based on per" do
+    it 'sets limit based on per' do
       params = subject.send(:adjust_pagination_params, :per => 5)
       params[:limit].should == 5
     end
 
-    it "sets offset based on page and default limit" do
+    it 'sets offset based on page and default limit' do
       params = subject.send(:adjust_pagination_params, :page => 2)
       params[:offset].should == 10
     end
 
-    it "sets offset based on page and per" do
+    it 'sets offset based on page and per' do
       params = subject.send(:adjust_pagination_params, :page => 2, :per => 4)
       params[:offset].should == 4
     end
 
-    it "prefers per to limit" do
+    it 'prefers per to limit' do
       params = subject.send(:adjust_pagination_params, :per => 5, :limit => 10)
       params[:limit].should == 5
     end
 
-    it "falls back to limit" do
+    it 'falls back to limit' do
       params = subject.send(:adjust_pagination_params, :limit => 3)
       params[:limit].should == 3
     end
 
-    it "prefers page to offset" do
+    it 'prefers page to offset' do
       params = subject.send(:adjust_pagination_params, :page => 2, :offset => 0)
       params[:offset].should == 10
     end
 
-    it "falls back to offset" do
+    it 'falls back to offset' do
       params = subject.send(:adjust_pagination_params, :offset => 6)
       params[:offset].should == 6
     end

data/spec/balanced/resources/api_key_spec.rb

@@ -1,48 +1,19 @@
-require "spec_helper"
+require 'spec_helper'
 
 describe Balanced::ApiKey do
-  describe "attributes", :vcr do
+
+  describe 'attributes', :vcr do
+
     before do
       @key = Balanced::ApiKey.new.save
     end
-    describe "#secret" do
+
+    describe '#secret' do
       subject { @key.secret }
       it { should_not be_nil }
       it { should_not be_empty }
     end
 
-    describe "#merchant" do
-      subject { @key.merchant }
-      it { should_not be_nil }
-      it { should be_instance_of Balanced::Merchant }
-    end
   end
 
-  describe "new key", :vcr do
-    describe "before configure", :vcr do
-      before do
-        @new_key = Balanced::ApiKey.new.save
-      end
-      describe "#merchant", :vcr do
-        subject { @new_key.merchant }
-        it { should_not be_nil }
-        it { should be_instance_of Balanced::Merchant }
-      end
-    end
-
-    describe "after configure", :vcr do
-      before do
-        @new_key = Balanced::ApiKey.new.save
-        Balanced.configure @new_key.secret
-        @new_key = Balanced::ApiKey.new.save
-      end
-
-      describe "#merchant", :vcr do
-        subject { @new_key.merchant }
-        it { should_not be_nil }
-        it { should be_instance_of Balanced::Merchant }
-      end
-    end
-
-  end
 end

data/spec/balanced/resources/bank_account_spec.rb

@@ -1,252 +1,157 @@
-require "spec_helper"
-
-describe Balanced::BankAccount, :vcr do
-  before do
-    api_key = Balanced::ApiKey.new.save
-    Balanced.configure api_key.secret
-
-    @marketplace = Balanced::Marketplace.new.save
-    card = @marketplace.create_card(
-        :card_number => "5105105105105100",
-        :expiration_month => "12",
-        :expiration_year => "2015"
-    )
-    # An initial balance for the marketplace
-    @buyer = @marketplace.create_buyer(
-        :email_address => 'buyer@example.org',
-        :card_uri => card.uri
-    )
-    @buyer.debit :amount => 10000000
-
-    @incomplete_bank_account_hash = {
-        :account_number => "0987654321",
-        :bank_code => "321174851",
-        :name => "Timmy T. McTimmerson"
+require 'spec_helper'
+
+describe Balanced::BankAccount, :vcr => true, :marketplace => true do
+
+  context 'after successful creation' do
+    subject(:bank_account) {
+      Balanced::BankAccount.new(
+          :name => 'William Henry Cavendish III',
+          :routing_number => '321174851',
+          :account_number => '0987654321',
+          :type => 'checking'
+      ).save
     }
+    its(:id) { subject.id.should_not be_nil }
+    its(:href) { subject.href.should eq("/bank_accounts/#{subject.id}") }
+    its(:account_type) { should eq('checking') }
+    its(:routing_number) { should eq('321174851') }
+    its(:account_number) { should end_with('4321') }
+    its(:name) { should eq('William Henry Cavendish III') }
+    its(:fingerprint) { should_not be_nil }
+    its(:customer) { should be_nil }
   end
 
-  describe 'when exception is thrown', :vcr do
-    it 'should not create without a type field' do
+  context 'create invalid' do
+    it 'should not create without a routing_number field' do
       lambda { Balanced::BankAccount.new(
-          :account_number => "0987654321",
-          :bank_code => "321174851",
-          :name => "Timmy T. McTimmerson"
+          :account_number => '0987654321',
+          :name => 'Timmy T. McTimmerson',
+          :type => 'checking'
       ).save }.should raise_error(Balanced::BadRequest)
     end
-  end
 
-  describe 'create', :vcr do
-    before do
-      @bank_account = @marketplace.create_bank_account(
-          :account_number => "0987654321",
-          :bank_code => "321174851",
-          :name => "Timmy T. McTimmerson",
-          :type => "checking"
-      )
+    it 'should not create without a account_number field' do
+      lambda { Balanced::BankAccount.new(
+          :routing_number => '321174851',
+          :name => 'Timmy T. McTimmerson',
+          :type => 'checking'
+      ).save }.should raise_error(Balanced::BadRequest)
     end
 
-    context 'without an account' do
-
-      subject { @bank_account.account }
-      it { should be_nil }
-
-      describe 'has_account?' do
-
-        subject { @bank_account.has_account? }
-        it { should be_false }
-
-      end
+    it 'should not create without a type field' do
+      lambda { Balanced::BankAccount.new(
+          :account_number => '0987654321',
+          :bank_code => '321174851',
+          :name => 'Timmy T. McTimmerson'
+      ).save }.should raise_error(Balanced::BadRequest)
     end
+  end
 
-    context 'with an account', :vcr do
-      before do
-        @account = @marketplace.create_account
-        bank_account = @marketplace.create_bank_account(
-            :account_number => "0987654321",
-            :bank_code => "321174851",
-            :name => "Timmy T. McTimmerson",
-            :type => "checking"
-        )
-        @account.add_bank_account(bank_account.uri)
-        @bank_account_two = bank_account.reload
-      end
-
-      describe 'has_account?' do
-        subject { @bank_account_two.has_account? }
-        it { should be_true }
-      end
-
+  context 'successful verification' do
+    subject(:verification) do
+      @bank_account = Balanced::BankAccount.new(
+          :name => 'William Henry Cavendish III',
+          :routing_number => '321174851',
+          :account_number => '0987654321',
+          :type => 'checking'
+      ).save
+      @verification = @bank_account.verify
     end
 
-    describe 'account_number', :vcr do
-      subject { @bank_account.account_number }
-      it { should end_with '4321' }
+    it 'verification#attributes' do
+      subject.bank_account.href.should eql(@bank_account.href)
+      subject.attempts_remaining.should eql(3)
+      subject.verification_status.should eql('pending')
     end
 
-    describe 'fingerprint', :vcr do
-      subject { @bank_account.fingerprint }
-      it { should have_at_least(20).characters }
+    it 'confirmation#attributes' do
+      confirmation = subject.confirm(1, 1)
+      confirmation.bank_account.href.should eql(subject.bank_account.href)
+      subject.attempts_remaining.should eql(2)
+      subject.verification_status.should eql('succeeded')
     end
 
-    describe 'does not invalidate on save', :vcr do
-      before do
-        @bank_account = @marketplace.create_bank_account(
-            :account_number => "0987654321",
-            :bank_code => "321174851",
-            :name => "Timmy T. McTimmerson",
-            :type => "checking"
-        )
-        @account = @marketplace.create_account
-        @account.add_bank_account(@bank_account.uri)
-        @bank_account = @account.bank_accounts[0]
-        @bank_account.save
-      end
-
-      subject { @bank_account.is_valid }
-      it { should be_true }
+    it 'successfully debits' do
+      subject.confirm(1, 1)
+      subject.verification_status.should eql('succeeded')
+      debit = subject.bank_account.debit(:amount => 1000)
+      debit.status.should eql('succeeded')
     end
 
-    describe 'credit', :vcr do
-      before do
-        @credit = @bank_account.credit(
-            :amount => 50,
-            :description => 'Blah'
-        )
-      end
-
-      describe 'bank_account' do
-        subject { @credit.bank_account }
-        its(:account_number) { should end_with '4321' }
-        its(:routing_number) { should eql '321174851' }
-      end
-
-      describe 'without an account', :vcr do
-        before do
-          @bank_account = @marketplace.create_bank_account(
-              :account_number => "1234567890111",
-              :bank_code => "021000021",
-              :name => "Timmy T. McTimmerson",
-              :type => "checking"
-          )
-        end
-        
-        describe 'with appears_on_statement_as', :vcr do
-          before do
-            @credit = @bank_account.credit(:amount => 1000, :description => "Testing", :appears_on_statement_as => "Test Company")
-          end
-          
-          subject { @credit }
-          its(:appears_on_statement_as) { should eql 'Test Company' }
-        end
-      end
-
-      describe 'with an account', :vcr do
-        before do
-          @bank_account = @marketplace.create_bank_account(
-              :account_number => "1234567890111",
-              :bank_code => "021000021",
-              :name => "Timmy T. McTimmerson",
-              :type => "checking"
-          )
-          @account = @marketplace.create_account
-          @account.add_bank_account(@bank_account.uri)
-          @bank_account.reload
-        end
-      
-        describe 'with appears_on_statement_as', :vcr do
-          before do
-            @credit = @bank_account.credit(
-              :amount => 1000,
-              :description => "Blahblahblah",
-              :appears_on_statement_as => "Test Company"
-            )
-          end
-        
-          subject { @credit }
-          it { should respond_to :account }
-          it { should be_instance_of Balanced::Credit }
-          its(:appears_on_statement_as) { should eql 'Test Company' }
-        end
-        
-        describe 'without appears_on_statement_as', :vcr do
-          before do
-            @credit = @bank_account.credit(
-              :amount => 1000,
-              :description => "Testing"
-            )
-          end
-        
-          subject { @credit }
-          it { should respond_to :account }
-          it { should be_instance_of Balanced::Credit }
-          its(:appears_on_statement_as) { should eql 'example.com' }
-        end
-      end
-    end
   end
 
-  describe 'verification' do
-
-    describe 'cannot debit when unverified', :vcr do
-      before do
-        @bank_account = @marketplace.create_bank_account(
-            :account_number => "0987654321",
-            :bank_code => "321174851",
-            :name => "Timmy T. McTimmerson",
-            :type => "checking"
-        )
-        @account = @marketplace.create_account
-        @account.add_bank_account(@bank_account.uri)
-      end
-
-      it do
-        lambda {
-          @account.debit(:amount => 100)
-        }.should raise_error(Balanced::Conflict)
-      end
+  context 'fails' do
+    before do
+      @bank_account = Balanced::BankAccount.new(
+          :name => 'Karl Malone',
+          :routing_number => '021000021',
+          :account_number => '9900000002',
+          :type => 'checking'
+      ).save
+      @verification = @bank_account.verify
     end
 
-    describe 'debits when verified', :vcr do
-      before do
-        @bank_account = @marketplace.create_bank_account(
-            :account_number => "0987654321",
-            :bank_code => "321174851",
-            :name => "Timmy T. McTimmerson",
-            :type => "checking"
-        )
-        @account = @marketplace.create_account
-        @account.add_bank_account(@bank_account.uri)
+    it 'throws error on invalid amounts' do
+      3.times do
+        expect {
+          @verification.confirm(2, 3)
+        }.to raise_error(Balanced::BankAccountVerificationFailure) { |exc|
+          expect(exc.description).to start_with 'Authentication amounts do not match'
+        }
       end
+    end
 
-      it do
+    it 'fails to debit' do
+      expect {
+        @verification.confirm(2, 3)
+      }.to raise_error(Balanced::BankAccountVerificationFailure) { |exc|
+        expect(exc.description).to start_with 'Authentication amounts do not match'
+      }
+      expect {
+        @bank_account.debit(:amount => 1000)
+      }.to raise_exception(Balanced::Conflict) { |exc|
+        expect(exc.description).to start_with 'Funding instrument cannot be debited'
+      }
+    end
 
-        authentication = @bank_account.verify
-        authentication.confirm(1, 1)
+  end
 
-        @account.debit(:amount => 100)
-      end
+  describe '#debit' do
+    before do
+      @bank_account = Balanced::BankAccount.new(
+          :name => 'William Henry Cavendish III',
+          :routing_number => '321174851',
+          :account_number => '0987654321',
+          :type => 'checking'
+      ).save
+      @verification = @bank_account.verify
+      @verification.confirm(1, 1)
     end
 
-    describe 'errors when incorrectly verified', :vcr do
-      before do
-        @bank_account = @marketplace.create_bank_account(
-            :account_number => "0987654321",
-            :bank_code => "321174851",
-            :name => "Timmy T. McTimmerson",
-            :type => "checking"
-        )
-        @account = @marketplace.create_account
-        @account.add_bank_account(@bank_account.uri)
-      end
-
-      it do
+    it 'succeeds' do
+      debit = @bank_account.debit(:amount => 1000)
+      debit.status.should eql('succeeded')
+    end
+  end
 
-        authentication = @bank_account.verify
+  describe '#credit' do
+    before do
+      @bank_account = Balanced::BankAccount.new(
+          :name => 'William Henry Cavendish III',
+          :routing_number => '321174851',
+          :account_number => '0987654321',
+          :type => 'checking'
+      ).save
+    end
 
-        lambda {
-          authentication.confirm(1, 2)
-        }.should raise_error(Balanced::BankAccountVerificationFailure)
-      end
+    it 'succeeds', :vcr => {:record => :new_episodes} do
+      before = Balanced::Marketplace.mine.in_escrow
+      @credit = @bank_account.credit(:amount => 1000)
+      @credit.should be_instance_of Balanced::Credit
+      @credit.status.should eql('succeeded')
+      @credit.destination.href.should eql(@bank_account.href)
+      after = Balanced::Marketplace.mine.in_escrow
+      after.should eql(before - @credit.amount)
     end
   end
 end