mirror of
https://github.com/stripe/stripe-ruby.git
synced 2025-06-06 00:01:04 -04:00
740 lines
35 KiB
Ruby
740 lines
35 KiB
Ruby
# File generated from our OpenAPI spec
|
|
# frozen_string_literal: true
|
|
|
|
module Stripe
|
|
# Issue a credit note to adjust an invoice's amount after the invoice is finalized.
|
|
#
|
|
# Related guide: [Credit notes](https://stripe.com/docs/billing/invoices/credit-notes)
|
|
class CreditNote < APIResource
|
|
extend Stripe::APIOperations::Create
|
|
extend Stripe::APIOperations::List
|
|
include Stripe::APIOperations::Save
|
|
|
|
OBJECT_NAME = "credit_note"
|
|
def self.object_name
|
|
"credit_note"
|
|
end
|
|
|
|
class DiscountAmount < Stripe::StripeObject
|
|
# The amount, in cents (or local equivalent), of the discount.
|
|
attr_reader :amount
|
|
# The discount that was applied to get this discount amount.
|
|
attr_reader :discount
|
|
end
|
|
|
|
class PretaxCreditAmount < Stripe::StripeObject
|
|
# The amount, in cents (or local equivalent), of the pretax credit amount.
|
|
attr_reader :amount
|
|
# The credit balance transaction that was applied to get this pretax credit amount.
|
|
attr_reader :credit_balance_transaction
|
|
# The discount that was applied to get this pretax credit amount.
|
|
attr_reader :discount
|
|
# Type of the pretax credit amount referenced.
|
|
attr_reader :type
|
|
end
|
|
|
|
class Refund < Stripe::StripeObject
|
|
# Amount of the refund that applies to this credit note, in cents (or local equivalent).
|
|
attr_reader :amount_refunded
|
|
# ID of the refund.
|
|
attr_reader :refund
|
|
end
|
|
|
|
class ShippingCost < Stripe::StripeObject
|
|
class Tax < Stripe::StripeObject
|
|
# Amount of tax applied for this rate.
|
|
attr_reader :amount
|
|
# Tax rates can be applied to [invoices](/invoicing/taxes/tax-rates), [subscriptions](/billing/taxes/tax-rates) and [Checkout Sessions](/payments/checkout/use-manual-tax-rates) to collect tax.
|
|
#
|
|
# Related guide: [Tax rates](/billing/taxes/tax-rates)
|
|
attr_reader :rate
|
|
# The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
|
|
attr_reader :taxability_reason
|
|
# The amount on which tax is calculated, in cents (or local equivalent).
|
|
attr_reader :taxable_amount
|
|
end
|
|
# Total shipping cost before any taxes are applied.
|
|
attr_reader :amount_subtotal
|
|
# Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
|
|
attr_reader :amount_tax
|
|
# Total shipping cost after taxes are applied.
|
|
attr_reader :amount_total
|
|
# The ID of the ShippingRate for this invoice.
|
|
attr_reader :shipping_rate
|
|
# The taxes applied to the shipping rate.
|
|
attr_reader :taxes
|
|
end
|
|
|
|
class TotalTax < Stripe::StripeObject
|
|
class TaxRateDetails < Stripe::StripeObject
|
|
# Attribute for field tax_rate
|
|
attr_reader :tax_rate
|
|
end
|
|
# The amount of the tax, in cents (or local equivalent).
|
|
attr_reader :amount
|
|
# Whether this tax is inclusive or exclusive.
|
|
attr_reader :tax_behavior
|
|
# Additional details about the tax rate. Only present when `type` is `tax_rate_details`.
|
|
attr_reader :tax_rate_details
|
|
# The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
|
|
attr_reader :taxability_reason
|
|
# The amount on which tax is calculated, in cents (or local equivalent).
|
|
attr_reader :taxable_amount
|
|
# The type of tax information.
|
|
attr_reader :type
|
|
end
|
|
|
|
class ListParams < Stripe::RequestParams
|
|
class Created < Stripe::RequestParams
|
|
# Minimum value to filter by (exclusive)
|
|
attr_accessor :gt
|
|
# Minimum value to filter by (inclusive)
|
|
attr_accessor :gte
|
|
# Maximum value to filter by (exclusive)
|
|
attr_accessor :lt
|
|
# Maximum value to filter by (inclusive)
|
|
attr_accessor :lte
|
|
|
|
def initialize(gt: nil, gte: nil, lt: nil, lte: nil)
|
|
@gt = gt
|
|
@gte = gte
|
|
@lt = lt
|
|
@lte = lte
|
|
end
|
|
end
|
|
# Only return credit notes that were created during the given date interval.
|
|
attr_accessor :created
|
|
# Only return credit notes for the customer specified by this customer ID.
|
|
attr_accessor :customer
|
|
# Only return credit notes for the account specified by this account ID.
|
|
attr_accessor :customer_account
|
|
# A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
|
|
attr_accessor :ending_before
|
|
# Specifies which fields in the response should be expanded.
|
|
attr_accessor :expand
|
|
# Only return credit notes for the invoice specified by this invoice ID.
|
|
attr_accessor :invoice
|
|
# A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
|
|
attr_accessor :limit
|
|
# A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
|
|
attr_accessor :starting_after
|
|
|
|
def initialize(
|
|
created: nil,
|
|
customer: nil,
|
|
customer_account: nil,
|
|
ending_before: nil,
|
|
expand: nil,
|
|
invoice: nil,
|
|
limit: nil,
|
|
starting_after: nil
|
|
)
|
|
@created = created
|
|
@customer = customer
|
|
@customer_account = customer_account
|
|
@ending_before = ending_before
|
|
@expand = expand
|
|
@invoice = invoice
|
|
@limit = limit
|
|
@starting_after = starting_after
|
|
end
|
|
end
|
|
|
|
class CreateParams < Stripe::RequestParams
|
|
class Line < Stripe::RequestParams
|
|
class TaxAmount < Stripe::RequestParams
|
|
# The amount, in cents (or local equivalent), of the tax.
|
|
attr_accessor :amount
|
|
# The id of the tax rate for this tax amount. The tax rate must have been automatically created by Stripe.
|
|
attr_accessor :tax_rate
|
|
# The amount on which tax is calculated, in cents (or local equivalent).
|
|
attr_accessor :taxable_amount
|
|
|
|
def initialize(amount: nil, tax_rate: nil, taxable_amount: nil)
|
|
@amount = amount
|
|
@tax_rate = tax_rate
|
|
@taxable_amount = taxable_amount
|
|
end
|
|
end
|
|
# The line item amount to credit. Only valid when `type` is `invoice_line_item`. If invoice is set up with `automatic_tax[enabled]=true`, this amount is tax exclusive
|
|
attr_accessor :amount
|
|
# The description of the credit note line item. Only valid when the `type` is `custom_line_item`.
|
|
attr_accessor :description
|
|
# The invoice line item to credit. Only valid when the `type` is `invoice_line_item`.
|
|
attr_accessor :invoice_line_item
|
|
# The line item quantity to credit.
|
|
attr_accessor :quantity
|
|
# A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
|
|
attr_accessor :tax_amounts
|
|
# The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
|
|
attr_accessor :tax_rates
|
|
# Type of the credit note line item, one of `invoice_line_item` or `custom_line_item`
|
|
attr_accessor :type
|
|
# The integer unit amount in cents (or local equivalent) of the credit note line item. This `unit_amount` will be multiplied by the quantity to get the full amount to credit for this line item. Only valid when `type` is `custom_line_item`.
|
|
attr_accessor :unit_amount
|
|
# Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
|
|
attr_accessor :unit_amount_decimal
|
|
|
|
def initialize(
|
|
amount: nil,
|
|
description: nil,
|
|
invoice_line_item: nil,
|
|
quantity: nil,
|
|
tax_amounts: nil,
|
|
tax_rates: nil,
|
|
type: nil,
|
|
unit_amount: nil,
|
|
unit_amount_decimal: nil
|
|
)
|
|
@amount = amount
|
|
@description = description
|
|
@invoice_line_item = invoice_line_item
|
|
@quantity = quantity
|
|
@tax_amounts = tax_amounts
|
|
@tax_rates = tax_rates
|
|
@type = type
|
|
@unit_amount = unit_amount
|
|
@unit_amount_decimal = unit_amount_decimal
|
|
end
|
|
end
|
|
|
|
class Refund < Stripe::RequestParams
|
|
# Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
|
|
attr_accessor :amount_refunded
|
|
# ID of an existing refund to link this credit note to.
|
|
attr_accessor :refund
|
|
|
|
def initialize(amount_refunded: nil, refund: nil)
|
|
@amount_refunded = amount_refunded
|
|
@refund = refund
|
|
end
|
|
end
|
|
|
|
class ShippingCost < Stripe::RequestParams
|
|
# The ID of the shipping rate to use for this order.
|
|
attr_accessor :shipping_rate
|
|
|
|
def initialize(shipping_rate: nil)
|
|
@shipping_rate = shipping_rate
|
|
end
|
|
end
|
|
# The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :amount
|
|
# The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
|
|
attr_accessor :credit_amount
|
|
# The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF.
|
|
attr_accessor :effective_at
|
|
# Type of email to send to the customer, one of `credit_note` or `none` and the default is `credit_note`.
|
|
attr_accessor :email_type
|
|
# Specifies which fields in the response should be expanded.
|
|
attr_accessor :expand
|
|
# ID of the invoice.
|
|
attr_accessor :invoice
|
|
# Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :lines
|
|
# The credit note's memo appears on the credit note PDF.
|
|
attr_accessor :memo
|
|
# Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
|
|
attr_accessor :metadata
|
|
# The integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe.
|
|
attr_accessor :out_of_band_amount
|
|
# Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
|
|
attr_accessor :reason
|
|
# The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice.
|
|
attr_accessor :refund_amount
|
|
# Refunds to link to this credit note.
|
|
attr_accessor :refunds
|
|
# When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :shipping_cost
|
|
|
|
def initialize(
|
|
amount: nil,
|
|
credit_amount: nil,
|
|
effective_at: nil,
|
|
email_type: nil,
|
|
expand: nil,
|
|
invoice: nil,
|
|
lines: nil,
|
|
memo: nil,
|
|
metadata: nil,
|
|
out_of_band_amount: nil,
|
|
reason: nil,
|
|
refund_amount: nil,
|
|
refunds: nil,
|
|
shipping_cost: nil
|
|
)
|
|
@amount = amount
|
|
@credit_amount = credit_amount
|
|
@effective_at = effective_at
|
|
@email_type = email_type
|
|
@expand = expand
|
|
@invoice = invoice
|
|
@lines = lines
|
|
@memo = memo
|
|
@metadata = metadata
|
|
@out_of_band_amount = out_of_band_amount
|
|
@reason = reason
|
|
@refund_amount = refund_amount
|
|
@refunds = refunds
|
|
@shipping_cost = shipping_cost
|
|
end
|
|
end
|
|
|
|
class UpdateParams < Stripe::RequestParams
|
|
# Specifies which fields in the response should be expanded.
|
|
attr_accessor :expand
|
|
# Credit note memo.
|
|
attr_accessor :memo
|
|
# Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
|
|
attr_accessor :metadata
|
|
|
|
def initialize(expand: nil, memo: nil, metadata: nil)
|
|
@expand = expand
|
|
@memo = memo
|
|
@metadata = metadata
|
|
end
|
|
end
|
|
|
|
class PreviewParams < Stripe::RequestParams
|
|
class Line < Stripe::RequestParams
|
|
class TaxAmount < Stripe::RequestParams
|
|
# The amount, in cents (or local equivalent), of the tax.
|
|
attr_accessor :amount
|
|
# The id of the tax rate for this tax amount. The tax rate must have been automatically created by Stripe.
|
|
attr_accessor :tax_rate
|
|
# The amount on which tax is calculated, in cents (or local equivalent).
|
|
attr_accessor :taxable_amount
|
|
|
|
def initialize(amount: nil, tax_rate: nil, taxable_amount: nil)
|
|
@amount = amount
|
|
@tax_rate = tax_rate
|
|
@taxable_amount = taxable_amount
|
|
end
|
|
end
|
|
# The line item amount to credit. Only valid when `type` is `invoice_line_item`. If invoice is set up with `automatic_tax[enabled]=true`, this amount is tax exclusive
|
|
attr_accessor :amount
|
|
# The description of the credit note line item. Only valid when the `type` is `custom_line_item`.
|
|
attr_accessor :description
|
|
# The invoice line item to credit. Only valid when the `type` is `invoice_line_item`.
|
|
attr_accessor :invoice_line_item
|
|
# The line item quantity to credit.
|
|
attr_accessor :quantity
|
|
# A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
|
|
attr_accessor :tax_amounts
|
|
# The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
|
|
attr_accessor :tax_rates
|
|
# Type of the credit note line item, one of `invoice_line_item` or `custom_line_item`
|
|
attr_accessor :type
|
|
# The integer unit amount in cents (or local equivalent) of the credit note line item. This `unit_amount` will be multiplied by the quantity to get the full amount to credit for this line item. Only valid when `type` is `custom_line_item`.
|
|
attr_accessor :unit_amount
|
|
# Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
|
|
attr_accessor :unit_amount_decimal
|
|
|
|
def initialize(
|
|
amount: nil,
|
|
description: nil,
|
|
invoice_line_item: nil,
|
|
quantity: nil,
|
|
tax_amounts: nil,
|
|
tax_rates: nil,
|
|
type: nil,
|
|
unit_amount: nil,
|
|
unit_amount_decimal: nil
|
|
)
|
|
@amount = amount
|
|
@description = description
|
|
@invoice_line_item = invoice_line_item
|
|
@quantity = quantity
|
|
@tax_amounts = tax_amounts
|
|
@tax_rates = tax_rates
|
|
@type = type
|
|
@unit_amount = unit_amount
|
|
@unit_amount_decimal = unit_amount_decimal
|
|
end
|
|
end
|
|
|
|
class Refund < Stripe::RequestParams
|
|
# Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
|
|
attr_accessor :amount_refunded
|
|
# ID of an existing refund to link this credit note to.
|
|
attr_accessor :refund
|
|
|
|
def initialize(amount_refunded: nil, refund: nil)
|
|
@amount_refunded = amount_refunded
|
|
@refund = refund
|
|
end
|
|
end
|
|
|
|
class ShippingCost < Stripe::RequestParams
|
|
# The ID of the shipping rate to use for this order.
|
|
attr_accessor :shipping_rate
|
|
|
|
def initialize(shipping_rate: nil)
|
|
@shipping_rate = shipping_rate
|
|
end
|
|
end
|
|
# The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :amount
|
|
# The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
|
|
attr_accessor :credit_amount
|
|
# The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF.
|
|
attr_accessor :effective_at
|
|
# Type of email to send to the customer, one of `credit_note` or `none` and the default is `credit_note`.
|
|
attr_accessor :email_type
|
|
# Specifies which fields in the response should be expanded.
|
|
attr_accessor :expand
|
|
# ID of the invoice.
|
|
attr_accessor :invoice
|
|
# Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :lines
|
|
# The credit note's memo appears on the credit note PDF.
|
|
attr_accessor :memo
|
|
# Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
|
|
attr_accessor :metadata
|
|
# The integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe.
|
|
attr_accessor :out_of_band_amount
|
|
# Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
|
|
attr_accessor :reason
|
|
# The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice.
|
|
attr_accessor :refund_amount
|
|
# Refunds to link to this credit note.
|
|
attr_accessor :refunds
|
|
# When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :shipping_cost
|
|
|
|
def initialize(
|
|
amount: nil,
|
|
credit_amount: nil,
|
|
effective_at: nil,
|
|
email_type: nil,
|
|
expand: nil,
|
|
invoice: nil,
|
|
lines: nil,
|
|
memo: nil,
|
|
metadata: nil,
|
|
out_of_band_amount: nil,
|
|
reason: nil,
|
|
refund_amount: nil,
|
|
refunds: nil,
|
|
shipping_cost: nil
|
|
)
|
|
@amount = amount
|
|
@credit_amount = credit_amount
|
|
@effective_at = effective_at
|
|
@email_type = email_type
|
|
@expand = expand
|
|
@invoice = invoice
|
|
@lines = lines
|
|
@memo = memo
|
|
@metadata = metadata
|
|
@out_of_band_amount = out_of_band_amount
|
|
@reason = reason
|
|
@refund_amount = refund_amount
|
|
@refunds = refunds
|
|
@shipping_cost = shipping_cost
|
|
end
|
|
end
|
|
|
|
class ListPreviewLineItemsParams < Stripe::RequestParams
|
|
class Line < Stripe::RequestParams
|
|
class TaxAmount < Stripe::RequestParams
|
|
# The amount, in cents (or local equivalent), of the tax.
|
|
attr_accessor :amount
|
|
# The id of the tax rate for this tax amount. The tax rate must have been automatically created by Stripe.
|
|
attr_accessor :tax_rate
|
|
# The amount on which tax is calculated, in cents (or local equivalent).
|
|
attr_accessor :taxable_amount
|
|
|
|
def initialize(amount: nil, tax_rate: nil, taxable_amount: nil)
|
|
@amount = amount
|
|
@tax_rate = tax_rate
|
|
@taxable_amount = taxable_amount
|
|
end
|
|
end
|
|
# The line item amount to credit. Only valid when `type` is `invoice_line_item`. If invoice is set up with `automatic_tax[enabled]=true`, this amount is tax exclusive
|
|
attr_accessor :amount
|
|
# The description of the credit note line item. Only valid when the `type` is `custom_line_item`.
|
|
attr_accessor :description
|
|
# The invoice line item to credit. Only valid when the `type` is `invoice_line_item`.
|
|
attr_accessor :invoice_line_item
|
|
# The line item quantity to credit.
|
|
attr_accessor :quantity
|
|
# A list of up to 10 tax amounts for the credit note line item. Cannot be mixed with `tax_rates`.
|
|
attr_accessor :tax_amounts
|
|
# The tax rates which apply to the credit note line item. Only valid when the `type` is `custom_line_item` and cannot be mixed with `tax_amounts`.
|
|
attr_accessor :tax_rates
|
|
# Type of the credit note line item, one of `invoice_line_item` or `custom_line_item`
|
|
attr_accessor :type
|
|
# The integer unit amount in cents (or local equivalent) of the credit note line item. This `unit_amount` will be multiplied by the quantity to get the full amount to credit for this line item. Only valid when `type` is `custom_line_item`.
|
|
attr_accessor :unit_amount
|
|
# Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
|
|
attr_accessor :unit_amount_decimal
|
|
|
|
def initialize(
|
|
amount: nil,
|
|
description: nil,
|
|
invoice_line_item: nil,
|
|
quantity: nil,
|
|
tax_amounts: nil,
|
|
tax_rates: nil,
|
|
type: nil,
|
|
unit_amount: nil,
|
|
unit_amount_decimal: nil
|
|
)
|
|
@amount = amount
|
|
@description = description
|
|
@invoice_line_item = invoice_line_item
|
|
@quantity = quantity
|
|
@tax_amounts = tax_amounts
|
|
@tax_rates = tax_rates
|
|
@type = type
|
|
@unit_amount = unit_amount
|
|
@unit_amount_decimal = unit_amount_decimal
|
|
end
|
|
end
|
|
|
|
class Refund < Stripe::RequestParams
|
|
# Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
|
|
attr_accessor :amount_refunded
|
|
# ID of an existing refund to link this credit note to.
|
|
attr_accessor :refund
|
|
|
|
def initialize(amount_refunded: nil, refund: nil)
|
|
@amount_refunded = amount_refunded
|
|
@refund = refund
|
|
end
|
|
end
|
|
|
|
class ShippingCost < Stripe::RequestParams
|
|
# The ID of the shipping rate to use for this order.
|
|
attr_accessor :shipping_rate
|
|
|
|
def initialize(shipping_rate: nil)
|
|
@shipping_rate = shipping_rate
|
|
end
|
|
end
|
|
# The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :amount
|
|
# The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
|
|
attr_accessor :credit_amount
|
|
# The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF.
|
|
attr_accessor :effective_at
|
|
# Type of email to send to the customer, one of `credit_note` or `none` and the default is `credit_note`.
|
|
attr_accessor :email_type
|
|
# A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
|
|
attr_accessor :ending_before
|
|
# Specifies which fields in the response should be expanded.
|
|
attr_accessor :expand
|
|
# ID of the invoice.
|
|
attr_accessor :invoice
|
|
# A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
|
|
attr_accessor :limit
|
|
# Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :lines
|
|
# The credit note's memo appears on the credit note PDF.
|
|
attr_accessor :memo
|
|
# Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
|
|
attr_accessor :metadata
|
|
# The integer amount in cents (or local equivalent) representing the amount that is credited outside of Stripe.
|
|
attr_accessor :out_of_band_amount
|
|
# Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
|
|
attr_accessor :reason
|
|
# The integer amount in cents (or local equivalent) representing the amount to refund. If set, a refund will be created for the charge associated with the invoice.
|
|
attr_accessor :refund_amount
|
|
# Refunds to link to this credit note.
|
|
attr_accessor :refunds
|
|
# When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
|
|
attr_accessor :shipping_cost
|
|
# A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
|
|
attr_accessor :starting_after
|
|
|
|
def initialize(
|
|
amount: nil,
|
|
credit_amount: nil,
|
|
effective_at: nil,
|
|
email_type: nil,
|
|
ending_before: nil,
|
|
expand: nil,
|
|
invoice: nil,
|
|
limit: nil,
|
|
lines: nil,
|
|
memo: nil,
|
|
metadata: nil,
|
|
out_of_band_amount: nil,
|
|
reason: nil,
|
|
refund_amount: nil,
|
|
refunds: nil,
|
|
shipping_cost: nil,
|
|
starting_after: nil
|
|
)
|
|
@amount = amount
|
|
@credit_amount = credit_amount
|
|
@effective_at = effective_at
|
|
@email_type = email_type
|
|
@ending_before = ending_before
|
|
@expand = expand
|
|
@invoice = invoice
|
|
@limit = limit
|
|
@lines = lines
|
|
@memo = memo
|
|
@metadata = metadata
|
|
@out_of_band_amount = out_of_band_amount
|
|
@reason = reason
|
|
@refund_amount = refund_amount
|
|
@refunds = refunds
|
|
@shipping_cost = shipping_cost
|
|
@starting_after = starting_after
|
|
end
|
|
end
|
|
|
|
class VoidCreditNoteParams < Stripe::RequestParams
|
|
# Specifies which fields in the response should be expanded.
|
|
attr_accessor :expand
|
|
|
|
def initialize(expand: nil)
|
|
@expand = expand
|
|
end
|
|
end
|
|
# The integer amount in cents (or local equivalent) representing the total amount of the credit note, including tax.
|
|
attr_reader :amount
|
|
# This is the sum of all the shipping amounts.
|
|
attr_reader :amount_shipping
|
|
# Time at which the object was created. Measured in seconds since the Unix epoch.
|
|
attr_reader :created
|
|
# Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
|
|
attr_reader :currency
|
|
# ID of the customer.
|
|
attr_reader :customer
|
|
# ID of the account.
|
|
attr_reader :customer_account
|
|
# Customer balance transaction related to this credit note.
|
|
attr_reader :customer_balance_transaction
|
|
# The integer amount in cents (or local equivalent) representing the total amount of discount that was credited.
|
|
attr_reader :discount_amount
|
|
# The aggregate amounts calculated per discount for all line items.
|
|
attr_reader :discount_amounts
|
|
# The date when this credit note is in effect. Same as `created` unless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the credit note PDF.
|
|
attr_reader :effective_at
|
|
# Unique identifier for the object.
|
|
attr_reader :id
|
|
# ID of the invoice.
|
|
attr_reader :invoice
|
|
# Line items that make up the credit note
|
|
attr_reader :lines
|
|
# Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
|
|
attr_reader :livemode
|
|
# Customer-facing text that appears on the credit note PDF.
|
|
attr_reader :memo
|
|
# Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
|
|
attr_reader :metadata
|
|
# A unique number that identifies this particular credit note and appears on the PDF of the credit note and its associated invoice.
|
|
attr_reader :number
|
|
# String representing the object's type. Objects of the same type share the same value.
|
|
attr_reader :object
|
|
# Amount that was credited outside of Stripe.
|
|
attr_reader :out_of_band_amount
|
|
# The link to download the PDF of the credit note.
|
|
attr_reader :pdf
|
|
# The amount of the credit note that was refunded to the customer, credited to the customer's balance, credited outside of Stripe, or any combination thereof.
|
|
attr_reader :post_payment_amount
|
|
# The amount of the credit note by which the invoice's `amount_remaining` and `amount_due` were reduced.
|
|
attr_reader :pre_payment_amount
|
|
# The pretax credit amounts (ex: discount, credit grants, etc) for all line items.
|
|
attr_reader :pretax_credit_amounts
|
|
# Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
|
|
attr_reader :reason
|
|
# Refunds related to this credit note.
|
|
attr_reader :refunds
|
|
# The details of the cost of shipping, including the ShippingRate applied to the invoice.
|
|
attr_reader :shipping_cost
|
|
# Status of this credit note, one of `issued` or `void`. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
|
|
attr_reader :status
|
|
# The integer amount in cents (or local equivalent) representing the amount of the credit note, excluding exclusive tax and invoice level discounts.
|
|
attr_reader :subtotal
|
|
# The integer amount in cents (or local equivalent) representing the amount of the credit note, excluding all tax and invoice level discounts.
|
|
attr_reader :subtotal_excluding_tax
|
|
# The integer amount in cents (or local equivalent) representing the total amount of the credit note, including tax and all discount.
|
|
attr_reader :total
|
|
# The integer amount in cents (or local equivalent) representing the total amount of the credit note, excluding tax, but including discounts.
|
|
attr_reader :total_excluding_tax
|
|
# The aggregate tax information for all line items.
|
|
attr_reader :total_taxes
|
|
# Type of this credit note, one of `pre_payment` or `post_payment`. A `pre_payment` credit note means it was issued when the invoice was open. A `post_payment` credit note means it was issued when the invoice was paid.
|
|
attr_reader :type
|
|
# The time that the credit note was voided.
|
|
attr_reader :voided_at
|
|
|
|
# Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice's amount_remaining (and amount_due), but not below zero.
|
|
# This amount is indicated by the credit note's pre_payment_amount. The excess amount is indicated by post_payment_amount, and it can result in any combination of the following:
|
|
#
|
|
#
|
|
# Refunds: create a new refund (using refund_amount) or link existing refunds (using refunds).
|
|
# Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized.
|
|
# Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount).
|
|
#
|
|
#
|
|
# The sum of refunds, customer balance credits, and outside of Stripe credits must equal the post_payment_amount.
|
|
#
|
|
# You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
|
|
# post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.
|
|
def self.create(params = {}, opts = {})
|
|
request_stripe_object(method: :post, path: "/v1/credit_notes", params: params, opts: opts)
|
|
end
|
|
|
|
# Returns a list of credit notes.
|
|
def self.list(params = {}, opts = {})
|
|
request_stripe_object(method: :get, path: "/v1/credit_notes", params: params, opts: opts)
|
|
end
|
|
|
|
# When retrieving a credit note preview, you'll get a lines property containing the first handful of those items. This URL you can retrieve the full (paginated) list of line items.
|
|
def self.list_preview_line_items(params = {}, opts = {})
|
|
request_stripe_object(
|
|
method: :get,
|
|
path: "/v1/credit_notes/preview/lines",
|
|
params: params,
|
|
opts: opts
|
|
)
|
|
end
|
|
|
|
# Get a preview of a credit note without creating it.
|
|
def self.preview(params = {}, opts = {})
|
|
request_stripe_object(
|
|
method: :get,
|
|
path: "/v1/credit_notes/preview",
|
|
params: params,
|
|
opts: opts
|
|
)
|
|
end
|
|
|
|
# Updates an existing credit note.
|
|
def self.update(id, params = {}, opts = {})
|
|
request_stripe_object(
|
|
method: :post,
|
|
path: format("/v1/credit_notes/%<id>s", { id: CGI.escape(id) }),
|
|
params: params,
|
|
opts: opts
|
|
)
|
|
end
|
|
|
|
# Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
|
|
def void_credit_note(params = {}, opts = {})
|
|
request_stripe_object(
|
|
method: :post,
|
|
path: format("/v1/credit_notes/%<id>s/void", { id: CGI.escape(self["id"]) }),
|
|
params: params,
|
|
opts: opts
|
|
)
|
|
end
|
|
|
|
# Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
|
|
def self.void_credit_note(id, params = {}, opts = {})
|
|
request_stripe_object(
|
|
method: :post,
|
|
path: format("/v1/credit_notes/%<id>s/void", { id: CGI.escape(id) }),
|
|
params: params,
|
|
opts: opts
|
|
)
|
|
end
|
|
end
|
|
end
|