braintree 2.10.0 → 4.26.0

data/lib/braintree/testing_gateway.rb

@@ -0,0 +1,43 @@
+module Braintree
+  class TestingGateway
+
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+      @config.assert_has_access_token_or_keys
+      @transaction_gateway = TransactionGateway.new(gateway)
+    end
+
+    def settle(transaction_id)
+      check_environment
+
+      response = @config.http.put("#{@config.base_merchant_path}/transactions/#{transaction_id}/settle")
+      @transaction_gateway._handle_transaction_response(response)
+    end
+
+    def settlement_confirm(transaction_id)
+      check_environment
+
+      response = @config.http.put("#{@config.base_merchant_path}/transactions/#{transaction_id}/settlement_confirm")
+      @transaction_gateway._handle_transaction_response(response)
+    end
+
+    def settlement_decline(transaction_id)
+      check_environment
+
+      response = @config.http.put("#{@config.base_merchant_path}/transactions/#{transaction_id}/settlement_decline")
+      @transaction_gateway._handle_transaction_response(response)
+    end
+
+    def settlement_pending(transaction_id)
+      check_environment
+
+      response = @config.http.put("#{@config.base_merchant_path}/transactions/#{transaction_id}/settlement_pending")
+      @transaction_gateway._handle_transaction_response(response)
+    end
+
+    def check_environment
+      raise TestOperationPerformedInProduction if @config.environment == :production
+    end
+  end
+end

data/lib/braintree/three_d_secure_info.rb

@@ -0,0 +1,53 @@
+module Braintree
+  class ThreeDSecureInfo
+    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_shift_possible
+    attr_reader :liability_shifted
+    attr_reader :pares_status
+    attr_reader :status
+    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
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+    end
+
+    def inspect
+      attr_order = [
+        :acs_transaction_id,
+        :authentication,
+        :cavv,
+        :ds_transaction_id,
+        :eci_flag,
+        :enrolled,
+        :liability_shift_possible,
+        :liability_shifted,
+        :lookup,
+        :pares_status,
+        :status,
+        :three_d_secure_authentication_id,
+        :three_d_secure_transaction_id,
+        :three_d_secure_version,
+        :xid
+      ]
+
+      formatted_attrs = attr_order.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<ThreeDSecureInfo #{formatted_attrs.join(", ")}>"
+    end
+  end
+end

data/lib/braintree/transaction/address_details.rb

@@ -1,12 +1,34 @@
 module Braintree
   class Transaction
-    class AddressDetails # :nodoc:
+    class AddressDetails
       include BaseModule
 
-      attr_reader :id, :first_name, :last_name, :company,
-        :street_address, :extended_address, :locality, :region,
-        :postal_code, :country_code_alpha2, :country_code_alpha3,
-        :country_code_numeric, :country_name
+      module ShippingMethod
+        SameDay = "same_day"
+        NextDay = "next_day"
+        Priority = "priority"
+        Ground = "ground"
+        Electronic = "electronic"
+        ShipToStore = "ship_to_store"
+        PickupInStore = "pickup_in_store"
+      end
+
+      attr_reader :company
+      attr_reader :country_code_alpha2
+      attr_reader :country_code_alpha3
+      attr_reader :country_code_numeric
+      attr_reader :country_name
+      attr_reader :extended_address
+      attr_reader :first_name
+      attr_reader :id
+      attr_reader :international_phone
+      attr_reader :last_name
+      attr_reader :locality
+      attr_reader :phone_number
+      attr_reader :postal_code
+      attr_reader :region
+      attr_reader :shipping_method
+      attr_reader :street_address
 
       def initialize(attributes)
         set_instance_variables_from_hash attributes unless attributes.nil?

data/lib/braintree/transaction/apple_pay_details.rb

@@ -0,0 +1,35 @@
+module Braintree
+  class Transaction
+    class ApplePayDetails
+      include BaseModule
+
+      attr_reader :bin
+      attr_reader :card_type
+      attr_reader :cardholder_name
+      attr_reader :commercial
+      attr_reader :country_of_issuance
+      attr_reader :debit
+      attr_reader :durbin_regulated
+      attr_reader :expiration_month
+      attr_reader :expiration_year
+      attr_reader :global_id
+      attr_reader :healthcare
+      attr_reader :image_url
+      attr_reader :issuing_bank
+      attr_reader :last_4
+      attr_reader :merchant_token_identifier
+      attr_reader :payment_instrument_name
+      attr_reader :payroll
+      attr_reader :prepaid
+      attr_reader :prepaid_reloadable
+      attr_reader :product_id
+      attr_reader :source_card_last4
+      attr_reader :source_description
+      attr_reader :token
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+      end
+    end
+  end
+end

