maxio-advanced-billing-sdk 1.0.0 → 2.0.0

data/lib/advanced_billing/models/subscription_group_prepayment_response.rb

@@ -60,12 +60,18 @@ module AdvancedBilling
                    amount_in_cents = SKIP,
                    ending_balance_in_cents = SKIP,
                    entry_type = SKIP,
-                   memo = SKIP)
+                   memo = SKIP,
+                   additional_properties = {})
       @id = id unless id == SKIP
       @amount_in_cents = amount_in_cents unless amount_in_cents == SKIP
       @ending_balance_in_cents = ending_balance_in_cents unless ending_balance_in_cents == SKIP
       @entry_type = entry_type unless entry_type == SKIP
       @memo = memo unless memo == SKIP
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -81,12 +87,16 @@ module AdvancedBilling
       entry_type = hash.key?('entry_type') ? hash['entry_type'] : SKIP
       memo = hash.key?('memo') ? hash['memo'] : SKIP
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupPrepaymentResponse.new(id,
                                               amount_in_cents,
                                               ending_balance_in_cents,
                                               entry_type,
-                                              memo)
+                                              memo,
+                                              hash)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_response.rb

@@ -30,8 +30,14 @@ module AdvancedBilling
       []
     end
 
-    def initialize(subscription_group = nil)
+    def initialize(subscription_group = nil,
+                   additional_properties = {})
       @subscription_group = subscription_group
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -42,8 +48,12 @@ module AdvancedBilling
       subscription_group = SubscriptionGroup.from_hash(hash['subscription_group']) if
         hash['subscription_group']
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
-      SubscriptionGroupResponse.new(subscription_group)
+      SubscriptionGroupResponse.new(subscription_group,
+                                    hash)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_signup.rb

@@ -95,7 +95,8 @@ module AdvancedBilling
                    payment_collection_method = CollectionMethod::AUTOMATIC,
                    payer_attributes = SKIP,
                    credit_card_attributes = SKIP,
-                   bank_account_attributes = SKIP)
+                   bank_account_attributes = SKIP,
+                   additional_properties = {})
       @payment_profile_id = payment_profile_id unless payment_profile_id == SKIP
       @payer_id = payer_id unless payer_id == SKIP
       @payer_reference = payer_reference unless payer_reference == SKIP
@@ -107,6 +108,11 @@ module AdvancedBilling
       @credit_card_attributes = credit_card_attributes unless credit_card_attributes == SKIP
       @bank_account_attributes = bank_account_attributes unless bank_account_attributes == SKIP
       @subscriptions = subscriptions
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -140,6 +146,9 @@ module AdvancedBilling
         bank_account_attributes = SubscriptionGroupBankAccount.from_hash(hash['bank_account_attributes'])
       end
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignup.new(subscriptions,
                                   payment_profile_id,
@@ -148,7 +157,8 @@ module AdvancedBilling
                                   payment_collection_method,
                                   payer_attributes,
                                   credit_card_attributes,
-                                  bank_account_attributes)
+                                  bank_account_attributes,
+                                  hash)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_signup_component.rb

@@ -61,12 +61,18 @@ module AdvancedBilling
                    allocated_quantity = SKIP,
                    unit_balance = SKIP,
                    price_point_id = SKIP,
-                   custom_price = SKIP)
+                   custom_price = SKIP,
+                   additional_properties = {})
       @component_id = component_id unless component_id == SKIP
       @allocated_quantity = allocated_quantity unless allocated_quantity == SKIP
       @unit_balance = unit_balance unless unit_balance == SKIP
       @price_point_id = price_point_id unless price_point_id == SKIP
       @custom_price = custom_price unless custom_price == SKIP
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -89,12 +95,16 @@ module AdvancedBilling
       custom_price = SubscriptionGroupComponentCustomPrice.from_hash(hash['custom_price']) if
         hash['custom_price']
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignupComponent.new(component_id,
                                            allocated_quantity,
                                            unit_balance,
                                            price_point_id,
-                                           custom_price)
+                                           custom_price,
+                                           hash)
     end
 
     # Validates an instance of the object from a given value.

