Class: Recurly::Requests::SubscriptionUpdate

Inherits:

Recurly::Request

• Object
• Recurly::Request
• Recurly::Requests::SubscriptionUpdate

Defined in:

lib/recurly/requests/subscription_update.rb

Instance Attribute Summary

• #auto_renew ⇒ Boolean

  Whether the subscription renews at the end of its term.

• #billing_info_id ⇒ String

  The billing_info_id is the value that represents a specific billing info for an end customer.

• #collection_method ⇒ String

  Change collection method.

• #credit_application_policy ⇒ CreditApplicationPolicy

  Controls whether credit invoices are automatically applied to new invoices.

• #custom_fields ⇒ Array[CustomField]

  The custom fields will only be altered when they are included in a request.

• #customer_notes ⇒ String

  Specify custom notes to add or override Customer Notes.

• #net_terms ⇒ Integer

  Integer representing the number of days after an invoice's creation that the invoice will become past due.

• #next_bill_date ⇒ DateTime

  If present, this sets the date the subscription's next billing period will start (current_period_ends_at).

• #po_number ⇒ String

  For manual invoicing, this identifies the PO number associated with the subscription.

• #remaining_billing_cycles ⇒ Integer

  The remaining billing cycles in the current term.

• #renewal_billing_cycles ⇒ Integer

  If auto_renew=true, when a term completes, total_billing_cycles takes this value as the length of subsequent terms.

• #revenue_schedule_type ⇒ String

  Revenue schedule type.

• #shipping ⇒ SubscriptionShippingUpdate

  Subscription shipping details.

• #tax_inclusive ⇒ Boolean

  This field is deprecated.

• #terms_and_conditions ⇒ String

  Specify custom notes to add or override Terms and Conditions.

• #vat_reverse_charge_notes ⇒ String

  Specify custom notes to add or override VAT reverse charge notes.

Attributes inherited from Recurly::Request

#attributes

Method Summary

Methods inherited from Recurly::Request

#==, #to_s

Methods included from Schema::SchemaFactory

#schema

Methods included from Schema::RequestCaster

#cast_request

Methods included from Schema::ResourceCaster

#cast

Methods included from Schema::SchemaValidator

#get_did_you_mean, #validate!, #validate_attribute!

Instance Attribute Details

#auto_renew ⇒ Boolean

Returns Whether the subscription renews at the end of its term.

Returns:

• (Boolean) —

  Whether the subscription renews at the end of its term.

# File 'lib/recurly/requests/subscription_update.rb', line 11

define_attribute :auto_renew, :Boolean

#billing_info_id ⇒ String

Returns The billing_info_id is the value that represents a specific billing info for an end customer. When billing_info_id is used to assign billing info to the subscription, all future billing events for the subscription will bill to the specified billing info. billing_info_id can ONLY be used for sites utilizing the Wallet feature.

Returns:

• (String) —

  The billing_info_id is the value that represents a specific billing info for an end customer. When billing_info_id is used to assign billing info to the subscription, all future billing events for the subscription will bill to the specified billing info. billing_info_id can ONLY be used for sites utilizing the Wallet feature.

# File 'lib/recurly/requests/subscription_update.rb', line 15

define_attribute :billing_info_id, String

#collection_method ⇒ String

Returns Change collection method.

Returns:

• (String) —

  Change collection method

# File 'lib/recurly/requests/subscription_update.rb', line 19

define_attribute :collection_method, String

#credit_application_policy ⇒ CreditApplicationPolicy

Returns Controls whether credit invoices are automatically applied to new invoices. The mode field determines the application behavior. When mode is all, the optional allowed_origins array can restrict which credit invoice origins are applied. - all: All available credit invoices are applied (default) - none: No credit invoices are applied automatically.

Returns:

• (CreditApplicationPolicy) —

  Controls whether credit invoices are automatically applied to new invoices. The mode field determines the application behavior. When mode is all, the optional allowed_origins array can restrict which credit invoice origins are applied. - all: All available credit invoices are applied (default) - none: No credit invoices are applied automatically

# File 'lib/recurly/requests/subscription_update.rb', line 23

define_attribute :credit_application_policy, :CreditApplicationPolicy

#custom_fields ⇒ Array[CustomField]

Returns The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.

Returns:

• (Array[CustomField]) —

  The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.

# File 'lib/recurly/requests/subscription_update.rb', line 27

define_attribute :custom_fields, Array, { :item_type => :CustomField }

