maxio-advanced-billing-sdk 7.0.1 → 8.0.0

data/lib/advanced_billing/models/component_custom_price.rb

@@ -35,6 +35,26 @@ module AdvancedBilling
     # @return [Array[Price]]
     attr_accessor :prices
 
+    # Applicable only to prepaid usage components. Controls whether the
+    # allocated quantity renews each period.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :renew_prepaid_allocation
+
+    # Applicable only to prepaid usage components. Controls whether remaining
+    # units roll over to the next period.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :rollover_prepaid_remainder
+
+    # Applicable only when rollover is enabled. Number of
+    # `expiration_interval_unit`s after which rollover amounts expire.
+    # @return [Integer]
+    attr_accessor :expiration_interval
+
+    # Applicable only when rollover is enabled. Interval unit for rollover
+    # expiration (month or day).
+    # @return [ExpirationIntervalUnit]
+    attr_accessor :expiration_interval_unit
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -43,6 +63,10 @@ module AdvancedBilling
       @_hash['interval'] = 'interval'
       @_hash['interval_unit'] = 'interval_unit'
       @_hash['prices'] = 'prices'
+      @_hash['renew_prepaid_allocation'] = 'renew_prepaid_allocation'
+      @_hash['rollover_prepaid_remainder'] = 'rollover_prepaid_remainder'
+      @_hash['expiration_interval'] = 'expiration_interval'
+      @_hash['expiration_interval_unit'] = 'expiration_interval_unit'
       @_hash
     end
 
@@ -53,6 +77,10 @@ module AdvancedBilling
         pricing_scheme
         interval
         interval_unit
+        renew_prepaid_allocation
+        rollover_prepaid_remainder
+        expiration_interval
+        expiration_interval_unit
       ]
     end
 
@@ -60,12 +88,16 @@ module AdvancedBilling
     def self.nullables
       %w[
         interval_unit
+        expiration_interval
+        expiration_interval_unit
       ]
     end
 
     def initialize(prices:, tax_included: SKIP, pricing_scheme: SKIP,
                    interval: SKIP, interval_unit: SKIP,
-                   additional_properties: {})
+                   renew_prepaid_allocation: SKIP,
+                   rollover_prepaid_remainder: SKIP, expiration_interval: SKIP,
+                   expiration_interval_unit: SKIP, additional_properties: {})
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
@@ -76,6 +108,13 @@ module AdvancedBilling
       @interval = interval unless interval == SKIP
       @interval_unit = interval_unit unless interval_unit == SKIP
       @prices = prices
+      @renew_prepaid_allocation = renew_prepaid_allocation unless renew_prepaid_allocation == SKIP
+      unless rollover_prepaid_remainder == SKIP
+        @rollover_prepaid_remainder =
+          rollover_prepaid_remainder
+      end
+      @expiration_interval = expiration_interval unless expiration_interval == SKIP
+      @expiration_interval_unit = expiration_interval_unit unless expiration_interval_unit == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -98,6 +137,14 @@ module AdvancedBilling
         hash.key?('pricing_scheme') ? hash['pricing_scheme'] : SKIP
       interval = hash.key?('interval') ? hash['interval'] : SKIP
       interval_unit = hash.key?('interval_unit') ? hash['interval_unit'] : SKIP
+      renew_prepaid_allocation =
+        hash.key?('renew_prepaid_allocation') ? hash['renew_prepaid_allocation'] : SKIP
+      rollover_prepaid_remainder =
+        hash.key?('rollover_prepaid_remainder') ? hash['rollover_prepaid_remainder'] : SKIP
+      expiration_interval =
+        hash.key?('expiration_interval') ? hash['expiration_interval'] : SKIP
+      expiration_interval_unit =
+        hash.key?('expiration_interval_unit') ? hash['expiration_interval_unit'] : SKIP
 
       # Clean out expected properties from Hash.
       additional_properties = hash.reject { |k, _| names.value?(k) }
@@ -108,6 +155,10 @@ module AdvancedBilling
                                pricing_scheme: pricing_scheme,
                                interval: interval,
                                interval_unit: interval_unit,
