braintree 2.6.3 → 2.7.0

data/lib/braintree.rb

@@ -32,6 +32,8 @@ require File.dirname(__FILE__) + "/braintree/credit_card_gateway"
 require File.dirname(__FILE__) + "/braintree/credit_card_verification"
 require File.dirname(__FILE__) + "/braintree/customer"
 require File.dirname(__FILE__) + "/braintree/customer_gateway"
+require File.dirname(__FILE__) + "/braintree/customer_search"
+require File.dirname(__FILE__) + "/braintree/descriptor"
 require File.dirname(__FILE__) + "/braintree/digest"
 require File.dirname(__FILE__) + "/braintree/discount"
 require File.dirname(__FILE__) + "/braintree/error_codes"

data/lib/braintree/customer.rb

@@ -67,6 +67,11 @@ module Braintree
       return_object_or_raise(:transaction) { sale(customer_id, transaction_attributes) }
     end
 
+    # See http://www.braintreepaymentsolutions.com/docs/ruby/customers/search
+    def self.search(&block)
+      Configuration.gateway.customer.search(&block)
+    end
+
     # Returns a ResourceCollection of transactions for the customer with the given +customer_id+.
     def self.transactions(customer_id, options = {})
       Configuration.gateway.customer.transactions(customer_id, options = {})

data/lib/braintree/customer_gateway.rb

@@ -7,7 +7,7 @@ module Braintree
 
     def all
       response = @config.http.post "/customers/advanced_search_ids"
-      ResourceCollection.new(response) { |ids| _fetch_customers(ids) }
+      ResourceCollection.new(response) { |ids| _fetch_customers(CustomerSearch.new, ids) }
     end
 
     def create(attributes = {})
@@ -40,6 +40,14 @@ module Braintree
       raise NotFoundError, "customer with id #{customer_id.inspect} not found"
     end
 
+    def search(&block)
+      search = CustomerSearch.new
+      block.call(search) if block
+
+      response = @config.http.post "/customers/advanced_search_ids", {:search => search.to_hash}
+      ResourceCollection.new(response) { |ids| _fetch_customers(search, ids) }
+    end
+
     def transactions(customer_id, options = {})
       response = @config.http.post "/customers/#{customer_id}/transaction_ids"
       ResourceCollection.new(response) { |ids| _fetch_transactions(customer_id, ids) }
@@ -93,8 +101,9 @@ module Braintree
       end
     end
 
-    def _fetch_customers(ids) # :nodoc:
-      response = @config.http.post "/customers/advanced_search", {:search => {:ids => ids}}
+    def _fetch_customers(search, ids) # :nodoc:
+      search.ids.in ids
+      response = @config.http.post "/customers/advanced_search", {:search => search.to_hash}
       attributes = response[:customers]
       Util.extract_attribute_as_array(attributes, :customer).map { |attrs| Customer._new(@gateway, attrs) }
     end

data/lib/braintree/customer_search.rb

@@ -0,0 +1,31 @@
+module Braintree
+  class CustomerSearch < AdvancedSearch # :nodoc:
+    text_fields(
+      :address_extended_address,
+      :address_first_name,
+      :address_last_name,
+      :address_locality,
+      :address_postal_code,
+      :address_region,
+      :address_street_address,
+      :cardholder_name,
+      :company,
+      :email,
+      :fax,
+      :first_name,
+      :id,
+      :last_name,
+      :payment_method_token,
+      :phone,
+      :website
+    )
+
+    equality_fields :credit_card_expiration_date
+
+    partial_match_fields :credit_card_number
+
+    multiple_value_field :ids
+
+    range_fields :created_at
+  end
+end

data/lib/braintree/descriptor.rb

@@ -0,0 +1,11 @@
+module Braintree
+  class Descriptor # :nodoc:
+    include BaseModule
+
+    attr_reader :name, :phone
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+    end
+  end
+end

data/lib/braintree/error_codes.rb

@@ -78,6 +78,11 @@ module Braintree
       WebsiteIsTooLong = "81615"
     end
 
+    module Descriptor
+      PhoneFormatIsInvalid = "92202"
+      NameFormatIsInvalid = "92201"
+    end
+
     # See http://www.braintreepaymentsolutions.com/docs/ruby/subscriptions/validations
     module Subscription
       BillingDayOfMonthCannotBeUpdated = "91918"
