braintree 3.0.1 → 4.0.0

data/lib/braintree/payment_method_nonce_details_payer_info.rb

@@ -0,0 +1,32 @@
+module Braintree
+  class PaymentMethodNonceDetailsPayerInfo # :nodoc:
+    include BaseModule
+
+    attr_reader :billing_agreement_id
+    attr_reader :country_code
+    attr_reader :email
+    attr_reader :first_name
+    attr_reader :last_name
+    attr_reader :payer_id
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+    end
+
+    def inspect
+      attr_order = [
+        :billing_agreement_id,
+        :country_code,
+        :email,
+        :first_name,
+        :last_name,
+        :payer_id,
+      ]
+
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<PaymentMethodNonceDetailsPayerInfo #{formatted_attrs.join(", ")}>"
+    end
+  end
+end

data/lib/braintree/payment_method_nonce_gateway.rb

@@ -8,7 +8,7 @@ module Braintree
       @config.assert_has_access_token_or_keys
     end
 
-    def create(payment_method_token, args = { payment_method_nonce: {} })
+    def create(payment_method_token, args = {payment_method_nonce: {}})
       Util.verify_keys(PaymentMethodNonceGateway._create_signature, args)
 
       response = @config.http.post("#{@config.base_merchant_path}/payment_methods/#{payment_method_token}/nonces", args)

data/lib/braintree/plan.rb

@@ -36,7 +36,7 @@ module Braintree
     end
 
     def self._new(*args)
-      self.new *args
+      self.new(*args)
     end
   end
 end

data/lib/braintree/processor_response_types.rb

@@ -1,7 +1,7 @@
 module Braintree
   module ProcessorResponseTypes
-    Approved = 'approved'
-    SoftDeclined = 'soft_declined'
-    HardDeclined = 'hard_declined'
+    Approved = "approved"
+    SoftDeclined = "soft_declined"
+    HardDeclined = "hard_declined"
   end
 end

data/lib/braintree/resource_collection.rb

@@ -22,9 +22,14 @@ module Braintree
       @ids.empty?
     end
 
-    # Returns the first item in the collection or nil if the collection is empty
-    def first
-      @paging_block.call([@ids.first]).first
+    # Returns the first or the first N items in the collection or nil if the collection is empty
+    def first(amount = 1)
+      return nil if @ids.empty?
+      return @paging_block.call([@ids.first]).first if amount == 1
+
+      @ids.first(amount).each_slice(@page_size).flat_map do |page_of_ids|
+        @paging_block.call(page_of_ids)
+      end
     end
 
     # Only the maximum size of a resource collection can be determined since the data on the server can change while

data/lib/braintree/revoked_payment_method_metadata.rb

@@ -15,7 +15,7 @@ module Braintree
     class << self
       protected :new
       def _new(*args) # :nodoc:
-        self.new *args
+        self.new(*args)
       end
     end
   end

data/lib/braintree/risk_data.rb

@@ -6,16 +6,18 @@ module Braintree
     attr_reader :customer_location_zip
     attr_reader :customer_tenure
     attr_reader :decision
+    attr_reader :decision_reasons
     attr_reader :device_data_captured
     attr_reader :fraud_service_provider
     attr_reader :id
+    attr_reader :transaction_risk_score
 
     def initialize(attributes)
       set_instance_variables_from_hash attributes unless attributes.nil?
     end
 
     def inspect
-      attr_order = [:id, :decision, :device_data_captured, :fraud_service_provider]
+      attr_order = [:id, :decision, :decision_reasons, :device_data_captured, :fraud_service_provider, :transaction_risk_score]
       formatted_attrs = attr_order.map do |attr|
         "#{attr}: #{send(attr).inspect}"
       end

data/lib/braintree/samsung_pay_card.rb

@@ -77,7 +77,7 @@ module Braintree
     end
 
     def self._new(*args) # :nodoc:
-      self.new *args
+      self.new(*args)
     end
   end
 end

data/lib/braintree/settlement_batch_summary.rb

@@ -1,11 +1,11 @@
 module Braintree
   class SettlementBatchSummary
     include BaseModule
-    
+
     attr_reader :records
 
     def self.generate(settlement_date, group_by_custom_field = nil)
-      criteria = { :settlement_date => settlement_date }
+      criteria = {:settlement_date => settlement_date}
       criteria.merge!({:group_by_custom_field => group_by_custom_field}) if group_by_custom_field
       Configuration.gateway.settlement_batch_summary.generate(criteria)
     end

data/lib/braintree/subscription.rb

@@ -11,11 +11,11 @@ module Braintree
     end
 
     module Status