data/lib/braintree/transaction/credit_card_details.rb

@@ -1,10 +1,29 @@
 module Braintree
   class Transaction
-    class CreditCardDetails # :nodoc:
+    class CreditCardDetails
       include BaseModule
 
-      attr_reader :bin, :card_type, :cardholder_name, :customer_location, :expiration_month,
-        :expiration_year, :last_4, :token
+      attr_reader :account_type
+      attr_reader :bin
+      attr_reader :card_type
+      attr_reader :cardholder_name
+      attr_reader :commercial
+      attr_reader :country_of_issuance
+      attr_reader :customer_location
+      attr_reader :debit
+      attr_reader :durbin_regulated
+      attr_reader :expiration_month
+      attr_reader :expiration_year
+      attr_reader :healthcare
+      attr_reader :image_url
+      attr_reader :issuing_bank
+      attr_reader :last_4
+      attr_reader :payroll
+      attr_reader :prepaid
+      attr_reader :prepaid_reloadable
+      attr_reader :product_id
+      attr_reader :token
+      attr_reader :unique_number_identifier
 
       def initialize(attributes)
         set_instance_variables_from_hash attributes unless attributes.nil?
@@ -15,7 +34,28 @@ module Braintree
       end
 
       def inspect
-        attr_order = [:token, :bin, :last_4, :card_type, :expiration_date, :cardholder_name, :customer_location]
+        attr_order = [
+          :bin,
+          :card_type,
+          :cardholder_name,
+          :commercial,
+          :country_of_issuance,
+          :customer_location,
+          :debit,
+          :durbin_regulated,
+          :expiration_date,
+          :healthcare,
+          :image_url,
+          :issuing_bank,
+          :last_4,
+          :payroll,
+          :prepaid,
+          :prepaid_reloadable,
+          :product_id,
+          :token,
+          :unique_number_identifier,
+        ]
+
         formatted_attrs = attr_order.map do |attr|
           "#{attr}: #{send(attr).inspect}"
         end
@@ -25,6 +65,17 @@ module Braintree
       def masked_number
         "#{bin}******#{last_4}"
       end
+
+      # NEXT_MAJOR_VERSION Remove this method
+      # The old venmo SDK class has been deprecated
+      def venmo_sdk?
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+        @venmo_sdk
+      end
+
+      def is_network_tokenized?
+        @is_network_tokenized
+      end
     end
   end
 end

data/lib/braintree/transaction/customer_details.rb

@@ -1,16 +1,24 @@
 module Braintree
   class Transaction
-    class CustomerDetails # :nodoc:
+    class CustomerDetails
       include BaseModule
 
-      attr_reader :company, :email, :fax, :first_name, :id, :last_name, :phone, :website
+      attr_reader :company
+      attr_reader :email
+      attr_reader :fax
+      attr_reader :first_name
+      attr_reader :id
+      attr_reader :international_phone
+      attr_reader :last_name
+      attr_reader :phone
+      attr_reader :website
 
       def initialize(attributes)
         set_instance_variables_from_hash attributes unless attributes.nil?
       end
 
       def inspect
-        attr_order = [:id, :first_name, :last_name, :email, :company, :website, :phone, :fax]
+        attr_order = [:id, :first_name, :last_name, :email, :company, :website, :phone, :international_phone, :fax]
         formatted_attrs = attr_order.map do |attr|
           "#{attr}: #{send(attr).inspect}"
         end

data/lib/braintree/transaction/disbursement_details.rb

@@ -0,0 +1,28 @@
+module Braintree
+  class Transaction
+    class DisbursementDetails
+      include BaseModule
+
+      attr_reader :disbursement_date
+      attr_reader :settlement_amount
+      attr_reader :settlement_currency_exchange_rate
+      attr_reader :settlement_currency_iso_code
+      attr_reader :success
+
+      alias_method :success?, :success
+
+      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?
+        @funds_held
+      end
+
+      def valid?
+        !disbursement_date.nil?
+      end
+    end
+  end
+end

data/lib/braintree/transaction/google_pay_details.rb

