recurly 2.18.24 → 3.0.0.beta.1

data/lib/recurly/resources/invoice.rb

@@ -0,0 +1,138 @@
+module Recurly
+  module Resources
+    class Invoice < Resource
+
+      # @!attribute account
+      #   @return [AccountMini]
+      define_attribute :account, :AccountMini
+
+      # @!attribute address
+      #   @return [Address]
+      define_attribute :address, :Address
+
+      # @!attribute balance
+      #   @return [Float] The outstanding balance remaining on this invoice.
+      define_attribute :balance, Float
+
+      # @!attribute closed_at
+      #   @return [DateTime] Date invoice was marked paid or failed.
+      define_attribute :closed_at, DateTime
+
+      # @!attribute collection_method
+      #   @return [String] An automatic invoice means a corresponding transaction is run using the account's billing information at the same time the invoice is created. Manual invoices are created without a corresponding transaction. The merchant must enter a manual payment transaction or have the customer pay the invoice with an automatic method, like credit card, PayPal, Amazon, or ACH bank payment.
+      define_attribute :collection_method, String, {:enum => ["automatic", "manual"]}
+
+      # @!attribute [r] created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime, {:read_only => true}
+
+      # @!attribute credit_payments
+      #   @return [Array[CreditPayment]] Credit payments
+      define_attribute :credit_payments, Array, {:item_type => :CreditPayment}
+
+      # @!attribute currency
+      #   @return [String] 3-letter ISO 4217 currency code.
+      define_attribute :currency, String
+
+      # @!attribute customer_notes
+      #   @return [String] This will default to the Customer Notes text specified on the Invoice Settings. Specify custom notes to add or override Customer Notes.
+      define_attribute :customer_notes, String
+
+      # @!attribute discount
+      #   @return [Float] Total discounts applied to this invoice.
+      define_attribute :discount, Float
+
+      # @!attribute due_at
+      #   @return [DateTime] Date invoice is due. This is the date the net terms are reached.
+      define_attribute :due_at, DateTime
+
+      # @!attribute [r] id
+      #   @return [String] Invoice ID
+      define_attribute :id, String, {:read_only => true}
+
+      # @!attribute line_items
+      #   @return [Array[LineItem]] Line items
+      define_attribute :line_items, Array, {:item_type => :LineItem}
+
+      # @!attribute net_terms
+      #   @return [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.
+      define_attribute :net_terms, Integer
+
+      # @!attribute number
+      #   @return [String] If VAT taxation and the Country Invoice Sequencing feature are enabled, invoices will have country-specific invoice numbers for invoices billed to EU countries (ex: FR1001). Non-EU invoices will continue to use the site-level invoice number sequence.
+      define_attribute :number, String
+
+      # @!attribute [r] object
+      #   @return [String] Object type
+      define_attribute :object, String, {:read_only => true}
+
+      # @!attribute origin
+      #   @return [String] The event that created the invoice.
+      define_attribute :origin, String, {:enum => ["purchase", "line_item_refund", "open_amount_refund", "renewal", "immediate_change", "termination", "credit", "gift_card", "write_off"]}
+
+      # @!attribute paid
+      #   @return [Float] The total amount of successful payments transaction on this invoice.
+      define_attribute :paid, Float
+
+      # @!attribute po_number
+      #   @return [String] For manual invoicing, this identifies the PO number associated with the subscription.
+      define_attribute :po_number, String
+
+      # @!attribute previous_invoice_id
+      #   @return [String] On refund invoices, this value will exist and show the invoice ID of the purchase invoice the refund was created from.
+      define_attribute :previous_invoice_id, String
+
+      # @!attribute refundable_amount
+      #   @return [Float] The refundable amount on a charge invoice. It will be null for all other invoices.
+      define_attribute :refundable_amount, Float
+
+      # @!attribute state
+      #   @return [String] Invoice state
+      define_attribute :state, String, {:enum => ["pending", "processing", "past_due", "paid", "failed"]}
+
+      # @!attribute subscription_ids
+      #   @return [Array[String]] If the invoice is charging or refunding for one or more subscriptions, these are their IDs.
+      define_attribute :subscription_ids, Array, {:item_type => String}
+
+      # @!attribute subtotal
+      #   @return [Float] The summation of charges, discounts, and credits, before tax.
+      define_attribute :subtotal, Float
+
+      # @!attribute tax
+      #   @return [Float] The total tax on this invoice.
+      define_attribute :tax, Float
+
+      # @!attribute tax_info
+      #   @return [TaxInfo]
+      define_attribute :tax_info, :TaxInfo
+
+      # @!attribute terms_and_conditions
+      #   @return [String] This will default to the Terms and Conditions text specified on the Invoice Settings page in your Recurly admin. Specify custom notes to add or override Terms and Conditions.
+      define_attribute :terms_and_conditions, String
+
+      # @!attribute total
+      #   @return [Float] The final total on this invoice. The summation of invoice charges, discounts, credits, and tax.
+      define_attribute :total, Float
+
+      # @!attribute transactions
+      #   @return [Array[Transaction]] Transactions
+      define_attribute :transactions, Array, {:item_type => :Transaction}
+
+      # @!attribute type
+      #   @return [String] Invoices are either charge, credit, or legacy invoices.
+      define_attribute :type, String, {:enum => ["charge", "credit", "legacy"]}
+
+      # @!attribute [r] updated_at
+      #   @return [DateTime] Last updated at
+      define_attribute :updated_at, DateTime, {:read_only => true}
+
+      # @!attribute vat_number
+      #   @return [String] VAT registration number for the customer on this invoice. This will come from the VAT Number field in the Billing Info or the Account Info depending on your tax settings and the invoice collection method.
+      define_attribute :vat_number, String
+
+      # @!attribute vat_reverse_charge_notes
+      #   @return [String] VAT Reverse Charge Notes only appear if you have EU VAT enabled or are using your own Avalara AvaTax account and the customer is in the EU, has a VAT number, and is in a different country than your own. This will default to the VAT Reverse Charge Notes text specified on the Tax Settings page in your Recurly admin, unless custom notes were created with the original subscription.
+      define_attribute :vat_reverse_charge_notes, String
+    end
+  end
+end

