braintree 2.10.0 → 4.26.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ca8e969e0988757df5800a440fdc36293b48bc0c72cc8c56b1175d74d79f309b
+  data.tar.gz: b44530a7eb4a73728fd4c79292633fc7d7ca0d6476c26b7277c1a3051d29fcaa
+SHA512:
+  metadata.gz: 2d985f754fa864774601dad717587b5d5d7f1e75a9579286100559e9cd4ab1819fd856b5c90c6d59870149b6d7bfd0cc5d2865f2d96362a208c037854b9ab312
+  data.tar.gz: 2ab4e8c0f48d76e10f4854e3e32fe55c154c8bdd40730625409f4259921268788c9bd2baf3152724a6d665ed5d0bf53dc7b540570f2f9777ced5dc53be6aeaa8

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009-2010 Braintree Payment Solutions
+Copyright (c) 2009-2020 Braintree, a division of PayPal, Inc.
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/braintree.gemspec

@@ -0,0 +1,24 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "braintree/version"
+
+Gem::Specification.new do |s|
+  s.name = "braintree"
+  s.summary = "Braintree Ruby Server SDK"
+  s.description = "Resources and tools for developers to integrate Braintree's global payments platform."
+  s.version = Braintree::Version::String
+  s.license = "MIT"
+  s.author = "Braintree"
+  s.email = "code@getbraintree.com"
+  s.homepage = "https://www.braintreepayments.com/"
+  s.files = Dir.glob ["README.rdoc", "LICENSE", "lib/**/*.{rb,crt}", "spec/**/*", "*.gemspec"]
+  s.add_dependency "builder", ">= 3.2.4"
+  s.add_dependency "rexml", ">= 3.1.9" # Use rexml version associated with minimum supported Ruby version
+  s.required_ruby_version = ">=2.6.0"
+  s.metadata = {
+    "bug_tracker_uri" => "https://github.com/braintree/braintree_ruby/issues",
+    "changelog_uri" => "https://github.com/braintree/braintree_ruby/blob/master/CHANGELOG.md",
+    "source_code_uri" => "https://github.com/braintree/braintree_ruby",
+    "documentation_uri" => "https://developer.paypal.com/braintree/docs"
+  }
+end
+

data/lib/braintree/account_updater_daily_report.rb

@@ -0,0 +1,20 @@
+module Braintree
+  class AccountUpdaterDailyReport
+    include BaseModule
+
+    attr_reader :report_date
+    attr_reader :report_url
+
+    class << self
+      protected :new
+      def _new(*args)
+        self.new(*args)
+      end
+    end
+
+    def initialize(attributes)
+      set_instance_variables_from_hash(attributes)
+      @report_date = Date.parse(report_date)
+    end
+  end
+end

data/lib/braintree/ach_mandate.rb

@@ -0,0 +1,14 @@
+module Braintree
+  class AchMandate
+    include BaseModule
+
+    attr_reader :accepted_at
+    attr_reader :text
+
+    def initialize(attributes)
+      set_instance_variables_from_hash(attributes)
+      @accepted_at = Time.parse(attributes[:accepted_at]) unless @accepted_at.class == Time
+    end
+
+  end
+end

data/lib/braintree/add_on.rb

@@ -1,4 +1,8 @@
 module Braintree
   class AddOn < Modification
+
+    def self.all
+      Configuration.gateway.add_on.all
+    end
   end
 end

data/lib/braintree/add_on_gateway.rb

@@ -0,0 +1,17 @@
+module Braintree
+  class AddOnGateway
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+      @config.assert_has_access_token_or_keys
+    end
+
+    def all
+      response = @config.http.get("#{@config.base_merchant_path}/add_ons")
+      attributes_collection = response[:add_ons]
+      attributes_collection.map do |attributes|
+        AddOn._new(attributes)
+      end
+    end
+  end
+end

data/lib/braintree/address/country_names.rb

@@ -29,6 +29,7 @@ module Braintree
     ["Bermuda", "BM", "BMU", "060"],
     ["Bhutan", "BT", "BTN", "064"],
     ["Bolivia", "BO", "BOL", "068"],
+    ["Bonaire, Sint Eustatius and Saba", "BQ", "BES", "535"],
     ["Bosnia and Herzegovina", "BA", "BIH", "070"],
     ["Botswana", "BW", "BWA", "072"],
     ["Bouvet Island", "BV", "BVT", "074"],
