balanced 0.8.2 → 1.0.beta1

data/lib/balanced/resources/account.rb

@@ -1,179 +0,0 @@
-module Balanced
-  # An Account represents a user within your Marketplace. An Account can have
-  # two +roles+. If the Account has the +buyer+ role then you may create
-  # Debits using this Account. If they have the +merchant+ role then you may
-  # create Credits to transfer funds to this Account.
-  #
-  class Account
-    include Balanced::Resource
-
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = self.class.uri
-      end
-      super attributes
-    end
-
-    # Attempts to find an existing buyer account by email
-    #
-    # @param [String] email An email of an account
-    # @return [Account] if account is found
-    # @return [nil] if account is not found
-    def self.find_by_email email
-      self.find(:first, :email_address => email)
-    end
-
-    # Returns a new Debit that represents a flow of money from this
-    # Account to your Marketplace's escrow account.
-    #
-    # @return [Debit]
-    def debit *args
-      warn_on_positional args
-
-      options = args.last.is_a?(Hash) ? args.pop : {}
-      amount = args[0] || options.fetch(:amount) { nil }
-      appears_on_statement_as = args[1] || options.fetch(:appears_on_statement_as) { nil }
-      hold_uri = args[2] || options.fetch(:hold_uri) { nil }
-      meta = args[3] || options.fetch(:meta) { nil }
-      description = args[4] || options.fetch(:description) { nil }
-      source_uri = args[5] || options.fetch(:source_uri) { nil }
-      on_behalf_of = args[6] || options.fetch(:on_behalf_of) { nil }
-
-      if on_behalf_of
-        if on_behalf_of.respond_to? :uri
-          on_behalf_of = on_behalf_of.uri
-        end
-        if !on_behalf_of.is_a?(String)
-          raise ArgumentError, 'The on_behalf_of parameter needs to be an account URI'
-        end
-        if on_behalf_of == self.uri
-          raise ArgumentError, 'The on_behalf_of parameter MAY NOT be the same account as the account you are debiting!'
-        end
-      end
-
-      debit = Debit.new(
-          :uri => self.debits_uri,
-          :amount => amount,
-          :appears_on_statement_as => appears_on_statement_as,
-          :hold_uri => hold_uri,
-          :meta => meta,
-          :description => description,
-          :source_uri => source_uri,
-          :on_behalf_of_uri => on_behalf_of
-      )
-      debit.save
-    end
-
-    # Returns a new Hold that represents a reservation of money on this
-    # Account which can be transferred via a Debit to your Marketplace
-    # up to 7 days later.
-    #
-    # @param [String] source_uri A specific funding source such as a Card
-    #    associated with this account. If not specified the most recently
-    #    added Card is used.
-    # @return [Hold] A Hold representing the reservation of funds from
-    #    this Account to your Marketplace.
-    def hold *args
-      warn_on_positional args
-
-      options = args.last.is_a?(Hash) ? args.pop : {}
-      amount = args[0] || options.fetch(:amount) { }
-      meta = args[1] || options.fetch(:meta) { nil }
-      source_uri = args[2] || options.fetch(:source_uri) { nil }
-      description = args[3] || options.fetch(:description) { nil }
-
-      hold = Hold.new(
-          :uri => self.holds_uri,
-          :amount => amount,
-          :meta => meta,
-          :source_uri => source_uri,
-          :description => description
-      )
-      hold.save
-    end
-
-    # Returns a new Credit representing a transfer of funds from your
-    # Marketplace to this Account.
-    #
-    # @param [String] destination_uri A specific funding destination such as
-    #    a BankAccount already associated with this account.
-    # @return [Credit] A Credit representing the transfer of funds from
-    #    your Marketplace to this Account.
-    def credit *args
-      warn_on_positional args
-
-      if args.last.is_a? Hash
-        args.last.merge! :uri => self.credits_uri
-      else
-        args << { :uri => self.credits_uri }
-      end
-      Credit.new(*args).save
-    end
-
-    # Associates the Card represented by +card_uri+ with this Account.
-    #
-    # @return [Account]
-    def add_card(card)
-      card.save if card.kind_of?(Balanced::Card) && card.hash.nil?
-      self.card_uri = Balanced::Utils.extract_uri_from_object(card)
-      save
-    end
-
-    # Associates the BankAccount represented by +bank_account_uri+ with this
-    # Account.
-    #
-    # @return [Account]
-    def add_bank_account(bank_account)
-      if bank_account.kind_of?(Balanced::BankAccount) && bank_account.fingerprint.nil?
-        bank_account.save
-      end
-      self.bank_account_uri = Balanced::Utils.extract_uri_from_object(bank_account)
-      save
-    end
-
-    # Adds the role Merchant to this Account.
-    #
-    # The merchant data for a *person* should look like:
-    #
-    #    {
-    #      :type => "person",
-    #      :name => "William James",        # Legal name
-    #      :street_address => "167 West 74th Street",
-    #      :postal_code => "10023",
-    #      :country_code => "USA",          # ISO 3166-1 alpha-3
-    #      :dob => "1842-01",
-    #      :phone_number => "+16505551234"
-    #    }
-    #
-    # For a *business*, the payload should look like:
-    #
-    #    {
-    #      :name => "Levain Bakery",
-    #      :tax_id => "253912384",          # Optional
-    #      :street_address => "167 West 74th Street",
-    #      :postal_code => "10023",
-    #      :phone_number => "+16505551234",
-    #      :country_code => "USA",          # ISO 3166-1 alpha-3
-    #      :person => {
-    #         :name => "William James",     # Legal name
-    #         :tax_id => "393483992",       # Optional
-    #         :street_address => "167 West 74th Street",  # Home address
-    #         :postal_code => "10023",
-    #         :dob => "1842-01-01",
-    #         :phone_number => "+16505551234",
-    #         :country_code => "USA"        # ISO 3166-1 alpha-3
-    #       }
-    #    }
-    #
-    def promote_to_merchant merchant
-      if merchant.is_a?(String)
-        self.merchant_uri = merchant
-      else
-        self.merchant = merchant
-      end
-      save
-    end
-
-  end
-end

