Class: AdvancedBilling::FullSubscriptionGroupResponse

Inherits:

BaseModel

Object
CoreLibrary::BaseModel
BaseModel
AdvancedBilling::FullSubscriptionGroupResponse

show all

Defined in:: lib/advanced_billing/models/full_subscription_group_response.rb

Overview

FullSubscriptionGroupResponse Model.

Instance Attribute Summary collapse

#account_balances ⇒ SubscriptionGroupBalances

The state of a subscription.
#cancel_at_end_of_period ⇒ TrueClass | FalseClass

The state of a subscription.
#current_billing_amount_in_cents ⇒ Integer

The state of a subscription.
#customer ⇒ SubscriptionGroupCustomer

The state of a subscription.
#customer_id ⇒ Integer

TODO: Write general description for this method.
#next_assessment_at ⇒ DateTime

TODO: Write general description for this method.
#payment_profile_id ⇒ Integer

TODO: Write general description for this method.
#primary_subscription_id ⇒ Integer

TODO: Write general description for this method.
#scheme ⇒ Integer

TODO: Write general description for this method.
#state ⇒ SubscriptionState

The state of a subscription.
#subscription_ids ⇒ Array[Integer]

TODO: Write general description for this method.
#uid ⇒ String

TODO: Write general description for this method.

Class Method Summary collapse

.from_hash(hash) ⇒ Object

Creates an instance of the object from a hash.
.names ⇒ Object

A mapping from model property names to API property names.
.nullables ⇒ Object

An array for nullable fields.
.optionals ⇒ Object

An array for optional fields.

Instance Method Summary collapse

Methods inherited from BaseModel

#to_hash, #to_json

Constructor Details

#initialize(uid: SKIP, scheme: SKIP, customer_id: SKIP, payment_profile_id: SKIP, subscription_ids: SKIP, primary_subscription_id: SKIP, next_assessment_at: SKIP, state: SKIP, cancel_at_end_of_period: SKIP, current_billing_amount_in_cents: SKIP, customer: SKIP, account_balances: SKIP, additional_properties: {}) ⇒ `FullSubscriptionGroupResponse`

Returns a new instance of FullSubscriptionGroupResponse.

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 458

def initialize(uid: SKIP, scheme: SKIP, customer_id: SKIP,
               payment_profile_id: SKIP, subscription_ids: SKIP,
               primary_subscription_id: SKIP, next_assessment_at: SKIP,
               state: SKIP, cancel_at_end_of_period: SKIP,
               current_billing_amount_in_cents: SKIP, customer: SKIP,
               account_balances: SKIP, additional_properties: {})
  @uid = uid unless uid == SKIP
  @scheme = scheme unless scheme == SKIP
  @customer_id = customer_id unless customer_id == SKIP
  @payment_profile_id = payment_profile_id unless payment_profile_id == SKIP
  @subscription_ids = subscription_ids unless subscription_ids == SKIP
  @primary_subscription_id = primary_subscription_id unless primary_subscription_id == SKIP
  @next_assessment_at = next_assessment_at unless next_assessment_at == SKIP
  @state = state unless state == SKIP
  @cancel_at_end_of_period = cancel_at_end_of_period unless cancel_at_end_of_period == SKIP
  unless current_billing_amount_in_cents == SKIP
    @current_billing_amount_in_cents =
      current_billing_amount_in_cents
  end
  @customer = customer unless customer == SKIP
  @account_balances = account_balances unless account_balances == SKIP

  # Add additional model properties to the instance.
  additional_properties.each do |_name, _value|
    instance_variable_set("@#{_name}", _value)
  end
end

Instance Attribute Details

#account_balances ⇒ `SubscriptionGroupBalances`

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](maxio.zendesk.com/hc/en-us/articles/24287076583565-Dunni ng-Overview) 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](maxio.zendesk.com/hc/en-us/articles/24287076583565-Dunni ng-Overview) process without payment. See the [Reactivation](maxio.zendesk.com/hc/en-us/articles/24252109503629- Reactivating-and-Resuming) 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](maxio.zendesk.com/hc/en-us/articles/24261076617869-Product -Editing) for more details. See [Subscription States](maxio.zendesk.com/hc/en-us/articles/24252119027853-Subscri ption-States) for more info about subscription states and state transitions.