@@ -58,6 +59,7 @@ module Braintree
     ["Côte d'Ivoire", "CI", "CIV", "384"],
     ["Croatia", "HR", "HRV", "191"],
     ["Cuba", "CU", "CUB", "192"],
+    ["Curaçao", "CW", "CUW", "531"],
     ["Cyprus", "CY", "CYP", "196"],
     ["Czech Republic", "CZ", "CZE", "203"],
     ["Denmark", "DK", "DNK", "208"],
@@ -156,7 +158,6 @@ module Braintree
     ["Nauru", "NR", "NRU", "520"],
     ["Nepal", "NP", "NPL", "524"],
     ["Netherlands", "NL", "NLD", "528"],
-    ["Netherlands Antilles", "AN", "ANT", "530"],
     ["New Caledonia", "NC", "NCL", "540"],
     ["New Zealand", "NZ", "NZL", "554"],
     ["Nicaragua", "NI", "NIC", "558"],
@@ -200,12 +201,14 @@ module Braintree
     ["Seychelles", "SC", "SYC", "690"],
     ["Sierra Leone", "SL", "SLE", "694"],
     ["Singapore", "SG", "SGP", "702"],
+    ["Sint Maarten (Dutch part)", "SX", "SXM", "534"],
     ["Slovakia", "SK", "SVK", "703"],
     ["Slovenia", "SI", "SVN", "705"],
     ["Solomon Islands", "SB", "SLB", "090"],
     ["Somalia", "SO", "SOM", "706"],
     ["South Africa", "ZA", "ZAF", "710"],
     ["South Georgia and South Sandwich Islands", "GS", "SGS", "239"],
+    ["South Sudan", "SS", "SSD", "728"],
     ["Spain", "ES", "ESP", "724"],
     ["Sri Lanka", "LK", "LKA", "144"],
     ["Sudan", "SD", "SDN", "736"],

data/lib/braintree/address.rb

@@ -1,74 +1,66 @@
 module Braintree
-  # See http://www.braintreepaymentsolutions.com/docs/ruby/addresses/details
   class Address
-    include BaseModule # :nodoc:
+    include BaseModule
 
-    attr_reader :company, :country_name, :created_at, :customer_id, :extended_address, :first_name, :id,
-      :last_name, :locality, :postal_code, :region, :street_address, :updated_at,
-      :country_code_alpha2, :country_code_alpha3, :country_code_numeric
+    attr_reader :company
+    attr_reader :country_code_alpha2
+    attr_reader :country_code_alpha3
+    attr_reader :country_code_numeric
+    attr_reader :country_name
+    attr_reader :created_at
+    attr_reader :customer_id
+    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 :street_address
+    attr_reader :updated_at
 
-    def self.create(attributes)
-      Configuration.gateway.address.create(attributes)
+    def self.create(*args)
+      Configuration.gateway.address.create(*args)
     end
 
-    def self.create!(attributes)
-      return_object_or_raise(:address) { create(attributes) }
+    def self.create!(*args)
+      Configuration.gateway.address.create!(*args)
     end
 
-    def self.delete(customer_or_customer_id, address_id)
-      Configuration.gateway.address.delete(customer_or_customer_id, address_id)
+    def self.delete(*args)
+      Configuration.gateway.address.delete(*args)
     end
 
-    def self.find(customer_or_customer_id, address_id)
-      Configuration.gateway.address.find(customer_or_customer_id, address_id)
+    def self.find(*args)
+      Configuration.gateway.address.find(*args)
     end
 
-    def self.update(customer_or_customer_id, address_id, attributes)
-      Configuration.gateway.address.update(customer_or_customer_id, address_id, attributes)
+    def self.update(*args)
+      Configuration.gateway.address.update(*args)
     end
 
-    def self.update!(customer_or_customer_id, address_id, attributes)
-      return_object_or_raise(:address) { update(customer_or_customer_id, address_id, attributes) }
+    def self.update!(*args)
+      Configuration.gateway.address.update!(*args)
     end
 
-    def initialize(gateway, attributes) # :nodoc:
+    def initialize(gateway, attributes)
       @gateway = gateway
       set_instance_variables_from_hash(attributes)
     end
 
-    def ==(other) # :nodoc:
+    def ==(other)
       return false unless other.is_a?(Address)
       id == other.id && customer_id == other.customer_id
     end
 
