braintree 4.13.0 → 4.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44371fa440317aa474b358a279682d0e79ad05565d4b1f583dabb77c237a5d34
-  data.tar.gz: 8487685b45da286097e7f366ca1b26820f89da15008a1f6555409e1c2605f61a
+  metadata.gz: 71fab9e9404ac3f2c30216aca3642baecbd01c942a25c16c70b6748563f32435
+  data.tar.gz: b8900d8aa7aac3716db035478510532bb82edd40ba599626d7cbe770fa939849
 SHA512:
-  metadata.gz: '0584f71fb953b0b73071bb368481873e3948fb55a3de2cc91b8d2c443aaf2544b739534d4283e6d50ad85d532eb3cfe2126338eebb92359c74f19185f55ceaf9'
-  data.tar.gz: 2d98c343dd94fdb128fdc09bd1e1688e12b82f0055b9666869c9f88c5fe74d9accf736f8ec3876e8d6ef6965874a3a8618a8bbe63df0e5146e30d2c7d723956e
+  metadata.gz: 9470b1e652814a7ae2fda1250b2c9f670069f1ef98a601ce2a382a4e3430017eaeaeaf7dabe4bc1b456c755d1b0fb258b06fc0593432d2b35c2ce9fc02671d5a
+  data.tar.gz: e376876f7c6ae2c5a1ce588c847d3494e828b29c4f2aee273d5e2c97348577db364b4bcc48ba0588074d87644a39f771b45c7eb56e7865be1cec730a76e72162

data/lib/braintree/credit_card.rb

@@ -23,6 +23,16 @@ module Braintree
       All = constants.map { |c| const_get(c) }
     end
 
+    module DebitNetwork
+      Accel = "ACCEL"
+      Nyce = "NYCE"
+      Pulse = "PULSE"
+      Star = "STAR"
+      Star_Access = "STAR_ACCESS"
+
+      All = constants.map { |c| const_get(c) }
+    end
+
     module CustomerLocation
       International = "international"
       US = "us"
@@ -160,7 +170,10 @@ module Braintree
     end
 
     # Returns true if the card is associated with Venmo SDK
+    # 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
 

data/lib/braintree/credit_card_gateway.rb

@@ -12,6 +12,10 @@ module Braintree
       if attributes.has_key?(:expiration_date) && (attributes.has_key?(:expiration_month) || attributes.has_key?(:expiration_year))
         raise ArgumentError.new("create with both expiration_month and expiration_year or only expiration_date")
       end
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(CreditCardGateway._create_signature, attributes)
       _do_create("/payment_methods", :credit_card => attributes)
     end