data/lib/balanced/resources/hold.rb

@@ -1,61 +0,0 @@
-module Balanced
-  # A Hold is a reservation of funds on a funding source such as a Card. This
-  # reservation is guaranteed until the +expires_at+ date. You may capture
-  # the Hold at any time before then which will create a Debit and transfer
-  # the funds to your Marketplace. If you do not capture the Hold it will
-  # be marked as invalid which is represented by the +is_void+ field being
-  # set to +true+.
-  #
-  # By default a Hold is created using the most recently added funding source
-  # on the Account. You may specify a specific funding source such as a Card
-  # or BankAccount uri.
-  #
-  class Hold
-    include Balanced::Resource
-
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = self.class.uri
-      end
-      super attributes
-    end
-
-    # Cancels an active Hold.
-    #
-    def void
-      self.is_void = true
-      begin
-        save
-      rescue Balanced::Error
-        self.is_void = false
-        raise
-      end
-    end
-
-    # Captures a valid Hold and returns a Debit representing the transfer of
-    # funds from the buyer's Account to your Marketplace.
-    #
-    # @return [Debit]
-    def capture *args
-      warn_on_positional args
-
-      options = args.last.is_a?(Hash) ? args.pop : {}
-      amount = args[0] || options.fetch(:amount) { nil }
-      appears_on_statement_as = args[1] || options.fetch(:appears_on_statement_as) { nil }
-      meta = args[2] || options.fetch(:meta) { nil }
-      description = args[3] || options.fetch(:description) { nil }
-
-      amount ||= self.amount
-      self.account.debit(
-          :amount => amount,
-          :appears_on_statement_as => appears_on_statement_as,
-          :hold_uri => self.uri,
-          :meta => meta,
-          :description => description
-      )
-    end
-
-  end
-end
-

