RecurlyClient.Types.SubscriptionChangeCreate

Contains the types generated from the schema SubscriptionChangeCreate

Documentation

data SubscriptionChangeCreate

Defines the object schema located at components.schemas.SubscriptionChangeCreate in the specification.

Constructors

SubscriptionChangeCreate

Fields

• subscriptionChangeCreateAdd_ons :: Maybe [SubscriptionAddOnUpdate]

  add_ons: If you provide a value for this field it will replace any existing add-ons. So, when adding or modifying an add-on, you need to include the existing subscription add-ons. Unchanged add-ons can be included just using the subscription add-on''s ID: `{"id": "abc123"}`. If this value is omitted your existing add-ons will be unaffected. To remove all existing add-ons, this value should be an empty array.'

  If a subscription add-on's `code` is supplied without the `id`, `{"code": "def456"}`, the subscription add-on attributes will be set to the current values of the plan add-on unless provided in the request.

  • If an `id` is passed, any attributes not passed in will pull from the existing subscription add-on
  • If a `code` is passed, any attributes not passed in will pull from the current values of the plan add-on
  • Attributes passed in as part of the request will override either of the above scenarios
• subscriptionChangeCreateBilling_info :: Maybe SubscriptionChangeBillingInfoCreate

  billing_info

• subscriptionChangeCreateCollection_method :: Maybe SubscriptionChangeCreateCollection_method

  collection_method

• subscriptionChangeCreateCoupon_codes :: Maybe [Text]

  coupon_codes: A list of coupon_codes to be redeemed on the subscription during the change. Only allowed if timeframe is now and you change something about the subscription that creates an invoice.

• subscriptionChangeCreateCustom_fields :: Maybe CustomFields

  custom_fields: 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.