data/lib/advanced_billing/models/subscription_group_signup_error.rb

@@ -73,13 +73,19 @@ module AdvancedBilling
                    payer = SKIP,
                    subscription_group = SKIP,
                    payment_profile_id = SKIP,
-                   payer_id = SKIP)
+                   payer_id = SKIP,
+                   additional_properties = {})
       @subscriptions = subscriptions unless subscriptions == SKIP
       @payer_reference = payer_reference unless payer_reference == SKIP
       @payer = payer unless payer == SKIP
       @subscription_group = subscription_group unless subscription_group == SKIP
       @payment_profile_id = payment_profile_id unless payment_profile_id == SKIP
       @payer_id = payer_id unless payer_id == SKIP
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -100,13 +106,17 @@ module AdvancedBilling
         hash.key?('payment_profile_id') ? hash['payment_profile_id'] : SKIP
       payer_id = hash.key?('payer_id') ? hash['payer_id'] : SKIP
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignupError.new(subscriptions,
                                        payer_reference,
                                        payer,
                                        subscription_group,
                                        payment_profile_id,
-                                       payer_id)
+                                       payer_id,
+                                       hash)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_signup_failure.rb

@@ -38,9 +38,15 @@ module AdvancedBilling
     end
 
     def initialize(subscription_group = nil,
-                   customer = nil)
+                   customer = nil,
+                   additional_properties = {})
       @subscription_group = subscription_group
       @customer = customer
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -53,9 +59,13 @@ module AdvancedBilling
       end
       customer = hash.key?('customer') ? hash['customer'] : nil
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignupFailure.new(subscription_group,
-                                         customer)
+                                         customer,
+                                         hash)
     end
 
     # Validates an instance of the object from a given value.

data/lib/advanced_billing/models/subscription_group_signup_failure_data.rb

@@ -81,7 +81,8 @@ module AdvancedBilling
                    payer_attributes = SKIP,
                    credit_card_attributes = SKIP,
                    bank_account_attributes = SKIP,
-                   subscriptions = SKIP)
+                   subscriptions = SKIP,
+                   additional_properties = {})
       @payer_id = payer_id unless payer_id == SKIP
       @payer_reference = payer_reference unless payer_reference == SKIP
       @payment_profile_id = payment_profile_id unless payment_profile_id == SKIP
@@ -93,6 +94,11 @@ module AdvancedBilling
       @credit_card_attributes = credit_card_attributes unless credit_card_attributes == SKIP
       @bank_account_attributes = bank_account_attributes unless bank_account_attributes == SKIP
       @subscriptions = subscriptions unless subscriptions == SKIP
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -126,6 +132,9 @@ module AdvancedBilling
 
       subscriptions = SKIP unless hash.key?('subscriptions')
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignupFailureData.new(payer_id,
                                              payer_reference,
@@ -134,7 +143,8 @@ module AdvancedBilling
                                              payer_attributes,
                                              credit_card_attributes,
                                              bank_account_attributes,
-                                             subscriptions)
+                                             subscriptions,
+                                             hash)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_signup_item.rb

@@ -126,7 +126,8 @@ module AdvancedBilling
                    components = SKIP,
                    custom_price = SKIP,
                    calendar_billing = SKIP,
-                   metafields = SKIP)
+                   metafields = SKIP,
+                   additional_properties = {})
       @product_handle = product_handle unless product_handle == SKIP
       @product_id = product_id unless product_id == SKIP
       @product_price_point_id = product_price_point_id unless product_price_point_id == SKIP
@@ -143,6 +144,11 @@ module AdvancedBilling
       @custom_price = custom_price unless custom_price == SKIP
       @calendar_billing = calendar_billing unless calendar_billing == SKIP
       @metafields = metafields unless metafields == SKIP
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -178,6 +184,9 @@ module AdvancedBilling
         hash['calendar_billing']
       metafields = hash.key?('metafields') ? hash['metafields'] : SKIP
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignupItem.new(product_handle,
                                       product_id,
@@ -191,7 +200,8 @@ module AdvancedBilling
                                       components,
                                       custom_price,
                                       calendar_billing,
-                                      metafields)
+                                      metafields,
+                                      hash)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_signup_request.rb