@@ -102,6 +107,7 @@ module Braintree
       PaymentMethodTokenCardTypeIsNotAccepted = "91902"
       PaymentMethodTokenIsInvalid = "91903"
       PaymentMethodTokenNotAssociatedWithCustomer = "91905"
+      PlanBillingFrequencyCannotBeUpdated = "91922"
       PlanIdIsInvalid = "91904"
       PriceCannotBeBlank = "81903"
       PriceFormatIsInvalid = "81904"
@@ -136,8 +142,8 @@ module Braintree
     # See http://www.braintreepaymentsolutions.com/docs/ruby/transactions/validations
     module Transaction
       AmountCannotBeNegative = "81501"
-      AmountIsRequired = "81502"
       AmountIsInvalid = "81503"
+      AmountIsRequired = "81502"
       AmountIsTooLarge = "81528"
       AmountMustBeGreaterThanZero = "81531"
       BillingAddressConflict = "91530"
@@ -146,15 +152,15 @@ module Braintree
       CannotRefundUnlessSettled = "91506"
       CannotSubmitForSettlement = "91507"
       CreditCardIsRequired = "91508"
-      CustomerDefaultPaymentMethodCardTypeIsNotAccepted = "81509"
       CustomFieldIsInvalid = "91526"
       CustomFieldIsTooLong = "81527"
-      CustomerIdIsInvalid = "91510"
+      CustomerDefaultPaymentMethodCardTypeIsNotAccepted = "81509"
       CustomerDoesNotHaveCreditCard = "91511"
+      CustomerIdIsInvalid = "91510"
       HasAlreadyBeenRefunded = "91512"
       MerchantAccountIdIsInvalid = "91513"
-      MerchantAccountNameIsInvalid = "91513" # Deprecated
       MerchantAccountIsSuspended = "91514"
+      MerchantAccountNameIsInvalid = "91513" # Deprecated
       OrderIdIsTooLong = "91501"
       PaymentMethodConflict = "91515"
       PaymentMethodDoesNotBelongToCustomer = "91516"
@@ -163,11 +169,15 @@ module Braintree
       PaymentMethodTokenIsInvalid = "91518"
       ProcessorAuthorizationCodeCannotBeSet = "91519"
       ProcessorAuthorizationCodeIsInvalid = "81520"
+      PurchaseOrderNumberIsTooLong = "91537"
       RefundAmountIsTooLarge = "91521"
       SettlementAmountIsTooLarge = "91522"
       SubscriptionDoesNotBelongToCustomer = "91529"
       SubscriptionIdIsInvalid = "91528"
       SubscriptionStatusMustBePastDue = "91531"
+      TaxAmountCannotBeNegative = "81534"
+      TaxAmountFormatIsInvalid = "81535"
+      TaxAmountIsTooLarge = "81536"
       TypeIsInvalid = "91523"
       TypeIsRequired = "91524"
       module Options

data/lib/braintree/http.rb

@@ -48,6 +48,7 @@ module Braintree
 
     def _http_do(http_verb, path, body = nil)
       connection = Net::HTTP.new(@config.server, @config.port)
+      connection.read_timeout = 60
       if @config.ssl?
         connection.use_ssl = true
         connection.verify_mode = OpenSSL::SSL::VERIFY_PEER

data/lib/braintree/subscription.rb

@@ -27,6 +27,7 @@ module Braintree
     attr_reader :next_billing_period_amount
     attr_reader :number_of_billing_cycles, :billing_day_of_month
     attr_reader :add_ons, :discounts
+    attr_reader :descriptor
 
     # See http://www.braintreepaymentsolutions.com/docs/ruby/subscriptions/cancel
     def self.cancel(subscription_id)
@@ -70,6 +71,7 @@ module Braintree
       set_instance_variables_from_hash(attributes)
       @balance = Util.to_big_decimal(balance)
       @price = Util.to_big_decimal(price)
+      @descriptor = Descriptor.new(@descriptor)
       transactions.map! { |attrs| Transaction._new(gateway, attrs) }
       add_ons.map! { |attrs| AddOn._new(attrs) }
       discounts.map! { |attrs| Discount._new(attrs) }

