braintree 2.104.0 → 4.9.0

data/lib/braintree/payment_method_nonce_details.rb

@@ -0,0 +1,37 @@
+module Braintree
+  class PaymentMethodNonceDetails # :nodoc:
+    include BaseModule
+
+    attr_reader :bin
+    attr_reader :card_type
+    attr_reader :expiration_month
+    attr_reader :expiration_year
+    attr_reader :is_network_tokenized
+    attr_reader :last_two
+    attr_reader :payer_info
+
+    alias_method :is_network_tokenized?, :is_network_tokenized
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+      @payer_info = PaymentMethodNonceDetailsPayerInfo.new(attributes[:payer_info]) if attributes[:payer_info]
+    end
+
+    def inspect
+      attr_order = [
+        :bin,
+        :card_type,
+        :expiration_month,
+        :expiration_year,
+        :is_network_tokenized,
+        :last_two,
+        :payer_info,
+      ]
+
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<PaymentMethodNonceDetails #{formatted_attrs.join(", ")}>"
+    end
+  end
+end

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/payment_method_parser.rb

@@ -6,23 +6,16 @@ module Braintree
         CreditCard._new(gateway, attributes[:credit_card])
       elsif attributes[:paypal_account]
         PayPalAccount._new(gateway, attributes[:paypal_account])
-      elsif attributes[:coinbase_account]
-        CoinbaseAccount._new(gateway, attributes[:coinbase_account])
       elsif attributes[:us_bank_account]
         UsBankAccount._new(gateway, attributes[:us_bank_account])
       elsif attributes[:apple_pay_card]
         ApplePayCard._new(gateway, attributes[:apple_pay_card])
       elsif attributes[:android_pay_card]
-        # NEXT_MAJOR_VERSION rename Android Pay to Google Pay
-        AndroidPayCard._new(gateway, attributes[:android_pay_card])
-      elsif attributes[:amex_express_checkout_card]
-        AmexExpressCheckoutCard._new(gateway, attributes[:amex_express_checkout_card])
+        GooglePayCard._new(gateway, attributes[:android_pay_card])
       elsif attributes[:venmo_account]
         VenmoAccount._new(gateway, attributes[:venmo_account])
       elsif attributes[:visa_checkout_card]
         VisaCheckoutCard._new(gateway, attributes[:visa_checkout_card])
-      elsif attributes[:masterpass_card]
-        MasterpassCard._new(gateway, attributes[:masterpass_card])
       elsif attributes[:samsung_pay_card]
         SamsungPayCard._new(gateway, attributes[:samsung_pay_card])
       else

data/lib/braintree/plan.rb

@@ -33,10 +33,30 @@ module Braintree
 
     class << self
       protected :new
+
+      def create(*args)
+        Configuration.gateway.plan.create(*args)
+      end
+
+      def create!(*args)
+        Configuration.gateway.plan.create!(*args)
+      end
+
+      def find(*args)
+        Configuration.gateway.plan.find(*args)
+      end
+
+      def update(*args)
+        Configuration.gateway.plan.update(*args)
+      end
+
+      def update!(*args)
+        Configuration.gateway.plan.update!(*args)
+      end
     end
 
     def self._new(*args)
-      self.new *args
+      self.new(*args)
     end
   end
 end

data/lib/braintree/plan_gateway.rb

@@ -1,5 +1,7 @@
 module Braintree
   class PlanGateway # :nodoc:
+    include BaseModule
+
     def initialize(gateway)
       @gateway = gateway
       @config = gateway.config
@@ -13,5 +15,103 @@ module Braintree
         Plan._new(@gateway, attributes)
       end
     end
