braintree 2.76.0 → 2.77.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f42a6a1794be0f659dc3cea9f5e84bff6e1d4e75
-  data.tar.gz: efdb9c09c2b5961fc4358af6f7d397ac4a304c53
+  metadata.gz: f91adc9f9c4c198e0a23a83d154ed5dec5c1a90e
+  data.tar.gz: fe219448f54a560983e11cd15062abe6c89da036
 SHA512:
-  metadata.gz: aaea5122d23bf61d943af46e50bd768b70efcfb2aede98c857e2ae36c84851b9871dffccafbfadeafca384101ec0b9dee2a5d69bd7ec3c664228836a5ef2da0d
-  data.tar.gz: e10e87bb06504b7119ff25ae558422a12d6ff88f614580a30af194eb8985b9b6655fb94b3c5fe8d65d5be8d96ccb3fead07214a73e2c3ec289fc09946c4cf7df
+  metadata.gz: d337708211ff819d6db66faa86e5b60a06bf8e539de8df21b5f38cff8dfbd941908c628155dbbb69b63b13ad25d778dfae72f876e4fcbe97afd8c665c5901bff
+  data.tar.gz: fcdeb5b27036b32e6c3f0380e4885ef38640ed94d0e8486b624cf7908dd33a8c12dbcc0082a1c3456fc03ab2df90b4ee2d6b117fbb81e74bdd61fc4bcabebbcf

data/lib/braintree.rb

@@ -30,7 +30,11 @@ require "braintree/address_gateway"
 require "braintree/advanced_search"
 require "braintree/android_pay_card"
 require "braintree/amex_express_checkout_card"
+require "braintree/apple_pay"
 require "braintree/apple_pay_card"
+require "braintree/apple_pay_gateway"
+require "braintree/apple_pay_options"
+require "braintree/authorization_adjustment"
 require "braintree/client_token"
 require "braintree/client_token_gateway"
 require "braintree/coinbase_account"
@@ -51,7 +55,13 @@ require "braintree/digest"
 require "braintree/discount"
 require "braintree/discount_gateway"
 require "braintree/dispute"
+require "braintree/dispute_gateway"
+require "braintree/dispute/evidence"
+require "braintree/dispute/history_event"
+require "braintree/dispute/transaction"
 require "braintree/dispute/transaction_details"
+require "braintree/document_upload"
+require "braintree/document_upload_gateway"
 require "braintree/error_codes"
 require "braintree/error_result"
 require "braintree/errors"
@@ -80,6 +90,7 @@ require "braintree/paypal_account_gateway"
 require "braintree/plan"
 require "braintree/plan_gateway"
 require "braintree/risk_data"
+require "braintree/facilitated_details"
 require "braintree/facilitator_details"
 require "braintree/three_d_secure_info"
 require "braintree/settlement_batch_summary"
@@ -125,6 +136,7 @@ require "braintree/transaction/visa_checkout_card_details"
 require "braintree/transaction/masterpass_card_details"
 require "braintree/unknown_payment_method"
 require "braintree/disbursement"
+require "braintree/dispute_search"
 require "braintree/transparent_redirect"
 require "braintree/transparent_redirect_gateway"
 require "braintree/util"

data/lib/braintree/apple_pay.rb