data/lib/braintree/subscription_gateway.rb

@@ -64,7 +64,8 @@ module Braintree
         :trial_duration,
         :trial_duration_unit,
         :trial_period,
-        {:options => [:do_not_inherit_add_ons_or_discounts, :start_immediately]}
+        {:options => [:do_not_inherit_add_ons_or_discounts, :start_immediately]},
+        {:descriptor => [:name, :phone]}
       ] + _add_on_discount_signature
     end
 
@@ -81,7 +82,8 @@ module Braintree
           :prorate_charges,
           :replace_all_add_ons_and_discounts,
           :revert_subscription_on_proration_failure
-        ]}
+        ]},
+        {:descriptor => [:name, :phone]}
       ] + _add_on_discount_signature
     end
 

data/lib/braintree/transaction.rb

@@ -45,6 +45,7 @@ module Braintree
     attr_reader :currency_iso_code
     attr_reader :custom_fields
     attr_reader :cvv_response_code
+    attr_reader :descriptor
     attr_reader :gateway_rejection_reason
     attr_reader :merchant_account_id
     attr_reader :order_id
@@ -55,12 +56,15 @@ module Braintree
     attr_reader :processor_response_code
     # The response text from the processor.
     attr_reader :processor_response_text
+    attr_reader :purchase_order_number
     attr_reader :refund_ids, :refunded_transaction_id
     attr_reader :settlement_batch_id
     # See Transaction::Status
     attr_reader :status
     attr_reader :status_history
     attr_reader :subscription_id
+    attr_reader :tax_amount
+    attr_reader :tax_exempt
     # Will either be "sale" or "credit"
     attr_reader :type
     attr_reader :updated_at
@@ -154,6 +158,8 @@ module Braintree
       @billing_details = AddressDetails.new(@billing)
       @shipping_details = AddressDetails.new(@shipping)
       @status_history = attributes[:status_history] ? attributes[:status_history].map { |s| StatusDetails.new(s) } : []
+      @tax_amount = Util.to_big_decimal(tax_amount)
+      @descriptor = Descriptor.new(@descriptor)
       add_ons.map! { |attrs| AddOn._new(attrs) } if add_ons
       discounts.map! { |attrs| Discount._new(attrs) } if discounts
     end

data/lib/braintree/transaction_gateway.rb

@@ -89,7 +89,8 @@ module Braintree
 
     def self._create_signature # :nodoc:
       [
-        :amount, :customer_id, :merchant_account_id, :order_id, :payment_method_token, :shipping_address_id, :type,
+        :amount, :customer_id, :merchant_account_id, :order_id, :payment_method_token,
+        :purchase_order_number, :shipping_address_id, :type, :tax_amount, :tax_exempt,
         {:credit_card => [:token, :cardholder_name, :cvv, :expiration_date, :expiration_month, :expiration_year, :number]},
         {:customer => [:id, :company, :email, :fax, :first_name, :last_name, :phone, :website]},
         {
@@ -99,7 +100,8 @@ module Braintree
           :shipping => AddressGateway._shared_signature
         },
         {:options => [:store_in_vault, :submit_for_settlement, :add_billing_address_to_payment_method, :store_shipping_address_in_vault]},
-        {:custom_fields => :_any_key_}
+        {:custom_fields => :_any_key_},
+        {:descriptor => [:name, :phone]}
       ]
     end
 

data/lib/braintree/version.rb

@@ -1,8 +1,8 @@
 module Braintree
   module Version
     Major = 2
-    Minor = 6
-    Tiny = 3
+    Minor = 7
+    Tiny = 0
 
     String = "#{Major}.#{Minor}.#{Tiny}"
   end

data/spec/integration/braintree/credit_card_spec.rb

@@ -73,6 +73,17 @@ describe Braintree::CreditCard do
       credit_card.billing_address.last_name.should == "Tables"
     end
 