data/lib/recurly/resources/invoice_collection.rb

@@ -0,0 +1,18 @@
+module Recurly
+  module Resources
+    class InvoiceCollection < Resource
+
+      # @!attribute charge_invoice
+      #   @return [Invoice]
+      define_attribute :charge_invoice, :Invoice
+
+      # @!attribute credit_invoices
+      #   @return [Array[Invoice]] Credit invoices
+      define_attribute :credit_invoices, Array, {:item_type => :Invoice}
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+    end
+  end
+end

data/lib/recurly/resources/line_item.rb

@@ -0,0 +1,166 @@
+module Recurly
+  module Resources
+    class LineItem < Resource
+
+      # @!attribute account
+      #   @return [AccountMini]
+      define_attribute :account, :AccountMini
+
+      # @!attribute accounting_code
+      #   @return [String] Internal accounting code to help you reconcile your revenue to the correct ledger. Line items created as part of a subscription invoice will use the plan or add-on's accounting code, otherwise the value will only be present if you define an accounting code when creating the line item.
+      define_attribute :accounting_code, String
+
+      # @!attribute add_on_code
+      #   @return [String] If the line item is a charge or credit for an add-on, this is its code.
+      define_attribute :add_on_code, String
+
+      # @!attribute add_on_id
+      #   @return [String] If the line item is a charge or credit for an add-on this is its ID.
+      define_attribute :add_on_id, String
+
+      # @!attribute amount
+      #   @return [Float] `(quantity * unit_amount) - (discount + tax)`
+      define_attribute :amount, Float
+
+      # @!attribute created_at
+      #   @return [DateTime] When the line item was created.
+      define_attribute :created_at, DateTime
+
+      # @!attribute credit_applied
+      #   @return [Float] The amount of credit from this line item that was applied to the invoice.
+      define_attribute :credit_applied, Float
+
+      # @!attribute credit_reason_code
+      #   @return [String] The reason the credit was given when line item is `type=credit`.
+      define_attribute :credit_reason_code, String, {:enum => ["general", "service", "promotional", "refund", "gift_card", "write_off"]}
+
+      # @!attribute currency
+      #   @return [String] 3-letter ISO 4217 currency code.
+      define_attribute :currency, String
+
+      # @!attribute description
+      #   @return [String] Description that appears on the invoice. For subscription related items this will be filled in automatically.
+      define_attribute :description, String
+
+      # @!attribute discount
+      #   @return [Float] The discount applied to the line item.
+      define_attribute :discount, Float
+
+      # @!attribute end_date
+      #   @return [DateTime] If this date is provided, it indicates the end of a time range.
+      define_attribute :end_date, DateTime
+
+      # @!attribute id
+      #   @return [String] Line item ID
+      define_attribute :id, String
+
+      # @!attribute invoice_id
+      #   @return [String] Once the line item has been invoiced this will be the invoice's ID.
+      define_attribute :invoice_id, String
+
+      # @!attribute invoice_number
+      #   @return [String] Once the line item has been invoiced this will be the invoice's number. If VAT taxation and the Country Invoice Sequencing feature are enabled, invoices will have country-specific invoice numbers for invoices billed to EU countries (ex: FR1001). Non-EU invoices will continue to use the site-level invoice number sequence.
+      define_attribute :invoice_number, String
+
+      # @!attribute legacy_category
+      #   @return [String] Category to describe the role of a line item on a legacy invoice: - "charges" refers to charges being billed for on this invoice. - "credits" refers to refund or proration credits. This portion of the invoice can be considered a credit memo. - "applied_credits" refers to previous credits applied to this invoice. See their `original_line_item_invoice_id` to determine where the credit first originated. - "carryforwards" can be ignored. They exist to consume any remaining credit balance. A new credit with the same amount will be created and placed back on the account.
+      define_attribute :legacy_category, String, {:enum => ["charge", "credit", "applied_credit", "carryforward"]}
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+
+      # @!attribute origin
+      #   @return [String] A credit created from an original charge will have the value of the charge's origin.
+      define_attribute :origin, String, {:enum => ["plan", "plan_trial", "setup_fee", "add_on_trial", "add_on", "debit", "one_time", "credit", "coupon", "carryforward"]}
+
+      # @!attribute original_line_item_invoice_id
+      #   @return [String] The invoice where the credit originated. Will only have a value if the line item is a credit created from a previous credit, or if the credit was created from a charge refund.
+      define_attribute :original_line_item_invoice_id, String
+
+      # @!attribute plan_code
+      #   @return [String] If the line item is a charge or credit for a plan or add-on, this is the plan's code.
+      define_attribute :plan_code, String
+
+      # @!attribute plan_id
+      #   @return [String] If the line item is a charge or credit for a plan or add-on, this is the plan's ID.
+      define_attribute :plan_id, String
+
+      # @!attribute previous_line_item_id
+      #   @return [String] Will only have a value if the line item is a credit created from a previous credit, or if the credit was created from a charge refund.
+      define_attribute :previous_line_item_id, String
+
+      # @!attribute product_code
+      #   @return [String] For plan related line items this will be the plan's code, for add-on related line items it will be the add-on's code.
+      define_attribute :product_code, String
+
+      # @!attribute proration_rate
+      #   @return [Float] When a line item has been prorated, this is the rate of the proration. Proration rates were made available for line items created after March 30, 2017. For line items created prior to that date, the proration rate will be `null`, even if the line item was prorated.
+      define_attribute :proration_rate, Float
+
+      # @!attribute quantity
+      #   @return [Integer] This number will be multiplied by the unit amount to compute the subtotal before any discounts or taxes.
+      define_attribute :quantity, Integer
+
+      # @!attribute refund
+      #   @return [Boolean] Refund?
+      define_attribute :refund, :Boolean
+
+      # @!attribute refunded_quantity
+      #   @return [Integer] For refund charges, the quantity being refunded. For non-refund charges, the total quantity refunded (possibly over multiple refunds).
+      define_attribute :refunded_quantity, Integer
+
+      # @!attribute start_date
+      #   @return [DateTime] If an end date is present, this is value indicates the beginning of a billing time range. If no end date is present it indicates billing for a specific date.
+      define_attribute :start_date, DateTime
+
+      # @!attribute state
+      #   @return [String] Pending line items are charges or credits on an account that have not been applied to an invoice yet. Invoiced line items will always have an `invoice_id` value.
+      define_attribute :state, String, {:enum => ["pending", "invoiced"]}
+
+      # @!attribute subscription_id
+      #   @return [String] If the line item is a charge or credit for a subscription, this is its ID.
+      define_attribute :subscription_id, String
+
+      # @!attribute subtotal
+      #   @return [Float] `quantity * unit_amount`
+      define_attribute :subtotal, Float
+
+      # @!attribute tax
+      #   @return [Float] The tax amount for the line item.
+      define_attribute :tax, Float
+
+      # @!attribute tax_code
+      #   @return [String] Optional field for EU VAT merchants and Avalara AvaTax Pro merchants. If you are using Recurly's EU VAT feature, you can use values of unknown, physical, or digital. If you have your own AvaTax account configured, you can use Avalara tax codes to assign custom tax rules.
+      define_attribute :tax_code, String
+
+      # @!attribute tax_exempt
+      #   @return [Boolean] `true` exempts tax on charges, `false` applies tax on charges. If not defined, then defaults to the Plan and Site settings. This attribute does not work for credits (negative line items). Credits are always applied post-tax. Pre-tax discounts should use the Coupons feature.
+      define_attribute :tax_exempt, :Boolean
+
+      # @!attribute tax_info
+      #   @return [TaxInfo]
+      define_attribute :tax_info, :TaxInfo
+
+      # @!attribute taxable
+      #   @return [Boolean] `true` if the line item is taxable, `false` if it is not.
+      define_attribute :taxable, :Boolean
+
+      # @!attribute type
+      #   @return [String] Charges are positive line items that debit the account. Credits are negative line items that credit the account.
+      define_attribute :type, String, {:enum => ["charge", "credit"]}
+
+      # @!attribute unit_amount
+      #   @return [Float] Positive amount for a charge, negative amount for a credit.
+      define_attribute :unit_amount, Float
+
+      # @!attribute updated_at
+      #   @return [DateTime] When the line item was last changed.
+      define_attribute :updated_at, DateTime
+
+      # @!attribute uuid
+      #   @return [String] The UUID is useful for matching data with the CSV exports and building URLs into Recurly's UI.
+      define_attribute :uuid, String
+    end
+  end
+end