+                               renew_prepaid_allocation: renew_prepaid_allocation,
+                               rollover_prepaid_remainder: rollover_prepaid_remainder,
+                               expiration_interval: expiration_interval,
+                               expiration_interval_unit: expiration_interval_unit,
                                additional_properties: additional_properties)
     end
 
@@ -134,7 +185,10 @@ module AdvancedBilling
       class_name = self.class.name.split('::').last
       "<#{class_name} tax_included: #{@tax_included}, pricing_scheme: #{@pricing_scheme},"\
       " interval: #{@interval}, interval_unit: #{@interval_unit}, prices: #{@prices},"\
-      " additional_properties: #{get_additional_properties}>"
+      " renew_prepaid_allocation: #{@renew_prepaid_allocation}, rollover_prepaid_remainder:"\
+      " #{@rollover_prepaid_remainder}, expiration_interval: #{@expiration_interval},"\
+      " expiration_interval_unit: #{@expiration_interval_unit}, additional_properties:"\
+      " #{get_additional_properties}>"
     end
 
     # Provides a debugging-friendly string with detailed object information.
@@ -142,7 +196,11 @@ module AdvancedBilling
       class_name = self.class.name.split('::').last
       "<#{class_name} tax_included: #{@tax_included.inspect}, pricing_scheme:"\
       " #{@pricing_scheme.inspect}, interval: #{@interval.inspect}, interval_unit:"\
-      " #{@interval_unit.inspect}, prices: #{@prices.inspect}, additional_properties:"\
+      " #{@interval_unit.inspect}, prices: #{@prices.inspect}, renew_prepaid_allocation:"\
+      " #{@renew_prepaid_allocation.inspect}, rollover_prepaid_remainder:"\
+      " #{@rollover_prepaid_remainder.inspect}, expiration_interval:"\
+      " #{@expiration_interval.inspect}, expiration_interval_unit:"\
+      " #{@expiration_interval_unit.inspect}, additional_properties:"\
       " #{get_additional_properties}>"
     end
   end

data/lib/advanced_billing/models/component_kind.rb

@@ -28,5 +28,21 @@ module AdvancedBilling
 
       COMPONENT_KIND.include?(value)
     end
+
+    def self.from_value(value, default_value = METERED_COMPONENT)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'metered_component' then METERED_COMPONENT
+      when 'quantity_based_component' then QUANTITY_BASED_COMPONENT
+      when 'on_off_component' then ON_OFF_COMPONENT
+      when 'prepaid_usage_component' then PREPAID_USAGE_COMPONENT
+      when 'event_based_component' then EVENT_BASED_COMPONENT
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/compounding_strategy.rb

@@ -23,5 +23,18 @@ module AdvancedBilling
 
       COMPOUNDING_STRATEGY.include?(value)
     end
+
+    def self.from_value(value, default_value = COMPOUND)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'compound' then COMPOUND
+      when 'fullprice' then FULLPRICE
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/create_allocation.rb

@@ -68,8 +68,7 @@ module AdvancedBilling
 
     # This attribute is particularly useful when you need to align billing
     # events for different components on distinct schedules within a
-    # subscription. Please note this only works for site with Multifrequency
-    # enabled
+    # subscription. This only works for site with Multifrequency enabled.
     # @return [BillingSchedule]
     attr_accessor :billing_schedule
 

data/lib/advanced_billing/models/create_invoice_coupon.rb

@@ -13,6 +13,10 @@ module AdvancedBilling
     # @return [String]
     attr_accessor :code
 
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :subcode
+
     # TODO: Write general description for this method
     # @return [Object]
     attr_accessor :percentage
@@ -41,6 +45,7 @@ module AdvancedBilling
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['code'] = 'code'
+      @_hash['subcode'] = 'subcode'
       @_hash['percentage'] = 'percentage'
       @_hash['amount'] = 'amount'
       @_hash['description'] = 'description'