+    it "accepts empty options hash" do
+      customer = Braintree::Customer.create!
+      result = Braintree::CreditCard.create(
+        :customer_id => customer.id,
+        :number => Braintree::Test::CreditCardNumbers::FailsSandboxVerification::Visa,
+        :expiration_date => "05/2009",
+        :options => {}
+      )
+      result.success?.should == true
+    end
+
     it "verifies the credit card if options[verify_card]=true" do
       customer = Braintree::Customer.create!
       result = Braintree::CreditCard.create(

data/spec/integration/braintree/customer_search_spec.rb

@@ -0,0 +1,146 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+
+describe Braintree::Transaction, "search" do
+  context "advanced" do
+    it "correctly returns a result with no matches" do
+      collection = Braintree::Customer.search do |search|
+        search.first_name.is "thisnameisnotreal"
+      end
+
+      collection.maximum_size.should == 0
+    end
+
+    it "can search on text fields" do
+      cctoken = "cctoken#{rand(1_000_000)}"
+      customer = Braintree::Customer.create!(
+        :first_name => "Timmy",
+        :last_name => "O'Toole",
+        :company => "O'Toole and #{rand(1_000_000)} Son(s)",
+        :email => "timmy@example.com",
+        :fax => "3145551234",
+        :phone => "5551231234",
+        :website => "http://example.com",
+        :credit_card => {
+          :cardholder_name => "Tim Tool",
+          :number => Braintree::Test::CreditCardNumbers::Visa,
+          :expiration_date => "05/2010",
+          :token => cctoken,
+          :billing_address => {
+            :first_name => "Thomas",
+            :last_name => "Otool",
+            :street_address => "1 E Main St",
+            :extended_address => "Suite 3",
+            :locality => "Chicago",
+            :region => "Illinois",
+            :postal_code => "60622",
+            :country_name => "United States of America"
+          }
+        }
+      )
+
+      customer = Braintree::Customer.find(customer.id)
+
+      search_criteria = {
+        :first_name                  => "Timmy",
+        :last_name                   => "O'Toole",
+        :company                     => customer.company,
+        :email                       => "timmy@example.com",
+        :phone                       => "5551231234",
+        :fax                         => "3145551234",
+        :website                     => "http://example.com",
+        :address_first_name          => "Thomas",
+        :address_last_name           => "Otool",
+        :address_street_address      => "1 E Main St",
+        :address_postal_code         => "60622",
+        :address_extended_address    => "Suite 3",
+        :address_locality            => "Chicago",
+        :address_region              => "Illinois",
+        :payment_method_token        => cctoken,
+        :cardholder_name             => "Tim Tool",
+        :credit_card_expiration_date => "05/2010",
+        :credit_card_number          => Braintree::Test::CreditCardNumbers::Visa
+      }
+
+      search_criteria.each do |criterion, value|
+        collection = Braintree::Customer.search do |search|
+          search.id.is customer.id
+          search.send(criterion).is value
+        end
+
+        collection.maximum_size.should == 1
+        collection.first.id.should == customer.id
+
+        collection = Braintree::Customer.search do |search|
+          search.id.is customer.id
+          search.send(criterion).is("invalid_attribute")
+        end
+        collection.should be_empty
+      end
+
+      collection = Braintree::Customer.search do |search|
+        search.id.is customer.id
+        search_criteria.each do |criterion, value|
+          search.send(criterion).is value
+        end
+      end
+
+      collection.maximum_size.should == 1
+      collection.first.id.should == customer.id
+    end
+
+    it "can search by created_at" do
+      company = "Company #{rand(1_000_000)}"
+      customer = Braintree::Customer.create!(
+        :company => company
+      )
+
+      created_at = customer.created_at
+      created_at.should be_utc
+
+      collection = Braintree::Customer.search do |search|
+        search.company.is company
+        search.created_at.between(
+          created_at - 60,
+          created_at + 60
+        )
+      end
+
+      collection.maximum_size.should == 1
+      collection.first.id.should == customer.id
+
+      collection = Braintree::Customer.search do |search|
+        search.company.is customer.company
+        search.created_at >= created_at - 1
+      end
+
+      collection.maximum_size.should == 1
+      collection.first.company.should == customer.company
+
+      collection = Braintree::Customer.search do |search|
+        search.company.is customer.company
+        search.created_at <= created_at + 1
+      end
+
+      collection.maximum_size.should == 1
+      collection.first.company.should == customer.company
+
+      collection = Braintree::Customer.search do |search|
+        search.company.is customer.company
+        search.created_at.between(
+          created_at - 300,
+          created_at - 100
+        )
+      end
+
+      collection.maximum_size.should == 0
+
+      collection = Braintree::Customer.search do |search|
+        search.company.is customer.company
+        search.created_at.is created_at
+      end
+
+      collection.maximum_size.should == 1
+      collection.first.company.should == customer.company
+    end
+  end
+end

data/spec/integration/braintree/subscription_spec.rb

@@ -520,6 +520,42 @@ describe Braintree::Subscription do
         result.errors.for(:subscription).for(:add_ons).for(:update).for_index(1).on(:quantity)[0].code.should == Braintree::ErrorCodes::Subscription::Modification::QuantityIsInvalid
       end
     end
+
+    context "descriptors" do
+      it "accepts name and phone and copies them to the transaction" do
+        result = Braintree::Subscription.create(
+          :payment_method_token => @credit_card.token,
+          :plan_id => SpecHelper::TriallessPlan[:id],
+          :descriptor => {
+            :name => '123*123456789012345678',
+            :phone => '3334445555'
+          }
+        )
+
+        result.success?.should == true
+        result.subscription.descriptor.name.should == '123*123456789012345678'
+        result.subscription.descriptor.phone.should == '3334445555'
+
+        result.subscription.transactions.size.should == 1
+        transaction = result.subscription.transactions.first
+        transaction.descriptor.name.should == '123*123456789012345678'
+        transaction.descriptor.phone.should == '3334445555'
+      end
+
+      it "has validation errors if format is invalid" do
+        result = Braintree::Subscription.create(
+          :payment_method_token => @credit_card.token,
+          :plan_id => SpecHelper::TriallessPlan[:id],
+          :descriptor => {
+            :name => 'badcompanyname12*badproduct12',
+            :phone => '%bad4445555'
+          }
+        )
+        result.success?.should == false
+        result.errors.for(:subscription).for(:descriptor).on(:name)[0].code.should == Braintree::ErrorCodes::Descriptor::NameFormatIsInvalid
+        result.errors.for(:subscription).for(:descriptor).on(:phone)[0].code.should == Braintree::ErrorCodes::Descriptor::PhoneFormatIsInvalid
+      end
+    end
   end
 
   describe "self.create!" do
@@ -606,6 +642,19 @@ describe Braintree::Subscription do
       result.subscription.payment_method_token.should == new_credit_card.token
     end
 
+    it "allows chaning the descriptors" do
+      result = Braintree::Subscription.update(@subscription.id,
+        :descriptor => {
+          :name => 'aaa*1234',
+          :phone => '3334443333'
+        }
+      )
+
+      result.success?.should == true
+      result.subscription.descriptor.name.should == 'aaa*1234'
+      result.subscription.descriptor.phone.should == '3334443333'
+    end
+
     context "when successful" do
       it "returns a success response with the updated subscription if valid" do
         new_id = rand(36**9).to_s(36)

data/spec/integration/braintree/transaction_search_spec.rb

@@ -10,7 +10,7 @@ describe Braintree::Transaction, "search" do
       collection.maximum_size.should == 0
     end
 
-    it "returns one result for text field search" do
+    it "can search on text fields" do
       first_name = "Tim#{rand(10000)}"
       token = "creditcard#{rand(10000)}"
       customer_id = "customer#{rand(10000)}"
@@ -115,92 +115,12 @@ describe Braintree::Transaction, "search" do
         end
         collection.should be_empty
       end
-    end
-
-    it "searches all fields at once" do
-      first_name = "Tim#{rand(10000)}"
-      token = "creditcard#{rand(10000)}"
-      customer_id = "customer#{rand(10000)}"
-
-      transaction = Braintree::Transaction.sale!(
-        :amount => Braintree::Test::TransactionAmounts::Authorize,
-        :credit_card => {
-        :number => Braintree::Test::CreditCardNumbers::Visa,
-        :expiration_date => "05/2012",
-        :cardholder_name => "Tom Smith",
-        :token => token,
-      },
-      :billing => {
-        :company => "Braintree",
-        :country_name => "United States of America",
-        :extended_address => "Suite 123",
-        :first_name => first_name,
-        :last_name => "Smith",
-        :locality => "Chicago",
-        :postal_code => "12345",
-        :region => "IL",
-        :street_address => "123 Main St"
-      },
-      :customer => {
-        :company => "Braintree",
-        :email => "smith@example.com",
-        :fax => "5551231234",
-        :first_name => "Tom",
-        :id => customer_id,
-        :last_name => "Smith",
-        :phone => "5551231234",
-        :website => "http://example.com",
-      },
-      :options => {
-        :store_in_vault => true
-      },
-      :order_id => "myorder",
-      :shipping => {
-        :company => "Braintree P.S.",
-        :country_name => "Mexico",
-        :extended_address => "Apt 456",
-        :first_name => "Thomas",
-        :last_name => "Smithy",
-        :locality => "Braintree",
-        :postal_code => "54321",
-        :region => "MA",
-        :street_address => "456 Road"
-      })
 
       collection = Braintree::Transaction.search do |search|
-        search.billing_company.is "Braintree"
-        search.billing_country_name.is "United States of America"
-        search.billing_extended_address.is "Suite 123"
-        search.billing_first_name.is first_name
-        search.billing_last_name.is "Smith"
-        search.billing_locality.is "Chicago"
-        search.billing_postal_code.is "12345"
-        search.billing_region.is "IL"
-        search.billing_street_address.is "123 Main St"
-        search.credit_card_cardholder_name.is "Tom Smith"
-        search.credit_card_expiration_date.is "05/2012"
-        search.credit_card_number.is Braintree::Test::CreditCardNumbers::Visa
-        search.customer_company.is "Braintree"
-        search.customer_email.is "smith@example.com"
-        search.customer_fax.is "5551231234"
-        search.customer_first_name.is "Tom"
-        search.customer_id.is customer_id
-        search.customer_last_name.is "Smith"
-        search.customer_phone.is "5551231234"
-        search.customer_website.is "http://example.com"
-        search.order_id.is "myorder"
-        search.payment_method_token.is token
-        search.processor_authorization_code.is transaction.processor_authorization_code
-        search.shipping_company.is "Braintree P.S."
-        search.shipping_country_name.is "Mexico"
-        search.shipping_extended_address.is "Apt 456"
-        search.shipping_first_name.is "Thomas"
-        search.shipping_last_name.is "Smithy"
-        search.shipping_locality.is "Braintree"
-        search.shipping_postal_code.is "54321"
-        search.shipping_region.is "MA"
-        search.shipping_street_address.is "456 Road"
         search.id.is transaction.id
+        search_criteria.each do |criterion, value|
+          search.send(criterion).is value
+        end
       end
 
       collection.maximum_size.should == 1
@@ -518,9 +438,9 @@ describe Braintree::Transaction, "search" do
           transaction = Braintree::Transaction.sale!(
             :amount => Braintree::Test::TransactionAmounts::Authorize,
             :credit_card => {
-            :number => Braintree::Test::CreditCardNumbers::Visa,
-            :expiration_date => "05/12"
-          }
+              :number => Braintree::Test::CreditCardNumbers::Visa,
+              :expiration_date => "05/12"
+            }
           )
 
           created_at = transaction.created_at