@@ -61,6 +65,10 @@ module Braintree
     end
 
     def update(token, attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(CreditCardGateway._update_signature, attributes)
       _do_update(:put, "/payment_methods/credit_card/#{token}", :credit_card => attributes)
     end
@@ -79,21 +87,25 @@ module Braintree
 
     def self._signature(type) # :nodoc:
       billing_address_params = AddressGateway._shared_signature
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_session
+      # The old venmo SDK class has been deprecated
       options = [
         :fail_on_duplicate_payment_method,
         :make_default,
         :skip_advanced_fraud_checking,
-        :venmo_sdk_session,
+        :venmo_sdk_session, # Deprecated
         :verification_account_type,
         :verification_amount,
         :verification_currency_iso_code,
         :verification_merchant_account_id,
         :verify_card
       ]
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_payment_method_code
+      # The old venmo SDK class has been deprecated
       signature = [
         :billing_address_id, :cardholder_name, :cvv, :expiration_date, :expiration_month,
-        :expiration_year, :number, :token, :venmo_sdk_payment_method_code, :device_data,
-        :payment_method_nonce,
+        :expiration_year, :number, :token, :venmo_sdk_payment_method_code, # Deprecated
+        :device_data, :payment_method_nonce,
         {:external_vault => [:network_transaction_id]},
         {:options => options},
         {:billing_address => billing_address_params}

data/lib/braintree/payment_method_gateway.rb

@@ -9,6 +9,10 @@ module Braintree
     end
 
     def create(attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(PaymentMethodGateway._create_signature, attributes)
       _do_create("/payment_methods", :payment_method => attributes)
     end
@@ -60,6 +64,10 @@ module Braintree
     end
 
     def update(token, attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
       Util.verify_keys(PaymentMethodGateway._update_signature, attributes)
       _do_update(:put, "/payment_methods/any/#{token}", :payment_method => attributes)
     end
@@ -149,11 +157,13 @@ module Braintree
     def self._signature(type) # :nodoc:
       billing_address_params = AddressGateway._shared_signature
       paypal_options_shipping_signature = AddressGateway._shared_signature
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_session
+      # The old venmo SDK class has been deprecated
       options = [
         :make_default,
         :skip_advanced_fraud_checking,
         :us_bank_account_verification_method,
-        :venmo_sdk_session,
+        :venmo_sdk_session, # Deprecated
         :verification_account_type,
         :verification_amount,
         :verification_currency_iso_code,
@@ -168,10 +178,12 @@ module Braintree
           {:shipping => paypal_options_shipping_signature}
         ],
       ]
+      # NEXT_MAJOR_VERSION Remove venmo_sdk_payment_method_code
+      # The old venmo SDK class has been deprecated
       signature = [
         :billing_address_id, :cardholder_name, :cvv, :expiration_date, :expiration_month,
-        :expiration_year, :number, :token, :venmo_sdk_payment_method_code, :device_data,
-        :payment_method_nonce,
+        :expiration_year, :number, :token, :venmo_sdk_payment_method_code, # Deprecated
+        :device_data, :payment_method_nonce,
         {:options => options},
         {:billing_address => billing_address_params}
       ]

data/lib/braintree/test/nonce.rb

@@ -53,6 +53,7 @@ module Braintree
       TransactableCountryOfIssuanceUSA = "fake-valid-country-of-issuance-usa-nonce"
       TransactableCountryOfIssuanceCAD = "fake-valid-country-of-issuance-cad-nonce"
       TransactableIssuingBankNetworkOnly = "fake-valid-issuing-bank-network-only-nonce"
+      TransactablePinlessDebitVisa = "fake-pinless-debit-visa-nonce"
       ProcessorDeclinedVisa = "fake-processor-declined-visa-nonce"
       ProcessorDeclinedMasterCard = "fake-processor-declined-mastercard-nonce"
       ProcessorDeclinedAmEx = "fake-processor-declined-amex-nonce"

data/lib/braintree/test/venmo_sdk.rb

@@ -1,3 +1,5 @@
+# NEXT_MAJOR_VERSION Remove this class
+# The old venmo SDK class has been deprecated
 module Braintree
   module Test
     module VenmoSDK

data/lib/braintree/transaction/credit_card_details.rb

@@ -64,7 +64,10 @@ module Braintree
         "#{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
 

data/lib/braintree/transaction/local_payment_details.rb

@@ -8,6 +8,8 @@ module Braintree
       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

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

data/lib/braintree/transaction/us_bank_account_details.rb

@@ -7,6 +7,7 @@ module Braintree
       attr_reader :account_type
       attr_reader :ach_mandate
       attr_reader :bank_name
+      attr_reader :global_id
       attr_reader :image_url
       attr_reader :last_4
       attr_reader :routing_number

data/lib/braintree/transaction.rb

@@ -91,8 +91,9 @@ module Braintree
       end
     end
 
-    attr_reader :acquirer_reference_number
     attr_reader :ach_return_code
+    attr_reader :ach_return_responses
+    attr_reader :acquirer_reference_number
     attr_reader :add_ons
     attr_reader :additional_processor_response          # The raw response from the processor.
     attr_reader :amount
@@ -111,6 +112,7 @@ module Braintree
     attr_reader :custom_fields
     attr_reader :customer_details
     attr_reader :cvv_response_code
+    attr_reader :debit_network
     attr_reader :descriptor
     attr_reader :disbursement_details
     attr_reader :discount_amount
@@ -136,6 +138,7 @@ module Braintree
     attr_reader :order_id
     attr_reader :partial_settlement_transaction_ids
     attr_reader :payment_instrument_type
+    attr_reader :payment_receipt
     attr_reader :paypal_details
     attr_reader :paypal_here_details
     attr_reader :plan_id
@@ -149,8 +152,8 @@ module Braintree
     attr_reader :purchase_order_number
     attr_reader :recurring
     attr_reader :refund_ids
-    attr_reader :refunded_transaction_id
     attr_reader :refunded_installments
+    attr_reader :refunded_transaction_id
     attr_reader :retried
     attr_reader :retried_transaction_id                 # the primary/parent transaction id of any retried transaction
     attr_reader :retrieval_reference_number
@@ -158,9 +161,9 @@ module Braintree
     attr_reader :risk_data
     attr_reader :samsung_pay_card_details
     attr_reader :sca_exemption_requested
-    attr_reader :service_fee_amount
     attr_reader :sepa_direct_debit_account_details
     attr_reader :sepa_direct_debit_return_code
+    attr_reader :service_fee_amount
     attr_reader :settlement_batch_id
     attr_reader :shipping_amount
     attr_reader :shipping_details
@@ -178,7 +181,6 @@ module Braintree
     attr_reader :venmo_account_details
     attr_reader :visa_checkout_card_details
     attr_reader :voice_referral_number
-    attr_reader :ach_return_responses
 
     def self.adjust_authorization(*args)
       Configuration.gateway.transaction.adjust_authorization(*args)
@@ -312,6 +314,7 @@ module Braintree
       @google_pay_details = GooglePayDetails.new(@google_pay_card)
       @local_payment_details = LocalPaymentDetails.new(@local_payment)
       @payment_instrument_type = attributes[:payment_instrument_type]
+      @payment_receipt = PaymentReceipt.new(attributes[:payment_receipt]) if attributes[:payment_receipt]
       @paypal_details = PayPalDetails.new(@paypal)
       @paypal_here_details = PayPalHereDetails.new(@paypal_here)
       @samsung_pay_card_details = SamsungPayCardDetails.new(attributes[:samsung_pay_card])

data/lib/braintree/transaction_gateway.rb

@@ -9,6 +9,14 @@ module Braintree
     end
 
     def create(attributes)
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:venmo_sdk_payment_method_code) || attributes.has_key?(:venmo_sdk_session)
+        warn "[DEPRECATED] The Venmo SDK integration is Unsupported. Please update your integration to use Pay with Venmo instead."
+      end
+      # NEXT_MAJOR_VERSION remove this check
+      if attributes.has_key?(:three_d_secure_token)
+        warn "[DEPRECATED] Passing :three_d_secure_token to create is deprecated. Please use :three_d_secure_authentication_id"
+      end
       Util.verify_keys(TransactionGateway._create_signature, attributes)
       _do_create "/transactions", :transaction => attributes
     end
@@ -183,6 +191,10 @@ module Braintree
       [:amount, :channel, {:options => [:submit_for_settlement]}]
     end
 
+
+    # NEXT_MAJOR_VERSION Remove venmo_sdk_payment_method_code, venmo_sdk_session, and three_d_secure_token
+    # The old venmo SDK class has been deprecated
+    # three_d_secure_token has been deprecated in favor of three_d_secure_authentication_id
     def self._create_signature # :nodoc:
       [
         :amount, :billing_address_id, :channel, :customer_id, :device_data, :discount_amount,
@@ -190,8 +202,8 @@ module Braintree
         :product_sku, :purchase_order_number, :service_fee_amount, :shared_billing_address_id,
         :shared_customer_id, :shared_payment_method_nonce, :shared_payment_method_token,
         :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,
+        :ships_from_postal_code, :tax_amount, :tax_exempt, :three_d_secure_authentication_id,:three_d_secure_token, #Deprecated
+        :transaction_source, :type, :venmo_sdk_payment_method_code, # Deprecated
         :sca_exemption, :currency_iso_code, :exchange_rate_quote_id,
         {: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]},
@@ -222,7 +234,7 @@ module Braintree
           :submit_for_settlement,
           :add_billing_address_to_payment_method,
           :store_shipping_address_in_vault,
-          :venmo_sdk_session,
+          :venmo_sdk_session, # Deprecated
           :payee_id,
           :payee_email,
           :skip_advanced_fraud_checking,

data/lib/braintree/transaction_search.rb

@@ -54,15 +54,16 @@ module Braintree
       CreditCard::CustomerLocation::International,
       CreditCard::CustomerLocation::US
     ]
+    multiple_value_field :debit_network, :allows => CreditCard::DebitNetwork::All
     multiple_value_field :ids
-    multiple_value_field :payment_instrument_type
-    multiple_value_field :user
     multiple_value_field :merchant_account_id
-    multiple_value_field :status, :allows => Transaction::Status::All
+    multiple_value_field :payment_instrument_type
+    multiple_value_field :reason_code
     multiple_value_field :source
-    multiple_value_field :type, :allows => Transaction::Type::All
+    multiple_value_field :status, :allows => Transaction::Status::All
     multiple_value_field :store_ids
-    multiple_value_field :reason_code
+    multiple_value_field :type, :allows => Transaction::Type::All
+    multiple_value_field :user
 
     key_value_fields :refund
 

data/lib/braintree/version.rb

@@ -1,7 +1,7 @@
 module Braintree
   module Version
     Major = 4
-    Minor = 13
+    Minor = 15
     Tiny = 0
 
     String = "#{Major}.#{Minor}.#{Tiny}"

data/lib/braintree/webhook_notification.rb

@@ -45,6 +45,7 @@ module Braintree
 
       RecipientUpdatedGrantedPaymentMethod = "recipient_updated_granted_payment_method"
 
+      SubscriptionBillingSkipped = "subscription_billing_skipped"
       SubscriptionCanceled = "subscription_canceled"
       SubscriptionChargedSuccessfully = "subscription_charged_successfully"
       SubscriptionChargedUnsuccessfully = "subscription_charged_unsuccessfully"

data/lib/braintree/webhook_testing_gateway.rb

@@ -72,6 +72,8 @@ module Braintree
         _disbursement_exception_sample_xml(id)
       when Braintree::WebhookNotification::Kind::Disbursement
         _disbursement_sample_xml(id)
+      when Braintree::WebhookNotification::Kind::SubscriptionBillingSkipped
+        _subscription_billing_skipped(id)
       when Braintree::WebhookNotification::Kind::SubscriptionChargedSuccessfully
         _subscription_charged_successfully(id)
       when Braintree::WebhookNotification::Kind::SubscriptionChargedUnsuccessfully
@@ -112,6 +114,21 @@ module Braintree
       XML
     end
 
+    def _subscription_billing_skipped(id)
+
+      <<-XML
+        <subscription>
+          <id>#{id}</id>
+          <transactions type="array">
+          </transactions>
+          <add_ons type="array">
+          </add_ons>
+          <discounts type="array">
+          </discounts>
+        </subscription>
+      XML
+    end
+
     def _subscription_charged_successfully(id)
 
       <<-XML

data/lib/braintree.rb

@@ -150,6 +150,9 @@ require "braintree/transaction/disbursement_details"
 require "braintree/transaction/google_pay_details"
 require "braintree/transaction/installment"
 require "braintree/transaction/installment/adjustment"
+require "braintree/transaction/payment_receipt"
+require "braintree/transaction/payment_receipt/card_present_data.rb"
+require "braintree/transaction/payment_receipt/merchant_address.rb"
 require "braintree/transaction/paypal_details"
 require "braintree/transaction/paypal_here_details"
 require "braintree/transaction/samsung_pay_card_details"

data/spec/integration/braintree/add_on_spec.rb

@@ -20,15 +20,15 @@ describe Braintree::AddOn do
       add_ons = Braintree::AddOn.all
       add_on = add_ons.select { |add_on| add_on.id == id }.first
 
-      add_on.should_not be_nil
-      add_on.amount.should == BigDecimal(expected[:amount])
-      add_on.created_at.should_not be_nil
-      add_on.description.should == expected[:description]
-      add_on.kind.should == expected[:kind]
-      add_on.name.should == expected[:name]
-      add_on.never_expires.should == expected[:never_expires]
-      add_on.number_of_billing_cycles.should == expected[:number_of_billing_cycles]
-      add_on.updated_at.should_not be_nil
+      expect(add_on).not_to be_nil
+      expect(add_on.amount).to eq(BigDecimal(expected[:amount]))
+      expect(add_on.created_at).not_to be_nil
+      expect(add_on.description).to eq(expected[:description])
+      expect(add_on.kind).to eq(expected[:kind])
+      expect(add_on.name).to eq(expected[:name])
+      expect(add_on.never_expires).to eq(expected[:never_expires])
+      expect(add_on.number_of_billing_cycles).to eq(expected[:number_of_billing_cycles])
+      expect(add_on.updated_at).not_to be_nil
     end
 
     it "raises with a helpful error if public_key and private_key are not set" do