@@ -53,6 +58,7 @@ module AdvancedBilling
     def self.optionals
       %w[
         code
+        subcode
         percentage
         amount
         description
@@ -66,7 +72,7 @@ module AdvancedBilling
       []
     end
 
-    def initialize(code: SKIP, percentage: SKIP, amount: SKIP,
+    def initialize(code: SKIP, subcode: SKIP, percentage: SKIP, amount: SKIP,
                    description: SKIP, product_family_id: SKIP,
                    compounding_strategy: SKIP, additional_properties: {})
       # Add additional model properties to the instance.
@@ -75,6 +81,7 @@ module AdvancedBilling
       end
 
       @code = code unless code == SKIP
+      @subcode = subcode unless subcode == SKIP
       @percentage = percentage unless percentage == SKIP
       @amount = amount unless amount == SKIP
       @description = description unless description == SKIP
@@ -88,6 +95,7 @@ module AdvancedBilling
 
       # Extract variables from the hash.
       code = hash.key?('code') ? hash['code'] : SKIP
+      subcode = hash.key?('subcode') ? hash['subcode'] : SKIP
       percentage = hash.key?('percentage') ? APIHelper.deserialize_union_type(
         UnionTypeLookUp.get(:CreateInvoiceCouponPercentage), hash['percentage']
       ) : SKIP
@@ -106,6 +114,7 @@ module AdvancedBilling
 
       # Create object from extracted values.
       CreateInvoiceCoupon.new(code: code,
+                              subcode: subcode,
                               percentage: percentage,
                               amount: amount,
                               description: description,
@@ -127,8 +136,8 @@ module AdvancedBilling
     # Provides a human-readable string representation of the object.
     def to_s
       class_name = self.class.name.split('::').last
-      "<#{class_name} code: #{@code}, percentage: #{@percentage}, amount: #{@amount},"\
-      " description: #{@description}, product_family_id: #{@product_family_id},"\
+      "<#{class_name} code: #{@code}, subcode: #{@subcode}, percentage: #{@percentage}, amount:"\
+      " #{@amount}, description: #{@description}, product_family_id: #{@product_family_id},"\
       " compounding_strategy: #{@compounding_strategy}, additional_properties:"\
       " #{get_additional_properties}>"
     end
@@ -136,10 +145,10 @@ module AdvancedBilling
     # Provides a debugging-friendly string with detailed object information.
     def inspect
       class_name = self.class.name.split('::').last
-      "<#{class_name} code: #{@code.inspect}, percentage: #{@percentage.inspect}, amount:"\
-      " #{@amount.inspect}, description: #{@description.inspect}, product_family_id:"\
-      " #{@product_family_id.inspect}, compounding_strategy: #{@compounding_strategy.inspect},"\
-      " additional_properties: #{get_additional_properties}>"
+      "<#{class_name} code: #{@code.inspect}, subcode: #{@subcode.inspect}, percentage:"\
+      " #{@percentage.inspect}, amount: #{@amount.inspect}, description: #{@description.inspect},"\
+      " product_family_id: #{@product_family_id.inspect}, compounding_strategy:"\
+      " #{@compounding_strategy.inspect}, additional_properties: #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/create_invoice_item.rb

@@ -26,14 +26,14 @@ module AdvancedBilling
     attr_accessor :unit_price
 
     # Set to true to automatically calculate taxes. Site must be configured to
-    # use and calculate taxes.
-    # If using Avalara, a tax_code parameter must also be sent.
+    # use and calculate taxes. If using AvaTax, a tax_code parameter must also
+    # be sent.
     # @return [TrueClass | FalseClass]
     attr_accessor :taxable
 
-    # Set to true to automatically calculate taxes. Site must be configured to
-    # use and calculate taxes.
-    # If using Avalara, a tax_code parameter must also be sent.
+    # A string representing the tax code related to the product type. This is
+    # especially important when using AvaTax to tax based on locale. This
+    # attribute has a max length of 25 characters.
     # @return [String]
     attr_accessor :tax_code
 

data/lib/advanced_billing/models/create_invoice_status.rb

@@ -19,5 +19,18 @@ module AdvancedBilling
 
       CREATE_INVOICE_STATUS.include?(value)
     end
+
+    def self.from_value(value, default_value = DRAFT)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'draft' then DRAFT
+      when 'open' then OPEN
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/create_metafield.rb

@@ -19,11 +19,9 @@ module AdvancedBilling
     # @return [MetafieldScope]
     attr_accessor :scope
 
-    # Indicates how data should be added to the metafield. For example, a text
-    # type is just a string, so a given metafield of this type can have any
-    # value attached. On the other hand, dropdown and radio have a set of
-    # allowed values that can be input, and appear differently on a Public
-    # Signup Page. Defaults to 'text'
+    # Indicates the type of metafield. A text metafield allows any string value.
+    # Dropdown and radio metafields have a set of values that can be selected.
+    # Defaults to 'text'.
     # @return [MetafieldInput]
     attr_accessor :input_type
 

data/lib/advanced_billing/models/create_or_update_product.rb

@@ -26,8 +26,8 @@ module AdvancedBilling
     attr_accessor :accounting_code
 
     # Deprecated value that can be ignored unless you have legacy hosted pages.
-    # For Public Signup Page users, please read this attribute from under the
-    # signup page.
+    # For Public Signup Page users, read this attribute from under the signup
+    # page.
     # @return [TrueClass | FalseClass]
     attr_accessor :require_credit_card
 
@@ -60,9 +60,13 @@ module AdvancedBilling
     # @return [IntervalUnit]
     attr_accessor :trial_interval_unit
 
-    # A string representing the trial interval unit for this product, either
-    # month or day
-    # @return [String]
+    # Indicates how a trial is handled when the trail period ends and there is
+    # no credit card on file. For `no_obligation`, the subscription transitions
+    # to a Trial Ended state. Maxio will not send any emails or statements. For
+    # `payment_expected`, the subscription transitions to a Past Due state.
+    # Maxio will send normal dunning emails and statements according to your
+    # other settings.
+    # @return [TrialType]
     attr_accessor :trial_type
 
     # The numerical expiration interval. i.e. an expiration_interval of ‘30’
@@ -82,8 +86,8 @@ module AdvancedBilling
     attr_accessor :auto_create_signup_page
 
     # A string representing the tax code related to the product type. This is
-    # especially important when using the Avalara service to tax based on
-    # locale. This attribute has a max length of 10 characters.
+    # especially important when using AvaTax to tax based on locale. This
+    # attribute has a max length of 25 characters.
     # @return [String]
     attr_accessor :tax_code
 
@@ -130,6 +134,7 @@ module AdvancedBilling
     def self.nullables
       %w[
         trial_interval_unit
+        trial_type
         expiration_interval_unit
       ]
     end

data/lib/advanced_billing/models/create_payment_profile.rb

@@ -9,15 +9,15 @@ module AdvancedBilling
     SKIP = Object.new
     private_constant :SKIP
 
-    # Token received after sending billing informations using chargify.js.
+    # Token received after sending billing information using chargify.js.
     # @return [String]
     attr_accessor :chargify_token
 
-    # Token received after sending billing informations using chargify.js.
+    # Token received after sending billing information using chargify.js.
     # @return [Integer]
     attr_accessor :id
 
-    # Token received after sending billing informations using chargify.js.
+    # Token received after sending billing information using chargify.js.
     # @return [PaymentType]
     attr_accessor :payment_type
 
@@ -81,9 +81,9 @@ module AdvancedBilling
     # The credit card or bank account billing address country, required in
     # [ISO_3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
     # format (i.e. “US”). This value is merely passed through to the payment
-    # gateway. Some gateways require country codes in a specific format. Please
-    # check your gateway’s documentation. If creating an ACH subscription, only
-    # US is supported at this time.
+    # gateway. Some gateways require country codes in a specific format. Check
+    # your gateway’s documentation. If creating an ACH subscription, only US is
+    # supported at this time.
     # @return [String]
     attr_accessor :billing_country
 

data/lib/advanced_billing/models/create_prepayment_method.rb

@@ -40,5 +40,24 @@ module AdvancedBilling
 
       CREATE_PREPAYMENT_METHOD.include?(value)
     end
+
+    def self.from_value(value, default_value = CHECK)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'check' then CHECK
+      when 'cash' then CASH
+      when 'money_order' then MONEY_ORDER
+      when 'ach' then ACH
+      when 'paypal_account' then PAYPAL_ACCOUNT
+      when 'credit_card' then CREDIT_CARD
+      when 'credit_card_on_file' then CREDIT_CARD_ON_FILE
+      when 'other' then OTHER
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/create_product_price_point.rb

@@ -47,9 +47,13 @@ module AdvancedBilling
     # @return [IntervalUnit]
     attr_accessor :trial_interval_unit
 
-    # A string representing the trial interval unit for this product price
-    # point, either month or day
-    # @return [String]
+    # Indicates how a trial is handled when the trail period ends and there is
+    # no credit card on file. For `no_obligation`, the subscription transitions
+    # to a Trial Ended state. Maxio will not send any emails or statements. For
+    # `payment_expected`, the subscription transitions to a Past Due state.
+    # Maxio will send normal dunning emails and statements according to your
+    # other settings.
+    # @return [TrialType]
     attr_accessor :trial_type
 
     # The product price point initial charge, in integer cents
@@ -115,6 +119,7 @@ module AdvancedBilling
     # An array for nullable fields
     def self.nullables
       %w[
+        trial_type
         expiration_interval_unit
       ]
     end

data/lib/advanced_billing/models/create_signup_proforma_preview_include.rb

@@ -16,5 +16,11 @@ module AdvancedBilling
 
       CREATE_SIGNUP_PROFORMA_PREVIEW_INCLUDE.include?(value)
     end
+
+    def self.from_value(value, default_value = NEXT_PROFORMA_INVOICE)
+      return default_value if value.nil?
+
+      default_value
+    end
   end
 end

data/lib/advanced_billing/models/create_usage.rb

@@ -26,11 +26,15 @@ module AdvancedBilling
 
     # This attribute is particularly useful when you need to align billing
     # events for different components on distinct schedules within a
-    # subscription. Please note this only works for site with Multifrequency
-    # enabled
+    # subscription. This only works for site with Multifrequency enabled.
     # @return [BillingSchedule]
     attr_accessor :billing_schedule
 
+    # Create or update custom pricing unique to the subscription. Used in place
+    # of `price_point_id`.
+    # @return [ComponentCustomPrice]
+    attr_accessor :custom_price
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -38,6 +42,7 @@ module AdvancedBilling
       @_hash['price_point_id'] = 'price_point_id'
       @_hash['memo'] = 'memo'
       @_hash['billing_schedule'] = 'billing_schedule'
+      @_hash['custom_price'] = 'custom_price'
       @_hash
     end
 
@@ -48,6 +53,7 @@ module AdvancedBilling
         price_point_id
         memo
         billing_schedule
+        custom_price
       ]
     end
 
@@ -57,7 +63,8 @@ module AdvancedBilling
     end
 
     def initialize(quantity: SKIP, price_point_id: SKIP, memo: SKIP,
-                   billing_schedule: SKIP, additional_properties: {})
+                   billing_schedule: SKIP, custom_price: SKIP,
+                   additional_properties: {})
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
@@ -67,6 +74,7 @@ module AdvancedBilling
       @price_point_id = price_point_id unless price_point_id == SKIP
       @memo = memo unless memo == SKIP
       @billing_schedule = billing_schedule unless billing_schedule == SKIP
+      @custom_price = custom_price unless custom_price == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -80,6 +88,7 @@ module AdvancedBilling
       memo = hash.key?('memo') ? hash['memo'] : SKIP
       billing_schedule = BillingSchedule.from_hash(hash['billing_schedule']) if
         hash['billing_schedule']
+      custom_price = ComponentCustomPrice.from_hash(hash['custom_price']) if hash['custom_price']
 
       # Clean out expected properties from Hash.
       additional_properties = hash.reject { |k, _| names.value?(k) }
@@ -89,6 +98,7 @@ module AdvancedBilling
                       price_point_id: price_point_id,
                       memo: memo,
                       billing_schedule: billing_schedule,
+                      custom_price: custom_price,
                       additional_properties: additional_properties)
     end
 