data/spec/integration/braintree/transaction_spec.rb

@@ -512,6 +512,92 @@ describe Braintree::Transaction do
       transaction.discounts.first.number_of_billing_cycles.should be_nil
       transaction.discounts.first.never_expires?.should be_true
     end
+
+    context "descriptors" do
+      it "accepts name and phone" do
+        result = Braintree::Transaction.sale(
+          :amount => Braintree::Test::TransactionAmounts::Authorize,
+          :credit_card => {
+            :number => Braintree::Test::CreditCardNumbers::Visa,
+            :expiration_date => "05/2009"
+          },
+          :descriptor => {
+            :name => '123*123456789012345678',
+            :phone => '3334445555'
+          }
+        )
+        result.success?.should == true
+        result.transaction.descriptor.name.should == '123*123456789012345678'
+        result.transaction.descriptor.phone.should == '3334445555'
+      end
+
+      it "has validation errors if format is invalid" do
+        result = Braintree::Transaction.sale(
+          :amount => Braintree::Test::TransactionAmounts::Authorize,
+          :credit_card => {
+            :number => Braintree::Test::CreditCardNumbers::Visa,
+            :expiration_date => "05/2009"
+          },
+          :descriptor => {
+            :name => 'badcompanyname12*badproduct12',
+            :phone => '%bad4445555'
+          }
+        )
+        result.success?.should == false
+        result.errors.for(:transaction).for(:descriptor).on(:name)[0].code.should == Braintree::ErrorCodes::Descriptor::NameFormatIsInvalid
+        result.errors.for(:transaction).for(:descriptor).on(:phone)[0].code.should == Braintree::ErrorCodes::Descriptor::PhoneFormatIsInvalid
+      end
+    end
+
+    context "level 2 fields" do
+      it "accepts tax_amount, tax_exempt, and purchase_order_number" do
+        result = Braintree::Transaction.sale(
+          :amount => Braintree::Test::TransactionAmounts::Authorize,
+          :credit_card => {
+            :number => Braintree::Test::CreditCardNumbers::Visa,
+            :expiration_date => "05/2009"
+          },
+          :tax_amount => '0.05',
+          :tax_exempt => false,
+          :purchase_order_number => '12345678901234567'
+        )
+        result.success?.should == true
+        result.transaction.tax_amount.should == BigDecimal.new("0.05")
+        result.transaction.tax_exempt.should == false
+        result.transaction.purchase_order_number.should == '12345678901234567'
+      end
+
+      it "accepts tax_amount as a BigDecimal" do
+        result = Braintree::Transaction.sale(
+          :amount => Braintree::Test::TransactionAmounts::Authorize,
+          :credit_card => {
+            :number => Braintree::Test::CreditCardNumbers::Visa,
+            :expiration_date => "05/2009"
+          },
+          :tax_amount => BigDecimal.new('1.99'),
+          :tax_exempt => true
+        )
+        result.success?.should == true
+        result.transaction.tax_amount.should == BigDecimal.new("1.99")
+        result.transaction.tax_exempt.should == true
+        result.transaction.purchase_order_number.should be_nil
+      end
+
+      it "has validation errors" do
+        result = Braintree::Transaction.sale(
+          :amount => Braintree::Test::TransactionAmounts::Authorize,
+          :credit_card => {
+            :number => Braintree::Test::CreditCardNumbers::Visa,
+            :expiration_date => "05/2009"
+          },
+          :tax_amount => 'abcd',
+          :purchase_order_number => 'a' * 18
+        )
+        result.success?.should == false
+        result.errors.for(:transaction).on(:tax_amount)[0].code.should == Braintree::ErrorCodes::Transaction::TaxAmountFormatIsInvalid
+        result.errors.for(:transaction).on(:purchase_order_number)[0].code.should == Braintree::ErrorCodes::Transaction::PurchaseOrderNumberIsTooLong
+      end
+    end
   end
 
   describe "self.create!" do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: braintree
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 19
   prerelease: false
   segments: 
   - 2
-  - 6
-  - 3
-  version: 2.6.3
+  - 7
+  - 0
+  version: 2.7.0
 platform: ruby
 authors: 
 - Braintree Payment Solutions
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-10 00:00:00 -06:00
+date: 2011-01-26 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -55,6 +55,8 @@ files:
 - lib/braintree/credit_card_verification.rb
 - lib/braintree/customer.rb
 - lib/braintree/customer_gateway.rb
+- lib/braintree/customer_search.rb
+- lib/braintree/descriptor.rb
 - lib/braintree/digest.rb
 - lib/braintree/discount.rb
 - lib/braintree/error_codes.rb
@@ -94,6 +96,7 @@ files:
 - spec/integration/braintree/address_spec.rb
 - spec/integration/braintree/advanced_search_spec.rb
 - spec/integration/braintree/credit_card_spec.rb
+- spec/integration/braintree/customer_search_spec.rb
 - spec/integration/braintree/customer_spec.rb
 - spec/integration/braintree/error_codes_spec.rb
 - spec/integration/braintree/http_spec.rb