#customer_notes ⇒ String

Returns Specify custom notes to add or override Customer Notes. Custom notes will stay with a subscription on all renewals.

Returns:

• (String) —

  Specify custom notes to add or override Customer Notes. Custom notes will stay with a subscription on all renewals.

# File 'lib/recurly/requests/subscription_update.rb', line 31

define_attribute :customer_notes, String

#net_terms ⇒ Integer

Returns Integer representing the number of days after an invoice's creation that the invoice will become past due. If an invoice's net terms are set to '0', it is due 'On Receipt' and will become past due 24 hours after it’s created. If an invoice is due net 30, it will become past due at 31 days exactly.

Returns:

• (Integer) —

  Integer representing the number of days after an invoice's creation that the invoice will become past due. If an invoice's net terms are set to '0', it is due 'On Receipt' and will become past due 24 hours after it’s created. If an invoice is due net 30, it will become past due at 31 days exactly.

# File 'lib/recurly/requests/subscription_update.rb', line 35

define_attribute :net_terms, Integer

#next_bill_date ⇒ DateTime

Returns If present, this sets the date the subscription's next billing period will start (current_period_ends_at). This can be used to align the subscription’s billing to a specific day of the month. For a subscription in a trial period, this will change when the trial expires. This parameter is useful for postponement of a subscription to change its billing date without proration.

Returns:

• (DateTime) —

  If present, this sets the date the subscription's next billing period will start (current_period_ends_at). This can be used to align the subscription’s billing to a specific day of the month. For a subscription in a trial period, this will change when the trial expires. This parameter is useful for postponement of a subscription to change its billing date without proration.

# File 'lib/recurly/requests/subscription_update.rb', line 39

define_attribute :next_bill_date, DateTime

#po_number ⇒ String

Returns For manual invoicing, this identifies the PO number associated with the subscription.

Returns:

• (String) —

  For manual invoicing, this identifies the PO number associated with the subscription.

# File 'lib/recurly/requests/subscription_update.rb', line 43

define_attribute :po_number, String

#remaining_billing_cycles ⇒ Integer

Returns The remaining billing cycles in the current term.

Returns:

• (Integer) —

  The remaining billing cycles in the current term.

# File 'lib/recurly/requests/subscription_update.rb', line 47

define_attribute :remaining_billing_cycles, Integer

#renewal_billing_cycles ⇒ Integer

Returns If auto_renew=true, when a term completes, total_billing_cycles takes this value as the length of subsequent terms. Defaults to the plan's total_billing_cycles.

Returns:

• (Integer) —

  If auto_renew=true, when a term completes, total_billing_cycles takes this value as the length of subsequent terms. Defaults to the plan's total_billing_cycles.

# File 'lib/recurly/requests/subscription_update.rb', line 51

define_attribute :renewal_billing_cycles, Integer

#revenue_schedule_type ⇒ String

Returns Revenue schedule type.

Returns:

• (String) —

  Revenue schedule type

# File 'lib/recurly/requests/subscription_update.rb', line 55

define_attribute :revenue_schedule_type, String

#shipping ⇒ SubscriptionShippingUpdate

Returns Subscription shipping details.

Returns:

• (SubscriptionShippingUpdate) —

  Subscription shipping details

# File 'lib/recurly/requests/subscription_update.rb', line 59

define_attribute :shipping, :SubscriptionShippingUpdate

#tax_inclusive ⇒ Boolean

Returns This field is deprecated. Please do not use it.

Returns:

• (Boolean) —

  This field is deprecated. Please do not use it.

# File 'lib/recurly/requests/subscription_update.rb', line 63

define_attribute :tax_inclusive, :Boolean

#terms_and_conditions ⇒ String

Returns Specify custom notes to add or override Terms and Conditions. Custom notes will stay with a subscription on all renewals.

Returns:

• (String) —

  Specify custom notes to add or override Terms and Conditions. Custom notes will stay with a subscription on all renewals.

# File 'lib/recurly/requests/subscription_update.rb', line 67

define_attribute :terms_and_conditions, String

#vat_reverse_charge_notes ⇒ String

Returns Specify custom notes to add or override VAT reverse charge notes. Custom notes will stay with a subscription on all renewals.

Returns:

• (String) —

  Specify custom notes to add or override VAT reverse charge notes. Custom notes will stay with a subscription on all renewals.

# File 'lib/recurly/requests/subscription_update.rb', line 71

define_attribute :vat_reverse_charge_notes, String