-      Active = 'Active'
-      Canceled = 'Canceled'
-      Expired = 'Expired'
-      PastDue = 'Past Due'
-      Pending = 'Pending'
+      Active = "Active"
+      Canceled = "Canceled"
+      Expired = "Expired"
+      PastDue = "Past Due"
+      Pending = "Pending"
 
       All = constants.map { |c| const_get(c) }
     end
@@ -115,7 +115,7 @@ module Braintree
     class << self
       protected :new
       def _new(*args) # :nodoc:
-        self.new *args
+        self.new(*args)
       end
     end
   end

data/lib/braintree/test/credit_card.rb

@@ -36,6 +36,7 @@ module Braintree
       Hipercard = "6062820524845321"
 
       Visa = "4012888888881881"
+      VisaCountryOfIssuanceIE = "4023490000000008"
       VisaInternational = "4009348888881881" # :nodoc:
       VisaPrepaid = "4500600000000061"
 

data/lib/braintree/three_d_secure_info.rb

@@ -2,16 +2,21 @@ module Braintree
   class ThreeDSecureInfo # :nodoc:
     include BaseModule
 
+    attr_reader :acs_transaction_id
+    attr_reader :cavv
+    attr_reader :ds_transaction_id
+    attr_reader :eci_flag
     attr_reader :enrolled
-    attr_reader :liability_shifted
     attr_reader :liability_shift_possible
+    attr_reader :liability_shifted
+    attr_reader :pares_status
     attr_reader :status
-    attr_reader :cavv
-    attr_reader :xid
-    attr_reader :eci_flag
-    attr_reader :three_d_secure_version
-    attr_reader :ds_transaction_id
     attr_reader :three_d_secure_authentication_id
+    attr_reader :three_d_secure_transaction_id
+    attr_reader :three_d_secure_version
+    attr_reader :xid
+    attr_reader :lookup
+    attr_reader :authentication
 
     alias_method :liability_shifted?, :liability_shifted
     alias_method :liability_shift_possible?, :liability_shift_possible
@@ -22,16 +27,21 @@ module Braintree
 
     def inspect
       attr_order = [
+        :acs_transaction_id,
+        :authentication,
+        :cavv,
+        :ds_transaction_id,
+        :eci_flag,
         :enrolled,
-        :liability_shifted,
         :liability_shift_possible,
+        :liability_shifted,
+        :lookup,
+        :pares_status,
         :status,
-        :cavv,
-        :xid,
-        :eci_flag,
-        :three_d_secure_version,
-        :ds_transaction_id,
         :three_d_secure_authentication_id,
+        :three_d_secure_transaction_id,
+        :three_d_secure_version,
+        :xid
       ]
 
       formatted_attrs = attr_order.map do |attr|

data/lib/braintree/transaction.rb

@@ -4,18 +4,18 @@ module Braintree
     include Braintree::Util::IdEquality
 
     module CreatedUsing
-      FullInformation = 'full_information'
-      Token = 'token'
-      Unrecognized = 'unrecognized'
+      FullInformation = "full_information"
+      Token = "token"
+      Unrecognized = "unrecognized"
     end
 
     module EscrowStatus
-      HoldPending    = 'hold_pending'
-      Held           = 'held'
-      ReleasePending = 'release_pending'
-      Released       = 'released'
-      Refunded       = 'refunded'
-      Unrecognized   = 'unrecognized'
+      HoldPending    = "hold_pending"
+      Held           = "held"
+      ReleasePending = "release_pending"
+      Released       = "released"
+      Refunded       = "refunded"
+      Unrecognized   = "unrecognized"
     end
 
     module GatewayRejectionReason
@@ -32,20 +32,20 @@ module Braintree
     end
 
     module Status
-      AuthorizationExpired   = 'authorization_expired'
-      Authorizing            = 'authorizing'
-      Authorized             = 'authorized'
-      GatewayRejected        = 'gateway_rejected'
-      Failed                 = 'failed'
-      ProcessorDeclined      = 'processor_declined'
-      Settled                = 'settled'
-      SettlementConfirmed    = 'settlement_confirmed'
-      SettlementDeclined     = 'settlement_declined'
-      SettlementPending      = 'settlement_pending'
-      Settling               = 'settling'
-      SubmittedForSettlement = 'submitted_for_settlement'
-      Voided                 = 'voided'
-      Unrecognized           = 'unrecognized'
+      AuthorizationExpired   = "authorization_expired"
+      Authorizing            = "authorizing"
+      Authorized             = "authorized"
+      GatewayRejected        = "gateway_rejected"
+      Failed                 = "failed"
+      ProcessorDeclined      = "processor_declined"
+      Settled                = "settled"
+      SettlementConfirmed    = "settlement_confirmed"
+      SettlementDeclined     = "settlement_declined"
+      SettlementPending      = "settlement_pending"
+      Settling               = "settling"
+      SubmittedForSettlement = "submitted_for_settlement"
+      Voided                 = "voided"
+      Unrecognized           = "unrecognized"
 
       All = constants.map { |c| const_get(c) }
     end