Returns:

(SubscriptionGroupBalances)



414
415
416

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 414

def account_balances
  @account_balances
end

#cancel_at_end_of_period ⇒ `TrueClass | FalseClass`

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

* `soft_failure` - Indicates that normal assessment/processing of the

* `unpaid` - Indicates an unpaid subscription. A subscription is

**End of Life States**

* `canceled` - Indicates a canceled subscription. This may happen at

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

* `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

Returns:

(TrueClass | FalseClass)



189
190
191

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 189

def cancel_at_end_of_period
  @cancel_at_end_of_period
end

#current_billing_amount_in_cents ⇒ `Integer`

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

* `soft_failure` - Indicates that normal assessment/processing of the

* `unpaid` - Indicates an unpaid subscription. A subscription is

**End of Life States**

* `canceled` - Indicates a canceled subscription. This may happen at

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

* `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

Returns:

(Integer)



264
265
266

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 264

def current_billing_amount_in_cents
  @current_billing_amount_in_cents
end

#customer ⇒ `SubscriptionGroupCustomer`

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

* `soft_failure` - Indicates that normal assessment/processing of the

* `unpaid` - Indicates an unpaid subscription. A subscription is

**End of Life States**

* `canceled` - Indicates a canceled subscription. This may happen at

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

* `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

Returns:

(SubscriptionGroupCustomer)



339
340
341

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 339

def customer
  @customer
end

#customer_id ⇒ `Integer`

TODO: Write general description for this method

Returns:

(Integer)



23
24
25

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 23

def customer_id
  @customer_id
end

#next_assessment_at ⇒ `DateTime`

TODO: Write general description for this method

Returns:

(DateTime)



39
40
41

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 39

def next_assessment_at
  @next_assessment_at
end

#payment_profile_id ⇒ `Integer`

TODO: Write general description for this method

Returns:

(Integer)



27
28
29

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 27

def payment_profile_id
  @payment_profile_id
end

#primary_subscription_id ⇒ `Integer`

TODO: Write general description for this method

Returns:

(Integer)



35
36
37

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 35

def primary_subscription_id
  @primary_subscription_id
end

#scheme ⇒ `Integer`

TODO: Write general description for this method

Returns:

(Integer)



19
20
21

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 19

def scheme
  @scheme
end

#state ⇒ `SubscriptionState`

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

* `soft_failure` - Indicates that normal assessment/processing of the

* `unpaid` - Indicates an unpaid subscription. A subscription is

**End of Life States**

* `canceled` - Indicates a canceled subscription. This may happen at

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

* `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

Returns:

(SubscriptionState)



114
115
116

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 114

def state
  @state
end

#subscription_ids ⇒ `Array[Integer]`

TODO: Write general description for this method

Returns:

(Array[Integer])



31
32
33

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 31

def subscription_ids
  @subscription_ids
end

#uid ⇒ `String`

TODO: Write general description for this method

Returns:

(String)



15
16
17

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 15

def uid
  @uid
end

Class Method Details

.from_hash(hash) ⇒ `Object`

Creates an instance of the object from a hash.

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 487

def self.from_hash(hash)
  return nil unless hash

  # Extract variables from the hash.
  uid = hash.key?('uid') ? hash['uid'] : SKIP
  scheme = hash.key?('scheme') ? hash['scheme'] : SKIP
  customer_id = hash.key?('customer_id') ? hash['customer_id'] : SKIP
  payment_profile_id =
    hash.key?('payment_profile_id') ? hash['payment_profile_id'] : SKIP
  subscription_ids =
    hash.key?('subscription_ids') ? hash['subscription_ids'] : SKIP
  primary_subscription_id =
    hash.key?('primary_subscription_id') ? hash['primary_subscription_id'] : 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
  current_billing_amount_in_cents =
    hash.key?('current_billing_amount_in_cents') ? hash['current_billing_amount_in_cents'] : SKIP
  customer = SubscriptionGroupCustomer.from_hash(hash['customer']) if hash['customer']
  account_balances = SubscriptionGroupBalances.from_hash(hash['account_balances']) if
    hash['account_balances']

  # Clean out expected properties from Hash.
  names.each_value { |k| hash.delete(k) }

  # Create object from extracted values.
  FullSubscriptionGroupResponse.new(uid: uid,
                                    scheme: scheme,
                                    customer_id: customer_id,
                                    payment_profile_id: payment_profile_id,
                                    subscription_ids: subscription_ids,
                                    primary_subscription_id: primary_subscription_id,
                                    next_assessment_at: next_assessment_at,
                                    state: state,
                                    cancel_at_end_of_period: cancel_at_end_of_period,
                                    current_billing_amount_in_cents: current_billing_amount_in_cents,
                                    customer: customer,
                                    account_balances: account_balances,
                                    additional_properties: hash)
