Class: PayPal::SDK::REST::DataTypes::Agreement

Inherits:

Base

• Object
• Core::API::DataTypes::Base
• Base
• PayPal::SDK::REST::DataTypes::Agreement

Includes:

RequestDataType

Defined in:

lib/paypal-sdk/rest/data_types.rb

Constant Summary

Constants inherited from Core::API::DataTypes::Base

Core::API::DataTypes::Base::ContentKey, Core::API::DataTypes::Base::HashOptions

Instance Attribute Summary

Attributes inherited from Base

#error, #header, #request_id

Class Method Summary

• .find(resource_id) ⇒ Object
• .load_members ⇒ Object
• .transactions(agreement_id, start_date, end_date, options = {}) ⇒ Object

Instance Method Summary

• #bill_balance(agreement_state_descriptor) ⇒ Object
• #cancel(agreement_state_descriptor) ⇒ Object
• #create ⇒ Object
• #execute ⇒ Object
• #get_token(links) ⇒ Object
• #re_activate(agreement_state_descriptor) ⇒ Object
• #set_balance(currency) ⇒ Object
• #suspend(agreement_state_descriptor) ⇒ Object
• #update(patch) ⇒ Object

Methods included from RequestDataType

#api, api, #error=, included

Methods included from SetAPI

#client_id=, #client_secret=, #set_config, #token=

Methods inherited from Base

#http_header, #merge!, #raise_error!, raise_on_api_error, #success?

Methods inherited from Core::API::DataTypes::Base

add_attribute, add_member, array_of, #convert_array, #convert_object, define_alias_methods, #hash_key, #initialize, #member_names, members, #members, #merge!, object_of, #set, #skip_value?, snakecase, #to_hash, #value_to_hash

Methods included from Core::Logging

#log_event, #logger, logger, logger=

Constructor Details

This class inherits a constructor from PayPal::SDK::Core::API::DataTypes::Base

Class Method Details

.find(resource_id) ⇒ Object

Raises:

• (ArgumentError)

# File 'lib/paypal-sdk/rest/data_types.rb', line 2272

def find(resource_id)
  raise ArgumentError.new("id required") if resource_id.to_s.strip.empty?
  path = "v1/payments/billing-agreements/#{resource_id}"
  self.new(api.get(path))
end

.load_members ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2236

def self.load_members
      object_of :id, String
      object_of :state, String
      object_of :name, String
      object_of :description, String
      object_of :start_date, String
      object_of :agreement_details, AgreementDetails
      object_of :payer, Payer
      object_of :shipping_address, Address
      object_of :override_merchant_preferences, MerchantPreferences
    array_of  :override_charge_models, OverrideChargeModel
      object_of :plan, Plan
      object_of :create_time, String
      object_of :update_time, String
    array_of  :links, Links
      object_of :token, String
end

.transactions(agreement_id, start_date, end_date, options = {}) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2331

def transactions(agreement_id, start_date, end_date, options = {})
  path = "v1/payments/billing-agreements/#{agreement_id}/transactions" #?start-date=#{start_date}&end-date=#{end_date}"
  options = { :start_date => start_date, :end_date => end_date }
  AgreementTransactions.new(api.get(path, options))
end

Instance Method Details

#bill_balance(agreement_state_descriptor) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2311

def bill_balance(agreement_state_descriptor)
  agreement_state_descriptor = AgreementStateDescriptor.new(agreement_state_descriptor) unless agreement_state_descriptor.is_a? AgreementStateDescriptor
  path = "v1/payments/billing-agreements/#{self.id}/bill-balance"
  response = api.post(path, agreement_state_descriptor.to_hash, http_header)
  self.merge!(response)
  success?
end

#cancel(agreement_state_descriptor) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2303

def cancel(agreement_state_descriptor)
  agreement_state_descriptor = AgreementStateDescriptor.new(agreement_state_descriptor) unless agreement_state_descriptor.is_a? AgreementStateDescriptor
  path = "v1/payments/billing-agreements/#{self.id}/cancel"
  response = api.post(path, agreement_state_descriptor.to_hash, http_header)
  self.merge!(response)
  success?
end

#create ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2256

def create()
  path = "v1/payments/billing-agreements/"
  response = api.post(path, self.to_hash, http_header)
  self.merge!(response)
  self.get_token(self.links)
  success?
end

#execute ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2264

def execute()
  path = "v1/payments/billing-agreements/#{self.token}/agreement-execute"
  response = api.post(path, {}, http_header)
  self.merge!(response)
  success?
end

#get_token(links) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2338

def get_token(links)
  links.each do |link|
    if link.rel.eql? "approval_url"
      uri = URI.parse(link.href)
      params = CGI.parse(uri.query)
      self.token = params['token'][0]
      return
    end
  end
end

#re_activate(agreement_state_descriptor) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2295

def re_activate(agreement_state_descriptor)
  agreement_state_descriptor = AgreementStateDescriptor.new(agreement_state_descriptor) unless agreement_state_descriptor.is_a? AgreementStateDescriptor
  path = "v1/payments/billing-agreements/#{self.id}/re-activate"
  response = api.post(path, agreement_state_descriptor.to_hash, http_header)
  self.merge!(response)
  success?
end

#set_balance(currency) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2319

def set_balance(currency)
  currency = Currency.new(currency) unless currency.is_a? Currency
  path = "v1/payments/billing-agreements/#{self.id}/set-balance"
  response = api.post(path, currency.to_hash, http_header)
  self.merge!(response)
  success?
end

#suspend(agreement_state_descriptor) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2287

def suspend(agreement_state_descriptor)
  agreement_state_descriptor = AgreementStateDescriptor.new(agreement_state_descriptor) unless agreement_state_descriptor.is_a? AgreementStateDescriptor
  path = "v1/payments/billing-agreements/#{self.id}/suspend"
  response = api.post(path, agreement_state_descriptor.to_hash, http_header)
  self.merge!(response)
  success?
end

#update(patch) ⇒ Object

# File 'lib/paypal-sdk/rest/data_types.rb', line 2279

def update(patch)
  patch = Patch.new(patch) unless patch.is_a? Patch
  path = "v1/payments/billing-agreements/#{self.id}"
  response = api.patch(path, [patch.to_hash], http_header)
  self.merge!(response)
  success?
end