@@ -90,10 +90,10 @@ module Braintree
       end
     end
 
+    attr_reader :acquirer_reference_number
     attr_reader :add_ons
     attr_reader :additional_processor_response          # The raw response from the processor.
     attr_reader :amount
-    attr_reader :google_pay_details
     attr_reader :apple_pay_details
     attr_reader :authorization_adjustments
     attr_reader :authorization_expires_at
@@ -118,8 +118,11 @@ module Braintree
     attr_reader :facilitated_details
     attr_reader :facilitator_details
     attr_reader :gateway_rejection_reason
+    attr_reader :google_pay_details
     attr_reader :graphql_id
     attr_reader :id
+    attr_reader :installment_count
+    attr_reader :installments
     attr_reader :local_payment_details
     attr_reader :merchant_account_id
     attr_reader :network_response_code                  # Response code from the card network
@@ -142,8 +145,11 @@ module Braintree
     attr_reader :recurring
     attr_reader :refund_ids
     attr_reader :refunded_transaction_id
+    attr_reader :refunded_installments
+    attr_reader :retrieval_reference_number
     attr_reader :risk_data
     attr_reader :samsung_pay_card_details
+    attr_reader :sca_exemption_requested
     attr_reader :service_fee_amount
     attr_reader :settlement_batch_id
     attr_reader :shipping_amount
@@ -162,7 +168,14 @@ module Braintree
     attr_reader :venmo_account_details
     attr_reader :visa_checkout_card_details
     attr_reader :voice_referral_number
-    attr_reader :retrieval_reference_number
+
+    def self.adjust_authorization(*args)
+      Configuration.gateway.transaction.adjust_authorization(*args)
+    end
+
+    def self.adjust_authorization!(*args)
+      Configuration.gateway.transaction.adjust_authorization!(*args)
+    end
 
     def self.create(*args)
       Configuration.gateway.transaction.create(*args)
@@ -304,7 +317,11 @@ module Braintree
       @us_bank_account_details = UsBankAccountDetails.new(attributes[:us_bank_account]) if attributes[:us_bank_account]
       @visa_checkout_card_details = VisaCheckoutCardDetails.new(attributes[:visa_checkout_card])
       @samsung_pay_card_details = SamsungPayCardDetails.new(attributes[:samsung_pay_card])
+      @sca_exemption_requested = attributes[:sca_exemption_requested]
       authorization_adjustments.map! { |attrs| AuthorizationAdjustment._new(attrs) } if authorization_adjustments
+
+      installments.map! { |attrs| Installment.new(attrs) } if installments
+      refunded_installments.map! { |attrs| Installment.new(attrs) } if refunded_installments
     end
 
     def inspect # :nodoc:
@@ -377,7 +394,7 @@ module Braintree
     class << self
       protected :new
       def _new(*args) # :nodoc:
-        self.new *args
+        self.new(*args)
       end
     end
 

data/lib/braintree/transaction/installment.rb

@@ -0,0 +1,28 @@
+module Braintree
+  class Transaction
+    class Installment
+      include BaseModule
+
+      attr_reader :id
+      attr_reader :amount
+      attr_reader :projected_disbursement_date
+      attr_reader :actual_disbursement_date
+      attr_reader :adjustments
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+        @amount = Util.to_big_decimal(amount)
+        adjustments.map! { |attrs| Adjustment.new(attrs) } if adjustments
+      end
+
+      def inspect
+        attrs = [:id, :amount, :projected_disbursement_date, :actual_disbursement_date, :adjustments]
+        formatted_attrs = attrs.map do |attr|
+          "#{attr}: #{send(attr).inspect}"
+        end
+
+        "#<#{formatted_attrs.join(", ")}>"
+      end
+    end
+  end
+end

data/lib/braintree/transaction/installment/adjustment.rb