data/lib/recurly/resources/plan.rb

@@ -0,0 +1,86 @@
+module Recurly
+  module Resources
+    class Plan < Resource
+
+      # @!attribute accounting_code
+      #   @return [String] Accounting code for invoice line items for the plan. If no value is provided, it defaults to plan's code.
+      define_attribute :accounting_code, String
+
+      # @!attribute code
+      #   @return [String] Unique code to identify the plan. This is used in Hosted Payment Page URLs and in the invoice exports.
+      define_attribute :code, String
+
+      # @!attribute [r] created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime, {:read_only => true}
+
+      # @!attribute currencies
+      #   @return [Array[String]] Pricing
+      define_attribute :currencies, Array, {:item_type => String}
+
+      # @!attribute [r] deleted_at
+      #   @return [DateTime] Deleted at
+      define_attribute :deleted_at, DateTime, {:read_only => true}
+
+      # @!attribute description
+      #   @return [String] Optional description, not displayed.
+      define_attribute :description, String
+
+      # @!attribute hosted_pages
+      #   @return [Hash] Hosted pages settings
+      define_attribute :hosted_pages, Hash
+
+      # @!attribute [r] id
+      #   @return [String] Plan ID
+      define_attribute :id, String, {:read_only => true}
+
+      # @!attribute interval_length
+      #   @return [Integer] Length of the plan's billing interval in `interval_unit`.
+      define_attribute :interval_length, Integer
+
+      # @!attribute interval_unit
+      #   @return [String] Unit for the plan's billing interval.
+      define_attribute :interval_unit, String, {:enum => ["days", "months"]}
+
+      # @!attribute name
+      #   @return [String] This name describes your plan and will appear on the Hosted Payment Page and the subscriber's invoice.
+      define_attribute :name, String
+
+      # @!attribute [r] object
+      #   @return [String] Object type
+      define_attribute :object, String, {:read_only => true}
+
+      # @!attribute setup_fee_accounting_code
+      #   @return [String] Accounting code for invoice line items for the plan's setup fee. If no value is provided, it defaults to plan's accounting code.
+      define_attribute :setup_fee_accounting_code, String
+
+      # @!attribute [r] state
+      #   @return [String] The current state of the plan.
+      define_attribute :state, String, {:read_only => true, :enum => ["active", "inactive"]}
+
+      # @!attribute tax_code
+      #   @return [String] Optional field for EU VAT merchants and Avalara AvaTax Pro merchants. If you are using Recurly's EU VAT feature, you can use values of 'unknown', 'physical', or 'digital'. If you have your own AvaTax account configured, you can use Avalara tax codes to assign custom tax rules.
+      define_attribute :tax_code, String
+
+      # @!attribute tax_exempt
+      #   @return [Boolean] `true` exempts tax on the plan, `false` applies tax on the plan.
+      define_attribute :tax_exempt, :Boolean
+
+      # @!attribute total_billing_cycles
+      #   @return [Integer] Automatically terminate subscriptions after a defined number of billing cycles. Number of billing cycles before the plan automatically stops renewing, defaults to `null` for continuous, automatic renewal.
+      define_attribute :total_billing_cycles, Integer
+
+      # @!attribute trial_length
+      #   @return [Integer] Length of plan's trial period in `trial_units`. `0` means `no trial`.
+      define_attribute :trial_length, Integer
+
+      # @!attribute trial_unit
+      #   @return [String] Units for the plan's trial period.
+      define_attribute :trial_unit, String, {:enum => ["days", "months"]}
+
+      # @!attribute [r] updated_at
+      #   @return [DateTime] Last updated at
+      define_attribute :updated_at, DateTime, {:read_only => true}
+    end
+  end
+end