data/lib/balanced/resources/invoice.rb

@@ -1,11 +0,0 @@
-module Balanced
-
-  # An Invoice is the invoice that Balanced generates instrumenting all
-  # the events
-
-  class Invoice
-    include Balanced::Resource
-
-  end
-
-end

data/lib/balanced/resources/merchant.rb

@@ -1,21 +0,0 @@
-module Balanced
-  # Resource representing the marketplace merchant object.
-  class Merchant
-    include Balanced::Resource
-
-    # Returns the Merchant associated with your Marketplace.
-    #
-    # @return [Merchant]
-    def self.me
-      self.all.first
-    end
-
-    # Returns the Merchant associated with your Marketplace.
-    #
-    # @return [Merchant]
-    def me
-      self.class.me
-    end
-
-  end
-end

data/lib/balanced/resources/transaction.rb

@@ -1,17 +0,0 @@
-module Balanced
-  # Any transfer, or potential transfer of, funds from or to, your
-  # Marketplace. E.g. a Credit, Debit, Refund, Reversal, or Hold.
-  #
-  class Transaction
-    include Balanced::Resource
-
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = self.class.uri
-      end
-      super attributes
-    end
-
-  end
-end

data/scenarios/account_add_card/definition.rb

@@ -1 +0,0 @@
-Balanced::Account.add_card

data/scenarios/account_add_card/request.rb

@@ -1,3 +0,0 @@
-<%= boiler_plate %>
-account = Balanced::Account.find('<%=request['uri']%>')
-response = account.add_card('<%= payload['card_uri']%>')

data/scenarios/account_add_card/ruby.mako

@@ -1,11 +0,0 @@
-% if mode == 'definition':
-Balanced::Account.add_card
-
-% else:
-require 'balanced'
-Balanced.configure('8c3aeeb80e9e11e38901026ba7f8ec28')
-
-account = Balanced::Account.find('/v1/marketplaces/TEST-MP4h8BxozeLxe7VAllP6b5gj/accounts/AC4SoZJ23TvXIUcUOBSTXYHQ')
-response = account.add_card('/v1/marketplaces/TEST-MP4h8BxozeLxe7VAllP6b5gj/cards/CC4Y12fGIP0HQ1jhcDgE9cFi')
-
-% endif

data/scenarios/account_capture_hold/definition.rb

@@ -1 +0,0 @@
-Balanced::Account.debit

data/scenarios/account_capture_hold/request.rb

@@ -1,3 +0,0 @@
-<%= boiler_plate %>
-account = Balanced::Account.find('<%=request['uri']%>')
-account.debit(:amount => '<%=payload['amount']%>', :hold_uri => '<%=payload['hold_uri']%>')

data/scenarios/account_capture_hold/ruby.mako

@@ -1,11 +0,0 @@
-% if mode == 'definition':
-Balanced::Account.debit
-
-% else:
-require 'balanced'
-Balanced.configure('8af725c6d54611e2bf5e026ba7f8ec28')
-
-account = Balanced::Account.find('/v1/marketplaces/TEST-MP4erLnXCYoaeyr3tx95WSKc/accounts/AC6jdot989BbUks8LFIdRVcX/debits')
-account.debit(:amount => '1000', :hold_uri => '/v1/marketplaces/TEST-MP4erLnXCYoaeyr3tx95WSKc/holds/HL6t6iMvY9Touhig2PZnCOHk')
-
-% endif

data/scenarios/account_create/definition.rb

@@ -1 +0,0 @@
-Balanced::Account.new

data/scenarios/account_create/request.rb

@@ -1,2 +0,0 @@
-<%= boiler_plate %>
-account = Balanced::Marketplace.my_marketplace.create_account

data/scenarios/account_create/ruby.mako

@@ -1,10 +0,0 @@
-% if mode == 'definition':
-Balanced::Account.new
-
-% else:
-require 'balanced'
-Balanced.configure('8c3aeeb80e9e11e38901026ba7f8ec28')
-
-account = Balanced::Marketplace.my_marketplace.create_account
-
-% endif