@@ -30,8 +30,14 @@ module AdvancedBilling
       []
     end
 
-    def initialize(subscription_group = nil)
+    def initialize(subscription_group = nil,
+                   additional_properties = {})
       @subscription_group = subscription_group
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -42,8 +48,12 @@ module AdvancedBilling
       subscription_group = SubscriptionGroupSignup.from_hash(hash['subscription_group']) if
         hash['subscription_group']
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
-      SubscriptionGroupSignupRequest.new(subscription_group)
+      SubscriptionGroupSignupRequest.new(subscription_group,
+                                         hash)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_signup_response.rb

@@ -3,6 +3,7 @@
 # This file was automatically generated by APIMATIC v2.0
 # ( https://apimatic.io ).
 
+require 'date'
 module AdvancedBilling
   # SubscriptionGroupSignupResponse Model.
   class SubscriptionGroupSignupResponse < BaseModel
@@ -34,18 +35,222 @@ module AdvancedBilling
     attr_accessor :primary_subscription_id
 
     # TODO: Write general description for this method
-    # @return [String]
+    # @return [DateTime]
     attr_accessor :next_assessment_at
 
-    # TODO: Write general description for this method
-    # @return [String]
+    # The state of a subscription.
+    # * **Live States**
+    #     * `active` - A normal, active subscription. It is not in a trial and
+    # is paid and up to date.
+    #     * `assessing` - An internal (transient) state that indicates a
+    # subscription is in the middle of periodic assessment. Do not base any
+    # access decisions in your app on this state, as it may not always be
+    # exposed.
+    #     * `pending` - An internal (transient) state that indicates a
+    # subscription is in the creation process. Do not base any access decisions
+    # in your app on this state, as it may not always be exposed.
+    #     * `trialing` - A subscription in trialing state has a valid trial
+    # subscription. This type of subscription may transition to active once
+    # payment is received when the trial has ended. Otherwise, it may go to a
+    # Problem or End of Life state.
+    #     * `paused` - An internal state that indicates that your account with
+    # Advanced Billing is in arrears.
+    # * **Problem States**
+    #     * `past_due` - Indicates that the most recent payment has failed, and
+    # payment is past due for this subscription. If you have enabled our
+    # automated dunning, this subscription will be in the dunning process
+    # (additional status and callbacks from the dunning process will be
+    # available in the future). If you are handling dunning and payment updates
+    # yourself, you will want to use this state to initiate a payment update
+    # from your customers.
+    #     * `soft_failure` - Indicates that normal assessment/processing of the
+    # subscription has failed for a reason that cannot be fixed by the Customer.
+    # For example, a Soft Fail may result from a timeout at the gateway or
+    # incorrect credentials on your part. The subscriptions should be retried
+    # automatically. An interface is being built for you to review problems
+    # resulting from these events to take manual action when needed.
+    #     * `unpaid` - Indicates an unpaid subscription. A subscription is
+    # marked unpaid if the retry period expires and you have configured your
+    # [Dunning](https://maxio-chargify.zendesk.com/hc/en-us/articles/54055051410
+    # 05) settings to have a Final Action of `mark the subscription unpaid`.
+    # * **End of Life States**
+    #     * `canceled` - Indicates a canceled subscription. This may happen at
+    # your request (via the API or the web interface) or due to the expiration
+    # of the
+    # [Dunning](https://maxio-chargify.zendesk.com/hc/en-us/articles/54055051410
+    # 05) process without payment. See the
+    # [Reactivation](https://maxio-chargify.zendesk.com/hc/en-us/articles/540455
+    # 9291021) documentation for info on how to restart a canceled subscription.
+    #     While a subscription is canceled, its period will not advance, it will
+    # not accrue any new charges, and Advanced Billing will not attempt to
+    # collect the overdue balance.
+    #     * `expired` - Indicates a subscription that has expired due to running
+    # its normal life cycle. Some products may be configured to have an
+    # expiration period. An expired subscription then is one that stayed active
+    # until it fulfilled its full period.
+    #     * `failed_to_create` - Indicates that signup has failed. (You may see
+    # this state in a signup_failure webhook.)
+    #     * `on_hold` - Indicates that a subscription’s billing has been
+    # temporarily stopped. While it is expected that the subscription will
+    # resume and return to active status, this is still treated as an “End of
+    # Life” state because the customer is not paying for services during this
+    # time.
+    #     * `suspended` - Indicates that a prepaid subscription has used up all
+    # their prepayment balance. If a prepayment is applied, it will return to an
+    # active state.
+    #     * `trial_ended` - A subscription in a trial_ended state is a
+    # subscription that completed a no-obligation trial and did not have a card
+    # on file at the expiration of the trial period. See [Product Pricing – No
+    # Obligation
+    # Trials](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405246782221
+    # ) for more details.
+    # See [Subscription
+    # States](https://maxio-chargify.zendesk.com/hc/en-us/articles/5404222005773
+    # ) for more info about subscription states and state transitions.
+    # @return [SubscriptionState]
     attr_accessor :state
 