data/lib/recurly/resources/settings.rb

@@ -0,0 +1,18 @@
+module Recurly
+  module Resources
+    class Settings < Resource
+
+      # @!attribute [r] accepted_currencies
+      #   @return [Array[String]]
+      define_attribute :accepted_currencies, Array, {:item_type => String, :read_only => true}
+
+      # @!attribute [r] billing_address_requirement
+      #   @return [String] - full:      Full Address (Street, City, State, Postal Code and Country) - streetzip: Street and Postal Code only - zip:       Postal Code only - none:      No Address
+      define_attribute :billing_address_requirement, String, {:read_only => true, :enum => ["full", "streetzip", "zip", "none"]}
+
+      # @!attribute [r] default_currency
+      #   @return [String] The default 3-letter ISO 4217 currency code.
+      define_attribute :default_currency, String, {:read_only => true}
+    end
+  end
+end

data/lib/recurly/resources/shipping_address.rb

@@ -0,0 +1,74 @@
+module Recurly
+  module Resources
+    class ShippingAddress < Resource
+
+      # @!attribute [r] account_id
+      #   @return [String] Account ID
+      define_attribute :account_id, String, {:read_only => true}
+
+      # @!attribute city
+      #   @return [String]
+      define_attribute :city, String
+
+      # @!attribute company
+      #   @return [String]
+      define_attribute :company, String
+
+      # @!attribute country
+      #   @return [String] Country, 2-letter ISO code.
+      define_attribute :country, String
+
+      # @!attribute [r] created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime, {:read_only => true}
+
+      # @!attribute email
+      #   @return [String]
+      define_attribute :email, String
+
+      # @!attribute first_name
+      #   @return [String]
+      define_attribute :first_name, String
+
+      # @!attribute [r] id
+      #   @return [String] Shipping Address ID
+      define_attribute :id, String, {:read_only => true}
+
+      # @!attribute last_name
+      #   @return [String]
+      define_attribute :last_name, String
+
+      # @!attribute nickname
+      #   @return [String]
+      define_attribute :nickname, String
+
+      # @!attribute phone
+      #   @return [String]
+      define_attribute :phone, String
+
+      # @!attribute postal_code
+      #   @return [String] Zip or postal code.
+      define_attribute :postal_code, String
+
+      # @!attribute region
+      #   @return [String] State or province.
+      define_attribute :region, String
+
+      # @!attribute street1
+      #   @return [String]
+      define_attribute :street1, String
+
+      # @!attribute street2
+      #   @return [String]
+      define_attribute :street2, String
+
+      # @!attribute [r] updated_at
+      #   @return [DateTime] Updated at
+      define_attribute :updated_at, DateTime, {:read_only => true}
+
+      # @!attribute vat_number
+      #   @return [String]
+      define_attribute :vat_number, String
+    end
+  end
+end