+
+    def create(attributes)
+      Util.verify_keys(PlanGateway._create_signature, attributes)
+      _do_create "/plans", :plan => attributes
+    end
+
+    def create!(*args)
+      return_object_or_raise(:plan) { create(*args) }
+    end
+
+    def find(id)
+      raise ArgumentError if id.nil? || id.to_s.strip == ""
+      response = @config.http.get("#{@config.base_merchant_path}/plans/#{id}")
+      Plan._new(@gateway, response[:plan])
+    rescue NotFoundError
+      raise NotFoundError, "plan with id #{id.inspect} not found"
+    end
+
+    def update(plan_id, attributes)
+      Util.verify_keys(PlanGateway._update_signature, attributes)
+      response = @config.http.put("#{@config.base_merchant_path}/plans/#{plan_id}", :plan => attributes)
+      if response[:plan]
+        SuccessfulResult.new(:plan => Plan._new(@gateway, response[:plan]))
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise UnexpectedError, "expected :plan or :api_error_response"
+      end
+    end
+
+    def update!(*args)
+      return_object_or_raise(:plan) { update(*args) }
+    end
+
+    def self._create_signature
+      [
+        :billing_day_of_month,
+        :billing_frequency,
+        :currency_iso_code,
+        :description,
+        :id,
+        :merchant_id,
+        :name,
+        :number_of_billing_cycles,
+        :price,
+        :trial_duration,
+        :trial_duration_unit,
+        :trial_period
+      ] + _add_on_discount_signature
+    end
+
+    def self._update_signature
+      [
+        :billing_day_of_month,
+        :billing_frequency,
+        :currency_iso_code,
+        :description,
+        :id,
+        :merchant_id,
+        :name,
+        :number_of_billing_cycles,
+        :price,
+        :trial_duration,
+        :trial_duration_unit,
+        :trial_period
+      ] + _add_on_discount_signature
+    end
+
+    def self._add_on_discount_signature
+      [
+        {
+          :add_ons => [
+            {:add => [:amount, :inherited_from_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:update => [:amount, :existing_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:remove => [:_any_key_]}
+          ]
+        },
+        {
+          :discounts => [
+            {:add => [:amount, :inherited_from_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:update => [:amount, :existing_id, :never_expires, :number_of_billing_cycles, :quantity]},
+            {:remove => [:_any_key_]}
+          ]
+        }
+      ]
+    end
+
+    def _do_create(path, params) # :nodoc:
+      response = @config.http.post("#{@config.base_merchant_path}#{path}", params)
+      if response[:plan]
+        SuccessfulResult.new(:plan => Plan._new(@gateway, response[:plan]))
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise UnexpectedError, "expected :plan or :api_error_response"
+      end
+    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/liability_shift.rb

@@ -0,0 +1,22 @@
+module Braintree
+  class RiskData
+    class LiabilityShift
+      include BaseModule
+
+      attr_reader :responsible_party
+      attr_reader :conditions
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+      end
+
+      def inspect
+        attr_order = [:responsible_party, :conditions]
+        formatted_attrs = attr_order.map do |attr|
+          "#{attr}: #{send(attr).inspect}"
+        end
+        "#<LiabilityShift #{formatted_attrs.join(", ")}>"
+      end
+    end
+  end
+end

data/lib/braintree/risk_data.rb

@@ -6,16 +6,20 @@ 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 :liability_shift
+    attr_reader :transaction_risk_score
 
     def initialize(attributes)
       set_instance_variables_from_hash attributes unless attributes.nil?
+      @liability_shift = LiabilityShift.new(attributes[:liability_shift]) if attributes[:liability_shift]
     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, :liability_shift, :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
@@ -101,11 +101,11 @@ module Braintree
       add_ons.map! { |attrs| AddOn._new(attrs) }
       discounts.map! { |attrs| Discount._new(attrs) }
       @status_history = attributes[:status_history] ? attributes[:status_history].map { |s| StatusDetails.new(s) } : []
-    end
-
-    def next_bill_amount
-      warn "[DEPRECATED] Subscription.next_bill_amount is deprecated. Please use Subscription.next_billing_period_amount"
-      @next_bill_amount
+      @first_billing_date = Date.parse(first_billing_date) unless first_billing_date.nil?
+      @next_billing_date = Date.parse(next_billing_date) unless next_billing_date.nil?
+      @billing_period_start_date = Date.parse(billing_period_start_date) unless billing_period_start_date.nil?
+      @billing_period_end_date = Date.parse(billing_period_end_date) unless billing_period_end_date.nil?
+      @paid_through_date = Date.parse(paid_through_date) unless paid_through_date.nil?
     end
 
     def never_expires?
@@ -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/successful_result.rb

@@ -6,23 +6,24 @@ module Braintree
     attr_reader :apple_pay_options
     attr_reader :credentials
     attr_reader :credit_card
+    attr_reader :credit_card_verification
     attr_reader :customer
     attr_reader :disputes
     attr_reader :document_upload
     attr_reader :evidence
+    attr_reader :exchange_rate_quote_payload
     attr_reader :merchant
     attr_reader :merchant_account
     attr_reader :merchant_accounts
-    attr_reader :new_transaction
     attr_reader :payment_method
     attr_reader :payment_method_nonce
     attr_reader :paypal_account
+    attr_reader :plan
     attr_reader :settlement_batch_summary
     attr_reader :subscription
     attr_reader :supported_networks
     attr_reader :transaction
     attr_reader :us_bank_account_verification
-    attr_reader :credit_card_verification
 
     def initialize(attributes = {}) # :nodoc:
       @attrs = attributes.keys

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/test/nonce.rb

@@ -12,14 +12,10 @@ module Braintree
       ApplePayAmEx = "fake-apple-pay-amex-nonce"
       AbstractTransactable = "fake-abstract-transactable-nonce"
       Europe = "fake-europe-bank-account-nonce"
-      Coinbase = "fake-coinbase-nonce"
-      # NEXT_MAJOR_VERSION rename Android Pay to Google Pay
-      AndroidPayDiscover = "fake-android-pay-discover-nonce"
-      AndroidPayVisa = "fake-android-pay-visa-nonce"
-      AndroidPayMasterCard = "fake-android-pay-mastercard-nonce"
-      AndroidPayAmEx = "fake-android-pay-amex-nonce"
-      # NEXT_MAJOR_VERSION Remove AmexExpressCheckout test nonces
-      AmexExpressCheckout = "fake-amex-express-checkout-nonce"
+      GooglePayDiscover = "fake-android-pay-discover-nonce"
+      GooglePayVisa = "fake-android-pay-visa-nonce"
+      GooglePayMasterCard = "fake-android-pay-mastercard-nonce"
+      GooglePayAmEx = "fake-android-pay-amex-nonce"
       VenmoAccount = "fake-venmo-account-nonce"
       VenmoAccountTokenIssuanceError = "fake-token-issuance-error-venmo-account-nonce"
       ThreeDSecureVisaFullAuthentication = "fake-three-d-secure-visa-full-authentication-nonce"
@@ -62,14 +58,8 @@ module Braintree
       ProcessorFailureJCB = "fake-processor-failure-jcb-nonce"
       LuhnInvalid = "fake-luhn-invalid-nonce"
       PayPalFuturePaymentRefreshToken = "fake-paypal-future-refresh-token-nonce"
-      SEPA = "fake-sepa-bank-account-nonce"
       GatewayRejectedFraud = "fake-gateway-rejected-fraud-nonce"
       GatewayRejectedRiskThresholds = "fake-gateway-rejected-risk-thresholds-nonce"
-      # NEXT_MAJOR_VERSION Remove Masterpass test nonces
-      MasterpassAmEx = "fake-masterpass-amex-nonce"
-      MasterpassDiscover = "fake-masterpass-discover-nonce"
-      MasterpassMasterCard = "fake-masterpass-mastercard-nonce"
-      MasterpassVisa = "fake-masterpass-visa-nonce"
       VisaCheckoutAmEx = "fake-visa-checkout-amex-nonce"
       VisaCheckoutDiscover = "fake-visa-checkout-discover-nonce"
       VisaCheckoutMasterCard = "fake-visa-checkout-mastercard-nonce"
@@ -78,15 +68,6 @@ module Braintree
       SamsungPayDiscover = "tokensam_fake_discover"
       SamsungPayMasterCard = "tokensam_fake_mastercard"
       SamsungPayVisa = "tokensam_fake_visa"
-
-      def self.const_missing(const_name)
-        if const_name == :AndroidPay
-          warn "[DEPRECATED] Braintree::Test::Nonce::AndroidPay is deprecated. Use a card-specific nonce, e.g. Braintree::Test::Nonce::AndroidPayMasterCard"
-          "fake-android-pay-nonce"
-        else
-          super
-        end
-      end
     end
   end
 end

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/disbursement_details.rb

@@ -13,6 +13,7 @@ module Braintree
 
       def initialize(attributes)
         set_instance_variables_from_hash attributes unless attributes.nil?
+        @disbursement_date = Date.parse(disbursement_date) unless disbursement_date.nil?
       end
 
       def funds_held?

data/lib/braintree/transaction/{android_pay_details.rb → google_pay_details.rb}

@@ -1,6 +1,6 @@
 module Braintree
   class Transaction
-    class AndroidPayDetails
+    class GooglePayDetails
       include BaseModule
 
       attr_reader :bin

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/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/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
@@ -23,6 +24,8 @@ module Braintree
       attr_reader :refund_from_transaction_fee_currency_iso_code
       attr_reader :refund_id
       attr_reader :seller_protection_status
+      attr_reader :tax_id
+      attr_reader :tax_id_type
       attr_reader :token
       attr_reader :transaction_fee_amount
       attr_reader :transaction_fee_currency_iso_code

data/lib/braintree/transaction/subscription_details.rb

@@ -8,6 +8,8 @@ module Braintree
 
       def initialize(attributes)
         set_instance_variables_from_hash attributes unless attributes.nil?
+        @billing_period_start_date = Date.parse(billing_period_start_date) unless billing_period_start_date.nil?
+        @billing_period_end_date = Date.parse(billing_period_end_date) unless billing_period_end_date.nil?
       end
     end
   end