-    # TODO: Write general description for this method
+    # The state of a subscription.
+    # * **Live States**
+    #     * `active` - A normal, active subscription. It is not in a trial and
+    # is paid and up to date.
+    #     * `assessing` - An internal (transient) state that indicates a
+    # subscription is in the middle of periodic assessment. Do not base any
+    # access decisions in your app on this state, as it may not always be
+    # exposed.
+    #     * `pending` - An internal (transient) state that indicates a
+    # subscription is in the creation process. Do not base any access decisions
+    # in your app on this state, as it may not always be exposed.
+    #     * `trialing` - A subscription in trialing state has a valid trial
+    # subscription. This type of subscription may transition to active once
+    # payment is received when the trial has ended. Otherwise, it may go to a
+    # Problem or End of Life state.
+    #     * `paused` - An internal state that indicates that your account with
+    # Advanced Billing is in arrears.
+    # * **Problem States**
+    #     * `past_due` - Indicates that the most recent payment has failed, and
+    # payment is past due for this subscription. If you have enabled our
+    # automated dunning, this subscription will be in the dunning process
+    # (additional status and callbacks from the dunning process will be
+    # available in the future). If you are handling dunning and payment updates
+    # yourself, you will want to use this state to initiate a payment update
+    # from your customers.
+    #     * `soft_failure` - Indicates that normal assessment/processing of the
+    # subscription has failed for a reason that cannot be fixed by the Customer.
+    # For example, a Soft Fail may result from a timeout at the gateway or
+    # incorrect credentials on your part. The subscriptions should be retried
+    # automatically. An interface is being built for you to review problems
+    # resulting from these events to take manual action when needed.
+    #     * `unpaid` - Indicates an unpaid subscription. A subscription is
+    # marked unpaid if the retry period expires and you have configured your
+    # [Dunning](https://maxio-chargify.zendesk.com/hc/en-us/articles/54055051410
+    # 05) settings to have a Final Action of `mark the subscription unpaid`.
+    # * **End of Life States**
+    #     * `canceled` - Indicates a canceled subscription. This may happen at
+    # your request (via the API or the web interface) or due to the expiration
+    # of the
+    # [Dunning](https://maxio-chargify.zendesk.com/hc/en-us/articles/54055051410
+    # 05) process without payment. See the
+    # [Reactivation](https://maxio-chargify.zendesk.com/hc/en-us/articles/540455
+    # 9291021) documentation for info on how to restart a canceled subscription.
+    #     While a subscription is canceled, its period will not advance, it will
+    # not accrue any new charges, and Advanced Billing will not attempt to
+    # collect the overdue balance.
+    #     * `expired` - Indicates a subscription that has expired due to running
+    # its normal life cycle. Some products may be configured to have an
+    # expiration period. An expired subscription then is one that stayed active
+    # until it fulfilled its full period.
+    #     * `failed_to_create` - Indicates that signup has failed. (You may see
+    # this state in a signup_failure webhook.)
+    #     * `on_hold` - Indicates that a subscription’s billing has been
+    # temporarily stopped. While it is expected that the subscription will
+    # resume and return to active status, this is still treated as an “End of
+    # Life” state because the customer is not paying for services during this
+    # time.
+    #     * `suspended` - Indicates that a prepaid subscription has used up all
+    # their prepayment balance. If a prepayment is applied, it will return to an
+    # active state.
+    #     * `trial_ended` - A subscription in a trial_ended state is a
+    # subscription that completed a no-obligation trial and did not have a card
+    # on file at the expiration of the trial period. See [Product Pricing – No
+    # Obligation
+    # Trials](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405246782221
+    # ) for more details.
+    # See [Subscription
+    # States](https://maxio-chargify.zendesk.com/hc/en-us/articles/5404222005773
+    # ) for more info about subscription states and state transitions.
     # @return [TrueClass | FalseClass]
     attr_accessor :cancel_at_end_of_period
 