data/scenarios/account_create_buyer/definition.rb

@@ -1 +0,0 @@
-Balanced::Marketplace.create_buyer

data/scenarios/account_create_buyer/request.rb

@@ -1,5 +0,0 @@
-<%= boiler_plate %>
-
-buyer = Balanced::Marketplace.my_marketplace.create_buyer(
-  <%= params_to_hash.call(payload) %>
-)

data/scenarios/account_create_buyer/ruby.mako

@@ -1,13 +0,0 @@
-% if mode == 'definition':
-Balanced::Marketplace.create_buyer
-
-% else:
-require 'balanced'
-Balanced.configure('8c3aeeb80e9e11e38901026ba7f8ec28')
-
-
-buyer = Balanced::Marketplace.my_marketplace.create_buyer(
-  :card_uri => '/v1/marketplaces/TEST-MP4h8BxozeLxe7VAllP6b5gj/cards/CC4KUcbT2dmJRIYoG0hBpO6S'
-)
-
-% endif

data/scenarios/account_create_debit/definition.rb

@@ -1 +0,0 @@
-Balanced::Account.debit

data/scenarios/account_create_debit/request.rb

@@ -1,3 +0,0 @@
-<%= boiler_plate %>
-account = Balanced::Account.find('<%=request['uri']%>')
-account.debit(:amount => '<%=payload['amount']%>')

data/scenarios/account_create_debit/ruby.mako

@@ -1,11 +0,0 @@
-% if mode == 'definition':
-Balanced::Account.debit
-
-% else:
-require 'balanced'
-Balanced.configure('8af725c6d54611e2bf5e026ba7f8ec28')
-
-account = Balanced::Account.find('/v1/marketplaces/TEST-MP4erLnXCYoaeyr3tx95WSKc/accounts/AC6jdot989BbUks8LFIdRVcX/debits')
-account.debit(:amount => '1000')
-
-% endif

data/scenarios/account_create_hold/definition.rb

@@ -1 +0,0 @@
-Balanced::Account.hold

data/scenarios/account_create_hold/request.rb

@@ -1,3 +0,0 @@
-<%= boiler_plate %>
-account = Balanced::Account.find('<%=request['account_uri']%>')
-account.hold(:amount => '<%=payload['amount']%>')

data/scenarios/account_create_hold/ruby.mako

@@ -1,11 +0,0 @@
-% if mode == 'definition':
-Balanced::Account.hold
-
-% else:
-require 'balanced'
-Balanced.configure('8af725c6d54611e2bf5e026ba7f8ec28')
-
-account = Balanced::Account.find('/v1/marketplaces/TEST-MP4erLnXCYoaeyr3tx95WSKc/accounts/AC6jdot989BbUks8LFIdRVcX')
-account.hold(:amount => '1000')
-
-% endif

data/scenarios/account_create_merchant/definition.rb

@@ -1 +0,0 @@
-Balanced::Account.add_bank_account

data/scenarios/account_create_merchant/request.rb

@@ -1,3 +0,0 @@
-<%= boiler_plate %>
-account = Balanced::Account.find('<%=request['uri']%>')
-account.add_bank_account("<%=payload['bank_account_uri']%>")

data/scenarios/account_create_merchant/ruby.mako

@@ -1,11 +0,0 @@
-% if mode == 'definition':
-Balanced::Account.add_bank_account
-
-% else:
-require 'balanced'
-Balanced.configure('8c3aeeb80e9e11e38901026ba7f8ec28')
-
-account = Balanced::Account.find('/v1/marketplaces/TEST-MP4h8BxozeLxe7VAllP6b5gj/accounts/AC4SoZJ23TvXIUcUOBSTXYHQ')
-account.add_bank_account("/v1/bank_accounts/BA5hNwwQFEWByAcdf1U5D5ok")
-
-% endif