data/lib/recurly/resources/site.rb

@@ -0,0 +1,46 @@
+module Recurly
+  module Resources
+    class Site < Resource
+
+      # @!attribute address
+      #   @return [Address]
+      define_attribute :address, :Address
+
+      # @!attribute [r] created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime, {:read_only => true}
+
+      # @!attribute [r] deleted_at
+      #   @return [DateTime] Deleted at
+      define_attribute :deleted_at, DateTime, {:read_only => true}
+
+      # @!attribute features
+      #   @return [Array[String]] A list of features enabled for the site.
+      define_attribute :features, Array, {:item_type => String}
+
+      # @!attribute [r] id
+      #   @return [String] Site ID
+      define_attribute :id, String, {:read_only => true}
+
+      # @!attribute [r] mode
+      #   @return [String] Mode
+      define_attribute :mode, String, {:read_only => true, :enum => ["development", "production", "sandbox"]}
+
+      # @!attribute [r] object
+      #   @return [String] Object type
+      define_attribute :object, String, {:read_only => true}
+
+      # @!attribute settings
+      #   @return [Settings]
+      define_attribute :settings, :Settings
+
+      # @!attribute [r] subdomain
+      #   @return [String]
+      define_attribute :subdomain, String, {:read_only => true}
+
+      # @!attribute [r] updated_at
+      #   @return [DateTime] Updated at
+      define_attribute :updated_at, DateTime, {:read_only => true}
+    end
+  end
+end