-    # TODO: Write general description for this method
+    # The state of a subscription.
+    # * **Live States**
+    #     * `active` - A normal, active subscription. It is not in a trial and
+    # is paid and up to date.
+    #     * `assessing` - An internal (transient) state that indicates a
+    # subscription is in the middle of periodic assessment. Do not base any
+    # access decisions in your app on this state, as it may not always be
+    # exposed.
+    #     * `pending` - An internal (transient) state that indicates a
+    # subscription is in the creation process. Do not base any access decisions
+    # in your app on this state, as it may not always be exposed.
+    #     * `trialing` - A subscription in trialing state has a valid trial
+    # subscription. This type of subscription may transition to active once
+    # payment is received when the trial has ended. Otherwise, it may go to a
+    # Problem or End of Life state.
+    #     * `paused` - An internal state that indicates that your account with
+    # Advanced Billing is in arrears.
+    # * **Problem States**
+    #     * `past_due` - Indicates that the most recent payment has failed, and
+    # payment is past due for this subscription. If you have enabled our
+    # automated dunning, this subscription will be in the dunning process
+    # (additional status and callbacks from the dunning process will be
+    # available in the future). If you are handling dunning and payment updates
+    # yourself, you will want to use this state to initiate a payment update
+    # from your customers.
+    #     * `soft_failure` - Indicates that normal assessment/processing of the
+    # subscription has failed for a reason that cannot be fixed by the Customer.
+    # For example, a Soft Fail may result from a timeout at the gateway or
+    # incorrect credentials on your part. The subscriptions should be retried
+    # automatically. An interface is being built for you to review problems
+    # resulting from these events to take manual action when needed.
+    #     * `unpaid` - Indicates an unpaid subscription. A subscription is
+    # marked unpaid if the retry period expires and you have configured your
+    # [Dunning](https://maxio-chargify.zendesk.com/hc/en-us/articles/54055051410
+    # 05) settings to have a Final Action of `mark the subscription unpaid`.
+    # * **End of Life States**
+    #     * `canceled` - Indicates a canceled subscription. This may happen at
+    # your request (via the API or the web interface) or due to the expiration
+    # of the
+    # [Dunning](https://maxio-chargify.zendesk.com/hc/en-us/articles/54055051410
+    # 05) process without payment. See the
+    # [Reactivation](https://maxio-chargify.zendesk.com/hc/en-us/articles/540455
+    # 9291021) documentation for info on how to restart a canceled subscription.
+    #     While a subscription is canceled, its period will not advance, it will
+    # not accrue any new charges, and Advanced Billing will not attempt to
+    # collect the overdue balance.
+    #     * `expired` - Indicates a subscription that has expired due to running
+    # its normal life cycle. Some products may be configured to have an
+    # expiration period. An expired subscription then is one that stayed active
+    # until it fulfilled its full period.
+    #     * `failed_to_create` - Indicates that signup has failed. (You may see
+    # this state in a signup_failure webhook.)
+    #     * `on_hold` - Indicates that a subscription’s billing has been
+    # temporarily stopped. While it is expected that the subscription will
+    # resume and return to active status, this is still treated as an “End of
+    # Life” state because the customer is not paying for services during this
+    # time.
+    #     * `suspended` - Indicates that a prepaid subscription has used up all
+    # their prepayment balance. If a prepayment is applied, it will return to an
+    # active state.
+    #     * `trial_ended` - A subscription in a trial_ended state is a
+    # subscription that completed a no-obligation trial and did not have a card
+    # on file at the expiration of the trial period. See [Product Pricing – No
+    # Obligation
+    # Trials](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405246782221
+    # ) for more details.
+    # See [Subscription
+    # States](https://maxio-chargify.zendesk.com/hc/en-us/articles/5404222005773
+    # ) for more info about subscription states and state transitions.
     # @return [Array[SubscriptionGroupItem]]
     attr_accessor :subscriptions
 