end

.names ⇒ `Object`

A mapping from model property names to API property names.

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 417

def self.names
  @_hash = {} if @_hash.nil?
  @_hash['uid'] = 'uid'
  @_hash['scheme'] = 'scheme'
  @_hash['customer_id'] = 'customer_id'
  @_hash['payment_profile_id'] = 'payment_profile_id'
  @_hash['subscription_ids'] = 'subscription_ids'
  @_hash['primary_subscription_id'] = 'primary_subscription_id'
  @_hash['next_assessment_at'] = 'next_assessment_at'
  @_hash['state'] = 'state'
  @_hash['cancel_at_end_of_period'] = 'cancel_at_end_of_period'
  @_hash['current_billing_amount_in_cents'] =
    'current_billing_amount_in_cents'
  @_hash['customer'] = 'customer'
  @_hash['account_balances'] = 'account_balances'
  @_hash
end

.nullables ⇒ `Object`

An array for nullable fields



454
455
456

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 454

def self.nullables
  []
end

.optionals ⇒ `Object`

An array for optional fields

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 436

def self.optionals
  %w[
    uid
    scheme
    customer_id
    payment_profile_id
    subscription_ids
    primary_subscription_id
    next_assessment_at
    state
    cancel_at_end_of_period
    current_billing_amount_in_cents
    customer
    account_balances
  ]
end

Instance Method Details

#to_custom_next_assessment_at ⇒ `Object`



533
534
535

# File 'lib/advanced_billing/models/full_subscription_group_response.rb', line 533

def to_custom_next_assessment_at
  DateTimeHelper.to_rfc3339(next_assessment_at)
end

Class: AdvancedBilling::FullSubscriptionGroupResponse

Overview

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from BaseModel

Constructor Details

Instance Attribute Details

#account_balances ⇒ SubscriptionGroupBalances

#cancel_at_end_of_period ⇒ TrueClass | FalseClass

#current_billing_amount_in_cents ⇒ Integer

#customer ⇒ SubscriptionGroupCustomer

#customer_id ⇒ Integer

#next_assessment_at ⇒ DateTime

#payment_profile_id ⇒ Integer

#primary_subscription_id ⇒ Integer

#scheme ⇒ Integer

#state ⇒ SubscriptionState

#subscription_ids ⇒ Array[Integer]

#uid ⇒ String

Class Method Details

.from_hash(hash) ⇒ Object

.names ⇒ Object

.nullables ⇒ Object

.optionals ⇒ Object

Instance Method Details

#to_custom_next_assessment_at ⇒ Object

#account_balances ⇒ `SubscriptionGroupBalances`

#cancel_at_end_of_period ⇒ `TrueClass | FalseClass`

#current_billing_amount_in_cents ⇒ `Integer`

#customer ⇒ `SubscriptionGroupCustomer`

#customer_id ⇒ `Integer`

#next_assessment_at ⇒ `DateTime`

#payment_profile_id ⇒ `Integer`

#primary_subscription_id ⇒ `Integer`

#scheme ⇒ `Integer`

#state ⇒ `SubscriptionState`

#subscription_ids ⇒ `Array[Integer]`

#uid ⇒ `String`

.from_hash(hash) ⇒ `Object`

.names ⇒ `Object`

.nullables ⇒ `Object`

.optionals ⇒ `Object`

#to_custom_next_assessment_at ⇒ `Object`