paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/models/setup_token_card_experience_context.rb

@@ -40,7 +40,7 @@ module PaypalServerSdk
 
     # Vault Instruction on action to be performed after a successful payer
     # approval.
-    # @return [String]
+    # @return [VaultInstructionAction]
     attr_accessor :vault_instruction
 
     # A mapping from model property names to API property names.
@@ -70,9 +70,10 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(brand_name: SKIP, locale: SKIP, return_url: SKIP,
-                   cancel_url: SKIP,
-                   vault_instruction: 'ON_CREATE_PAYMENT_TOKENS')
+    def initialize(
+      brand_name: SKIP, locale: SKIP, return_url: SKIP, cancel_url: SKIP,
+      vault_instruction: VaultInstructionAction::ON_CREATE_PAYMENT_TOKENS
+    )
       @brand_name = brand_name unless brand_name == SKIP
       @locale = locale unless locale == SKIP
       @return_url = return_url unless return_url == SKIP
@@ -90,7 +91,7 @@ module PaypalServerSdk
       return_url = hash.key?('return_url') ? hash['return_url'] : SKIP
       cancel_url = hash.key?('cancel_url') ? hash['cancel_url'] : SKIP
       vault_instruction =
-        hash['vault_instruction'] ||= 'ON_CREATE_PAYMENT_TOKENS'
+        hash['vault_instruction'] ||= VaultInstructionAction::ON_CREATE_PAYMENT_TOKENS
 
       # Create object from extracted values.
       SetupTokenCardExperienceContext.new(brand_name: brand_name,
@@ -99,5 +100,20 @@ module PaypalServerSdk
                                           cancel_url: cancel_url,
                                           vault_instruction: vault_instruction)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} brand_name: #{@brand_name}, locale: #{@locale}, return_url: #{@return_url},"\
+      " cancel_url: #{@cancel_url}, vault_instruction: #{@vault_instruction}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} brand_name: #{@brand_name.inspect}, locale: #{@locale.inspect}, return_url:"\
+      " #{@return_url.inspect}, cancel_url: #{@cancel_url.inspect}, vault_instruction:"\
+      " #{@vault_instruction.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/setup_token_request.rb

@@ -10,8 +10,9 @@ module PaypalServerSdk
     SKIP = Object.new
     private_constant :SKIP
 
-    # Customer in merchant's or partner's system of records.
-    # @return [CustomerRequest]
+    # This object defines a customer in your system. Use it to manage customer
+    # profiles, save payment methods and contact details.
+    # @return [Customer]
     attr_accessor :customer
 
     # The payment method to vault with the instrument details.
@@ -50,11 +51,24 @@ module PaypalServerSdk
       # Extract variables from the hash.
       payment_source = SetupTokenRequestPaymentSource.from_hash(hash['payment_source']) if
         hash['payment_source']
-      customer = CustomerRequest.from_hash(hash['customer']) if hash['customer']
+      customer = Customer.from_hash(hash['customer']) if hash['customer']
 
       # Create object from extracted values.
       SetupTokenRequest.new(payment_source: payment_source,
                             customer: customer)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} customer: #{@customer}, payment_source: #{@payment_source}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} customer: #{@customer.inspect}, payment_source:"\
+      " #{@payment_source.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/setup_token_request_card.rb

@@ -43,17 +43,13 @@ module PaypalServerSdk
     attr_accessor :billing_address
 
     # The verification method of the card.
-    # @return [String]
+    # @return [VaultCardVerificationMethod]
     attr_accessor :verification_method
 
     # Customizes the Vault creation flow experience for your customers.
     # @return [SetupTokenCardExperienceContext]
     attr_accessor :experience_context
 
-    # Customizes the Vault creation flow experience for your customers.
-    # @return [Object]
-    attr_accessor :network_transaction_reference
-
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -65,8 +61,6 @@ module PaypalServerSdk
       @_hash['billing_address'] = 'billing_address'
       @_hash['verification_method'] = 'verification_method'
       @_hash['experience_context'] = 'experience_context'