@@ -105,7 +310,8 @@ module AdvancedBilling
                    state = SKIP,
                    cancel_at_end_of_period = SKIP,
                    subscriptions = SKIP,
-                   payment_collection_method = CollectionMethod::AUTOMATIC)
+                   payment_collection_method = CollectionMethod::AUTOMATIC,
+                   additional_properties = {})
       @uid = uid unless uid == SKIP
       @scheme = scheme unless scheme == SKIP
       @customer_id = customer_id unless customer_id == SKIP
@@ -120,6 +326,11 @@ module AdvancedBilling
         @payment_collection_method =
           payment_collection_method
       end
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -136,8 +347,11 @@ module AdvancedBilling
         hash.key?('subscription_ids') ? hash['subscription_ids'] : SKIP
       primary_subscription_id =
         hash.key?('primary_subscription_id') ? hash['primary_subscription_id'] : SKIP
-      next_assessment_at =
-        hash.key?('next_assessment_at') ? hash['next_assessment_at'] : SKIP
+      next_assessment_at = if hash.key?('next_assessment_at')
+                             (DateTimeHelper.from_rfc3339(hash['next_assessment_at']) if hash['next_assessment_at'])
+                           else
+                             SKIP
+                           end
       state = hash.key?('state') ? hash['state'] : SKIP
       cancel_at_end_of_period =
         hash.key?('cancel_at_end_of_period') ? hash['cancel_at_end_of_period'] : SKIP
@@ -154,6 +368,9 @@ module AdvancedBilling
       payment_collection_method =
         hash['payment_collection_method'] ||= CollectionMethod::AUTOMATIC
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignupResponse.new(uid,
                                           scheme,
@@ -165,7 +382,12 @@ module AdvancedBilling
                                           state,
                                           cancel_at_end_of_period,
                                           subscriptions,
-                                          payment_collection_method)
+                                          payment_collection_method,
+                                          hash)
+    end
+
+    def to_custom_next_assessment_at
+      DateTimeHelper.to_rfc3339(next_assessment_at)
     end
   end
 end

data/lib/advanced_billing/models/subscription_group_signup_success.rb

@@ -36,9 +36,15 @@ module AdvancedBilling
     end
 
     def initialize(subscription_group = nil,
-                   customer = nil)
+                   customer = nil,
+                   additional_properties = {})
       @subscription_group = subscription_group
       @customer = customer
+
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -51,9 +57,13 @@ module AdvancedBilling
       end
       customer = Customer.from_hash(hash['customer']) if hash['customer']
 
+      # Clean out expected properties from Hash.
+      names.each_value { |k| hash.delete(k) }
+
       # Create object from extracted values.
       SubscriptionGroupSignupSuccess.new(subscription_group,
-                                         customer)
+                                         customer,
+                                         hash)
     end
 
     # Validates an instance of the object from a given value.