@@ -0,0 +1,42 @@
+module Braintree
+  class Transaction
+    class GooglePayDetails
+      include BaseModule
+
+      attr_reader :bin
+      attr_reader :card_type
+      attr_reader :commercial
+      attr_reader :country_of_issuance
+      attr_reader :debit
+      attr_reader :durbin_regulated
+      attr_reader :expiration_month
+      attr_reader :expiration_year
+      attr_reader :global_id
+      attr_reader :google_transaction_id
+      attr_reader :healthcare
+      attr_reader :image_url
+      attr_reader :issuing_bank
+      attr_reader :last_4
+      attr_reader :payroll
+      attr_reader :prepaid
+      attr_reader :prepaid_reloadable
+      attr_reader :product_id
+      attr_reader :source_card_last_4
+      attr_reader :source_card_type
+      attr_reader :source_description
+      attr_reader :token
+      attr_reader :virtual_card_last_4
+      attr_reader :virtual_card_type
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+        @card_type = @virtual_card_type
+        @last_4 = @virtual_card_last_4
+      end
+
+      def is_network_tokenized?
+        @is_network_tokenized
+      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/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/local_payment_details.rb

@@ -0,0 +1,27 @@
+module Braintree
+  class Transaction
+    class LocalPaymentDetails
+      include BaseModule
+
+      attr_reader :blik_aliases
+      attr_reader :capture_id
+      attr_reader :custom_field
+      attr_reader :debug_id
+      attr_reader :description
+      attr_reader :funding_source
+      attr_reader :implicitly_vaulted_payment_method_global_id
+      attr_reader :implicitly_vaulted_payment_method_token
+      attr_reader :payer_id
+      attr_reader :payment_id
+      attr_reader :refund_from_transaction_fee_amount
+      attr_reader :refund_from_transaction_fee_currency_iso_code
+      attr_reader :refund_id
+      attr_reader :transaction_fee_amount
+      attr_reader :transaction_fee_currency_iso_code
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+      end
+    end
+  end
+end

data/lib/braintree/transaction/meta_checkout_card_details.rb

@@ -0,0 +1,55 @@
+module Braintree
+    class Transaction
+      class MetaCheckoutCardDetails # :nodoc:
+        include BaseModule
+
+        attr_reader :bin
+        attr_reader :card_type
+        attr_reader :cardholder_name
+        attr_reader :commercial
+        attr_reader :container_id
+        attr_reader :country_of_issuance
+        attr_reader :created_at
+        attr_reader :customer_location
+        attr_reader :debit
+        attr_reader :durbin_regulated
+        attr_reader :expiration_month
+        attr_reader :expiration_year
+        attr_reader :healthcare
+        attr_reader :image_url
+        attr_reader :is_network_tokenized
+        attr_reader :issuing_bank
+        attr_reader :last_4
+        attr_reader :payroll
+        attr_reader :prepaid
+        attr_reader :prepaid_reloadable
+        attr_reader :product_id
+        attr_reader :token
+        attr_reader :unique_number_identifier
+        attr_reader :updated_at
+
+        def initialize(attributes)
+          set_instance_variables_from_hash attributes unless attributes.nil?
+        end
+
+        def expiration_date
+          "#{expiration_month}/#{expiration_year}"
+        end
+
+        def inspect
+          attr_order = [
+            :bin, :card_type, :cardholder_name, :commercial, :container_id, :country_of_issuance,
+            :customer_location, :debit, :durbin_regulated, :expiration_date, :healthcare, :image_url,
+            :issuing_bank, :last_4, :payroll, :prepaid, :prepaid_reloadable, :product_id, :token]
+          formatted_attrs = attr_order.map do |attr|
+            "#{attr}: #{send(attr).inspect}"
+          end
+          "#<#{formatted_attrs.join(", ")}>"
+        end
+
+        def masked_number
+          "#{bin}******#{last_4}"
+        end
+      end
+    end
+  end

data/lib/braintree/transaction/meta_checkout_token_details.rb