@@ -0,0 +1,33 @@
+module Braintree
+  class Transaction
+    class Installment
+      class Adjustment
+        include BaseModule
+
+        module Kind
+          Refund = "REFUND"
+          Dispute = "DISPUTE"
+        end
+
+        attr_reader :amount
+        attr_reader :kind
+        attr_reader :projected_disbursement_date
+        attr_reader :actual_disbursement_date
+
+        def initialize(attributes)
+          set_instance_variables_from_hash attributes unless attributes.nil?
+          @amount = Util.to_big_decimal(amount)
+        end
+
+        def inspect
+          attrs = [:amount, :kind, :projected_disbursement_date, :actual_disbursement_date]
+          formatted_attrs = attrs.map do |attr|
+            "#{attr}: #{send(attr).inspect}"
+          end
+
+          "#<#{formatted_attrs.join(", ")}>"
+        end
+      end
+    end
+  end
+end

data/lib/braintree/transaction/paypal_details.rb

@@ -4,6 +4,7 @@ module Braintree
       include BaseModule
 
       attr_reader :authorization_id
+      attr_reader :billing_agreement_id
       attr_reader :capture_id
       attr_reader :custom_field
       attr_reader :debug_id

data/lib/braintree/transaction_gateway.rb

@@ -53,7 +53,7 @@ module Braintree
     end
 
     def credit(attributes)
-      create(attributes.merge(:type => 'credit'))
+      create(attributes.merge(:type => "credit"))
     end
 
     def credit!(*args)
@@ -72,7 +72,7 @@ module Braintree
       options = if amount_or_options.is_a?(Hash)
                   amount_or_options
                 else
-                  { :amount => amount_or_options }
+                  {:amount => amount_or_options}
                 end
 
       Util.verify_keys(TransactionGateway._refund_signature, options)
@@ -97,7 +97,7 @@ module Braintree
     end
 
     def sale(attributes)
-      create(attributes.merge(:type => 'sale'))
+      create(attributes.merge(:type => "sale"))
     end
 
     def sale!(*args)
@@ -139,6 +139,18 @@ module Braintree
       return_object_or_raise(:transaction) { submit_for_settlement(*args) }
     end
 
+    def adjust_authorization(transaction_id, amount)
+      raise ArgumentError, "transaction_id is invalid" unless transaction_id =~ /\A[0-9a-z]+\z/
+      Util.verify_keys(TransactionGateway._adjust_authorization_signature, {})
+      transaction_params = {:amount => amount}
+      response = @config.http.put("#{@config.base_merchant_path}/transactions/#{transaction_id}/adjust_authorization", :transaction => transaction_params)
+      _handle_transaction_response(response)
+    end
+
+    def adjust_authorization!(*args)
+      return_object_or_raise(:transaction) { adjust_authorization(*args) }
+    end
+
     def update_details(transaction_id, options = {})
       raise ArgumentError, "transaction_id is invalid" unless transaction_id =~ /\A[0-9a-z]+\z/
       Util.verify_keys(TransactionGateway._update_details_signature, options)
@@ -180,6 +192,7 @@ module Braintree
         :shared_shipping_address_id, :shipping_address_id, :shipping_amount,
         :ships_from_postal_code, :tax_amount, :tax_exempt, :three_d_secure_authentication_id,
         :three_d_secure_token, :transaction_source, :type, :venmo_sdk_payment_method_code,
+        :sca_exemption, :currency_iso_code,
         {:line_items => [:quantity, :name, :description, :kind, :unit_amount, :unit_tax_amount, :total_amount, :discount_amount, :tax_amount, :unit_of_measure, :product_code, :commodity_code, :url]},
         {:risk_data => [:customer_browser, :customer_device_id, :customer_ip, :customer_location_zip, :customer_tenure]},
         {:credit_card => [:token, :cardholder_name, :cvv, :expiration_date, :expiration_month, :expiration_year, :number]},
@@ -245,7 +258,8 @@ module Braintree
           ]},
         ]},
         {:apple_pay_card => [:number, :cardholder_name, :cryptogram, :expiration_month, :expiration_year, :eci_indicator]},
-        {:google_pay_card => [:number, :cryptogram, :google_transaction_id, :expiration_month, :expiration_year, :source_card_type, :source_card_last_four, :eci_indicator]}
+        {:google_pay_card => [:number, :cryptogram, :google_transaction_id, :expiration_month, :expiration_year, :source_card_type, :source_card_last_four, :eci_indicator]},
+        {:installments => [:count]},
       ]
     end
 
@@ -263,6 +277,12 @@ module Braintree
       ]
     end
 
+    def self._adjust_authorization_signature
+      [
+        :amount
+      ]
+    end
+
     def self._update_details_signature # :nodoc:
       [
         :amount,
@@ -274,7 +294,8 @@ module Braintree
     def self._refund_signature
       [
         :amount,
-        :order_id
+        :merchant_account_id,
+        :order_id,
       ]
     end