-    # Deprecated. Use Braintree::Address.delete
-    def delete
-      warn "[DEPRECATED] delete as an instance method is deprecated. Please use Address.delete"
-      @gateway.address.delete(customer_id, self.id)
-    end
-
-    # Deprecated. Use Braintree::Address.update
-    def update(attributes)
-      warn "[DEPRECATED] update as an instance method is deprecated. Please use Address.update"
-      result = @gateway.address.update(customer_id, id, attributes)
-      if result.success?
-        copy_instance_variables_from_object result.address
-      end
-      result
-    end
-
-    # Deprecated. Use Braintree::Address.update!
-    def update!(attributes)
-      warn "[DEPRECATED] update! as an instance method is deprecated. Please use Address.update!"
-      return_object_or_raise(:address) { update(attributes) }
-    end
-
     class << self
       protected :new
     end
 
-    def self._new(*args) # :nodoc:
-      self.new *args
+    def self._new(*args)
+      self.new(*args)
     end
   end
 end

data/lib/braintree/address_gateway.rb

@@ -1,8 +1,11 @@
 module Braintree
-  class AddressGateway # :nodoc
+  class AddressGateway
+    include BaseModule
+
     def initialize(gateway)
       @gateway = gateway
       @config = gateway.config
+      @config.assert_has_access_token_or_keys
     end
 
     def create(attributes)
@@ -13,7 +16,7 @@ module Braintree
       unless attributes[:customer_id] =~ /\A[0-9A-Za-z_-]+\z/
         raise ArgumentError, ":customer_id contains invalid characters"
       end
-      response = @config.http.post "/customers/#{attributes.delete(:customer_id)}/addresses", :address => attributes
+      response = @config.http.post("#{@config.base_merchant_path}/customers/#{attributes.delete(:customer_id)}/addresses", :address => attributes)
       if response[:address]
         SuccessfulResult.new(:address => Address._new(@gateway, response[:address]))
       elsif response[:api_error_response]
@@ -23,15 +26,20 @@ module Braintree
       end
     end
 
+    def create!(*args)
+      return_object_or_raise(:address) { create(*args) }
+    end
+
     def delete(customer_or_customer_id, address_id)
       customer_id = _determine_customer_id(customer_or_customer_id)
-      @config.http.delete("/customers/#{customer_id}/addresses/#{address_id}")
+      @config.http.delete("#{@config.base_merchant_path}/customers/#{customer_id}/addresses/#{address_id}")
       SuccessfulResult.new
     end
 
     def find(customer_or_customer_id, address_id)
       customer_id = _determine_customer_id(customer_or_customer_id)
-      response = @config.http.get("/customers/#{customer_id}/addresses/#{address_id}")
+      raise ArgumentError if address_id.nil? || address_id.to_s.strip == ""
+      response = @config.http.get("#{@config.base_merchant_path}/customers/#{customer_id}/addresses/#{address_id}")
       Address._new(@gateway, response[:address])
     rescue NotFoundError
       raise NotFoundError, "address for customer #{customer_id.inspect} with id #{address_id.inspect} not found"
@@ -40,7 +48,7 @@ module Braintree
     def update(customer_or_customer_id, address_id, attributes)
       Util.verify_keys(AddressGateway._update_signature, attributes)
       customer_id = _determine_customer_id(customer_or_customer_id)
-      response = @config.http.put "/customers/#{customer_id}/addresses/#{address_id}", :address => attributes
+      response = @config.http.put("#{@config.base_merchant_path}/customers/#{customer_id}/addresses/#{address_id}", :address => attributes)
       if response[:address]
         SuccessfulResult.new(:address => Address._new(@gateway, response[:address]))
       elsif response[:api_error_response]
@@ -50,7 +58,11 @@ module Braintree
       end
     end
 
-    def _determine_customer_id(customer_or_customer_id) # :nodoc:
+    def update!(*args)
+      return_object_or_raise(:address) { update(*args) }
+    end
+
+    def _determine_customer_id(customer_or_customer_id)
       customer_id = customer_or_customer_id.is_a?(Customer) ? customer_or_customer_id.id : customer_or_customer_id
       unless customer_id =~ /\A[\w_-]+\z/
         raise ArgumentError, "customer_id contains invalid characters"
@@ -58,17 +70,18 @@ module Braintree
       customer_id
     end
 
-    def self._create_signature # :nodoc:
+    def self._create_signature
       _shared_signature + [:customer_id]
     end
 