@@ -0,0 +1,58 @@
+module Braintree
+    class Transaction
+      class MetaCheckoutTokenDetails # :nodoc:
+        include BaseModule
+
+        attr_reader :bin
+        attr_reader :container_id
+        attr_reader :card_type
+        attr_reader :cardholder_name
+        attr_reader :commercial
+        attr_reader :country_of_issuance
+        attr_reader :created_at
+        attr_reader :cryptogram
+        attr_reader :customer_location
+        attr_reader :debit
+        attr_reader :durbin_regulated
+        attr_reader :ecommerce_indicator
+        attr_reader :expiration_month
+        attr_reader :expiration_year
+        attr_reader :healthcare
+        attr_reader :image_url
+        attr_reader :issuing_bank
+        attr_reader :is_network_tokenized
+        attr_reader :last_4
+        attr_reader :payroll
+        attr_reader :prepaid
+        attr_reader :prepaid_reloadable
+        attr_reader :product_id
+        attr_reader :token
+        attr_reader :unique_number_identifier
+        attr_reader :updated_at
+
+        def initialize(attributes)
+          set_instance_variables_from_hash attributes unless attributes.nil?
+        end
+
+        def expiration_date
+          "#{expiration_month}/#{expiration_year}"
+        end
+
+        def inspect
+          attr_order = [
+            :bin, :card_type, :cardholder_name, :commercial, :container_id, :country_of_issuance,
+            :cryptogram, :customer_location, :debit, :durbin_regulated, :ecommerce_indicator,
+            :expiration_date, :healthcare, :image_url, :is_network_tokenized, :issuing_bank, :last_4,
+            :payroll, :prepaid, :prepaid_reloadable, :product_id, :token]
+          formatted_attrs = attr_order.map do |attr|
+            "#{attr}: #{send(attr).inspect}"
+          end
+          "#<#{formatted_attrs.join(", ")}>"
+        end
+
+        def masked_number
+          "#{bin}******#{last_4}"
+        end
+      end
+    end
+  end

data/lib/braintree/transaction/package_details.rb

@@ -0,0 +1,19 @@
+module Braintree
+    class Transaction
+        class PackageDetails
+            include BaseModule
+
+            attr_reader :carrier
+            attr_reader :id
+            # NEXT_MAJOR_VERSION Remove this method
+            # use paypal_tracker_id going forward
+            attr_reader :paypal_tracking_id
+            attr_reader :paypal_tracker_id
+            attr_reader :tracking_number
+
+            def initialize(attributes)
+              set_instance_variables_from_hash attributes unless attributes.nil?
+            end
+        end
+    end
+end

data/lib/braintree/transaction/payment_receipt/card_present_data.rb

@@ -0,0 +1,36 @@
+module Braintree
+  class Transaction
+    class PaymentReceipt
+      class CardPresentData
+        include BaseModule
+
+        attr_reader :application_cryptogram
+        attr_reader :application_identifier
+        attr_reader :application_interchange_profile
+        attr_reader :application_name
+        attr_reader :application_transaction_counter
+        attr_reader :application_usage_control
+        attr_reader :authorization_mode
+        attr_reader :authorization_response_code
+        attr_reader :card_entry_method
+        attr_reader :card_sequence_number
+        attr_reader :cardholder_verification_method_results
+        attr_reader :cashback_amount
+        attr_reader :cryptogram_information_data
+        attr_reader :issuer_action_code_default
+        attr_reader :issuer_action_code_denial
+        attr_reader :issuer_action_code_online
+        attr_reader :issuer_authentication_data
+        attr_reader :terminal_country_code
+        attr_reader :terminal_transaction_date
+        attr_reader :terminal_transaction_type
+        attr_reader :terminal_verification_result
+        attr_reader :unpredictable_number
+
+        def initialize(attributes)
+          set_instance_variables_from_hash attributes unless attributes.nil?
+        end
+      end
+    end
+  end
+end

data/lib/braintree/transaction/payment_receipt/merchant_address.rb

@@ -0,0 +1,19 @@
+module Braintree
+  class Transaction
+    class PaymentReceipt
+      class MerchantAddress
+        include BaseModule
+
+        attr_reader :locality
+        attr_reader :phone
+        attr_reader :postal_code
+        attr_reader :region
+        attr_reader :street_address
+
+        def initialize(attributes)
+          set_instance_variables_from_hash attributes unless attributes.nil?
+        end
+      end
+    end
+  end
+end

data/lib/braintree/transaction/payment_receipt.rb

@@ -0,0 +1,31 @@
+module Braintree
+  class Transaction
+    class PaymentReceipt
+      include BaseModule
+
+      attr_reader :account_balance
+      attr_reader :amount
+      attr_reader :card_last_4
+      attr_reader :card_present_data
+      attr_reader :card_type
+      attr_reader :currency_iso_code
+      attr_reader :global_id
+      attr_reader :id
+      attr_reader :merchant_address
+      attr_reader :merchant_identification_number
+      attr_reader :merchant_name
+      attr_reader :pin_verified
+      attr_reader :processor_authorization_code
+      attr_reader :processor_response_code
+      attr_reader :processor_response_text
+      attr_reader :terminal_identification_number
+      attr_reader :type
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+        @card_present_data = CardPresentData.new(attributes[:card_present_date]) if attributes[:card_present_data]
+        @merchant_address = MerchantAddress.new(attributes[:merchant_address]) if attributes[:merchant_address]
+      end
+    end
+  end
+end