data/lib/recurly/resources/subscription.rb

@@ -0,0 +1,134 @@
+module Recurly
+  module Resources
+    class Subscription < Resource
+
+      # @!attribute account
+      #   @return [AccountMini]
+      define_attribute :account, :AccountMini
+
+      # @!attribute activated_at
+      #   @return [DateTime] Activated at
+      define_attribute :activated_at, DateTime
+
+      # @!attribute add_ons
+      #   @return [Array[SubscriptionAddOn]] Add-ons
+      define_attribute :add_ons, Array, {:item_type => :SubscriptionAddOn}
+
+      # @!attribute add_ons_total
+      #   @return [Float] Total price of add-ons
+      define_attribute :add_ons_total, Float
+
+      # @!attribute bank_account_authorized_at
+      #   @return [DateTime] Recurring subscriptions paid with ACH will have this attribute set. This timestamp is used for alerting customers to reauthorize in 3 years in accordance with NACHA rules. If a subscription becomes inactive or the billing info is no longer a bank account, this timestamp is cleared.
+      define_attribute :bank_account_authorized_at, DateTime
+
+      # @!attribute canceled_at
+      #   @return [DateTime] Canceled at
+      define_attribute :canceled_at, DateTime
+
+      # @!attribute collection_method
+      #   @return [String] Collection method
+      define_attribute :collection_method, String, {:enum => ["automatic", "manual"]}
+
+      # @!attribute coupon_redemptions
+      #   @return [Array[CouponRedemptionMini]] Coupon redemptions
+      define_attribute :coupon_redemptions, Array, {:item_type => :CouponRedemptionMini}
+
+      # @!attribute created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime
+
+      # @!attribute currency
+      #   @return [String] 3-letter ISO 4217 currency code.
+      define_attribute :currency, String
+
+      # @!attribute current_period_ends_at
+      #   @return [DateTime] Current billing period ends at
+      define_attribute :current_period_ends_at, DateTime
+
+      # @!attribute current_period_started_at
+      #   @return [DateTime] Current billing period started at
+      define_attribute :current_period_started_at, DateTime
+
+      # @!attribute customer_notes
+      #   @return [String] Customer notes
+      define_attribute :customer_notes, String
+
+      # @!attribute expiration_reason
+      #   @return [String] Expiration reason
+      define_attribute :expiration_reason, String
+
+      # @!attribute expires_at
+      #   @return [DateTime] Expires at
+      define_attribute :expires_at, DateTime
+
+      # @!attribute id
+      #   @return [String] Subscription ID
+      define_attribute :id, String
+
+      # @!attribute net_terms
+      #   @return [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.
+      define_attribute :net_terms, Integer
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+
+      # @!attribute pending_change
+      #   @return [SubscriptionChange]
+      define_attribute :pending_change, :SubscriptionChange
+
+      # @!attribute plan
+      #   @return [PlanMini]
+      define_attribute :plan, :PlanMini
+
+      # @!attribute po_number
+      #   @return [String] For manual invoicing, this identifies the PO number associated with the subscription.
+      define_attribute :po_number, String
+
+      # @!attribute quantity
+      #   @return [Integer] Subscription quantity
+      define_attribute :quantity, Integer
+
+      # @!attribute remaining_billing_cycles
+      #   @return [Integer] Remaining billing cycles
+      define_attribute :remaining_billing_cycles, Integer
+
+      # @!attribute shipping_address
+      #   @return [ShippingAddress]
+      define_attribute :shipping_address, :ShippingAddress
+
+      # @!attribute state
+      #   @return [String] State
+      define_attribute :state, String, {:enum => ["active", "canceled", "expired", "failed", "future", "paused"]}
+
+      # @!attribute subtotal
+      #   @return [Float] Estimated total, before tax.
+      define_attribute :subtotal, Float
+
+      # @!attribute terms_and_conditions
+      #   @return [String] Terms and conditions
+      define_attribute :terms_and_conditions, String
+
+      # @!attribute trial_ends_at
+      #   @return [DateTime] Trial period ends at
+      define_attribute :trial_ends_at, DateTime
+
+      # @!attribute trial_started_at
+      #   @return [DateTime] Trial period started at
+      define_attribute :trial_started_at, DateTime
+
+      # @!attribute unit_amount
+      #   @return [Float] Subscription unit price
+      define_attribute :unit_amount, Float
+
+      # @!attribute updated_at
+      #   @return [DateTime] Last updated at
+      define_attribute :updated_at, DateTime
+
+      # @!attribute uuid
+      #   @return [String] The UUID is useful for matching data with the CSV exports and building URLs into Recurly's UI.
+      define_attribute :uuid, String
+    end
+  end
+end