-      @_hash['network_transaction_reference'] =
-        'network_transaction_reference'
       @_hash
     end
 
@@ -81,7 +75,6 @@ module PaypalServerSdk
         billing_address
         verification_method
         experience_context
-        network_transaction_reference
       ]
     end
 
@@ -92,8 +85,7 @@ module PaypalServerSdk
 
     def initialize(name: SKIP, number: SKIP, expiry: SKIP, security_code: SKIP,
                    brand: SKIP, billing_address: SKIP,
-                   verification_method: SKIP, experience_context: SKIP,
-                   network_transaction_reference: SKIP)
+                   verification_method: SKIP, experience_context: SKIP)
       @name = name unless name == SKIP
       @number = number unless number == SKIP
       @expiry = expiry unless expiry == SKIP
@@ -102,10 +94,6 @@ module PaypalServerSdk
       @billing_address = billing_address unless billing_address == SKIP
       @verification_method = verification_method unless verification_method == SKIP
       @experience_context = experience_context unless experience_context == SKIP
-      unless network_transaction_reference == SKIP
-        @network_transaction_reference =
-          network_transaction_reference
-      end
     end
 
     # Creates an instance of the object from a hash.
@@ -123,8 +111,6 @@ module PaypalServerSdk
         hash.key?('verification_method') ? hash['verification_method'] : SKIP
       experience_context = SetupTokenCardExperienceContext.from_hash(hash['experience_context']) if
         hash['experience_context']
-      network_transaction_reference =
-        hash.key?('network_transaction_reference') ? hash['network_transaction_reference'] : SKIP
 
       # Create object from extracted values.
       SetupTokenRequestCard.new(name: name,
@@ -134,8 +120,24 @@ module PaypalServerSdk
                                 brand: brand,
                                 billing_address: billing_address,
                                 verification_method: verification_method,
-                                experience_context: experience_context,
-                                network_transaction_reference: network_transaction_reference)
+                                experience_context: experience_context)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, number: #{@number}, expiry: #{@expiry}, security_code:"\
+      " #{@security_code}, brand: #{@brand}, billing_address: #{@billing_address},"\
+      " verification_method: #{@verification_method}, experience_context: #{@experience_context}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, number: #{@number.inspect}, expiry:"\
+      " #{@expiry.inspect}, security_code: #{@security_code.inspect}, brand: #{@brand.inspect},"\
+      " billing_address: #{@billing_address.inspect}, verification_method:"\
+      " #{@verification_method.inspect}, experience_context: #{@experience_context.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/setup_token_request_payment_source.rb

@@ -73,5 +73,18 @@ module PaypalServerSdk
                                          venmo: venmo,
                                          token: token)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card}, paypal: #{@paypal}, venmo: #{@venmo}, token: #{@token}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card.inspect}, paypal: #{@paypal.inspect}, venmo:"\
+      " #{@venmo.inspect}, token: #{@token.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/setup_token_response.rb

@@ -13,16 +13,13 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :id
 
-    # Ordinal number for sorting.
-    # @return [Integer]
-    attr_accessor :ordinal
-
-    # Customer in merchant's or partner's system of records.
-    # @return [CustomerRequest]
+    # This object defines a customer in your system. Use it to manage customer
+    # profiles, save payment methods and contact details.
+    # @return [Customer]
     attr_accessor :customer
 
     # The status of the payment token.
-    # @return [String]
+    # @return [PaymentTokenStatus]
     attr_accessor :status
 
     # The setup payment method details.
@@ -37,7 +34,6 @@ module PaypalServerSdk
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['id'] = 'id'
-      @_hash['ordinal'] = 'ordinal'
       @_hash['customer'] = 'customer'
       @_hash['status'] = 'status'
       @_hash['payment_source'] = 'payment_source'