-    def self._shared_signature # :nodoc:
+    def self._shared_signature
       [:company, :country_code_alpha2, :country_code_alpha3, :country_code_numeric,
-        :country_name, :extended_address, :first_name,
-        :last_name, :locality, :postal_code, :region, :street_address]
+       :country_name, :extended_address, :first_name,
+       {:international_phone => [:country_code, :national_number]},
+       :last_name, :locality, :phone_number, :postal_code, :region, :street_address]
     end
 
-    def self._update_signature # :nodoc:
+    def self._update_signature
       _create_signature
     end
   end

data/lib/braintree/advanced_search.rb

@@ -1,6 +1,6 @@
 module Braintree
-  class AdvancedSearch # :nodoc:
-    class SearchNode # :nodoc:
+  class AdvancedSearch
+    class SearchNode
       def self.operators(*operator_names)
         operator_names.each do |operator|
           define_method(operator) do |value|
@@ -14,25 +14,29 @@ module Braintree
       end
     end
 
-    class EqualityNode < SearchNode # :nodoc:
-      operators :is, :is_not
+    class IsNode < SearchNode
+      operators :is
+    end
+
+    class EqualityNode < IsNode
+      operators :is_not
     end
 
-    class PartialMatchNode < EqualityNode # :nodoc:
+    class PartialMatchNode < EqualityNode
       operators :ends_with, :starts_with
     end
 
-    class TextNode < PartialMatchNode # :nodoc:
+    class TextNode < PartialMatchNode
       operators :contains
     end
 
-    class KeyValueNode < SearchNode # :nodoc:
+    class KeyValueNode < SearchNode
       def is(value)
         @parent.add_criteria(@node_name, value)
       end
     end
 
-    class MultipleValueNode < SearchNode # :nodoc:
+    class MultipleValueNode < SearchNode
       def in(*values)
         values.flatten!
 
@@ -58,6 +62,10 @@ module Braintree
       end
     end
 
+    class EndsWithNode < SearchNode
+      operators :ends_with
+    end
+
     class MultipleValueOrTextNode < MultipleValueNode
       extend Forwardable
       def_delegators :@text_node, :contains, :ends_with, :is, :is_not, :starts_with
@@ -68,12 +76,11 @@ module Braintree
       end
     end
 
-    class RangeNode < SearchNode # :nodoc:
+    class RangeNode < SearchNode
       operators :is
 
       def between(min, max)
-        self >= min
-        self <= max
+        self >= min && self <= max
       end
 
       def >=(min)
@@ -93,6 +100,10 @@ module Braintree
       _create_field_accessors(fields, EqualityNode)
     end
 
+    def self.is_fields(*fields)
+      _create_field_accessors(fields, IsNode)
+    end
+
     def self.partial_match_fields(*fields)
       _create_field_accessors(fields, PartialMatchNode)
     end
@@ -121,6 +132,10 @@ module Braintree
       _create_field_accessors(fields, DateRangeNode)
     end
 
+    def self.ends_with_fields(*fields)
+      _create_field_accessors(fields, EndsWithNode)
+    end
+
     def self._create_field_accessors(fields, node_class)
       fields.each do |field|
         define_method(field) do |*args|

data/lib/braintree/apple_pay.rb

@@ -0,0 +1,29 @@
+module Braintree
+  class ApplePay
+    include BaseModule
+
+    def initialize(gateway, attributes)
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args)
+      self.new(*args)
+    end
+
+    def self.register_domain(domain)
+      Configuration.gateway.apple_pay.register_domain(domain)
+    end
+
+    def self.unregister_domain(domain)
+      Configuration.gateway.apple_pay.unregister_domain(domain)
+    end
+
+    def self.registered_domains
+      Configuration.gateway.apple_pay.registered_domains
+    end
+  end
+end

data/lib/braintree/apple_pay_card.rb

@@ -0,0 +1,66 @@
+module Braintree
+  class ApplePayCard
+    include BaseModule
+
+    module CardType
+      AmEx = "Apple Pay - American Express"
+      Visa = "Apple Pay - Visa"
+      MasterCard = "Apple Pay - MasterCard"
+
+      All = constants.map { |c| const_get(c) }
+    end
+
+    attr_reader :billing_address
+    attr_reader :bin
+    attr_reader :card_type
+    attr_reader :cardholder_name
+    attr_reader :commercial
+    attr_reader :country_of_issuance
+    attr_reader :created_at
+    attr_reader :customer_id
+    attr_reader :debit
+    attr_reader :default
+    attr_reader :durbin_regulated
+    attr_reader :expiration_month
+    attr_reader :expiration_year
+    attr_reader :expired
+    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 :subscriptions
+    attr_reader :token
+    attr_reader :updated_at
+
+    def initialize(gateway, attributes)
+      @gateway = gateway
+      set_instance_variables_from_hash(attributes)
+      @billing_address = attributes[:billing_address] ? Address._new(@gateway, attributes[:billing_address]) : nil
+      @subscriptions = (@subscriptions || []).map { |subscription_hash| Subscription._new(@gateway, subscription_hash) }
+    end
+
+    def default?
+      @default
+    end
+
+    def expired?
+      @expired
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args)
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/apple_pay_gateway.rb