@@ -0,0 +1,29 @@
+module Braintree
+  class ApplePay
+    include BaseModule # :nodoc:
+
+    def initialize(gateway, attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      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

@@ -10,7 +10,7 @@ module Braintree
       All = constants.map { |c| const_get(c) }
     end
 
-    attr_reader :card_type, :created_at, :customer_id, :default, :expiration_month,
+    attr_reader :bin, :card_type, :created_at, :customer_id, :default, :expiration_month,
       :expiration_year, :expired, :image_url, :last_4, :payment_instrument_name,
       :source_description, :subscriptions, :token, :updated_at
 

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 # :nodoc:
+
+    attr_reader :domains
+
+    def initialize(attributes) # :nodoc:
+      set_instance_variables_from_hash(attributes)
+    end
+
+    class << self
+      protected :new
+    end
+
+    def self._new(*args) # :nodoc:
+      self.new *args
+    end
+  end
+end

data/lib/braintree/authorization_adjustment.rb

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

data/lib/braintree/dispute.rb

@@ -3,21 +3,40 @@ module Braintree
     include BaseModule
 
     attr_reader :amount
+    attr_reader :amount_disputed
+    attr_reader :amount_won
+    attr_reader :case_number
+    attr_reader :created_at
+    attr_reader :currency_iso_code
+    attr_reader :date_opened
+    attr_reader :date_won
+    attr_reader :evidence
+    attr_reader :forwarded_comments
+    attr_reader :id
+    attr_reader :kind
+    attr_reader :merchant_account_id
+    attr_reader :original_dispute_id
+    attr_reader :reason
+    attr_reader :reason_code
+    attr_reader :reason_description
     attr_reader :received_date
+    attr_reader :reference_number
     attr_reader :reply_by_date
     attr_reader :status
-    attr_reader :reason
-    attr_reader :currency_iso_code
-    attr_reader :id
+    attr_reader :status_history
+    attr_reader :transaction
     attr_reader :transaction_details
-    attr_reader :kind
-    attr_reader :date_opened
-    attr_reader :date_won
+    attr_reader :updated_at
 
     module Status
+      Accepted = "accepted"
+      Disputed = "disputed"
+      Expired = "expired"
       Open = "open"
       Lost = "lost"
       Won = "won"
+
+      All = constants.map { |c| const_get(c) }
     end
 
     module Reason
@@ -32,12 +51,16 @@ module Braintree
       ProductUnsatisfactory = "product_unsatisfactory"
       TransactionAmountDiffers = "transaction_amount_differs"
       Retrieval = "retrieval"
+
+      All = constants.map { |c| const_get(c) }
     end
 
     module Kind
       Chargeback = "chargeback"
       PreArbitration = "pre_arbitration"
       Retrieval = "retrieval"
+
+      All = constants.map { |c| const_get(c) }
     end
 
     class << self
@@ -47,14 +70,60 @@ module Braintree
       end
     end
 
+    def self.accept(dispute_id)
+      Configuration.gateway.dispute.accept(dispute_id)
+    end
+
+    def self.add_file_evidence(dispute_id, document_upload_id)
+      Configuration.gateway.dispute.add_file_evidence(dispute_id, document_upload_id)
+    end
+
+    def self.add_text_evidence(dispute_id, content)
+      Configuration.gateway.dispute.add_text_evidence(dispute_id, content)
+    end
+
+    def self.finalize(dispute_id)
+      Configuration.gateway.dispute.finalize(dispute_id)
+    end
+
+    def self.find(dispute_id)
+      Configuration.gateway.dispute.find(dispute_id)
+    end
+
+    def self.remove_evidence(dispute_id, evidence_id)
+      Configuration.gateway.dispute.remove_evidence(dispute_id, evidence_id)
+    end
+
+    def self.search(&block)
+      Configuration.gateway.dispute.search(&block)
+    end
+
     def initialize(attributes) # :nodoc:
       set_instance_variables_from_hash(attributes)
+      @date_opened = Date.parse(date_opened) unless date_opened.nil?
+      @date_won = Date.parse(date_won) unless date_won.nil?
       @received_date = Date.parse(received_date)
       @reply_by_date = Date.parse(reply_by_date) unless reply_by_date.nil?
       @amount = Util.to_big_decimal(amount)
-      @transaction_details = TransactionDetails.new(@transaction)
-      @date_opened = Date.parse(date_opened) unless date_opened.nil?
-      @date_won = Date.parse(date_won) unless date_won.nil?
+      @amount_disputed = Util.to_big_decimal(amount_disputed)
+      @amount_won = Util.to_big_decimal(amount_won)
+
+      @evidence = evidence.map do |record|
+        Braintree::Dispute::Evidence.new(record)
+      end unless evidence.nil?
+
+      @transaction_details = TransactionDetails.new(transaction)
+      @transaction = Transaction.new(transaction)
+
+      @status_history = status_history.map do |event|
+        Braintree::Dispute::HistoryEvent.new(event)
+      end unless status_history.nil?
+    end
+
+    # Returns true if +other+ is a Dispute with the same id
+    def ==(other)
+      return false unless other.is_a?(Dispute)
+      id == other.id
     end
   end
 end

data/lib/braintree/dispute/evidence.rb

@@ -0,0 +1,18 @@
+module Braintree
+  class Dispute
+    class Evidence # :nodoc:
+      include BaseModule
+
+      attr_reader :comment
+      attr_reader :created_at
+      attr_reader :id
+      attr_reader :sent_to_processor_at
+      attr_reader :url
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+        @sent_to_processor_at = Date.parse(sent_to_processor_at) unless sent_to_processor_at.nil?
+      end
+    end
+  end
+end

data/lib/braintree/dispute/history_event.rb

@@ -0,0 +1,14 @@
+module Braintree
+  class Dispute
+    class HistoryEvent # :nodoc:
+      include BaseModule
+
+      attr_reader :status
+      attr_reader :timestamp
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+      end
+    end
+  end
+end

data/lib/braintree/dispute/transaction.rb

@@ -0,0 +1,18 @@
+module Braintree
+  class Dispute
+    class Transaction # :nodoc:
+      include BaseModule
+
+      attr_reader :amount
+      attr_reader :id
+      attr_reader :order_id
+      attr_reader :purchase_order_number
+      attr_reader :payment_instrument_subtype
+
+      def initialize(attributes)
+        set_instance_variables_from_hash attributes unless attributes.nil?
+        @amount = Util.to_big_decimal(amount)
+      end
+    end
+  end
+end

data/lib/braintree/dispute_gateway.rb

@@ -0,0 +1,118 @@
+module Braintree
+  class DisputeGateway # :nodoc:
+    def initialize(gateway)
+      @gateway = gateway
+      @config = gateway.config
+      @config.assert_has_access_token_or_keys
+    end
+
+    def accept(dispute_id)
+      raise ArgumentError, "dispute_id contains invalid characters" unless dispute_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "dispute_id cannot be blank" if dispute_id.nil? || dispute_id.to_s.strip == ""
+
+      response = @config.http.put("#{@config.base_merchant_path}/disputes/#{dispute_id}/accept")
+      if response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        SuccessfulResult.new
+      end
+    rescue NotFoundError
+      raise NotFoundError, "dispute with id #{dispute_id} not found"
+    end
+
+    def add_file_evidence(dispute_id, document_upload_id)
+      raise ArgumentError, "dispute_id contains invalid characters" unless dispute_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "dispute_id cannot be blank" if dispute_id.nil? || dispute_id.to_s.strip == ""
+      raise ArgumentError, "document_upload_id contains invalid characters" unless document_upload_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "document_upload_id cannot be blank" if document_upload_id.nil? || dispute_id.to_s.strip == ""
+
+      params = {document_upload_id: document_upload_id}
+      response = @config.http.post("#{@config.base_merchant_path}/disputes/#{dispute_id}/evidence", params)
+
+      if response[:evidence]
+        SuccessfulResult.new(:evidence => Dispute::Evidence.new(response[:evidence]))
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise "expected :evidence or :api_error_response"
+      end
+    rescue NotFoundError
+      raise NotFoundError, "dispute with id #{dispute_id} not found"
+    end
+
+    def add_text_evidence(dispute_id, content)
+      raise ArgumentError, "dispute_id contains invalid characters" unless dispute_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "dispute_id cannot be blank" if dispute_id.nil? || dispute_id.to_s.strip == ""
+      raise ArgumentError, "content cannot be blank" if content.nil? || content.to_s.strip == ""
+
+      params = {comments: content}
+      response = @config.http.post("#{@config.base_merchant_path}/disputes/#{dispute_id}/evidence", params)
+
+      if response[:evidence]
+        SuccessfulResult.new(:evidence => Dispute::Evidence.new(response[:evidence]))
+      elsif response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        raise "expected :evidence or :api_error_response"
+      end
+    rescue NotFoundError
+      raise NotFoundError, "dispute with id #{dispute_id} not found"
+    end
+
+    def finalize(dispute_id)
+      raise ArgumentError, "dispute_id contains invalid characters" unless dispute_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "dispute_id cannot be blank" if dispute_id.nil? || dispute_id.to_s.strip == ""
+
+      response = @config.http.put("#{@config.base_merchant_path}/disputes/#{dispute_id}/finalize")
+      if response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        SuccessfulResult.new
+      end
+    rescue NotFoundError
+      raise NotFoundError, "dispute with id #{dispute_id} not found"
+    end
+
+    def find(dispute_id)
+      raise ArgumentError, "dispute_id contains invalid characters" unless dispute_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "dispute_id cannot be blank" if dispute_id.nil? || dispute_id.to_s.strip == ""
+      response = @config.http.get("#{@config.base_merchant_path}/disputes/#{dispute_id}")
+      Dispute._new(response[:dispute])
+    rescue NotFoundError
+      raise NotFoundError, "dispute with id #{dispute_id} not found"
+    end
+
+    def remove_evidence(dispute_id, evidence_id)
+      raise ArgumentError, "dispute_id contains invalid characters" unless dispute_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "dispute_id cannot be blank" if dispute_id.nil? || dispute_id.to_s.strip == ""
+      raise ArgumentError, "evidence_id contains invalid characters" unless evidence_id.to_s =~ /\A[\w-]+\z/
+      raise ArgumentError, "evidence_id cannot be blank" if evidence_id.nil? || evidence_id.to_s.strip == ""
+
+      response = @config.http.delete("#{@config.base_merchant_path}/disputes/#{dispute_id}/evidence/#{evidence_id}")
+
+      if response.respond_to?(:to_hash) && response[:api_error_response]
+        ErrorResult.new(@gateway, response[:api_error_response])
+      else
+        SuccessfulResult.new
+      end
+    rescue NotFoundError
+      raise NotFoundError, "evidence with id #{evidence_id} for dispute with id #{dispute_id} not found"
+    end
+
+    def search(&block)
+      search = DisputeSearch.new
+      block.call(search) if block
+
+      paginated_results = PaginatedCollection.new { |page| _fetch_disputes(search, page) }
+      SuccessfulResult.new(:disputes => paginated_results)
+    end
+
+    def _fetch_disputes(search, page)
+      response = @config.http.post("#{@config.base_merchant_path}/disputes/advanced_search?page=#{page}", {:search => search.to_hash, :page => page})
+      body = response[:disputes]
+      disputes = Util.extract_attribute_as_array(body, :dispute).map { |d| Dispute._new(d) }
+
+      PaginatedResult.new(body[:total_items], body[:page_size], disputes)
+    end
+  end
+end