@@ -49,7 +45,6 @@ module PaypalServerSdk
     def self.optionals
       %w[
         id
-        ordinal
         customer
         status
         payment_source
@@ -62,10 +57,10 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(id: SKIP, ordinal: SKIP, customer: SKIP, status: 'CREATED',
-                   payment_source: SKIP, links: SKIP)
+    def initialize(id: SKIP, customer: SKIP,
+                   status: PaymentTokenStatus::CREATED, payment_source: SKIP,
+                   links: SKIP)
       @id = id unless id == SKIP
-      @ordinal = ordinal unless ordinal == SKIP
       @customer = customer unless customer == SKIP
       @status = status unless status == SKIP
       @payment_source = payment_source unless payment_source == SKIP
@@ -78,9 +73,8 @@ module PaypalServerSdk
 
       # Extract variables from the hash.
       id = hash.key?('id') ? hash['id'] : SKIP
-      ordinal = hash.key?('ordinal') ? hash['ordinal'] : SKIP
-      customer = CustomerRequest.from_hash(hash['customer']) if hash['customer']
-      status = hash['status'] ||= 'CREATED'
+      customer = Customer.from_hash(hash['customer']) if hash['customer']
+      status = hash['status'] ||= PaymentTokenStatus::CREATED
       payment_source = SetupTokenResponsePaymentSource.from_hash(hash['payment_source']) if
         hash['payment_source']
       # Parameter is an array, so we need to iterate through it
@@ -96,11 +90,24 @@ module PaypalServerSdk
 
       # Create object from extracted values.
       SetupTokenResponse.new(id: id,
-                             ordinal: ordinal,
                              customer: customer,
                              status: status,
                              payment_source: payment_source,
                              links: links)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, customer: #{@customer}, status: #{@status}, payment_source:"\
+      " #{@payment_source}, links: #{@links}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, customer: #{@customer.inspect}, status:"\
+      " #{@status.inspect}, payment_source: #{@payment_source.inspect}, links: #{@links.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/setup_token_response_card.rb

@@ -28,11 +28,11 @@ module PaypalServerSdk
     attr_accessor :expiry
 
     # Address request details.
-    # @return [AddressDetails]
+    # @return [CardResponseAddress]
     attr_accessor :billing_address
 
     # Verification status of Card.
-    # @return [String]
+    # @return [CardVerificationStatus]
     attr_accessor :verification_status
 
     # Card Verification details including the authorization details and 3D
@@ -125,7 +125,7 @@ module PaypalServerSdk
       last_digits = hash.key?('last_digits') ? hash['last_digits'] : SKIP
       brand = hash.key?('brand') ? hash['brand'] : SKIP
       expiry = hash.key?('expiry') ? hash['expiry'] : SKIP
-      billing_address = AddressDetails.from_hash(hash['billing_address']) if
+      billing_address = CardResponseAddress.from_hash(hash['billing_address']) if
         hash['billing_address']
       verification_status =
         hash.key?('verification_status') ? hash['verification_status'] : SKIP
@@ -152,5 +152,27 @@ module PaypalServerSdk
                                  bin_details: bin_details,
                                  type: type)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, last_digits: #{@last_digits}, brand: #{@brand}, expiry:"\
+      " #{@expiry}, billing_address: #{@billing_address}, verification_status:"\
+      " #{@verification_status}, verification: #{@verification}, network_transaction_reference:"\
+      " #{@network_transaction_reference}, authentication_result: #{@authentication_result},"\
+      " bin_details: #{@bin_details}, type: #{@type}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, last_digits: #{@last_digits.inspect}, brand:"\
+      " #{@brand.inspect}, expiry: #{@expiry.inspect}, billing_address:"\
+      " #{@billing_address.inspect}, verification_status: #{@verification_status.inspect},"\
+      " verification: #{@verification.inspect}, network_transaction_reference:"\
+      " #{@network_transaction_reference.inspect}, authentication_result:"\
+      " #{@authentication_result.inspect}, bin_details: #{@bin_details.inspect}, type:"\
+      " #{@type.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/setup_token_response_payment_source.rb

@@ -64,5 +64,18 @@ module PaypalServerSdk
                                           paypal: paypal,
                                           venmo: venmo)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card}, paypal: #{@paypal}, venmo: #{@venmo}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card.inspect}, paypal: #{@paypal.inspect}, venmo:"\
+      " #{@venmo.inspect}>"
+    end
   end
 end