@@ -0,0 +1,37 @@
+module Braintree
+  class ApplePayGateway
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+    end
+
+    def register_domain(domain)
+      response = @config.http.post("#{@config.base_merchant_path}/processing/apple_pay/validate_domains", :url => domain)
+
+      if response.has_key?(:response) && response[:response][:success]
+        Braintree::SuccessfulResult.new
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise "expected :response or :api_error_response"
+      end
+    end
+
+    def unregister_domain(domain)
+      @config.http.delete("#{@config.base_merchant_path}/processing/apple_pay/unregister_domain", :url => CGI.escape(domain))
+      SuccessfulResult.new
+    end
+
+    def registered_domains
+      response = @config.http.get("#{@config.base_merchant_path}/processing/apple_pay/registered_domains")
+
+      if response.has_key?(:response)
+        Braintree::SuccessfulResult.new(:apple_pay_options => ApplePayOptions._new(response[:response]))
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise "expected :response or :api_error_response"
+      end
+    end
+  end
+end

data/lib/braintree/apple_pay_options.rb

@@ -0,0 +1,19 @@
+module Braintree
+  class ApplePayOptions
+    include BaseModule
+
+    attr_reader :domains
+
+    def initialize(attributes)
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args)
+      self.new(*args)
+    end
+  end
+end

data/lib/braintree/authorization_adjustment.rb

@@ -0,0 +1,23 @@
+module Braintree
+  class AuthorizationAdjustment
+    include BaseModule
+
+    attr_reader :amount
+    attr_reader :success
+    attr_reader :timestamp
+    attr_reader :processor_response_code
+    attr_reader :processor_response_text
+    attr_reader :processor_response_type
+
+    class << self
+      protected :new
+      def _new(*args)
+        self.new(*args)
+      end
+    end
+
+    def initialize(attributes)
+      set_instance_variables_from_hash(attributes)
+    end
+  end
+end

data/lib/braintree/base_module.rb

@@ -1,5 +1,5 @@
 module Braintree
-  module BaseModule # :nodoc: all
+  module BaseModule
     module Methods
       def return_object_or_raise(object_to_return)
         result = yield
@@ -18,6 +18,16 @@ module Braintree
 
       def set_instance_variables_from_hash(hash)
         hash.each do |key, value|
+          if key == :global_id
+            instance_variable_set "@graphql_id", value
+          elsif key == :android_pay_cards
+            instance_variable_set "@google_pay_cards", value
+          elsif key == :android_pay_card
+            instance_variable_set "@google_pay_card", value
+          elsif key == :android_pay_details
+            instance_variable_set "@google_pay_details", value
+          end
+
           instance_variable_set "@#{key}", value
         end
       end

data/lib/braintree/bin_data.rb

@@ -0,0 +1,34 @@
+module Braintree
+  class BinData
+    include BaseModule
+
+    attr_reader :commercial
+    attr_reader :country_of_issuance
+    attr_reader :debit
+    attr_reader :durbin_regulated
+    attr_reader :healthcare
+    attr_reader :issuing_bank
+    attr_reader :payroll
+    attr_reader :prepaid
+    attr_reader :prepaid_reloadable
+    attr_reader :product_id
+
+    def initialize(attributes)
+      set_instance_variables_from_hash attributes unless attributes.nil?
+    end
+
+    def inspect
+      formatted_attributes = self.class._attributes.map do |attr|
+        "#{attr}: #{send(attr).inspect}"
+      end
+      "#<#{self.class} #{formatted_attributes.join(", ")}>"
+    end
+
+    def self._attributes
+      [
+        :commercial, :country_of_issuance, :debit, :durbin_regulated, :healthcare,
+        :issuing_bank, :payroll, :prepaid, :prepaid_reloadable, :product_id
+      ]
+    end
+  end
+end