• subscriptionChangeCreateNet_terms :: Maybe Int

  net_terms: Integer normally paired with `Net Terms Type` and representing the number of days past the current date (for `net` Net Terms Type) or days after the last day of the current month (for `eom` Net Terms Type) that the invoice will become past due. During a subscription change, it's not necessary to provide both the `Net Terms Type` and `Net Terms` parameters.

  For more information on how net terms work with `manual` collection visit our docs page (https://docs.recurly.com/docs/manual-payments#section-collection-terms) or visit (https://docs.recurly.com/docs/automatic-invoicing-terms#section-collection-terms) for information about net terms using `automatic` collection.

  Constraints:

  • Minimum of 0.0
• subscriptionChangeCreateNet_terms_type :: Maybe SubscriptionChangeCreateNet_terms_type

  net_terms_type: Optionally supplied string that may be either `net` or `eom` (end-of-month). When `net`, an invoice becomes past due the specified number of `Net Terms` days from the current date. When `eom` an invoice becomes past due the specified number of `Net Terms` days from the last day of the current month.

• subscriptionChangeCreatePlan_code :: Maybe Text

  plan_code: If you want to change to a new plan, you can provide the plan's code or id. If both are provided the `plan_id` will be used.

  Constraints:

  • Maximum length of 50
• subscriptionChangeCreatePlan_id :: Maybe Text

  plan_id: If you want to change to a new plan, you can provide the plan's code or id. If both are provided the `plan_id` will be used.

  Constraints:

  • Maximum length of 13
• subscriptionChangeCreatePo_number :: Maybe Text

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

  Constraints:

  • Maximum length of 50
• subscriptionChangeCreateProration_settings :: Maybe ProrationSettings

  proration_settings: Allows you to control how any resulting charges and credits will be calculated and prorated.

• subscriptionChangeCreateQuantity :: Maybe Int

  quantity: Optionally override the default quantity of 1.

  Constraints:

  • Minimum of 0.0
• subscriptionChangeCreateRamp_intervals :: Maybe [SubscriptionRampInterval]

  ramp_intervals: The new set of ramp intervals for the subscription.

• subscriptionChangeCreateRevenue_schedule_type :: Maybe SubscriptionChangeCreateRevenue_schedule_type

  revenue_schedule_type

• subscriptionChangeCreateShipping :: Maybe SubscriptionChangeShippingCreate

  shipping: Shipping addresses are tied to a customer's account. Each account can have up to 20 different shipping addresses, and if you have enabled multiple subscriptions per account, you can associate different shipping addresses to each subscription.

• subscriptionChangeCreateTax_inclusive :: Maybe Bool

  tax_inclusive: This field is deprecated. Please do not use it.

• subscriptionChangeCreateTimeframe :: Maybe SubscriptionChangeCreateTimeframe

  timeframe: The timeframe parameter controls when the upgrade or downgrade takes place. The subscription change can occur now, when the subscription is next billed, or when the subscription term ends. Generally, if you're performing an upgrade, you will want the change to occur immediately (now). If you're performing a downgrade, you should set the timeframe to `term_end` or `bill_date` so the change takes effect at a scheduled billing date. The `renewal` timeframe option is accepted as an alias for `term_end`.

• subscriptionChangeCreateTransaction_type :: Maybe SubscriptionChangeCreateTransaction_type

  transaction_type: An optional type designation for the payment gateway transaction created by this request. Supports 'moto' value, which is the acronym for mail order and telephone transactions.

• subscriptionChangeCreateUnit_amount :: Maybe Float

  unit_amount: Optionally, sets custom pricing for the subscription, overriding the plan's default unit amount. The subscription's current currency will be used.

  Constraints:

  • Maxium of 1000000.0
  • Minimum of 0.0

Instances

FromJSON SubscriptionChangeCreate

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

parseJSON :: Value -> Parser SubscriptionChangeCreate

parseJSONList :: Value -> Parser [SubscriptionChangeCreate]

ToJSON SubscriptionChangeCreate

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

toJSON :: SubscriptionChangeCreate -> Value

toEncoding :: SubscriptionChangeCreate -> Encoding

toJSONList :: [SubscriptionChangeCreate] -> Value

toEncodingList :: [SubscriptionChangeCreate] -> Encoding

Show SubscriptionChangeCreate

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

showsPrec :: Int -> SubscriptionChangeCreate -> ShowS

show :: SubscriptionChangeCreate -> String

showList :: [SubscriptionChangeCreate] -> ShowS

Eq SubscriptionChangeCreate

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

(==) :: SubscriptionChangeCreate -> SubscriptionChangeCreate -> Bool

(/=) :: SubscriptionChangeCreate -> SubscriptionChangeCreate -> Bool

mkSubscriptionChangeCreate :: SubscriptionChangeCreate

Create a new SubscriptionChangeCreate with all required fields.

data SubscriptionChangeCreateCollection_method

Defines the enum schema located at components.schemas.SubscriptionChangeCreate.properties.collection_method in the specification.

Constructors

SubscriptionChangeCreateCollection_methodOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

SubscriptionChangeCreateCollection_methodTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

SubscriptionChangeCreateCollection_methodEnumAutomatic

Represents the JSON value "automatic"

SubscriptionChangeCreateCollection_methodEnumManual

Represents the JSON value "manual"

Instances

FromJSON SubscriptionChangeCreateCollection_method

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

parseJSON :: Value -> Parser SubscriptionChangeCreateCollection_method

parseJSONList :: Value -> Parser [SubscriptionChangeCreateCollection_method]

ToJSON SubscriptionChangeCreateCollection_method

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

toJSON :: SubscriptionChangeCreateCollection_method -> Value

toEncoding :: SubscriptionChangeCreateCollection_method -> Encoding

toJSONList :: [SubscriptionChangeCreateCollection_method] -> Value

toEncodingList :: [SubscriptionChangeCreateCollection_method] -> Encoding

Show SubscriptionChangeCreateCollection_method

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

showsPrec :: Int -> SubscriptionChangeCreateCollection_method -> ShowS

show :: SubscriptionChangeCreateCollection_method -> String

showList :: [SubscriptionChangeCreateCollection_method] -> ShowS

Eq SubscriptionChangeCreateCollection_method

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

(==) :: SubscriptionChangeCreateCollection_method -> SubscriptionChangeCreateCollection_method -> Bool

(/=) :: SubscriptionChangeCreateCollection_method -> SubscriptionChangeCreateCollection_method -> Bool

data SubscriptionChangeCreateNet_terms_type

Defines the enum schema located at components.schemas.SubscriptionChangeCreate.properties.net_terms_type in the specification.

Optionally supplied string that may be either `net` or `eom` (end-of-month). When `net`, an invoice becomes past due the specified number of `Net Terms` days from the current date. When `eom` an invoice becomes past due the specified number of `Net Terms` days from the last day of the current month.

Constructors

SubscriptionChangeCreateNet_terms_typeOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

SubscriptionChangeCreateNet_terms_typeTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

SubscriptionChangeCreateNet_terms_typeEnumNet

Represents the JSON value "net"

SubscriptionChangeCreateNet_terms_typeEnumEom

Represents the JSON value "eom"

Instances

FromJSON SubscriptionChangeCreateNet_terms_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

parseJSON :: Value -> Parser SubscriptionChangeCreateNet_terms_type

parseJSONList :: Value -> Parser [SubscriptionChangeCreateNet_terms_type]

ToJSON SubscriptionChangeCreateNet_terms_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

toJSON :: SubscriptionChangeCreateNet_terms_type -> Value

toEncoding :: SubscriptionChangeCreateNet_terms_type -> Encoding

toJSONList :: [SubscriptionChangeCreateNet_terms_type] -> Value

toEncodingList :: [SubscriptionChangeCreateNet_terms_type] -> Encoding

Show SubscriptionChangeCreateNet_terms_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

showsPrec :: Int -> SubscriptionChangeCreateNet_terms_type -> ShowS

show :: SubscriptionChangeCreateNet_terms_type -> String

showList :: [SubscriptionChangeCreateNet_terms_type] -> ShowS

Eq SubscriptionChangeCreateNet_terms_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

(==) :: SubscriptionChangeCreateNet_terms_type -> SubscriptionChangeCreateNet_terms_type -> Bool

(/=) :: SubscriptionChangeCreateNet_terms_type -> SubscriptionChangeCreateNet_terms_type -> Bool

data SubscriptionChangeCreateRevenue_schedule_type

Defines the enum schema located at components.schemas.SubscriptionChangeCreate.properties.revenue_schedule_type in the specification.

Constructors

SubscriptionChangeCreateRevenue_schedule_typeOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

SubscriptionChangeCreateRevenue_schedule_typeTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

SubscriptionChangeCreateRevenue_schedule_typeEnumAt_range_end

Represents the JSON value "at_range_end"

SubscriptionChangeCreateRevenue_schedule_typeEnumAt_range_start

Represents the JSON value "at_range_start"

SubscriptionChangeCreateRevenue_schedule_typeEnumEvenly

Represents the JSON value "evenly"

SubscriptionChangeCreateRevenue_schedule_typeEnumNever

Represents the JSON value "never"

Instances

FromJSON SubscriptionChangeCreateRevenue_schedule_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

parseJSON :: Value -> Parser SubscriptionChangeCreateRevenue_schedule_type

parseJSONList :: Value -> Parser [SubscriptionChangeCreateRevenue_schedule_type]

ToJSON SubscriptionChangeCreateRevenue_schedule_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

toJSON :: SubscriptionChangeCreateRevenue_schedule_type -> Value

toEncoding :: SubscriptionChangeCreateRevenue_schedule_type -> Encoding

toJSONList :: [SubscriptionChangeCreateRevenue_schedule_type] -> Value

toEncodingList :: [SubscriptionChangeCreateRevenue_schedule_type] -> Encoding

Show SubscriptionChangeCreateRevenue_schedule_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

showsPrec :: Int -> SubscriptionChangeCreateRevenue_schedule_type -> ShowS

show :: SubscriptionChangeCreateRevenue_schedule_type -> String

showList :: [SubscriptionChangeCreateRevenue_schedule_type] -> ShowS

Eq SubscriptionChangeCreateRevenue_schedule_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

(==) :: SubscriptionChangeCreateRevenue_schedule_type -> SubscriptionChangeCreateRevenue_schedule_type -> Bool

(/=) :: SubscriptionChangeCreateRevenue_schedule_type -> SubscriptionChangeCreateRevenue_schedule_type -> Bool

data SubscriptionChangeCreateTimeframe

Defines the enum schema located at components.schemas.SubscriptionChangeCreate.properties.timeframe in the specification.

The timeframe parameter controls when the upgrade or downgrade takes place. The subscription change can occur now, when the subscription is next billed, or when the subscription term ends. Generally, if you're performing an upgrade, you will want the change to occur immediately (now). If you're performing a downgrade, you should set the timeframe to `term_end` or `bill_date` so the change takes effect at a scheduled billing date. The `renewal` timeframe option is accepted as an alias for `term_end`.

Constructors

SubscriptionChangeCreateTimeframeOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

SubscriptionChangeCreateTimeframeTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

SubscriptionChangeCreateTimeframeEnumBill_date

Represents the JSON value "bill_date"

SubscriptionChangeCreateTimeframeEnumNow

Represents the JSON value "now"

SubscriptionChangeCreateTimeframeEnumRenewal

Represents the JSON value "renewal"

SubscriptionChangeCreateTimeframeEnumTerm_end

Represents the JSON value "term_end"

Instances

FromJSON SubscriptionChangeCreateTimeframe

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

parseJSON :: Value -> Parser SubscriptionChangeCreateTimeframe

parseJSONList :: Value -> Parser [SubscriptionChangeCreateTimeframe]

ToJSON SubscriptionChangeCreateTimeframe

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

toJSON :: SubscriptionChangeCreateTimeframe -> Value

toEncoding :: SubscriptionChangeCreateTimeframe -> Encoding

toJSONList :: [SubscriptionChangeCreateTimeframe] -> Value

toEncodingList :: [SubscriptionChangeCreateTimeframe] -> Encoding

Show SubscriptionChangeCreateTimeframe

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

showsPrec :: Int -> SubscriptionChangeCreateTimeframe -> ShowS

show :: SubscriptionChangeCreateTimeframe -> String

showList :: [SubscriptionChangeCreateTimeframe] -> ShowS

Eq SubscriptionChangeCreateTimeframe

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

(==) :: SubscriptionChangeCreateTimeframe -> SubscriptionChangeCreateTimeframe -> Bool

(/=) :: SubscriptionChangeCreateTimeframe -> SubscriptionChangeCreateTimeframe -> Bool

data SubscriptionChangeCreateTransaction_type

Defines the enum schema located at components.schemas.SubscriptionChangeCreate.properties.transaction_type in the specification.

An optional type designation for the payment gateway transaction created by this request. Supports 'moto' value, which is the acronym for mail order and telephone transactions.

Constructors

SubscriptionChangeCreateTransaction_typeOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

SubscriptionChangeCreateTransaction_typeTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

SubscriptionChangeCreateTransaction_typeEnumMoto

Represents the JSON value "moto"

Instances

FromJSON SubscriptionChangeCreateTransaction_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

parseJSON :: Value -> Parser SubscriptionChangeCreateTransaction_type

parseJSONList :: Value -> Parser [SubscriptionChangeCreateTransaction_type]

ToJSON SubscriptionChangeCreateTransaction_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

toJSON :: SubscriptionChangeCreateTransaction_type -> Value

toEncoding :: SubscriptionChangeCreateTransaction_type -> Encoding

toJSONList :: [SubscriptionChangeCreateTransaction_type] -> Value

toEncodingList :: [SubscriptionChangeCreateTransaction_type] -> Encoding

Show SubscriptionChangeCreateTransaction_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

showsPrec :: Int -> SubscriptionChangeCreateTransaction_type -> ShowS

show :: SubscriptionChangeCreateTransaction_type -> String

showList :: [SubscriptionChangeCreateTransaction_type] -> ShowS

Eq SubscriptionChangeCreateTransaction_type

Defined in RecurlyClient.Types.SubscriptionChangeCreate

Methods

(==) :: SubscriptionChangeCreateTransaction_type -> SubscriptionChangeCreateTransaction_type -> Bool

(/=) :: SubscriptionChangeCreateTransaction_type -> SubscriptionChangeCreateTransaction_type -> Bool