@@ -96,16 +106,16 @@ module AdvancedBilling
     def to_s
       class_name = self.class.name.split('::').last
       "<#{class_name} quantity: #{@quantity}, price_point_id: #{@price_point_id}, memo: #{@memo},"\
-      " billing_schedule: #{@billing_schedule}, additional_properties:"\
-      " #{get_additional_properties}>"
+      " billing_schedule: #{@billing_schedule}, custom_price: #{@custom_price},"\
+      " additional_properties: #{get_additional_properties}>"
     end
 
     # Provides a debugging-friendly string with detailed object information.
     def inspect
       class_name = self.class.name.split('::').last
       "<#{class_name} quantity: #{@quantity.inspect}, price_point_id: #{@price_point_id.inspect},"\
-      " memo: #{@memo.inspect}, billing_schedule: #{@billing_schedule.inspect},"\
-      " additional_properties: #{get_additional_properties}>"
+      " memo: #{@memo.inspect}, billing_schedule: #{@billing_schedule.inspect}, custom_price:"\
+      " #{@custom_price.inspect}, additional_properties: #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/credit_card_vault.rb

@@ -113,5 +113,49 @@ module AdvancedBilling
 
       CREDIT_CARD_VAULT.include?(value)
     end
+
+    def self.from_value(value, default_value = ADYEN)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'adyen' then ADYEN
+      when 'authorizenet' then AUTHORIZENET
+      when 'beanstream' then BEANSTREAM
+      when 'blue_snap' then BLUE_SNAP
+      when 'bogus' then BOGUS
+      when 'braintree1' then BRAINTREE1
+      when 'braintree_blue' then BRAINTREE_BLUE
+      when 'checkout' then CHECKOUT
+      when 'cybersource' then CYBERSOURCE
+      when 'elavon' then ELAVON
+      when 'eway' then EWAY
+      when 'eway_rapid' then EWAY_RAPID
+      when 'eway_rapid_std' then EWAY_RAPID_STD
+      when 'firstdata' then FIRSTDATA
+      when 'forte' then FORTE
+      when 'litle' then LITLE
+      when 'maxio_payments' then MAXIO_PAYMENTS
+      when 'maxp' then MAXP
+      when 'moduslink' then MODUSLINK
+      when 'moneris' then MONERIS
+      when 'nmi' then NMI
+      when 'orbital' then ORBITAL
+      when 'payment_express' then PAYMENT_EXPRESS
+      when 'paymill' then PAYMILL
+      when 'paypal' then PAYPAL
+      when 'paypal_complete' then PAYPAL_COMPLETE
+      when 'pin' then PIN
+      when 'square' then SQUARE
+      when 'stripe' then STRIPE
+      when 'stripe_connect' then STRIPE_CONNECT
+      when 'trust_commerce' then TRUST_COMMERCE
+      when 'unipaas' then UNIPAAS
+      when 'wirecard' then WIRECARD
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/credit_note_status.rb

@@ -19,5 +19,18 @@ module AdvancedBilling
 
       CREDIT_NOTE_STATUS.include?(value)
     end
+
+    def self.from_value(value, default_value = OPEN)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'open' then OPEN
+      when 'applied' then APPLIED
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/credit_scheme.rb

@@ -22,5 +22,19 @@ module AdvancedBilling
 
       CREDIT_SCHEME.include?(value)
     end
+
+    def self.from_value(value, default_value = NONE)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'none' then NONE
+      when 'credit' then CREDIT
+      when 'refund' then REFUND
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/credit_type.rb

@@ -24,5 +24,19 @@ module AdvancedBilling
 
       CREDIT_TYPE.include?(value)
     end
+
+    def self.from_value(value, default_value = FULL)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'full' then FULL
+      when 'prorated' then PRORATED
+      when 'none' then NONE
+      else
+        default_value
+      end
+    end
   end
 end