published on Friday, Aug 14, 2026 by Pulumi
published on Friday, Aug 14, 2026 by Pulumi
Subscriptions allow you to charge a customer on a recurring basis.
Related guide: Creating subscriptions
Create Subscription Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Subscription(name: string, args?: SubscriptionArgs, opts?: CustomResourceOptions);@overload
def Subscription(resource_name: str,
args: Optional[SubscriptionArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def Subscription(resource_name: str,
opts: Optional[ResourceOptions] = None,
add_invoice_items: Optional[Sequence[SubscriptionAddInvoiceItemArgs]] = None,
application_fee_percent: Optional[float] = None,
automatic_tax: Optional[SubscriptionAutomaticTaxArgs] = None,
backdate_start_date: Optional[float] = None,
billing_cycle_anchor: Optional[float] = None,
billing_cycle_anchor_config: Optional[SubscriptionBillingCycleAnchorConfigArgs] = None,
billing_mode: Optional[SubscriptionBillingModeArgs] = None,
billing_schedules: Optional[Sequence[SubscriptionBillingScheduleArgs]] = None,
billing_thresholds: Optional[SubscriptionBillingThresholdsArgs] = None,
cancel_at: Optional[float] = None,
cancel_at_period_end: Optional[bool] = None,
cancellation_details: Optional[SubscriptionCancellationDetailsArgs] = None,
collection_method: Optional[str] = None,
currency: Optional[str] = None,
customer: Optional[str] = None,
customer_account: Optional[str] = None,
days_until_due: Optional[float] = None,
default_payment_method: Optional[str] = None,
default_source: Optional[str] = None,
default_tax_rates: Optional[Sequence[str]] = None,
description: Optional[str] = None,
discounts: Optional[Sequence[SubscriptionDiscountArgs]] = None,
invoice_settings: Optional[SubscriptionInvoiceSettingsArgs] = None,
items: Optional[Sequence[SubscriptionItemArgs]] = None,
metadata: Optional[Mapping[str, str]] = None,
off_session: Optional[bool] = None,
on_behalf_of: Optional[str] = None,
pause_collection: Optional[SubscriptionPauseCollectionArgs] = None,
payment_behavior: Optional[str] = None,
payment_settings: Optional[SubscriptionPaymentSettingsArgs] = None,
pending_invoice_item_interval: Optional[SubscriptionPendingInvoiceItemIntervalArgs] = None,
proration_behavior: Optional[str] = None,
transfer_data: Optional[SubscriptionTransferDataArgs] = None,
trial_end: Optional[float] = None,
trial_from_plan: Optional[bool] = None,
trial_period_days: Optional[float] = None,
trial_settings: Optional[SubscriptionTrialSettingsArgs] = None)func NewSubscription(ctx *Context, name string, args *SubscriptionArgs, opts ...ResourceOption) (*Subscription, error)public Subscription(string name, SubscriptionArgs? args = null, CustomResourceOptions? opts = null)
public Subscription(String name, SubscriptionArgs args)
public Subscription(String name, SubscriptionArgs args, CustomResourceOptions options)
type: stripe:Subscription
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "stripe_subscription" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args SubscriptionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args SubscriptionArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args SubscriptionArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args SubscriptionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args SubscriptionArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var subscriptionResource = new Stripe.Subscription("subscriptionResource", new()
{
AddInvoiceItems = new[]
{
new Stripe.Inputs.SubscriptionAddInvoiceItemArgs
{
Discountable = false,
Discounts = new[]
{
new Stripe.Inputs.SubscriptionAddInvoiceItemDiscountArgs
{
Coupon = "string",
Discount = "string",
PromotionCode = "string",
},
},
Metadata =
{
{ "string", "string" },
},
Period = new Stripe.Inputs.SubscriptionAddInvoiceItemPeriodArgs
{
End = new Stripe.Inputs.SubscriptionAddInvoiceItemPeriodEndArgs
{
Type = "string",
Timestamp = 0.0,
},
Start = new Stripe.Inputs.SubscriptionAddInvoiceItemPeriodStartArgs
{
Type = "string",
Timestamp = 0.0,
},
},
Price = "string",
PriceData = new Stripe.Inputs.SubscriptionAddInvoiceItemPriceDataArgs
{
Currency = "string",
Product = "string",
TaxBehavior = "string",
UnitAmount = 0.0,
UnitAmountDecimal = 0.0,
},
Quantity = 0.0,
TaxRates = new[]
{
"string",
},
},
},
ApplicationFeePercent = 0.0,
AutomaticTax = new Stripe.Inputs.SubscriptionAutomaticTaxArgs
{
Enabled = false,
DisabledReason = "string",
Liability = new Stripe.Inputs.SubscriptionAutomaticTaxLiabilityArgs
{
Type = "string",
Account = "string",
},
},
BackdateStartDate = 0.0,
BillingCycleAnchor = 0.0,
BillingCycleAnchorConfig = new Stripe.Inputs.SubscriptionBillingCycleAnchorConfigArgs
{
DayOfMonth = 0.0,
Hour = 0.0,
Minute = 0.0,
Month = 0.0,
Second = 0.0,
},
BillingMode = new Stripe.Inputs.SubscriptionBillingModeArgs
{
Type = "string",
Flexible = new Stripe.Inputs.SubscriptionBillingModeFlexibleArgs
{
ProrationDiscounts = "string",
},
UpdatedAt = 0.0,
},
BillingSchedules = new[]
{
new Stripe.Inputs.SubscriptionBillingScheduleArgs
{
BillUntil = new Stripe.Inputs.SubscriptionBillingScheduleBillUntilArgs
{
Type = "string",
ComputedTimestamp = 0.0,
Duration = new Stripe.Inputs.SubscriptionBillingScheduleBillUntilDurationArgs
{
Interval = "string",
IntervalCount = 0.0,
},
Timestamp = 0.0,
},
AppliesTos = new[]
{
new Stripe.Inputs.SubscriptionBillingScheduleAppliesToArgs
{
Type = "string",
Price = "string",
},
},
Key = "string",
},
},
BillingThresholds = new Stripe.Inputs.SubscriptionBillingThresholdsArgs
{
AmountGte = 0.0,
ResetBillingCycleAnchor = false,
},
CancelAt = 0.0,
CancelAtPeriodEnd = false,
CancellationDetails = new Stripe.Inputs.SubscriptionCancellationDetailsArgs
{
Comment = "string",
Feedback = "string",
Reason = "string",
},
CollectionMethod = "string",
Currency = "string",
Customer = "string",
CustomerAccount = "string",
DaysUntilDue = 0.0,
DefaultPaymentMethod = "string",
DefaultSource = "string",
DefaultTaxRates = new[]
{
"string",
},
Description = "string",
Discounts = new[]
{
new Stripe.Inputs.SubscriptionDiscountArgs
{
Coupon = "string",
Discount = "string",
PromotionCode = "string",
},
},
InvoiceSettings = new Stripe.Inputs.SubscriptionInvoiceSettingsArgs
{
AccountTaxIds = new[]
{
"string",
},
Issuer = new Stripe.Inputs.SubscriptionInvoiceSettingsIssuerArgs
{
Type = "string",
Account = "string",
},
},
Items = new[]
{
new Stripe.Inputs.SubscriptionItemArgs
{
BillingThresholds = new Stripe.Inputs.SubscriptionItemBillingThresholdsArgs
{
UsageGte = 0.0,
},
Discounts = new[]
{
new Stripe.Inputs.SubscriptionItemDiscountArgs
{
Coupon = "string",
Discount = "string",
PromotionCode = "string",
},
},
Id = "string",
Metadata =
{
{ "string", "string" },
},
Price = "string",
PriceData = new Stripe.Inputs.SubscriptionItemPriceDataArgs
{
Currency = "string",
Product = "string",
Recurring = new Stripe.Inputs.SubscriptionItemPriceDataRecurringArgs
{
Interval = "string",
IntervalCount = 0.0,
},
TaxBehavior = "string",
UnitAmount = 0.0,
UnitAmountDecimal = 0.0,
},
Quantity = 0.0,
TaxRates = new[]
{
"string",
},
},
},
Metadata =
{
{ "string", "string" },
},
OffSession = false,
OnBehalfOf = "string",
PauseCollection = new Stripe.Inputs.SubscriptionPauseCollectionArgs
{
Behavior = "string",
ResumesAt = 0.0,
},
PaymentBehavior = "string",
PaymentSettings = new Stripe.Inputs.SubscriptionPaymentSettingsArgs
{
PaymentMethodOptions = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsArgs
{
AcssDebit = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitArgs
{
MandateOptions = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs
{
TransactionType = "string",
},
VerificationMethod = "string",
},
Bancontact = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsBancontactArgs
{
PreferredLanguage = "string",
},
Card = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsCardArgs
{
MandateOptions = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsCardMandateOptionsArgs
{
Amount = 0.0,
AmountType = "string",
Description = "string",
},
Network = "string",
RequestThreeDSecure = "string",
},
CustomerBalance = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceArgs
{
BankTransfer = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs
{
EuBankTransfer = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs
{
Country = "string",
},
Type = "string",
},
FundingType = "string",
},
Payto = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsPaytoArgs
{
MandateOptions = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs
{
Amount = 0.0,
AmountType = "string",
Purpose = "string",
},
},
Pix = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsPixArgs
{
ExpiresAfterSeconds = 0.0,
MandateOptions = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsPixMandateOptionsArgs
{
Amount = 0.0,
AmountIncludesIof = "string",
EndDate = "string",
PaymentSchedule = "string",
},
},
Upi = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsUpiArgs
{
MandateOptions = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs
{
Amount = 0.0,
AmountType = "string",
Description = "string",
EndDate = 0.0,
},
},
UsBankAccount = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountArgs
{
FinancialConnections = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs
{
Filters = new Stripe.Inputs.SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs
{
AccountSubcategories = new[]
{
"string",
},
},
Permissions = new[]
{
"string",
},
Prefetches = new[]
{
"string",
},
},
VerificationMethod = "string",
},
},
PaymentMethodTypes = new[]
{
"string",
},
SaveDefaultPaymentMethod = "string",
},
PendingInvoiceItemInterval = new Stripe.Inputs.SubscriptionPendingInvoiceItemIntervalArgs
{
Interval = "string",
IntervalCount = 0.0,
},
ProrationBehavior = "string",
TransferData = new Stripe.Inputs.SubscriptionTransferDataArgs
{
Destination = "string",
AmountPercent = 0.0,
},
TrialEnd = 0.0,
TrialFromPlan = false,
TrialPeriodDays = 0.0,
TrialSettings = new Stripe.Inputs.SubscriptionTrialSettingsArgs
{
EndBehavior = new Stripe.Inputs.SubscriptionTrialSettingsEndBehaviorArgs
{
MissingPaymentMethod = "string",
},
},
});
example, err := stripe.NewSubscription(ctx, "subscriptionResource", &stripe.SubscriptionArgs{
AddInvoiceItems: stripe.SubscriptionAddInvoiceItemArray{
&stripe.SubscriptionAddInvoiceItemArgs{
Discountable: pulumi.Bool(false),
Discounts: stripe.SubscriptionAddInvoiceItemDiscountArray{
&stripe.SubscriptionAddInvoiceItemDiscountArgs{
Coupon: pulumi.String("string"),
Discount: pulumi.String("string"),
PromotionCode: pulumi.String("string"),
},
},
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
Period: &stripe.SubscriptionAddInvoiceItemPeriodArgs{
End: &stripe.SubscriptionAddInvoiceItemPeriodEndArgs{
Type: pulumi.String("string"),
Timestamp: pulumi.Float64(0),
},
Start: &stripe.SubscriptionAddInvoiceItemPeriodStartArgs{
Type: pulumi.String("string"),
Timestamp: pulumi.Float64(0),
},
},
Price: pulumi.String("string"),
PriceData: &stripe.SubscriptionAddInvoiceItemPriceDataArgs{
Currency: pulumi.String("string"),
Product: pulumi.String("string"),
TaxBehavior: pulumi.String("string"),
UnitAmount: pulumi.Float64(0),
UnitAmountDecimal: pulumi.Float64(0),
},
Quantity: pulumi.Float64(0),
TaxRates: pulumi.StringArray{
pulumi.String("string"),
},
},
},
ApplicationFeePercent: pulumi.Float64(0),
AutomaticTax: &stripe.SubscriptionAutomaticTaxArgs{
Enabled: pulumi.Bool(false),
DisabledReason: pulumi.String("string"),
Liability: &stripe.SubscriptionAutomaticTaxLiabilityArgs{
Type: pulumi.String("string"),
Account: pulumi.String("string"),
},
},
BackdateStartDate: pulumi.Float64(0),
BillingCycleAnchor: pulumi.Float64(0),
BillingCycleAnchorConfig: &stripe.SubscriptionBillingCycleAnchorConfigArgs{
DayOfMonth: pulumi.Float64(0),
Hour: pulumi.Float64(0),
Minute: pulumi.Float64(0),
Month: pulumi.Float64(0),
Second: pulumi.Float64(0),
},
BillingMode: &stripe.SubscriptionBillingModeArgs{
Type: pulumi.String("string"),
Flexible: &stripe.SubscriptionBillingModeFlexibleArgs{
ProrationDiscounts: pulumi.String("string"),
},
UpdatedAt: pulumi.Float64(0),
},
BillingSchedules: stripe.SubscriptionBillingScheduleArray{
&stripe.SubscriptionBillingScheduleArgs{
BillUntil: &stripe.SubscriptionBillingScheduleBillUntilArgs{
Type: pulumi.String("string"),
ComputedTimestamp: pulumi.Float64(0),
Duration: &stripe.SubscriptionBillingScheduleBillUntilDurationArgs{
Interval: pulumi.String("string"),
IntervalCount: pulumi.Float64(0),
},
Timestamp: pulumi.Float64(0),
},
AppliesTos: stripe.SubscriptionBillingScheduleAppliesToArray{
&stripe.SubscriptionBillingScheduleAppliesToArgs{
Type: pulumi.String("string"),
Price: pulumi.String("string"),
},
},
Key: pulumi.String("string"),
},
},
BillingThresholds: &stripe.SubscriptionBillingThresholdsArgs{
AmountGte: pulumi.Float64(0),
ResetBillingCycleAnchor: pulumi.Bool(false),
},
CancelAt: pulumi.Float64(0),
CancelAtPeriodEnd: pulumi.Bool(false),
CancellationDetails: &stripe.SubscriptionCancellationDetailsArgs{
Comment: pulumi.String("string"),
Feedback: pulumi.String("string"),
Reason: pulumi.String("string"),
},
CollectionMethod: pulumi.String("string"),
Currency: pulumi.String("string"),
Customer: pulumi.String("string"),
CustomerAccount: pulumi.String("string"),
DaysUntilDue: pulumi.Float64(0),
DefaultPaymentMethod: pulumi.String("string"),
DefaultSource: pulumi.String("string"),
DefaultTaxRates: pulumi.StringArray{
pulumi.String("string"),
},
Description: pulumi.String("string"),
Discounts: stripe.SubscriptionDiscountArray{
&stripe.SubscriptionDiscountArgs{
Coupon: pulumi.String("string"),
Discount: pulumi.String("string"),
PromotionCode: pulumi.String("string"),
},
},
InvoiceSettings: &stripe.SubscriptionInvoiceSettingsArgs{
AccountTaxIds: pulumi.StringArray{
pulumi.String("string"),
},
Issuer: &stripe.SubscriptionInvoiceSettingsIssuerArgs{
Type: pulumi.String("string"),
Account: pulumi.String("string"),
},
},
Items: stripe.SubscriptionItemTypeArray{
&stripe.SubscriptionItemTypeArgs{
BillingThresholds: &stripe.SubscriptionItemBillingThresholdsArgs{
UsageGte: pulumi.Float64(0),
},
Discounts: stripe.SubscriptionItemDiscountArray{
&stripe.SubscriptionItemDiscountArgs{
Coupon: pulumi.String("string"),
Discount: pulumi.String("string"),
PromotionCode: pulumi.String("string"),
},
},
Id: pulumi.String("string"),
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
Price: pulumi.String("string"),
PriceData: &stripe.SubscriptionItemPriceDataArgs{
Currency: pulumi.String("string"),
Product: pulumi.String("string"),
Recurring: &stripe.SubscriptionItemPriceDataRecurringArgs{
Interval: pulumi.String("string"),
IntervalCount: pulumi.Float64(0),
},
TaxBehavior: pulumi.String("string"),
UnitAmount: pulumi.Float64(0),
UnitAmountDecimal: pulumi.Float64(0),
},
Quantity: pulumi.Float64(0),
TaxRates: pulumi.StringArray{
pulumi.String("string"),
},
},
},
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
OffSession: pulumi.Bool(false),
OnBehalfOf: pulumi.String("string"),
PauseCollection: &stripe.SubscriptionPauseCollectionArgs{
Behavior: pulumi.String("string"),
ResumesAt: pulumi.Float64(0),
},
PaymentBehavior: pulumi.String("string"),
PaymentSettings: &stripe.SubscriptionPaymentSettingsArgs{
PaymentMethodOptions: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsArgs{
AcssDebit: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitArgs{
MandateOptions: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs{
TransactionType: pulumi.String("string"),
},
VerificationMethod: pulumi.String("string"),
},
Bancontact: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsBancontactArgs{
PreferredLanguage: pulumi.String("string"),
},
Card: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsCardArgs{
MandateOptions: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsCardMandateOptionsArgs{
Amount: pulumi.Float64(0),
AmountType: pulumi.String("string"),
Description: pulumi.String("string"),
},
Network: pulumi.String("string"),
RequestThreeDSecure: pulumi.String("string"),
},
CustomerBalance: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceArgs{
BankTransfer: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs{
EuBankTransfer: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs{
Country: pulumi.String("string"),
},
Type: pulumi.String("string"),
},
FundingType: pulumi.String("string"),
},
Payto: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsPaytoArgs{
MandateOptions: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs{
Amount: pulumi.Float64(0),
AmountType: pulumi.String("string"),
Purpose: pulumi.String("string"),
},
},
Pix: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsPixArgs{
ExpiresAfterSeconds: pulumi.Float64(0),
MandateOptions: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsPixMandateOptionsArgs{
Amount: pulumi.Float64(0),
AmountIncludesIof: pulumi.String("string"),
EndDate: pulumi.String("string"),
PaymentSchedule: pulumi.String("string"),
},
},
Upi: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsUpiArgs{
MandateOptions: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs{
Amount: pulumi.Float64(0),
AmountType: pulumi.String("string"),
Description: pulumi.String("string"),
EndDate: pulumi.Float64(0),
},
},
UsBankAccount: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountArgs{
FinancialConnections: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs{
Filters: &stripe.SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs{
AccountSubcategories: pulumi.StringArray{
pulumi.String("string"),
},
},
Permissions: pulumi.StringArray{
pulumi.String("string"),
},
Prefetches: pulumi.StringArray{
pulumi.String("string"),
},
},
VerificationMethod: pulumi.String("string"),
},
},
PaymentMethodTypes: pulumi.StringArray{
pulumi.String("string"),
},
SaveDefaultPaymentMethod: pulumi.String("string"),
},
PendingInvoiceItemInterval: &stripe.SubscriptionPendingInvoiceItemIntervalArgs{
Interval: pulumi.String("string"),
IntervalCount: pulumi.Float64(0),
},
ProrationBehavior: pulumi.String("string"),
TransferData: &stripe.SubscriptionTransferDataArgs{
Destination: pulumi.String("string"),
AmountPercent: pulumi.Float64(0),
},
TrialEnd: pulumi.Float64(0),
TrialFromPlan: pulumi.Bool(false),
TrialPeriodDays: pulumi.Float64(0),
TrialSettings: &stripe.SubscriptionTrialSettingsArgs{
EndBehavior: &stripe.SubscriptionTrialSettingsEndBehaviorArgs{
MissingPaymentMethod: pulumi.String("string"),
},
},
})
resource "stripe_subscription" "subscriptionResource" {
lifecycle {
create_before_destroy = true
}
add_invoice_items {
discountable = false
discounts {
coupon = "string"
discount = "string"
promotion_code = "string"
}
metadata = {
"string" = "string"
}
period = {
end = {
type = "string"
timestamp = 0
}
start = {
type = "string"
timestamp = 0
}
}
price = "string"
price_data = {
currency = "string"
product = "string"
tax_behavior = "string"
unit_amount = 0
unit_amount_decimal = 0
}
quantity = 0
tax_rates = ["string"]
}
application_fee_percent = 0
automatic_tax = {
enabled = false
disabled_reason = "string"
liability = {
type = "string"
account = "string"
}
}
backdate_start_date = 0
billing_cycle_anchor = 0
billing_cycle_anchor_config = {
day_of_month = 0
hour = 0
minute = 0
month = 0
second = 0
}
billing_mode = {
type = "string"
flexible = {
proration_discounts = "string"
}
updated_at = 0
}
billing_schedules {
bill_until = {
type = "string"
computed_timestamp = 0
duration = {
interval = "string"
interval_count = 0
}
timestamp = 0
}
applies_tos {
type = "string"
price = "string"
}
key = "string"
}
billing_thresholds = {
amount_gte = 0
reset_billing_cycle_anchor = false
}
cancel_at = 0
cancel_at_period_end = false
cancellation_details = {
comment = "string"
feedback = "string"
reason = "string"
}
collection_method = "string"
currency = "string"
customer = "string"
customer_account = "string"
days_until_due = 0
default_payment_method = "string"
default_source = "string"
default_tax_rates = ["string"]
description = "string"
discounts {
coupon = "string"
discount = "string"
promotion_code = "string"
}
invoice_settings = {
account_tax_ids = ["string"]
issuer = {
type = "string"
account = "string"
}
}
items {
billing_thresholds = {
usage_gte = 0
}
discounts {
coupon = "string"
discount = "string"
promotion_code = "string"
}
id = "string"
metadata = {
"string" = "string"
}
price = "string"
price_data = {
currency = "string"
product = "string"
recurring = {
interval = "string"
interval_count = 0
}
tax_behavior = "string"
unit_amount = 0
unit_amount_decimal = 0
}
quantity = 0
tax_rates = ["string"]
}
metadata = {
"string" = "string"
}
off_session = false
on_behalf_of = "string"
pause_collection = {
behavior = "string"
resumes_at = 0
}
payment_behavior = "string"
payment_settings = {
payment_method_options = {
acss_debit = {
mandate_options = {
transaction_type = "string"
}
verification_method = "string"
}
bancontact = {
preferred_language = "string"
}
card = {
mandate_options = {
amount = 0
amount_type = "string"
description = "string"
}
network = "string"
request_three_d_secure = "string"
}
customer_balance = {
bank_transfer = {
eu_bank_transfer = {
country = "string"
}
type = "string"
}
funding_type = "string"
}
payto = {
mandate_options = {
amount = 0
amount_type = "string"
purpose = "string"
}
}
pix = {
expires_after_seconds = 0
mandate_options = {
amount = 0
amount_includes_iof = "string"
end_date = "string"
payment_schedule = "string"
}
}
upi = {
mandate_options = {
amount = 0
amount_type = "string"
description = "string"
end_date = 0
}
}
us_bank_account = {
financial_connections = {
filters = {
account_subcategories = ["string"]
}
permissions = ["string"]
prefetches = ["string"]
}
verification_method = "string"
}
}
payment_method_types = ["string"]
save_default_payment_method = "string"
}
pending_invoice_item_interval = {
interval = "string"
interval_count = 0
}
proration_behavior = "string"
transfer_data = {
destination = "string"
amount_percent = 0
}
trial_end = 0
trial_from_plan = false
trial_period_days = 0
trial_settings = {
end_behavior = {
missing_payment_method = "string"
}
}
}
var subscriptionResource = new Subscription("subscriptionResource", SubscriptionArgs.builder()
.addInvoiceItems(SubscriptionAddInvoiceItemArgs.builder()
.discountable(false)
.discounts(SubscriptionAddInvoiceItemDiscountArgs.builder()
.coupon("string")
.discount("string")
.promotionCode("string")
.build())
.metadata(Map.of("string", "string"))
.period(SubscriptionAddInvoiceItemPeriodArgs.builder()
.end(SubscriptionAddInvoiceItemPeriodEndArgs.builder()
.type("string")
.timestamp(0.0)
.build())
.start(SubscriptionAddInvoiceItemPeriodStartArgs.builder()
.type("string")
.timestamp(0.0)
.build())
.build())
.price("string")
.priceData(SubscriptionAddInvoiceItemPriceDataArgs.builder()
.currency("string")
.product("string")
.taxBehavior("string")
.unitAmount(0.0)
.unitAmountDecimal(0.0)
.build())
.quantity(0.0)
.taxRates("string")
.build())
.applicationFeePercent(0.0)
.automaticTax(SubscriptionAutomaticTaxArgs.builder()
.enabled(false)
.disabledReason("string")
.liability(SubscriptionAutomaticTaxLiabilityArgs.builder()
.type("string")
.account("string")
.build())
.build())
.backdateStartDate(0.0)
.billingCycleAnchor(0.0)
.billingCycleAnchorConfig(SubscriptionBillingCycleAnchorConfigArgs.builder()
.dayOfMonth(0.0)
.hour(0.0)
.minute(0.0)
.month(0.0)
.second(0.0)
.build())
.billingMode(SubscriptionBillingModeArgs.builder()
.type("string")
.flexible(SubscriptionBillingModeFlexibleArgs.builder()
.prorationDiscounts("string")
.build())
.updatedAt(0.0)
.build())
.billingSchedules(SubscriptionBillingScheduleArgs.builder()
.billUntil(SubscriptionBillingScheduleBillUntilArgs.builder()
.type("string")
.computedTimestamp(0.0)
.duration(SubscriptionBillingScheduleBillUntilDurationArgs.builder()
.interval("string")
.intervalCount(0.0)
.build())
.timestamp(0.0)
.build())
.appliesTos(SubscriptionBillingScheduleAppliesToArgs.builder()
.type("string")
.price("string")
.build())
.key("string")
.build())
.billingThresholds(SubscriptionBillingThresholdsArgs.builder()
.amountGte(0.0)
.resetBillingCycleAnchor(false)
.build())
.cancelAt(0.0)
.cancelAtPeriodEnd(false)
.cancellationDetails(SubscriptionCancellationDetailsArgs.builder()
.comment("string")
.feedback("string")
.reason("string")
.build())
.collectionMethod("string")
.currency("string")
.customer("string")
.customerAccount("string")
.daysUntilDue(0.0)
.defaultPaymentMethod("string")
.defaultSource("string")
.defaultTaxRates("string")
.description("string")
.discounts(SubscriptionDiscountArgs.builder()
.coupon("string")
.discount("string")
.promotionCode("string")
.build())
.invoiceSettings(SubscriptionInvoiceSettingsArgs.builder()
.accountTaxIds("string")
.issuer(SubscriptionInvoiceSettingsIssuerArgs.builder()
.type("string")
.account("string")
.build())
.build())
.items(com.pulumi.stripe.inputs.SubscriptionItemArgs.builder()
.billingThresholds(SubscriptionItemBillingThresholdsArgs.builder()
.usageGte(0.0)
.build())
.discounts(SubscriptionItemDiscountArgs.builder()
.coupon("string")
.discount("string")
.promotionCode("string")
.build())
.id("string")
.metadata(Map.of("string", "string"))
.price("string")
.priceData(SubscriptionItemPriceDataArgs.builder()
.currency("string")
.product("string")
.recurring(SubscriptionItemPriceDataRecurringArgs.builder()
.interval("string")
.intervalCount(0.0)
.build())
.taxBehavior("string")
.unitAmount(0.0)
.unitAmountDecimal(0.0)
.build())
.quantity(0.0)
.taxRates("string")
.build())
.metadata(Map.of("string", "string"))
.offSession(false)
.onBehalfOf("string")
.pauseCollection(SubscriptionPauseCollectionArgs.builder()
.behavior("string")
.resumesAt(0.0)
.build())
.paymentBehavior("string")
.paymentSettings(SubscriptionPaymentSettingsArgs.builder()
.paymentMethodOptions(SubscriptionPaymentSettingsPaymentMethodOptionsArgs.builder()
.acssDebit(SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitArgs.builder()
.mandateOptions(SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs.builder()
.transactionType("string")
.build())
.verificationMethod("string")
.build())
.bancontact(SubscriptionPaymentSettingsPaymentMethodOptionsBancontactArgs.builder()
.preferredLanguage("string")
.build())
.card(SubscriptionPaymentSettingsPaymentMethodOptionsCardArgs.builder()
.mandateOptions(SubscriptionPaymentSettingsPaymentMethodOptionsCardMandateOptionsArgs.builder()
.amount(0.0)
.amountType("string")
.description("string")
.build())
.network("string")
.requestThreeDSecure("string")
.build())
.customerBalance(SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceArgs.builder()
.bankTransfer(SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs.builder()
.euBankTransfer(SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs.builder()
.country("string")
.build())
.type("string")
.build())
.fundingType("string")
.build())
.payto(SubscriptionPaymentSettingsPaymentMethodOptionsPaytoArgs.builder()
.mandateOptions(SubscriptionPaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs.builder()
.amount(0.0)
.amountType("string")
.purpose("string")
.build())
.build())
.pix(SubscriptionPaymentSettingsPaymentMethodOptionsPixArgs.builder()
.expiresAfterSeconds(0.0)
.mandateOptions(SubscriptionPaymentSettingsPaymentMethodOptionsPixMandateOptionsArgs.builder()
.amount(0.0)
.amountIncludesIof("string")
.endDate("string")
.paymentSchedule("string")
.build())
.build())
.upi(SubscriptionPaymentSettingsPaymentMethodOptionsUpiArgs.builder()
.mandateOptions(SubscriptionPaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs.builder()
.amount(0.0)
.amountType("string")
.description("string")
.endDate(0.0)
.build())
.build())
.usBankAccount(SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountArgs.builder()
.financialConnections(SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs.builder()
.filters(SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs.builder()
.accountSubcategories("string")
.build())
.permissions("string")
.prefetches("string")
.build())
.verificationMethod("string")
.build())
.build())
.paymentMethodTypes("string")
.saveDefaultPaymentMethod("string")
.build())
.pendingInvoiceItemInterval(SubscriptionPendingInvoiceItemIntervalArgs.builder()
.interval("string")
.intervalCount(0.0)
.build())
.prorationBehavior("string")
.transferData(SubscriptionTransferDataArgs.builder()
.destination("string")
.amountPercent(0.0)
.build())
.trialEnd(0.0)
.trialFromPlan(false)
.trialPeriodDays(0.0)
.trialSettings(SubscriptionTrialSettingsArgs.builder()
.endBehavior(SubscriptionTrialSettingsEndBehaviorArgs.builder()
.missingPaymentMethod("string")
.build())
.build())
.build());
subscription_resource = stripe.Subscription("subscriptionResource",
add_invoice_items=[{
"discountable": False,
"discounts": [{
"coupon": "string",
"discount": "string",
"promotion_code": "string",
}],
"metadata": {
"string": "string",
},
"period": {
"end": {
"type": "string",
"timestamp": float(0),
},
"start": {
"type": "string",
"timestamp": float(0),
},
},
"price": "string",
"price_data": {
"currency": "string",
"product": "string",
"tax_behavior": "string",
"unit_amount": float(0),
"unit_amount_decimal": float(0),
},
"quantity": float(0),
"tax_rates": ["string"],
}],
application_fee_percent=float(0),
automatic_tax={
"enabled": False,
"disabled_reason": "string",
"liability": {
"type": "string",
"account": "string",
},
},
backdate_start_date=float(0),
billing_cycle_anchor=float(0),
billing_cycle_anchor_config={
"day_of_month": float(0),
"hour": float(0),
"minute": float(0),
"month": float(0),
"second": float(0),
},
billing_mode={
"type": "string",
"flexible": {
"proration_discounts": "string",
},
"updated_at": float(0),
},
billing_schedules=[{
"bill_until": {
"type": "string",
"computed_timestamp": float(0),
"duration": {
"interval": "string",
"interval_count": float(0),
},
"timestamp": float(0),
},
"applies_tos": [{
"type": "string",
"price": "string",
}],
"key": "string",
}],
billing_thresholds={
"amount_gte": float(0),
"reset_billing_cycle_anchor": False,
},
cancel_at=float(0),
cancel_at_period_end=False,
cancellation_details={
"comment": "string",
"feedback": "string",
"reason": "string",
},
collection_method="string",
currency="string",
customer="string",
customer_account="string",
days_until_due=float(0),
default_payment_method="string",
default_source="string",
default_tax_rates=["string"],
description="string",
discounts=[{
"coupon": "string",
"discount": "string",
"promotion_code": "string",
}],
invoice_settings={
"account_tax_ids": ["string"],
"issuer": {
"type": "string",
"account": "string",
},
},
items=[{
"billing_thresholds": {
"usage_gte": float(0),
},
"discounts": [{
"coupon": "string",
"discount": "string",
"promotion_code": "string",
}],
"id": "string",
"metadata": {
"string": "string",
},
"price": "string",
"price_data": {
"currency": "string",
"product": "string",
"recurring": {
"interval": "string",
"interval_count": float(0),
},
"tax_behavior": "string",
"unit_amount": float(0),
"unit_amount_decimal": float(0),
},
"quantity": float(0),
"tax_rates": ["string"],
}],
metadata={
"string": "string",
},
off_session=False,
on_behalf_of="string",
pause_collection={
"behavior": "string",
"resumes_at": float(0),
},
payment_behavior="string",
payment_settings={
"payment_method_options": {
"acss_debit": {
"mandate_options": {
"transaction_type": "string",
},
"verification_method": "string",
},
"bancontact": {
"preferred_language": "string",
},
"card": {
"mandate_options": {
"amount": float(0),
"amount_type": "string",
"description": "string",
},
"network": "string",
"request_three_d_secure": "string",
},
"customer_balance": {
"bank_transfer": {
"eu_bank_transfer": {
"country": "string",
},
"type": "string",
},
"funding_type": "string",
},
"payto": {
"mandate_options": {
"amount": float(0),
"amount_type": "string",
"purpose": "string",
},
},
"pix": {
"expires_after_seconds": float(0),
"mandate_options": {
"amount": float(0),
"amount_includes_iof": "string",
"end_date": "string",
"payment_schedule": "string",
},
},
"upi": {
"mandate_options": {
"amount": float(0),
"amount_type": "string",
"description": "string",
"end_date": float(0),
},
},
"us_bank_account": {
"financial_connections": {
"filters": {
"account_subcategories": ["string"],
},
"permissions": ["string"],
"prefetches": ["string"],
},
"verification_method": "string",
},
},
"payment_method_types": ["string"],
"save_default_payment_method": "string",
},
pending_invoice_item_interval={
"interval": "string",
"interval_count": float(0),
},
proration_behavior="string",
transfer_data={
"destination": "string",
"amount_percent": float(0),
},
trial_end=float(0),
trial_from_plan=False,
trial_period_days=float(0),
trial_settings={
"end_behavior": {
"missing_payment_method": "string",
},
})
const subscriptionResource = new stripe.Subscription("subscriptionResource", {
addInvoiceItems: [{
discountable: false,
discounts: [{
coupon: "string",
discount: "string",
promotionCode: "string",
}],
metadata: {
string: "string",
},
period: {
end: {
type: "string",
timestamp: 0,
},
start: {
type: "string",
timestamp: 0,
},
},
price: "string",
priceData: {
currency: "string",
product: "string",
taxBehavior: "string",
unitAmount: 0,
unitAmountDecimal: 0,
},
quantity: 0,
taxRates: ["string"],
}],
applicationFeePercent: 0,
automaticTax: {
enabled: false,
disabledReason: "string",
liability: {
type: "string",
account: "string",
},
},
backdateStartDate: 0,
billingCycleAnchor: 0,
billingCycleAnchorConfig: {
dayOfMonth: 0,
hour: 0,
minute: 0,
month: 0,
second: 0,
},
billingMode: {
type: "string",
flexible: {
prorationDiscounts: "string",
},
updatedAt: 0,
},
billingSchedules: [{
billUntil: {
type: "string",
computedTimestamp: 0,
duration: {
interval: "string",
intervalCount: 0,
},
timestamp: 0,
},
appliesTos: [{
type: "string",
price: "string",
}],
key: "string",
}],
billingThresholds: {
amountGte: 0,
resetBillingCycleAnchor: false,
},
cancelAt: 0,
cancelAtPeriodEnd: false,
cancellationDetails: {
comment: "string",
feedback: "string",
reason: "string",
},
collectionMethod: "string",
currency: "string",
customer: "string",
customerAccount: "string",
daysUntilDue: 0,
defaultPaymentMethod: "string",
defaultSource: "string",
defaultTaxRates: ["string"],
description: "string",
discounts: [{
coupon: "string",
discount: "string",
promotionCode: "string",
}],
invoiceSettings: {
accountTaxIds: ["string"],
issuer: {
type: "string",
account: "string",
},
},
items: [{
billingThresholds: {
usageGte: 0,
},
discounts: [{
coupon: "string",
discount: "string",
promotionCode: "string",
}],
id: "string",
metadata: {
string: "string",
},
price: "string",
priceData: {
currency: "string",
product: "string",
recurring: {
interval: "string",
intervalCount: 0,
},
taxBehavior: "string",
unitAmount: 0,
unitAmountDecimal: 0,
},
quantity: 0,
taxRates: ["string"],
}],
metadata: {
string: "string",
},
offSession: false,
onBehalfOf: "string",
pauseCollection: {
behavior: "string",
resumesAt: 0,
},
paymentBehavior: "string",
paymentSettings: {
paymentMethodOptions: {
acssDebit: {
mandateOptions: {
transactionType: "string",
},
verificationMethod: "string",
},
bancontact: {
preferredLanguage: "string",
},
card: {
mandateOptions: {
amount: 0,
amountType: "string",
description: "string",
},
network: "string",
requestThreeDSecure: "string",
},
customerBalance: {
bankTransfer: {
euBankTransfer: {
country: "string",
},
type: "string",
},
fundingType: "string",
},
payto: {
mandateOptions: {
amount: 0,
amountType: "string",
purpose: "string",
},
},
pix: {
expiresAfterSeconds: 0,
mandateOptions: {
amount: 0,
amountIncludesIof: "string",
endDate: "string",
paymentSchedule: "string",
},
},
upi: {
mandateOptions: {
amount: 0,
amountType: "string",
description: "string",
endDate: 0,
},
},
usBankAccount: {
financialConnections: {
filters: {
accountSubcategories: ["string"],
},
permissions: ["string"],
prefetches: ["string"],
},
verificationMethod: "string",
},
},
paymentMethodTypes: ["string"],
saveDefaultPaymentMethod: "string",
},
pendingInvoiceItemInterval: {
interval: "string",
intervalCount: 0,
},
prorationBehavior: "string",
transferData: {
destination: "string",
amountPercent: 0,
},
trialEnd: 0,
trialFromPlan: false,
trialPeriodDays: 0,
trialSettings: {
endBehavior: {
missingPaymentMethod: "string",
},
},
});
type: stripe:Subscription
properties:
addInvoiceItems:
- discountable: false
discounts:
- coupon: string
discount: string
promotionCode: string
metadata:
string: string
period:
end:
timestamp: 0
type: string
start:
timestamp: 0
type: string
price: string
priceData:
currency: string
product: string
taxBehavior: string
unitAmount: 0
unitAmountDecimal: 0
quantity: 0
taxRates:
- string
applicationFeePercent: 0
automaticTax:
disabledReason: string
enabled: false
liability:
account: string
type: string
backdateStartDate: 0
billingCycleAnchor: 0
billingCycleAnchorConfig:
dayOfMonth: 0
hour: 0
minute: 0
month: 0
second: 0
billingMode:
flexible:
prorationDiscounts: string
type: string
updatedAt: 0
billingSchedules:
- appliesTos:
- price: string
type: string
billUntil:
computedTimestamp: 0
duration:
interval: string
intervalCount: 0
timestamp: 0
type: string
key: string
billingThresholds:
amountGte: 0
resetBillingCycleAnchor: false
cancelAt: 0
cancelAtPeriodEnd: false
cancellationDetails:
comment: string
feedback: string
reason: string
collectionMethod: string
currency: string
customer: string
customerAccount: string
daysUntilDue: 0
defaultPaymentMethod: string
defaultSource: string
defaultTaxRates:
- string
description: string
discounts:
- coupon: string
discount: string
promotionCode: string
invoiceSettings:
accountTaxIds:
- string
issuer:
account: string
type: string
items:
- billingThresholds:
usageGte: 0
discounts:
- coupon: string
discount: string
promotionCode: string
id: string
metadata:
string: string
price: string
priceData:
currency: string
product: string
recurring:
interval: string
intervalCount: 0
taxBehavior: string
unitAmount: 0
unitAmountDecimal: 0
quantity: 0
taxRates:
- string
metadata:
string: string
offSession: false
onBehalfOf: string
pauseCollection:
behavior: string
resumesAt: 0
paymentBehavior: string
paymentSettings:
paymentMethodOptions:
acssDebit:
mandateOptions:
transactionType: string
verificationMethod: string
bancontact:
preferredLanguage: string
card:
mandateOptions:
amount: 0
amountType: string
description: string
network: string
requestThreeDSecure: string
customerBalance:
bankTransfer:
euBankTransfer:
country: string
type: string
fundingType: string
payto:
mandateOptions:
amount: 0
amountType: string
purpose: string
pix:
expiresAfterSeconds: 0
mandateOptions:
amount: 0
amountIncludesIof: string
endDate: string
paymentSchedule: string
upi:
mandateOptions:
amount: 0
amountType: string
description: string
endDate: 0
usBankAccount:
financialConnections:
filters:
accountSubcategories:
- string
permissions:
- string
prefetches:
- string
verificationMethod: string
paymentMethodTypes:
- string
saveDefaultPaymentMethod: string
pendingInvoiceItemInterval:
interval: string
intervalCount: 0
prorationBehavior: string
transferData:
amountPercent: 0
destination: string
trialEnd: 0
trialFromPlan: false
trialPeriodDays: 0
trialSettings:
endBehavior:
missingPaymentMethod: string
Subscription Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Subscription resource accepts the following input properties:
- Add
Invoice List<SubscriptionItems Add Invoice Item> - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- Application
Fee doublePercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- Automatic
Tax SubscriptionAutomatic Tax - Backdate
Start doubleDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- Billing
Cycle doubleAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - Billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config - The fixed values used to calculate the
billing_cycle_anchor. - Billing
Mode SubscriptionBilling Mode - The billing mode of the subscription.
- Billing
Schedules List<SubscriptionBilling Schedule> - Billing schedules for this subscription.
- Billing
Thresholds SubscriptionBilling Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- Cancel
At double - A date in the future at which the subscription will automatically get canceled
- Cancel
At boolPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - Cancellation
Details SubscriptionCancellation Details - Details about why this subscription was cancelled
- Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Customer string
- ID of the customer who owns the subscription.
- Customer
Account string - ID of the account representing the customer who owns the subscription.
- Days
Until doubleDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - Default
Payment stringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Tax List<string>Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - Description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- Discounts
List<Subscription
Discount> - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - Invoice
Settings SubscriptionInvoice Settings - Items
List<Subscription
Item> - List of subscription items, each with an attached price.
- Metadata Dictionary<string, string>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- Off
Session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - On
Behalf stringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- Pause
Collection SubscriptionPause Collection - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - Payment
Behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - Payment
Settings SubscriptionPayment Settings - Payment settings passed on to invoices created by the subscription.
- Pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- Proration
Behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - Transfer
Data SubscriptionTransfer Data - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- Trial
End double - If the subscription has a trial, the end of that trial.
- Trial
From boolPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - Trial
Period doubleDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- Trial
Settings SubscriptionTrial Settings - Settings related to subscription trials.
- Add
Invoice []SubscriptionItems Add Invoice Item Args - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- Application
Fee float64Percent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- Automatic
Tax SubscriptionAutomatic Tax Args - Backdate
Start float64Date - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- Billing
Cycle float64Anchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - Billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config Args - The fixed values used to calculate the
billing_cycle_anchor. - Billing
Mode SubscriptionBilling Mode Args - The billing mode of the subscription.
- Billing
Schedules []SubscriptionBilling Schedule Args - Billing schedules for this subscription.
- Billing
Thresholds SubscriptionBilling Thresholds Args - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- Cancel
At float64 - A date in the future at which the subscription will automatically get canceled
- Cancel
At boolPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - Cancellation
Details SubscriptionCancellation Details Args - Details about why this subscription was cancelled
- Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Customer string
- ID of the customer who owns the subscription.
- Customer
Account string - ID of the account representing the customer who owns the subscription.
- Days
Until float64Due - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - Default
Payment stringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Tax []stringRates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - Description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- Discounts
[]Subscription
Discount Args - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - Invoice
Settings SubscriptionInvoice Settings Args - Items
[]Subscription
Item Type Args - List of subscription items, each with an attached price.
- Metadata map[string]string
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- Off
Session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - On
Behalf stringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- Pause
Collection SubscriptionPause Collection Args - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - Payment
Behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - Payment
Settings SubscriptionPayment Settings Args - Payment settings passed on to invoices created by the subscription.
- Pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval Args - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- Proration
Behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - Transfer
Data SubscriptionTransfer Data Args - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- Trial
End float64 - If the subscription has a trial, the end of that trial.
- Trial
From boolPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - Trial
Period float64Days - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- Trial
Settings SubscriptionTrial Settings Args - Settings related to subscription trials.
- add_
invoice_ list(object)items - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application_
fee_ numberpercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic_
tax object - backdate_
start_ numberdate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing_
cycle_ numberanchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing_
cycle_ objectanchor_ config - The fixed values used to calculate the
billing_cycle_anchor. - billing_
mode object - The billing mode of the subscription.
- billing_
schedules list(object) - Billing schedules for this subscription.
- billing_
thresholds object - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel_
at number - A date in the future at which the subscription will automatically get canceled
- cancel_
at_ boolperiod_ end - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - cancellation_
details object - Details about why this subscription was cancelled
- collection_
method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer string
- ID of the customer who owns the subscription.
- customer_
account string - ID of the account representing the customer who owns the subscription.
- days_
until_ numberdue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default_
payment_ stringmethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
tax_ list(string)rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts list(object)
- The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - invoice_
settings object - items list(object)
- List of subscription items, each with an attached price.
- metadata map(string)
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- off_
session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on_
behalf_ stringof - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause_
collection object - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment_
behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment_
settings object - Payment settings passed on to invoices created by the subscription.
- pending_
invoice_ objectitem_ interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- proration_
behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - transfer_
data object - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial_
end number - If the subscription has a trial, the end of that trial.
- trial_
from_ boolplan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial_
period_ numberdays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial_
settings object - Settings related to subscription trials.
- add
Invoice List<SubscriptionItems Add Invoice Item> - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application
Fee DoublePercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic
Tax SubscriptionAutomatic Tax - backdate
Start DoubleDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing
Cycle DoubleAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config - The fixed values used to calculate the
billing_cycle_anchor. - billing
Mode SubscriptionBilling Mode - The billing mode of the subscription.
- billing
Schedules List<SubscriptionBilling Schedule> - Billing schedules for this subscription.
- billing
Thresholds SubscriptionBilling Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel
At Double - A date in the future at which the subscription will automatically get canceled
- cancel
At BooleanPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - cancellation
Details SubscriptionCancellation Details - Details about why this subscription was cancelled
- collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer String
- ID of the customer who owns the subscription.
- customer
Account String - ID of the account representing the customer who owns the subscription.
- days
Until DoubleDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default
Payment StringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Source String - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Tax List<String>Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description String
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts
List<Subscription
Discount> - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - invoice
Settings SubscriptionInvoice Settings - items
List<Subscription
Item> - List of subscription items, each with an attached price.
- metadata Map<String,String>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- off
Session Boolean - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on
Behalf StringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause
Collection SubscriptionPause Collection - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment
Behavior String - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment
Settings SubscriptionPayment Settings - Payment settings passed on to invoices created by the subscription.
- pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- proration
Behavior String - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - transfer
Data SubscriptionTransfer Data - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial
End Double - If the subscription has a trial, the end of that trial.
- trial
From BooleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial
Period DoubleDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial
Settings SubscriptionTrial Settings - Settings related to subscription trials.
- add
Invoice SubscriptionItems Add Invoice Item[] - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application
Fee numberPercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic
Tax SubscriptionAutomatic Tax - backdate
Start numberDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing
Cycle numberAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config - The fixed values used to calculate the
billing_cycle_anchor. - billing
Mode SubscriptionBilling Mode - The billing mode of the subscription.
- billing
Schedules SubscriptionBilling Schedule[] - Billing schedules for this subscription.
- billing
Thresholds SubscriptionBilling Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel
At number - A date in the future at which the subscription will automatically get canceled
- cancel
At booleanPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - cancellation
Details SubscriptionCancellation Details - Details about why this subscription was cancelled
- collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer string
- ID of the customer who owns the subscription.
- customer
Account string - ID of the account representing the customer who owns the subscription.
- days
Until numberDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default
Payment stringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Tax string[]Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts
Subscription
Discount[] - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - invoice
Settings SubscriptionInvoice Settings - items
Subscription
Item[] - List of subscription items, each with an attached price.
- metadata {[key: string]: string}
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- off
Session boolean - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on
Behalf stringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause
Collection SubscriptionPause Collection - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment
Behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment
Settings SubscriptionPayment Settings - Payment settings passed on to invoices created by the subscription.
- pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- proration
Behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - transfer
Data SubscriptionTransfer Data - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial
End number - If the subscription has a trial, the end of that trial.
- trial
From booleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial
Period numberDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial
Settings SubscriptionTrial Settings - Settings related to subscription trials.
- add_
invoice_ Sequence[Subscriptionitems Add Invoice Item Args] - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application_
fee_ floatpercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic_
tax SubscriptionAutomatic Tax Args - backdate_
start_ floatdate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing_
cycle_ floatanchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing_
cycle_ Subscriptionanchor_ config Billing Cycle Anchor Config Args - The fixed values used to calculate the
billing_cycle_anchor. - billing_
mode SubscriptionBilling Mode Args - The billing mode of the subscription.
- billing_
schedules Sequence[SubscriptionBilling Schedule Args] - Billing schedules for this subscription.
- billing_
thresholds SubscriptionBilling Thresholds Args - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel_
at float - A date in the future at which the subscription will automatically get canceled
- cancel_
at_ boolperiod_ end - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - cancellation_
details SubscriptionCancellation Details Args - Details about why this subscription was cancelled
- collection_
method str - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer str
- ID of the customer who owns the subscription.
- customer_
account str - ID of the account representing the customer who owns the subscription.
- days_
until_ floatdue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default_
payment_ strmethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
source str - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
tax_ Sequence[str]rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description str
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts
Sequence[Subscription
Discount Args] - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - invoice_
settings SubscriptionInvoice Settings Args - items
Sequence[Subscription
Item Args] - List of subscription items, each with an attached price.
- metadata Mapping[str, str]
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- off_
session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on_
behalf_ strof - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause_
collection SubscriptionPause Collection Args - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment_
behavior str - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment_
settings SubscriptionPayment Settings Args - Payment settings passed on to invoices created by the subscription.
- pending_
invoice_ Subscriptionitem_ interval Pending Invoice Item Interval Args - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- proration_
behavior str - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - transfer_
data SubscriptionTransfer Data Args - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial_
end float - If the subscription has a trial, the end of that trial.
- trial_
from_ boolplan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial_
period_ floatdays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial_
settings SubscriptionTrial Settings Args - Settings related to subscription trials.
- add
Invoice List<Property Map>Items - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application
Fee NumberPercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic
Tax Property Map - backdate
Start NumberDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing
Cycle NumberAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing
Cycle Property MapAnchor Config - The fixed values used to calculate the
billing_cycle_anchor. - billing
Mode Property Map - The billing mode of the subscription.
- billing
Schedules List<Property Map> - Billing schedules for this subscription.
- billing
Thresholds Property Map - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel
At Number - A date in the future at which the subscription will automatically get canceled
- cancel
At BooleanPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - cancellation
Details Property Map - Details about why this subscription was cancelled
- collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer String
- ID of the customer who owns the subscription.
- customer
Account String - ID of the account representing the customer who owns the subscription.
- days
Until NumberDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default
Payment StringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Source String - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Tax List<String>Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description String
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts List<Property Map>
- The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - invoice
Settings Property Map - items List<Property Map>
- List of subscription items, each with an attached price.
- metadata Map<String>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- off
Session Boolean - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on
Behalf StringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause
Collection Property Map - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment
Behavior String - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment
Settings Property Map - Payment settings passed on to invoices created by the subscription.
- pending
Invoice Property MapItem Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- proration
Behavior String - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - transfer
Data Property Map - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial
End Number - If the subscription has a trial, the end of that trial.
- trial
From BooleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial
Period NumberDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial
Settings Property Map - Settings related to subscription trials.
Outputs
All input properties are implicitly available as output properties. Additionally, the Subscription resource produces the following output properties:
- Application string
- ID of the Connect Application that created the subscription.
- Canceled
At double - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - Created double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Ended
At double - If the subscription has ended, the date the subscription ended.
- Id string
- The provider-assigned unique ID for this managed resource.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Managed
Payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- Next
Pending doubleInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Pending
Setup stringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- Pending
Update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - Presentment
Details SubscriptionPresentment Details - Schedule string
- The schedule attached to the subscription
- Start
Date double - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - Status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- Test
Clock string - ID of the test clock this subscription belongs to.
- Trial
Start double - If the subscription has a trial, the beginning of that trial.
- Application string
- ID of the Connect Application that created the subscription.
- Canceled
At float64 - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - Created float64
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Ended
At float64 - If the subscription has ended, the date the subscription ended.
- Id string
- The provider-assigned unique ID for this managed resource.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Managed
Payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- Next
Pending float64Invoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Pending
Setup stringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- Pending
Update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - Presentment
Details SubscriptionPresentment Details - Schedule string
- The schedule attached to the subscription
- Start
Date float64 - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - Status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- Test
Clock string - ID of the test clock this subscription belongs to.
- Trial
Start float64 - If the subscription has a trial, the beginning of that trial.
- application string
- ID of the Connect Application that created the subscription.
- canceled_
at number - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- ended_
at number - If the subscription has ended, the date the subscription ended.
- id string
- The provider-assigned unique ID for this managed resource.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed_
payments object - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- next_
pending_ numberinvoice_ item_ invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object string
- String representing the object's type. Objects of the same type share the same value.
- pending_
setup_ stringintent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending_
update object - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment_
details object - schedule string
- The schedule attached to the subscription
- start_
date number - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test_
clock string - ID of the test clock this subscription belongs to.
- trial_
start number - If the subscription has a trial, the beginning of that trial.
- application String
- ID of the Connect Application that created the subscription.
- canceled
At Double - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - created Double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- ended
At Double - If the subscription has ended, the date the subscription ended.
- id String
- The provider-assigned unique ID for this managed resource.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed
Payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- next
Pending DoubleInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object String
- String representing the object's type. Objects of the same type share the same value.
- pending
Setup StringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending
Update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment
Details SubscriptionPresentment Details - schedule String
- The schedule attached to the subscription
- start
Date Double - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status String
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test
Clock String - ID of the test clock this subscription belongs to.
- trial
Start Double - If the subscription has a trial, the beginning of that trial.
- application string
- ID of the Connect Application that created the subscription.
- canceled
At number - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- ended
At number - If the subscription has ended, the date the subscription ended.
- id string
- The provider-assigned unique ID for this managed resource.
- livemode boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed
Payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- next
Pending numberInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object string
- String representing the object's type. Objects of the same type share the same value.
- pending
Setup stringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending
Update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment
Details SubscriptionPresentment Details - schedule string
- The schedule attached to the subscription
- start
Date number - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test
Clock string - ID of the test clock this subscription belongs to.
- trial
Start number - If the subscription has a trial, the beginning of that trial.
- application str
- ID of the Connect Application that created the subscription.
- canceled_
at float - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - created float
- Time at which the object was created. Measured in seconds since the Unix epoch.
- ended_
at float - If the subscription has ended, the date the subscription ended.
- id str
- The provider-assigned unique ID for this managed resource.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed_
payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- next_
pending_ floatinvoice_ item_ invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object str
- String representing the object's type. Objects of the same type share the same value.
- pending_
setup_ strintent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending_
update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment_
details SubscriptionPresentment Details - schedule str
- The schedule attached to the subscription
- start_
date float - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status str
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test_
clock str - ID of the test clock this subscription belongs to.
- trial_
start float - If the subscription has a trial, the beginning of that trial.
- application String
- ID of the Connect Application that created the subscription.
- canceled
At Number - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - created Number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- ended
At Number - If the subscription has ended, the date the subscription ended.
- id String
- The provider-assigned unique ID for this managed resource.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed
Payments Property Map - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- next
Pending NumberInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object String
- String representing the object's type. Objects of the same type share the same value.
- pending
Setup StringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending
Update Property Map - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment
Details Property Map - schedule String
- The schedule attached to the subscription
- start
Date Number - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status String
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test
Clock String - ID of the test clock this subscription belongs to.
- trial
Start Number - If the subscription has a trial, the beginning of that trial.
Look up Existing Subscription Resource
Get an existing Subscription resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: SubscriptionState, opts?: CustomResourceOptions): Subscription@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
add_invoice_items: Optional[Sequence[SubscriptionAddInvoiceItemArgs]] = None,
application: Optional[str] = None,
application_fee_percent: Optional[float] = None,
automatic_tax: Optional[SubscriptionAutomaticTaxArgs] = None,
backdate_start_date: Optional[float] = None,
billing_cycle_anchor: Optional[float] = None,
billing_cycle_anchor_config: Optional[SubscriptionBillingCycleAnchorConfigArgs] = None,
billing_mode: Optional[SubscriptionBillingModeArgs] = None,
billing_schedules: Optional[Sequence[SubscriptionBillingScheduleArgs]] = None,
billing_thresholds: Optional[SubscriptionBillingThresholdsArgs] = None,
cancel_at: Optional[float] = None,
cancel_at_period_end: Optional[bool] = None,
canceled_at: Optional[float] = None,
cancellation_details: Optional[SubscriptionCancellationDetailsArgs] = None,
collection_method: Optional[str] = None,
created: Optional[float] = None,
currency: Optional[str] = None,
customer: Optional[str] = None,
customer_account: Optional[str] = None,
days_until_due: Optional[float] = None,
default_payment_method: Optional[str] = None,
default_source: Optional[str] = None,
default_tax_rates: Optional[Sequence[str]] = None,
description: Optional[str] = None,
discounts: Optional[Sequence[SubscriptionDiscountArgs]] = None,
ended_at: Optional[float] = None,
invoice_settings: Optional[SubscriptionInvoiceSettingsArgs] = None,
items: Optional[Sequence[SubscriptionItemArgs]] = None,
livemode: Optional[bool] = None,
managed_payments: Optional[SubscriptionManagedPaymentsArgs] = None,
metadata: Optional[Mapping[str, str]] = None,
next_pending_invoice_item_invoice: Optional[float] = None,
object: Optional[str] = None,
off_session: Optional[bool] = None,
on_behalf_of: Optional[str] = None,
pause_collection: Optional[SubscriptionPauseCollectionArgs] = None,
payment_behavior: Optional[str] = None,
payment_settings: Optional[SubscriptionPaymentSettingsArgs] = None,
pending_invoice_item_interval: Optional[SubscriptionPendingInvoiceItemIntervalArgs] = None,
pending_setup_intent: Optional[str] = None,
pending_update: Optional[SubscriptionPendingUpdateArgs] = None,
presentment_details: Optional[SubscriptionPresentmentDetailsArgs] = None,
proration_behavior: Optional[str] = None,
schedule: Optional[str] = None,
start_date: Optional[float] = None,
status: Optional[str] = None,
test_clock: Optional[str] = None,
transfer_data: Optional[SubscriptionTransferDataArgs] = None,
trial_end: Optional[float] = None,
trial_from_plan: Optional[bool] = None,
trial_period_days: Optional[float] = None,
trial_settings: Optional[SubscriptionTrialSettingsArgs] = None,
trial_start: Optional[float] = None) -> Subscriptionfunc GetSubscription(ctx *Context, name string, id IDInput, state *SubscriptionState, opts ...ResourceOption) (*Subscription, error)public static Subscription Get(string name, Input<string> id, SubscriptionState? state, CustomResourceOptions? opts = null)public static Subscription get(String name, Output<String> id, SubscriptionState state, CustomResourceOptions options)resources: _: type: stripe:Subscription get: id: ${id}import {
to = stripe_subscription.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Add
Invoice List<SubscriptionItems Add Invoice Item> - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- Application string
- ID of the Connect Application that created the subscription.
- Application
Fee doublePercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- Automatic
Tax SubscriptionAutomatic Tax - Backdate
Start doubleDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- Billing
Cycle doubleAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - Billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config - The fixed values used to calculate the
billing_cycle_anchor. - Billing
Mode SubscriptionBilling Mode - The billing mode of the subscription.
- Billing
Schedules List<SubscriptionBilling Schedule> - Billing schedules for this subscription.
- Billing
Thresholds SubscriptionBilling Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- Cancel
At double - A date in the future at which the subscription will automatically get canceled
- Cancel
At boolPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - Canceled
At double - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - Cancellation
Details SubscriptionCancellation Details - Details about why this subscription was cancelled
- Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - Created double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Customer string
- ID of the customer who owns the subscription.
- Customer
Account string - ID of the account representing the customer who owns the subscription.
- Days
Until doubleDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - Default
Payment stringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Tax List<string>Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - Description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- Discounts
List<Subscription
Discount> - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - Ended
At double - If the subscription has ended, the date the subscription ended.
- Invoice
Settings SubscriptionInvoice Settings - Items
List<Subscription
Item> - List of subscription items, each with an attached price.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Managed
Payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- Metadata Dictionary<string, string>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- Next
Pending doubleInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Off
Session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - On
Behalf stringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- Pause
Collection SubscriptionPause Collection - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - Payment
Behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - Payment
Settings SubscriptionPayment Settings - Payment settings passed on to invoices created by the subscription.
- Pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- Pending
Setup stringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- Pending
Update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - Presentment
Details SubscriptionPresentment Details - Proration
Behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - Schedule string
- The schedule attached to the subscription
- Start
Date double - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - Status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- Test
Clock string - ID of the test clock this subscription belongs to.
- Transfer
Data SubscriptionTransfer Data - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- Trial
End double - If the subscription has a trial, the end of that trial.
- Trial
From boolPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - Trial
Period doubleDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- Trial
Settings SubscriptionTrial Settings - Settings related to subscription trials.
- Trial
Start double - If the subscription has a trial, the beginning of that trial.
- Add
Invoice []SubscriptionItems Add Invoice Item Args - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- Application string
- ID of the Connect Application that created the subscription.
- Application
Fee float64Percent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- Automatic
Tax SubscriptionAutomatic Tax Args - Backdate
Start float64Date - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- Billing
Cycle float64Anchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - Billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config Args - The fixed values used to calculate the
billing_cycle_anchor. - Billing
Mode SubscriptionBilling Mode Args - The billing mode of the subscription.
- Billing
Schedules []SubscriptionBilling Schedule Args - Billing schedules for this subscription.
- Billing
Thresholds SubscriptionBilling Thresholds Args - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- Cancel
At float64 - A date in the future at which the subscription will automatically get canceled
- Cancel
At boolPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - Canceled
At float64 - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - Cancellation
Details SubscriptionCancellation Details Args - Details about why this subscription was cancelled
- Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - Created float64
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Customer string
- ID of the customer who owns the subscription.
- Customer
Account string - ID of the account representing the customer who owns the subscription.
- Days
Until float64Due - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - Default
Payment stringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - Default
Tax []stringRates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - Description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- Discounts
[]Subscription
Discount Args - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - Ended
At float64 - If the subscription has ended, the date the subscription ended.
- Invoice
Settings SubscriptionInvoice Settings Args - Items
[]Subscription
Item Type Args - List of subscription items, each with an attached price.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Managed
Payments SubscriptionManaged Payments Args - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- Metadata map[string]string
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- Next
Pending float64Invoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Off
Session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - On
Behalf stringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- Pause
Collection SubscriptionPause Collection Args - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - Payment
Behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - Payment
Settings SubscriptionPayment Settings Args - Payment settings passed on to invoices created by the subscription.
- Pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval Args - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- Pending
Setup stringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- Pending
Update SubscriptionPending Update Args - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - Presentment
Details SubscriptionPresentment Details Args - Proration
Behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - Schedule string
- The schedule attached to the subscription
- Start
Date float64 - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - Status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- Test
Clock string - ID of the test clock this subscription belongs to.
- Transfer
Data SubscriptionTransfer Data Args - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- Trial
End float64 - If the subscription has a trial, the end of that trial.
- Trial
From boolPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - Trial
Period float64Days - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- Trial
Settings SubscriptionTrial Settings Args - Settings related to subscription trials.
- Trial
Start float64 - If the subscription has a trial, the beginning of that trial.
- add_
invoice_ list(object)items - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application string
- ID of the Connect Application that created the subscription.
- application_
fee_ numberpercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic_
tax object - backdate_
start_ numberdate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing_
cycle_ numberanchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing_
cycle_ objectanchor_ config - The fixed values used to calculate the
billing_cycle_anchor. - billing_
mode object - The billing mode of the subscription.
- billing_
schedules list(object) - Billing schedules for this subscription.
- billing_
thresholds object - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel_
at number - A date in the future at which the subscription will automatically get canceled
- cancel_
at_ boolperiod_ end - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - canceled_
at number - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - cancellation_
details object - Details about why this subscription was cancelled
- collection_
method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer string
- ID of the customer who owns the subscription.
- customer_
account string - ID of the account representing the customer who owns the subscription.
- days_
until_ numberdue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default_
payment_ stringmethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
tax_ list(string)rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts list(object)
- The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - ended_
at number - If the subscription has ended, the date the subscription ended.
- invoice_
settings object - items list(object)
- List of subscription items, each with an attached price.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed_
payments object - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- metadata map(string)
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- next_
pending_ numberinvoice_ item_ invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object string
- String representing the object's type. Objects of the same type share the same value.
- off_
session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on_
behalf_ stringof - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause_
collection object - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment_
behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment_
settings object - Payment settings passed on to invoices created by the subscription.
- pending_
invoice_ objectitem_ interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- pending_
setup_ stringintent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending_
update object - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment_
details object - proration_
behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - schedule string
- The schedule attached to the subscription
- start_
date number - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test_
clock string - ID of the test clock this subscription belongs to.
- transfer_
data object - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial_
end number - If the subscription has a trial, the end of that trial.
- trial_
from_ boolplan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial_
period_ numberdays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial_
settings object - Settings related to subscription trials.
- trial_
start number - If the subscription has a trial, the beginning of that trial.
- add
Invoice List<SubscriptionItems Add Invoice Item> - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application String
- ID of the Connect Application that created the subscription.
- application
Fee DoublePercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic
Tax SubscriptionAutomatic Tax - backdate
Start DoubleDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing
Cycle DoubleAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config - The fixed values used to calculate the
billing_cycle_anchor. - billing
Mode SubscriptionBilling Mode - The billing mode of the subscription.
- billing
Schedules List<SubscriptionBilling Schedule> - Billing schedules for this subscription.
- billing
Thresholds SubscriptionBilling Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel
At Double - A date in the future at which the subscription will automatically get canceled
- cancel
At BooleanPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - canceled
At Double - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - cancellation
Details SubscriptionCancellation Details - Details about why this subscription was cancelled
- collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - created Double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer String
- ID of the customer who owns the subscription.
- customer
Account String - ID of the account representing the customer who owns the subscription.
- days
Until DoubleDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default
Payment StringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Source String - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Tax List<String>Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description String
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts
List<Subscription
Discount> - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - ended
At Double - If the subscription has ended, the date the subscription ended.
- invoice
Settings SubscriptionInvoice Settings - items
List<Subscription
Item> - List of subscription items, each with an attached price.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed
Payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- metadata Map<String,String>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- next
Pending DoubleInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object String
- String representing the object's type. Objects of the same type share the same value.
- off
Session Boolean - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on
Behalf StringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause
Collection SubscriptionPause Collection - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment
Behavior String - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment
Settings SubscriptionPayment Settings - Payment settings passed on to invoices created by the subscription.
- pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- pending
Setup StringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending
Update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment
Details SubscriptionPresentment Details - proration
Behavior String - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - schedule String
- The schedule attached to the subscription
- start
Date Double - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status String
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test
Clock String - ID of the test clock this subscription belongs to.
- transfer
Data SubscriptionTransfer Data - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial
End Double - If the subscription has a trial, the end of that trial.
- trial
From BooleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial
Period DoubleDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial
Settings SubscriptionTrial Settings - Settings related to subscription trials.
- trial
Start Double - If the subscription has a trial, the beginning of that trial.
- add
Invoice SubscriptionItems Add Invoice Item[] - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application string
- ID of the Connect Application that created the subscription.
- application
Fee numberPercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic
Tax SubscriptionAutomatic Tax - backdate
Start numberDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing
Cycle numberAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing
Cycle SubscriptionAnchor Config Billing Cycle Anchor Config - The fixed values used to calculate the
billing_cycle_anchor. - billing
Mode SubscriptionBilling Mode - The billing mode of the subscription.
- billing
Schedules SubscriptionBilling Schedule[] - Billing schedules for this subscription.
- billing
Thresholds SubscriptionBilling Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel
At number - A date in the future at which the subscription will automatically get canceled
- cancel
At booleanPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - canceled
At number - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - cancellation
Details SubscriptionCancellation Details - Details about why this subscription was cancelled
- collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer string
- ID of the customer who owns the subscription.
- customer
Account string - ID of the account representing the customer who owns the subscription.
- days
Until numberDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default
Payment stringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Source string - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Tax string[]Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description string
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts
Subscription
Discount[] - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - ended
At number - If the subscription has ended, the date the subscription ended.
- invoice
Settings SubscriptionInvoice Settings - items
Subscription
Item[] - List of subscription items, each with an attached price.
- livemode boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed
Payments SubscriptionManaged Payments - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- metadata {[key: string]: string}
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- next
Pending numberInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object string
- String representing the object's type. Objects of the same type share the same value.
- off
Session boolean - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on
Behalf stringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause
Collection SubscriptionPause Collection - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment
Behavior string - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment
Settings SubscriptionPayment Settings - Payment settings passed on to invoices created by the subscription.
- pending
Invoice SubscriptionItem Interval Pending Invoice Item Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- pending
Setup stringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending
Update SubscriptionPending Update - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment
Details SubscriptionPresentment Details - proration
Behavior string - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - schedule string
- The schedule attached to the subscription
- start
Date number - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status string
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test
Clock string - ID of the test clock this subscription belongs to.
- transfer
Data SubscriptionTransfer Data - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial
End number - If the subscription has a trial, the end of that trial.
- trial
From booleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial
Period numberDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial
Settings SubscriptionTrial Settings - Settings related to subscription trials.
- trial
Start number - If the subscription has a trial, the beginning of that trial.
- add_
invoice_ Sequence[Subscriptionitems Add Invoice Item Args] - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application str
- ID of the Connect Application that created the subscription.
- application_
fee_ floatpercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic_
tax SubscriptionAutomatic Tax Args - backdate_
start_ floatdate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing_
cycle_ floatanchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing_
cycle_ Subscriptionanchor_ config Billing Cycle Anchor Config Args - The fixed values used to calculate the
billing_cycle_anchor. - billing_
mode SubscriptionBilling Mode Args - The billing mode of the subscription.
- billing_
schedules Sequence[SubscriptionBilling Schedule Args] - Billing schedules for this subscription.
- billing_
thresholds SubscriptionBilling Thresholds Args - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel_
at float - A date in the future at which the subscription will automatically get canceled
- cancel_
at_ boolperiod_ end - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - canceled_
at float - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - cancellation_
details SubscriptionCancellation Details Args - Details about why this subscription was cancelled
- collection_
method str - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - created float
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer str
- ID of the customer who owns the subscription.
- customer_
account str - ID of the account representing the customer who owns the subscription.
- days_
until_ floatdue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default_
payment_ strmethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
source str - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default_
tax_ Sequence[str]rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description str
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts
Sequence[Subscription
Discount Args] - The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - ended_
at float - If the subscription has ended, the date the subscription ended.
- invoice_
settings SubscriptionInvoice Settings Args - items
Sequence[Subscription
Item Args] - List of subscription items, each with an attached price.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed_
payments SubscriptionManaged Payments Args - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- metadata Mapping[str, str]
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- next_
pending_ floatinvoice_ item_ invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object str
- String representing the object's type. Objects of the same type share the same value.
- off_
session bool - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on_
behalf_ strof - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause_
collection SubscriptionPause Collection Args - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment_
behavior str - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment_
settings SubscriptionPayment Settings Args - Payment settings passed on to invoices created by the subscription.
- pending_
invoice_ Subscriptionitem_ interval Pending Invoice Item Interval Args - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- pending_
setup_ strintent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending_
update SubscriptionPending Update Args - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment_
details SubscriptionPresentment Details Args - proration_
behavior str - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - schedule str
- The schedule attached to the subscription
- start_
date float - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status str
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test_
clock str - ID of the test clock this subscription belongs to.
- transfer_
data SubscriptionTransfer Data Args - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial_
end float - If the subscription has a trial, the end of that trial.
- trial_
from_ boolplan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial_
period_ floatdays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial_
settings SubscriptionTrial Settings Args - Settings related to subscription trials.
- trial_
start float - If the subscription has a trial, the beginning of that trial.
- add
Invoice List<Property Map>Items - A list of prices and quantities that will generate invoice items appended to the next invoice for this subscription. You may pass up to 20 items.
- application String
- ID of the Connect Application that created the subscription.
- application
Fee NumberPercent - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.
- automatic
Tax Property Map - backdate
Start NumberDate - A past timestamp to backdate the subscription's start date to. If set, the first invoice will contain line items for the timespan between the start date and the current time. Can be combined with trials and the billing cycle anchor.
- billing
Cycle NumberAnchor - The reference point that aligns future billing cycle dates. It sets the day of week for
weekintervals, the day of month formonthandyearintervals, and the month of year foryearintervals. The timestamp is in UTC format. - billing
Cycle Property MapAnchor Config - The fixed values used to calculate the
billing_cycle_anchor. - billing
Mode Property Map - The billing mode of the subscription.
- billing
Schedules List<Property Map> - Billing schedules for this subscription.
- billing
Thresholds Property Map - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
- cancel
At Number - A date in the future at which the subscription will automatically get canceled
- cancel
At BooleanPeriod End - Whether this subscription will (if
status=active) or did (ifstatus=canceled) cancel at the end of the current billing period. - canceled
At Number - If the subscription has been canceled, the date of that cancellation. If the subscription was canceled with
cancel_at_period_end,canceled_atwill reflect the time of the most recent update request, not the end of the subscription period when the subscription is automatically moved to a canceled state. - cancellation
Details Property Map - Details about why this subscription was cancelled
- collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription asactive. - created Number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer String
- ID of the customer who owns the subscription.
- customer
Account String - ID of the account representing the customer who owns the subscription.
- days
Until NumberDue - Number of days a customer has to pay invoices generated by this subscription. This value will be
nullfor subscriptions wherecollection_method=charge_automatically. - default
Payment StringMethod - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over
default_source. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Source String - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If
default_payment_methodis also set,default_payment_methodwill take precedence. If neither are set, invoices will use the customer's invoice_settings.default_payment_method or default_source. - default
Tax List<String>Rates - The tax rates that will apply to any subscription item that does not have
tax_ratesset. Invoices created will have theirdefault_tax_ratespopulated from the subscription. - description String
- The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
- discounts List<Property Map>
- The discounts applied to the subscription. Subscription item discounts are applied before subscription discounts. Use
expand[]=discountsto expand each discount. - ended
At Number - If the subscription has ended, the date the subscription ended.
- invoice
Settings Property Map - items List<Property Map>
- List of subscription items, each with an attached price.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - managed
Payments Property Map - Settings for Managed Payments for this Subscription and resulting Invoices and PaymentIntents.
- metadata Map<String>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- next
Pending NumberInvoice Item Invoice - Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at
pending_invoice_item_interval. - object String
- String representing the object's type. Objects of the same type share the same value.
- off
Session Boolean - Indicates if a customer is on or off-session while an invoice payment is attempted. Defaults to
false(on-session). - on
Behalf StringOf - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the Connect documentation for details.
- pause
Collection Property Map - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to
paused. Learn more about pausing collection. - payment
Behavior String - Controls how Stripe handles the first invoice when payment is required and
collection_method=charge_automatically. Subscriptions withcollection_method=send_invoiceare automatically activated regardless of the first Invoice status. - payment
Settings Property Map - Payment settings passed on to invoices created by the subscription.
- pending
Invoice Property MapItem Interval - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling Create an invoice for the given subscription at the specified interval.
- pending
Setup StringIntent - You can use this SetupIntent to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the SCA Migration Guide.
- pending
Update Property Map - If specified, pending updates that will be applied to the subscription once the
latest_invoicehas been paid. - presentment
Details Property Map - proration
Behavior String - Determines how to handle prorations resulting from the
billing_cycle_anchor. If no value is passed, the default iscreate_prorations. - schedule String
- The schedule attached to the subscription
- start
Date Number - Date when the subscription was first created. The date might differ from the
createddate due to backdating. - status String
Possible values are
incomplete,incomplete_expired,trialing,active,past_due,canceled,unpaid, orpaused.For
collection_method=charge_automaticallya subscription moves intoincompleteif the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into anactivestatus. If the first invoice is not paid within 23 hours, the subscription transitions toincomplete_expired. This is a terminal status, the open invoice will be voided and no further invoices will be generated.A subscription that is currently in a trial period is
trialingand moves toactivewhen the trial period is over.A subscription can only enter a
pausedstatus when a trial ends without a payment method. Apausedsubscription doesn't generate invoices and can be resumed after your customer adds their payment method. Thepausedstatus is different from pausing collection, which still generates invoices and leaves the subscription's status unchanged.If subscription
collection_method=charge_automatically, it becomespast_duewhen payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will becomecanceledorunpaid(depending on your subscriptions settings).If subscription
collection_method=send_invoiceit becomespast_duewhen its invoice is not paid by the due date, andcanceledorunpaidif it is still not paid by an additional deadline after that. Note that when a subscription has a status ofunpaid, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.- test
Clock String - ID of the test clock this subscription belongs to.
- transfer
Data Property Map - The account (if any) the subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
- trial
End Number - If the subscription has a trial, the end of that trial.
- trial
From BooleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more. - trial
Period NumberDays - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See Using trial periods on subscriptions to learn more.
- trial
Settings Property Map - Settings related to subscription trials.
- trial
Start Number - If the subscription has a trial, the beginning of that trial.
Supporting Types
SubscriptionAddInvoiceItem, SubscriptionAddInvoiceItemArgs
- Discountable bool
- Controls whether discounts apply to this invoice item. Defaults to true if no value is provided.
- Discounts
List<Subscription
Add Invoice Item Discount> - The coupons to redeem into discounts for the item.
- Metadata Dictionary<string, string>
- Set of key-value pairs 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. - Period
Subscription
Add Invoice Item Period - The period associated with this invoice item. If not set,
period.start.typedefaults tomax_item_period_startandperiod.end.typedefaults tomin_item_period_end. - Price string
- The ID of the price object. One of
priceorprice_datais required. - Price
Data SubscriptionAdd Invoice Item Price Data - Data used to generate a new Price object inline. One of
priceorprice_datais required. - Quantity double
- Quantity for this item. Defaults to 1.
- Tax
Rates List<string> - The tax rates which apply to the item. When set, the
default_tax_ratesdo not apply to this item.
- Discountable bool
- Controls whether discounts apply to this invoice item. Defaults to true if no value is provided.
- Discounts
[]Subscription
Add Invoice Item Discount - The coupons to redeem into discounts for the item.
- Metadata map[string]string
- Set of key-value pairs 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. - Period
Subscription
Add Invoice Item Period - The period associated with this invoice item. If not set,
period.start.typedefaults tomax_item_period_startandperiod.end.typedefaults tomin_item_period_end. - Price string
- The ID of the price object. One of
priceorprice_datais required. - Price
Data SubscriptionAdd Invoice Item Price Data - Data used to generate a new Price object inline. One of
priceorprice_datais required. - Quantity float64
- Quantity for this item. Defaults to 1.
- Tax
Rates []string - The tax rates which apply to the item. When set, the
default_tax_ratesdo not apply to this item.
- discountable bool
- Controls whether discounts apply to this invoice item. Defaults to true if no value is provided.
- discounts list(object)
- The coupons to redeem into discounts for the item.
- metadata map(string)
- Set of key-value pairs 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. - period object
- The period associated with this invoice item. If not set,
period.start.typedefaults tomax_item_period_startandperiod.end.typedefaults tomin_item_period_end. - price string
- The ID of the price object. One of
priceorprice_datais required. - price_
data object - Data used to generate a new Price object inline. One of
priceorprice_datais required. - quantity number
- Quantity for this item. Defaults to 1.
- tax_
rates list(string) - The tax rates which apply to the item. When set, the
default_tax_ratesdo not apply to this item.
- discountable Boolean
- Controls whether discounts apply to this invoice item. Defaults to true if no value is provided.
- discounts
List<Subscription
Add Invoice Item Discount> - The coupons to redeem into discounts for the item.
- metadata Map<String,String>
- Set of key-value pairs 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. - period
Subscription
Add Invoice Item Period - The period associated with this invoice item. If not set,
period.start.typedefaults tomax_item_period_startandperiod.end.typedefaults tomin_item_period_end. - price String
- The ID of the price object. One of
priceorprice_datais required. - price
Data SubscriptionAdd Invoice Item Price Data - Data used to generate a new Price object inline. One of
priceorprice_datais required. - quantity Double
- Quantity for this item. Defaults to 1.
- tax
Rates List<String> - The tax rates which apply to the item. When set, the
default_tax_ratesdo not apply to this item.
- discountable boolean
- Controls whether discounts apply to this invoice item. Defaults to true if no value is provided.
- discounts
Subscription
Add Invoice Item Discount[] - The coupons to redeem into discounts for the item.
- metadata {[key: string]: string}
- Set of key-value pairs 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. - period
Subscription
Add Invoice Item Period - The period associated with this invoice item. If not set,
period.start.typedefaults tomax_item_period_startandperiod.end.typedefaults tomin_item_period_end. - price string
- The ID of the price object. One of
priceorprice_datais required. - price
Data SubscriptionAdd Invoice Item Price Data - Data used to generate a new Price object inline. One of
priceorprice_datais required. - quantity number
- Quantity for this item. Defaults to 1.
- tax
Rates string[] - The tax rates which apply to the item. When set, the
default_tax_ratesdo not apply to this item.
- discountable bool
- Controls whether discounts apply to this invoice item. Defaults to true if no value is provided.
- discounts
Sequence[Subscription
Add Invoice Item Discount] - The coupons to redeem into discounts for the item.
- metadata Mapping[str, str]
- Set of key-value pairs 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. - period
Subscription
Add Invoice Item Period - The period associated with this invoice item. If not set,
period.start.typedefaults tomax_item_period_startandperiod.end.typedefaults tomin_item_period_end. - price str
- The ID of the price object. One of
priceorprice_datais required. - price_
data SubscriptionAdd Invoice Item Price Data - Data used to generate a new Price object inline. One of
priceorprice_datais required. - quantity float
- Quantity for this item. Defaults to 1.
- tax_
rates Sequence[str] - The tax rates which apply to the item. When set, the
default_tax_ratesdo not apply to this item.
- discountable Boolean
- Controls whether discounts apply to this invoice item. Defaults to true if no value is provided.
- discounts List<Property Map>
- The coupons to redeem into discounts for the item.
- metadata Map<String>
- Set of key-value pairs 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. - period Property Map
- The period associated with this invoice item. If not set,
period.start.typedefaults tomax_item_period_startandperiod.end.typedefaults tomin_item_period_end. - price String
- The ID of the price object. One of
priceorprice_datais required. - price
Data Property Map - Data used to generate a new Price object inline. One of
priceorprice_datais required. - quantity Number
- Quantity for this item. Defaults to 1.
- tax
Rates List<String> - The tax rates which apply to the item. When set, the
default_tax_ratesdo not apply to this item.
SubscriptionAddInvoiceItemDiscount, SubscriptionAddInvoiceItemDiscountArgs
- Coupon string
- ID of the coupon to create a new discount for.
- Discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- Promotion
Code string - ID of the promotion code to create a new discount for.
- Coupon string
- ID of the coupon to create a new discount for.
- Discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- Promotion
Code string - ID of the promotion code to create a new discount for.
- coupon string
- ID of the coupon to create a new discount for.
- discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion_
code string - ID of the promotion code to create a new discount for.
- coupon String
- ID of the coupon to create a new discount for.
- discount String
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code String - ID of the promotion code to create a new discount for.
- coupon string
- ID of the coupon to create a new discount for.
- discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code string - ID of the promotion code to create a new discount for.
- coupon str
- ID of the coupon to create a new discount for.
- discount str
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion_
code str - ID of the promotion code to create a new discount for.
- coupon String
- ID of the coupon to create a new discount for.
- discount String
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code String - ID of the promotion code to create a new discount for.
SubscriptionAddInvoiceItemPeriod, SubscriptionAddInvoiceItemPeriodArgs
- End
Subscription
Add Invoice Item Period End - End of the invoice item period.
- Start
Subscription
Add Invoice Item Period Start - Start of the invoice item period.
- End
Subscription
Add Invoice Item Period End - End of the invoice item period.
- Start
Subscription
Add Invoice Item Period Start - Start of the invoice item period.
- end
Subscription
Add Invoice Item Period End - End of the invoice item period.
- start
Subscription
Add Invoice Item Period Start - Start of the invoice item period.
- end
Subscription
Add Invoice Item Period End - End of the invoice item period.
- start
Subscription
Add Invoice Item Period Start - Start of the invoice item period.
- end
Subscription
Add Invoice Item Period End - End of the invoice item period.
- start
Subscription
Add Invoice Item Period Start - Start of the invoice item period.
- end Property Map
- End of the invoice item period.
- start Property Map
- Start of the invoice item period.
SubscriptionAddInvoiceItemPeriodEnd, SubscriptionAddInvoiceItemPeriodEndArgs
SubscriptionAddInvoiceItemPeriodStart, SubscriptionAddInvoiceItemPeriodStartArgs
SubscriptionAddInvoiceItemPriceData, SubscriptionAddInvoiceItemPriceDataArgs
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Product string
- The ID of the Product that this Price will belong to.
- Tax
Behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - Unit
Amount double - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
- Unit
Amount doubleDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Product string
- The ID of the Product that this Price will belong to.
- Tax
Behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - Unit
Amount float64 - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
- Unit
Amount float64Decimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product string
- The ID of the Product that this Price will belong to.
- tax_
behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit_
amount number - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
- unit_
amount_ numberdecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product String
- The ID of the Product that this Price will belong to.
- tax
Behavior String - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit
Amount Double - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
- unit
Amount DoubleDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product string
- The ID of the Product that this Price will belong to.
- tax
Behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit
Amount number - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
- unit
Amount numberDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product str
- The ID of the Product that this Price will belong to.
- tax_
behavior str - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit_
amount float - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
- unit_
amount_ floatdecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product String
- The ID of the Product that this Price will belong to.
- tax
Behavior String - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit
Amount Number - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
- unit
Amount NumberDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
SubscriptionAutomaticTax, SubscriptionAutomaticTaxArgs
- Enabled bool
- Whether Stripe automatically computes tax on this subscription.
- Disabled
Reason string - If Stripe disabled automatic tax, this enum describes why.
- Liability
Subscription
Automatic Tax Liability - The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
- Enabled bool
- Whether Stripe automatically computes tax on this subscription.
- Disabled
Reason string - If Stripe disabled automatic tax, this enum describes why.
- Liability
Subscription
Automatic Tax Liability - The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
- enabled bool
- Whether Stripe automatically computes tax on this subscription.
- disabled_
reason string - If Stripe disabled automatic tax, this enum describes why.
- liability object
- The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
- enabled Boolean
- Whether Stripe automatically computes tax on this subscription.
- disabled
Reason String - If Stripe disabled automatic tax, this enum describes why.
- liability
Subscription
Automatic Tax Liability - The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
- enabled boolean
- Whether Stripe automatically computes tax on this subscription.
- disabled
Reason string - If Stripe disabled automatic tax, this enum describes why.
- liability
Subscription
Automatic Tax Liability - The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
- enabled bool
- Whether Stripe automatically computes tax on this subscription.
- disabled_
reason str - If Stripe disabled automatic tax, this enum describes why.
- liability
Subscription
Automatic Tax Liability - The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
- enabled Boolean
- Whether Stripe automatically computes tax on this subscription.
- disabled
Reason String - If Stripe disabled automatic tax, this enum describes why.
- liability Property Map
- The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
SubscriptionAutomaticTaxLiability, SubscriptionAutomaticTaxLiabilityArgs
SubscriptionBillingCycleAnchorConfig, SubscriptionBillingCycleAnchorConfigArgs
- Day
Of doubleMonth - The day of the month of the billingcycleanchor.
- Hour double
- The hour of the day of the billingcycleanchor.
- Minute double
- The minute of the hour of the billingcycleanchor.
- Month double
- The month to start full cycle billing periods.
- Second double
- The second of the minute of the billingcycleanchor.
- Day
Of float64Month - The day of the month of the billingcycleanchor.
- Hour float64
- The hour of the day of the billingcycleanchor.
- Minute float64
- The minute of the hour of the billingcycleanchor.
- Month float64
- The month to start full cycle billing periods.
- Second float64
- The second of the minute of the billingcycleanchor.
- day_
of_ numbermonth - The day of the month of the billingcycleanchor.
- hour number
- The hour of the day of the billingcycleanchor.
- minute number
- The minute of the hour of the billingcycleanchor.
- month number
- The month to start full cycle billing periods.
- second number
- The second of the minute of the billingcycleanchor.
- day
Of DoubleMonth - The day of the month of the billingcycleanchor.
- hour Double
- The hour of the day of the billingcycleanchor.
- minute Double
- The minute of the hour of the billingcycleanchor.
- month Double
- The month to start full cycle billing periods.
- second Double
- The second of the minute of the billingcycleanchor.
- day
Of numberMonth - The day of the month of the billingcycleanchor.
- hour number
- The hour of the day of the billingcycleanchor.
- minute number
- The minute of the hour of the billingcycleanchor.
- month number
- The month to start full cycle billing periods.
- second number
- The second of the minute of the billingcycleanchor.
- day_
of_ floatmonth - The day of the month of the billingcycleanchor.
- hour float
- The hour of the day of the billingcycleanchor.
- minute float
- The minute of the hour of the billingcycleanchor.
- month float
- The month to start full cycle billing periods.
- second float
- The second of the minute of the billingcycleanchor.
- day
Of NumberMonth - The day of the month of the billingcycleanchor.
- hour Number
- The hour of the day of the billingcycleanchor.
- minute Number
- The minute of the hour of the billingcycleanchor.
- month Number
- The month to start full cycle billing periods.
- second Number
- The second of the minute of the billingcycleanchor.
SubscriptionBillingMode, SubscriptionBillingModeArgs
- Type string
- Controls how prorations and invoices for subscriptions are calculated and orchestrated.
- Flexible
Subscription
Billing Mode Flexible - Configure behavior for flexible billing mode
- Updated
At double - Details on when the current billing_mode was adopted.
- Type string
- Controls how prorations and invoices for subscriptions are calculated and orchestrated.
- Flexible
Subscription
Billing Mode Flexible - Configure behavior for flexible billing mode
- Updated
At float64 - Details on when the current billing_mode was adopted.
- type string
- Controls how prorations and invoices for subscriptions are calculated and orchestrated.
- flexible object
- Configure behavior for flexible billing mode
- updated_
at number - Details on when the current billing_mode was adopted.
- type String
- Controls how prorations and invoices for subscriptions are calculated and orchestrated.
- flexible
Subscription
Billing Mode Flexible - Configure behavior for flexible billing mode
- updated
At Double - Details on when the current billing_mode was adopted.
- type string
- Controls how prorations and invoices for subscriptions are calculated and orchestrated.
- flexible
Subscription
Billing Mode Flexible - Configure behavior for flexible billing mode
- updated
At number - Details on when the current billing_mode was adopted.
- type str
- Controls how prorations and invoices for subscriptions are calculated and orchestrated.
- flexible
Subscription
Billing Mode Flexible - Configure behavior for flexible billing mode
- updated_
at float - Details on when the current billing_mode was adopted.
- type String
- Controls how prorations and invoices for subscriptions are calculated and orchestrated.
- flexible Property Map
- Configure behavior for flexible billing mode
- updated
At Number - Details on when the current billing_mode was adopted.
SubscriptionBillingModeFlexible, SubscriptionBillingModeFlexibleArgs
- Proration
Discounts string - Controls how invoices and invoice items display proration amounts and discount amounts.
- Proration
Discounts string - Controls how invoices and invoice items display proration amounts and discount amounts.
- proration_
discounts string - Controls how invoices and invoice items display proration amounts and discount amounts.
- proration
Discounts String - Controls how invoices and invoice items display proration amounts and discount amounts.
- proration
Discounts string - Controls how invoices and invoice items display proration amounts and discount amounts.
- proration_
discounts str - Controls how invoices and invoice items display proration amounts and discount amounts.
- proration
Discounts String - Controls how invoices and invoice items display proration amounts and discount amounts.
SubscriptionBillingSchedule, SubscriptionBillingScheduleArgs
- Bill
Until SubscriptionBilling Schedule Bill Until - Specifies the end of billing period.
- Applies
Tos List<SubscriptionBilling Schedule Applies To> - Specifies which subscription items the billing schedule applies to.
- Key string
- Unique identifier for the billing schedule.
- Bill
Until SubscriptionBilling Schedule Bill Until - Specifies the end of billing period.
- Applies
Tos []SubscriptionBilling Schedule Applies To - Specifies which subscription items the billing schedule applies to.
- Key string
- Unique identifier for the billing schedule.
- bill_
until object - Specifies the end of billing period.
- applies_
tos list(object) - Specifies which subscription items the billing schedule applies to.
- key string
- Unique identifier for the billing schedule.
- bill
Until SubscriptionBilling Schedule Bill Until - Specifies the end of billing period.
- applies
Tos List<SubscriptionBilling Schedule Applies To> - Specifies which subscription items the billing schedule applies to.
- key String
- Unique identifier for the billing schedule.
- bill
Until SubscriptionBilling Schedule Bill Until - Specifies the end of billing period.
- applies
Tos SubscriptionBilling Schedule Applies To[] - Specifies which subscription items the billing schedule applies to.
- key string
- Unique identifier for the billing schedule.
- bill_
until SubscriptionBilling Schedule Bill Until - Specifies the end of billing period.
- applies_
tos Sequence[SubscriptionBilling Schedule Applies To] - Specifies which subscription items the billing schedule applies to.
- key str
- Unique identifier for the billing schedule.
- bill
Until Property Map - Specifies the end of billing period.
- applies
Tos List<Property Map> - Specifies which subscription items the billing schedule applies to.
- key String
- Unique identifier for the billing schedule.
SubscriptionBillingScheduleAppliesTo, SubscriptionBillingScheduleAppliesToArgs
SubscriptionBillingScheduleBillUntil, SubscriptionBillingScheduleBillUntilArgs
- Type string
- Describes how the billing schedule will determine the end date. Either
durationortimestamp. - Computed
Timestamp double - The timestamp the billing schedule will apply until.
- Duration
Subscription
Billing Schedule Bill Until Duration - Specifies the billing period.
- Timestamp double
- If specified, the billing schedule will apply until the specified timestamp.
- Type string
- Describes how the billing schedule will determine the end date. Either
durationortimestamp. - Computed
Timestamp float64 - The timestamp the billing schedule will apply until.
- Duration
Subscription
Billing Schedule Bill Until Duration - Specifies the billing period.
- Timestamp float64
- If specified, the billing schedule will apply until the specified timestamp.
- type string
- Describes how the billing schedule will determine the end date. Either
durationortimestamp. - computed_
timestamp number - The timestamp the billing schedule will apply until.
- duration object
- Specifies the billing period.
- timestamp number
- If specified, the billing schedule will apply until the specified timestamp.
- type String
- Describes how the billing schedule will determine the end date. Either
durationortimestamp. - computed
Timestamp Double - The timestamp the billing schedule will apply until.
- duration
Subscription
Billing Schedule Bill Until Duration - Specifies the billing period.
- timestamp Double
- If specified, the billing schedule will apply until the specified timestamp.
- type string
- Describes how the billing schedule will determine the end date. Either
durationortimestamp. - computed
Timestamp number - The timestamp the billing schedule will apply until.
- duration
Subscription
Billing Schedule Bill Until Duration - Specifies the billing period.
- timestamp number
- If specified, the billing schedule will apply until the specified timestamp.
- type str
- Describes how the billing schedule will determine the end date. Either
durationortimestamp. - computed_
timestamp float - The timestamp the billing schedule will apply until.
- duration
Subscription
Billing Schedule Bill Until Duration - Specifies the billing period.
- timestamp float
- If specified, the billing schedule will apply until the specified timestamp.
- type String
- Describes how the billing schedule will determine the end date. Either
durationortimestamp. - computed
Timestamp Number - The timestamp the billing schedule will apply until.
- duration Property Map
- Specifies the billing period.
- timestamp Number
- If specified, the billing schedule will apply until the specified timestamp.
SubscriptionBillingScheduleBillUntilDuration, SubscriptionBillingScheduleBillUntilDurationArgs
- Interval string
- Specifies billing duration. Either
day,week,monthoryear. - Interval
Count double - The multiplier applied to the interval.
- Interval string
- Specifies billing duration. Either
day,week,monthoryear. - Interval
Count float64 - The multiplier applied to the interval.
- interval string
- Specifies billing duration. Either
day,week,monthoryear. - interval_
count number - The multiplier applied to the interval.
- interval String
- Specifies billing duration. Either
day,week,monthoryear. - interval
Count Double - The multiplier applied to the interval.
- interval string
- Specifies billing duration. Either
day,week,monthoryear. - interval
Count number - The multiplier applied to the interval.
- interval str
- Specifies billing duration. Either
day,week,monthoryear. - interval_
count float - The multiplier applied to the interval.
- interval String
- Specifies billing duration. Either
day,week,monthoryear. - interval
Count Number - The multiplier applied to the interval.
SubscriptionBillingThresholds, SubscriptionBillingThresholdsArgs
- Amount
Gte double - Monetary threshold that triggers the subscription to create an invoice
- Reset
Billing boolCycle Anchor - Indicates if the
billing_cycle_anchorshould be reset when a threshold is reached. If true,billing_cycle_anchorwill be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not betrueif the subscription contains items with plans that haveaggregate_usage=last_ever.
- Amount
Gte float64 - Monetary threshold that triggers the subscription to create an invoice
- Reset
Billing boolCycle Anchor - Indicates if the
billing_cycle_anchorshould be reset when a threshold is reached. If true,billing_cycle_anchorwill be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not betrueif the subscription contains items with plans that haveaggregate_usage=last_ever.
- amount_
gte number - Monetary threshold that triggers the subscription to create an invoice
- reset_
billing_ boolcycle_ anchor - Indicates if the
billing_cycle_anchorshould be reset when a threshold is reached. If true,billing_cycle_anchorwill be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not betrueif the subscription contains items with plans that haveaggregate_usage=last_ever.
- amount
Gte Double - Monetary threshold that triggers the subscription to create an invoice
- reset
Billing BooleanCycle Anchor - Indicates if the
billing_cycle_anchorshould be reset when a threshold is reached. If true,billing_cycle_anchorwill be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not betrueif the subscription contains items with plans that haveaggregate_usage=last_ever.
- amount
Gte number - Monetary threshold that triggers the subscription to create an invoice
- reset
Billing booleanCycle Anchor - Indicates if the
billing_cycle_anchorshould be reset when a threshold is reached. If true,billing_cycle_anchorwill be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not betrueif the subscription contains items with plans that haveaggregate_usage=last_ever.
- amount_
gte float - Monetary threshold that triggers the subscription to create an invoice
- reset_
billing_ boolcycle_ anchor - Indicates if the
billing_cycle_anchorshould be reset when a threshold is reached. If true,billing_cycle_anchorwill be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not betrueif the subscription contains items with plans that haveaggregate_usage=last_ever.
- amount
Gte Number - Monetary threshold that triggers the subscription to create an invoice
- reset
Billing BooleanCycle Anchor - Indicates if the
billing_cycle_anchorshould be reset when a threshold is reached. If true,billing_cycle_anchorwill be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged. This value may not betrueif the subscription contains items with plans that haveaggregate_usage=last_ever.
SubscriptionCancellationDetails, SubscriptionCancellationDetailsArgs
- Comment string
- Additional comments about why the user canceled the subscription, if the subscription was canceled explicitly by the user.
- Feedback string
- The customer submitted reason for why they canceled, if the subscription was canceled explicitly by the user.
- Reason string
- Why this subscription was canceled.
- Comment string
- Additional comments about why the user canceled the subscription, if the subscription was canceled explicitly by the user.
- Feedback string
- The customer submitted reason for why they canceled, if the subscription was canceled explicitly by the user.
- Reason string
- Why this subscription was canceled.
- comment string
- Additional comments about why the user canceled the subscription, if the subscription was canceled explicitly by the user.
- feedback string
- The customer submitted reason for why they canceled, if the subscription was canceled explicitly by the user.
- reason string
- Why this subscription was canceled.
- comment String
- Additional comments about why the user canceled the subscription, if the subscription was canceled explicitly by the user.
- feedback String
- The customer submitted reason for why they canceled, if the subscription was canceled explicitly by the user.
- reason String
- Why this subscription was canceled.
- comment string
- Additional comments about why the user canceled the subscription, if the subscription was canceled explicitly by the user.
- feedback string
- The customer submitted reason for why they canceled, if the subscription was canceled explicitly by the user.
- reason string
- Why this subscription was canceled.
- comment String
- Additional comments about why the user canceled the subscription, if the subscription was canceled explicitly by the user.
- feedback String
- The customer submitted reason for why they canceled, if the subscription was canceled explicitly by the user.
- reason String
- Why this subscription was canceled.
SubscriptionDiscount, SubscriptionDiscountArgs
- Coupon string
- ID of the coupon to create a new discount for.
- Discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- Promotion
Code string - ID of the promotion code to create a new discount for.
- Coupon string
- ID of the coupon to create a new discount for.
- Discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- Promotion
Code string - ID of the promotion code to create a new discount for.
- coupon string
- ID of the coupon to create a new discount for.
- discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion_
code string - ID of the promotion code to create a new discount for.
- coupon String
- ID of the coupon to create a new discount for.
- discount String
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code String - ID of the promotion code to create a new discount for.
- coupon string
- ID of the coupon to create a new discount for.
- discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code string - ID of the promotion code to create a new discount for.
- coupon str
- ID of the coupon to create a new discount for.
- discount str
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion_
code str - ID of the promotion code to create a new discount for.
- coupon String
- ID of the coupon to create a new discount for.
- discount String
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code String - ID of the promotion code to create a new discount for.
SubscriptionInvoiceSettings, SubscriptionInvoiceSettingsArgs
- Account
Tax List<string>Ids - The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
- Issuer
Subscription
Invoice Settings Issuer
- Account
Tax []stringIds - The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
- Issuer
Subscription
Invoice Settings Issuer
- account_
tax_ list(string)ids - The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
- issuer object
- account
Tax List<String>Ids - The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
- issuer
Subscription
Invoice Settings Issuer
- account
Tax string[]Ids - The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
- issuer
Subscription
Invoice Settings Issuer
- account_
tax_ Sequence[str]ids - The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
- issuer
Subscription
Invoice Settings Issuer
- account
Tax List<String>Ids - The account tax IDs associated with the subscription. Will be set on invoices generated by the subscription.
- issuer Property Map
SubscriptionInvoiceSettingsIssuer, SubscriptionInvoiceSettingsIssuerArgs
SubscriptionItem, SubscriptionItemArgs
- Billing
Thresholds SubscriptionItem Billing Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
- Discounts
List<Subscription
Item Discount> - The coupons to redeem into discounts for the subscription item.
- Id string
- Unique identifier for the object.
- Metadata Dictionary<string, string>
- Set of key-value pairs 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. - Price string
- The ID of the price object.
- Price
Data SubscriptionItem Price Data - Data used to generate a new Price object inline.
- Quantity double
- Quantity for this item.
- Tax
Rates List<string> - A list of Tax Rate ids. These Tax Rates will override the
default_tax_rateson the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
- Billing
Thresholds SubscriptionItem Billing Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
- Discounts
[]Subscription
Item Discount - The coupons to redeem into discounts for the subscription item.
- Id string
- Unique identifier for the object.
- Metadata map[string]string
- Set of key-value pairs 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. - Price string
- The ID of the price object.
- Price
Data SubscriptionItem Price Data - Data used to generate a new Price object inline.
- Quantity float64
- Quantity for this item.
- Tax
Rates []string - A list of Tax Rate ids. These Tax Rates will override the
default_tax_rateson the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
- billing_
thresholds object - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
- discounts list(object)
- The coupons to redeem into discounts for the subscription item.
- id string
- Unique identifier for the object.
- metadata map(string)
- Set of key-value pairs 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. - price string
- The ID of the price object.
- price_
data object - Data used to generate a new Price object inline.
- quantity number
- Quantity for this item.
- tax_
rates list(string) - A list of Tax Rate ids. These Tax Rates will override the
default_tax_rateson the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
- billing
Thresholds SubscriptionItem Billing Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
- discounts
List<Subscription
Item Discount> - The coupons to redeem into discounts for the subscription item.
- id String
- Unique identifier for the object.
- metadata Map<String,String>
- Set of key-value pairs 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. - price String
- The ID of the price object.
- price
Data SubscriptionItem Price Data - Data used to generate a new Price object inline.
- quantity Double
- Quantity for this item.
- tax
Rates List<String> - A list of Tax Rate ids. These Tax Rates will override the
default_tax_rateson the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
- billing
Thresholds SubscriptionItem Billing Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
- discounts
Subscription
Item Discount[] - The coupons to redeem into discounts for the subscription item.
- id string
- Unique identifier for the object.
- metadata {[key: string]: string}
- Set of key-value pairs 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. - price string
- The ID of the price object.
- price
Data SubscriptionItem Price Data - Data used to generate a new Price object inline.
- quantity number
- Quantity for this item.
- tax
Rates string[] - A list of Tax Rate ids. These Tax Rates will override the
default_tax_rateson the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
- billing_
thresholds SubscriptionItem Billing Thresholds - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
- discounts
Sequence[Subscription
Item Discount] - The coupons to redeem into discounts for the subscription item.
- id str
- Unique identifier for the object.
- metadata Mapping[str, str]
- Set of key-value pairs 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. - price str
- The ID of the price object.
- price_
data SubscriptionItem Price Data - Data used to generate a new Price object inline.
- quantity float
- Quantity for this item.
- tax_
rates Sequence[str] - A list of Tax Rate ids. These Tax Rates will override the
default_tax_rateson the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
- billing
Thresholds Property Map - Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
- discounts List<Property Map>
- The coupons to redeem into discounts for the subscription item.
- id String
- Unique identifier for the object.
- metadata Map<String>
- Set of key-value pairs 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. - price String
- The ID of the price object.
- price
Data Property Map - Data used to generate a new Price object inline.
- quantity Number
- Quantity for this item.
- tax
Rates List<String> - A list of Tax Rate ids. These Tax Rates will override the
default_tax_rateson the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
SubscriptionItemBillingThresholds, SubscriptionItemBillingThresholdsArgs
- Usage
Gte double - Usage threshold that triggers the subscription to create an invoice
- Usage
Gte float64 - Usage threshold that triggers the subscription to create an invoice
- usage_
gte number - Usage threshold that triggers the subscription to create an invoice
- usage
Gte Double - Usage threshold that triggers the subscription to create an invoice
- usage
Gte number - Usage threshold that triggers the subscription to create an invoice
- usage_
gte float - Usage threshold that triggers the subscription to create an invoice
- usage
Gte Number - Usage threshold that triggers the subscription to create an invoice
SubscriptionItemDiscount, SubscriptionItemDiscountArgs
- Coupon string
- ID of the coupon to create a new discount for.
- Discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- Promotion
Code string - ID of the promotion code to create a new discount for.
- Coupon string
- ID of the coupon to create a new discount for.
- Discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- Promotion
Code string - ID of the promotion code to create a new discount for.
- coupon string
- ID of the coupon to create a new discount for.
- discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion_
code string - ID of the promotion code to create a new discount for.
- coupon String
- ID of the coupon to create a new discount for.
- discount String
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code String - ID of the promotion code to create a new discount for.
- coupon string
- ID of the coupon to create a new discount for.
- discount string
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code string - ID of the promotion code to create a new discount for.
- coupon str
- ID of the coupon to create a new discount for.
- discount str
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion_
code str - ID of the promotion code to create a new discount for.
- coupon String
- ID of the coupon to create a new discount for.
- discount String
- ID of an existing discount on the object (or one of its ancestors) to reuse.
- promotion
Code String - ID of the promotion code to create a new discount for.
SubscriptionItemPriceData, SubscriptionItemPriceDataArgs
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Product string
- The ID of the Product that this Price will belong to.
- Recurring
Subscription
Item Price Data Recurring - The recurring components of a price such as
intervalandinterval_count. - Tax
Behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - Unit
Amount double - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
- Unit
Amount doubleDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Product string
- The ID of the Product that this Price will belong to.
- Recurring
Subscription
Item Price Data Recurring - The recurring components of a price such as
intervalandinterval_count. - Tax
Behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - Unit
Amount float64 - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
- Unit
Amount float64Decimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product string
- The ID of the Product that this Price will belong to.
- recurring object
- The recurring components of a price such as
intervalandinterval_count. - tax_
behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit_
amount number - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
- unit_
amount_ numberdecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product String
- The ID of the Product that this Price will belong to.
- recurring
Subscription
Item Price Data Recurring - The recurring components of a price such as
intervalandinterval_count. - tax
Behavior String - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit
Amount Double - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
- unit
Amount DoubleDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product string
- The ID of the Product that this Price will belong to.
- recurring
Subscription
Item Price Data Recurring - The recurring components of a price such as
intervalandinterval_count. - tax
Behavior string - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit
Amount number - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
- unit
Amount numberDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product str
- The ID of the Product that this Price will belong to.
- recurring
Subscription
Item Price Data Recurring - The recurring components of a price such as
intervalandinterval_count. - tax_
behavior str - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit_
amount float - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
- unit_
amount_ floatdecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- product String
- The ID of the Product that this Price will belong to.
- recurring Property Map
- The recurring components of a price such as
intervalandinterval_count. - tax
Behavior String - Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. Once specified as eitherinclusiveorexclusive, it cannot be changed. - unit
Amount Number - A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
- unit
Amount NumberDecimal - Same as
unit_amount, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one ofunit_amountandunit_amount_decimalcan be set.
SubscriptionItemPriceDataRecurring, SubscriptionItemPriceDataRecurringArgs
- Interval string
- Specifies billing frequency. Either
day,week,monthoryear. - Interval
Count double - The number of intervals between subscription billings. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
- Interval string
- Specifies billing frequency. Either
day,week,monthoryear. - Interval
Count float64 - The number of intervals between subscription billings. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
- interval string
- Specifies billing frequency. Either
day,week,monthoryear. - interval_
count number - The number of intervals between subscription billings. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
- interval String
- Specifies billing frequency. Either
day,week,monthoryear. - interval
Count Double - The number of intervals between subscription billings. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
- interval string
- Specifies billing frequency. Either
day,week,monthoryear. - interval
Count number - The number of intervals between subscription billings. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
- interval str
- Specifies billing frequency. Either
day,week,monthoryear. - interval_
count float - The number of intervals between subscription billings. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
- interval String
- Specifies billing frequency. Either
day,week,monthoryear. - interval
Count Number - The number of intervals between subscription billings. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
SubscriptionManagedPayments, SubscriptionManagedPaymentsArgs
- Enabled bool
- Set to
trueto enable Managed Payments, Stripe's merchant of record solution, for this session.
- Enabled bool
- Set to
trueto enable Managed Payments, Stripe's merchant of record solution, for this session.
- enabled bool
- Set to
trueto enable Managed Payments, Stripe's merchant of record solution, for this session.
- enabled Boolean
- Set to
trueto enable Managed Payments, Stripe's merchant of record solution, for this session.
- enabled boolean
- Set to
trueto enable Managed Payments, Stripe's merchant of record solution, for this session.
- enabled bool
- Set to
trueto enable Managed Payments, Stripe's merchant of record solution, for this session.
- enabled Boolean
- Set to
trueto enable Managed Payments, Stripe's merchant of record solution, for this session.
SubscriptionPauseCollection, SubscriptionPauseCollectionArgs
- behavior string
- The payment collection behavior for this subscription while paused.
- resumes_
at number - The time after which the subscription will resume collecting payments.
- behavior str
- The payment collection behavior for this subscription while paused.
- resumes_
at float - The time after which the subscription will resume collecting payments.
SubscriptionPaymentSettings, SubscriptionPaymentSettingsArgs
- Payment
Method SubscriptionOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to invoices created by the subscription.
- Payment
Method List<string>Types - The list of payment method types to provide to every invoice created by the subscription. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.
- Save
Default stringPayment Method - Configure whether Stripe updates
subscription.default_payment_methodwhen payment succeeds. Defaults tooff.
- Payment
Method SubscriptionOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to invoices created by the subscription.
- Payment
Method []stringTypes - The list of payment method types to provide to every invoice created by the subscription. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.
- Save
Default stringPayment Method - Configure whether Stripe updates
subscription.default_payment_methodwhen payment succeeds. Defaults tooff.
- payment_
method_ objectoptions - Payment-method-specific configuration to provide to invoices created by the subscription.
- payment_
method_ list(string)types - The list of payment method types to provide to every invoice created by the subscription. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.
- save_
default_ stringpayment_ method - Configure whether Stripe updates
subscription.default_payment_methodwhen payment succeeds. Defaults tooff.
- payment
Method SubscriptionOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to invoices created by the subscription.
- payment
Method List<String>Types - The list of payment method types to provide to every invoice created by the subscription. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.
- save
Default StringPayment Method - Configure whether Stripe updates
subscription.default_payment_methodwhen payment succeeds. Defaults tooff.
- payment
Method SubscriptionOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to invoices created by the subscription.
- payment
Method string[]Types - The list of payment method types to provide to every invoice created by the subscription. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.
- save
Default stringPayment Method - Configure whether Stripe updates
subscription.default_payment_methodwhen payment succeeds. Defaults tooff.
- payment_
method_ Subscriptionoptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to invoices created by the subscription.
- payment_
method_ Sequence[str]types - The list of payment method types to provide to every invoice created by the subscription. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.
- save_
default_ strpayment_ method - Configure whether Stripe updates
subscription.default_payment_methodwhen payment succeeds. Defaults tooff.
- payment
Method Property MapOptions - Payment-method-specific configuration to provide to invoices created by the subscription.
- payment
Method List<String>Types - The list of payment method types to provide to every invoice created by the subscription. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.
- save
Default StringPayment Method - Configure whether Stripe updates
subscription.default_payment_methodwhen payment succeeds. Defaults tooff.
SubscriptionPaymentSettingsPaymentMethodOptions, SubscriptionPaymentSettingsPaymentMethodOptionsArgs
- Acss
Debit SubscriptionPayment Settings Payment Method Options Acss Debit - This sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to invoices created by the subscription.
- Bancontact
Subscription
Payment Settings Payment Method Options Bancontact - This sub-hash contains details about the Bancontact payment method options to pass to invoices created by the subscription.
- Card
Subscription
Payment Settings Payment Method Options Card - This sub-hash contains details about the Card payment method options to pass to invoices created by the subscription.
- Customer
Balance SubscriptionPayment Settings Payment Method Options Customer Balance - This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
- Payto
Subscription
Payment Settings Payment Method Options Payto - This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
- Pix
Subscription
Payment Settings Payment Method Options Pix - This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
- Upi
Subscription
Payment Settings Payment Method Options Upi - This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
- Us
Bank SubscriptionAccount Payment Settings Payment Method Options Us Bank Account - This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
- Acss
Debit SubscriptionPayment Settings Payment Method Options Acss Debit - This sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to invoices created by the subscription.
- Bancontact
Subscription
Payment Settings Payment Method Options Bancontact - This sub-hash contains details about the Bancontact payment method options to pass to invoices created by the subscription.
- Card
Subscription
Payment Settings Payment Method Options Card - This sub-hash contains details about the Card payment method options to pass to invoices created by the subscription.
- Customer
Balance SubscriptionPayment Settings Payment Method Options Customer Balance - This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
- Payto
Subscription
Payment Settings Payment Method Options Payto - This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
- Pix
Subscription
Payment Settings Payment Method Options Pix - This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
- Upi
Subscription
Payment Settings Payment Method Options Upi - This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
- Us
Bank SubscriptionAccount Payment Settings Payment Method Options Us Bank Account - This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
- acss_
debit object - This sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to invoices created by the subscription.
- bancontact object
- This sub-hash contains details about the Bancontact payment method options to pass to invoices created by the subscription.
- card object
- This sub-hash contains details about the Card payment method options to pass to invoices created by the subscription.
- customer_
balance object - This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
- payto object
- This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
- pix object
- This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
- upi object
- This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
- us_
bank_ objectaccount - This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
- acss
Debit SubscriptionPayment Settings Payment Method Options Acss Debit - This sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to invoices created by the subscription.
- bancontact
Subscription
Payment Settings Payment Method Options Bancontact - This sub-hash contains details about the Bancontact payment method options to pass to invoices created by the subscription.
- card
Subscription
Payment Settings Payment Method Options Card - This sub-hash contains details about the Card payment method options to pass to invoices created by the subscription.
- customer
Balance SubscriptionPayment Settings Payment Method Options Customer Balance - This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
- payto
Subscription
Payment Settings Payment Method Options Payto - This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
- pix
Subscription
Payment Settings Payment Method Options Pix - This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
- upi
Subscription
Payment Settings Payment Method Options Upi - This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
- us
Bank SubscriptionAccount Payment Settings Payment Method Options Us Bank Account - This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
- acss
Debit SubscriptionPayment Settings Payment Method Options Acss Debit - This sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to invoices created by the subscription.
- bancontact
Subscription
Payment Settings Payment Method Options Bancontact - This sub-hash contains details about the Bancontact payment method options to pass to invoices created by the subscription.
- card
Subscription
Payment Settings Payment Method Options Card - This sub-hash contains details about the Card payment method options to pass to invoices created by the subscription.
- customer
Balance SubscriptionPayment Settings Payment Method Options Customer Balance - This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
- payto
Subscription
Payment Settings Payment Method Options Payto - This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
- pix
Subscription
Payment Settings Payment Method Options Pix - This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
- upi
Subscription
Payment Settings Payment Method Options Upi - This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
- us
Bank SubscriptionAccount Payment Settings Payment Method Options Us Bank Account - This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
- acss_
debit SubscriptionPayment Settings Payment Method Options Acss Debit - This sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to invoices created by the subscription.
- bancontact
Subscription
Payment Settings Payment Method Options Bancontact - This sub-hash contains details about the Bancontact payment method options to pass to invoices created by the subscription.
- card
Subscription
Payment Settings Payment Method Options Card - This sub-hash contains details about the Card payment method options to pass to invoices created by the subscription.
- customer_
balance SubscriptionPayment Settings Payment Method Options Customer Balance - This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
- payto
Subscription
Payment Settings Payment Method Options Payto - This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
- pix
Subscription
Payment Settings Payment Method Options Pix - This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
- upi
Subscription
Payment Settings Payment Method Options Upi - This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
- us_
bank_ Subscriptionaccount Payment Settings Payment Method Options Us Bank Account - This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
- acss
Debit Property Map - This sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to invoices created by the subscription.
- bancontact Property Map
- This sub-hash contains details about the Bancontact payment method options to pass to invoices created by the subscription.
- card Property Map
- This sub-hash contains details about the Card payment method options to pass to invoices created by the subscription.
- customer
Balance Property Map - This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
- payto Property Map
- This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
- pix Property Map
- This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
- upi Property Map
- This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
- us
Bank Property MapAccount - This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebit, SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitArgs
- Mandate
Options SubscriptionPayment Settings Payment Method Options Acss Debit Mandate Options - Verification
Method string - Bank account verification method. The default value is
automatic.
- Mandate
Options SubscriptionPayment Settings Payment Method Options Acss Debit Mandate Options - Verification
Method string - Bank account verification method. The default value is
automatic.
- mandate_
options object - verification_
method string - Bank account verification method. The default value is
automatic.
- mandate
Options SubscriptionPayment Settings Payment Method Options Acss Debit Mandate Options - verification
Method String - Bank account verification method. The default value is
automatic.
- mandate
Options SubscriptionPayment Settings Payment Method Options Acss Debit Mandate Options - verification
Method string - Bank account verification method. The default value is
automatic.
- mandate_
options SubscriptionPayment Settings Payment Method Options Acss Debit Mandate Options - verification_
method str - Bank account verification method. The default value is
automatic.
- mandate
Options Property Map - verification
Method String - Bank account verification method. The default value is
automatic.
SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitMandateOptions, SubscriptionPaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs
- Transaction
Type string - Transaction type of the mandate.
- Transaction
Type string - Transaction type of the mandate.
- transaction_
type string - Transaction type of the mandate.
- transaction
Type String - Transaction type of the mandate.
- transaction
Type string - Transaction type of the mandate.
- transaction_
type str - Transaction type of the mandate.
- transaction
Type String - Transaction type of the mandate.
SubscriptionPaymentSettingsPaymentMethodOptionsBancontact, SubscriptionPaymentSettingsPaymentMethodOptionsBancontactArgs
- Preferred
Language string - Preferred language of the Bancontact authorization page that the customer is redirected to.
- Preferred
Language string - Preferred language of the Bancontact authorization page that the customer is redirected to.
- preferred_
language string - Preferred language of the Bancontact authorization page that the customer is redirected to.
- preferred
Language String - Preferred language of the Bancontact authorization page that the customer is redirected to.
- preferred
Language string - Preferred language of the Bancontact authorization page that the customer is redirected to.
- preferred_
language str - Preferred language of the Bancontact authorization page that the customer is redirected to.
- preferred
Language String - Preferred language of the Bancontact authorization page that the customer is redirected to.
SubscriptionPaymentSettingsPaymentMethodOptionsCard, SubscriptionPaymentSettingsPaymentMethodOptionsCardArgs
- Mandate
Options SubscriptionPayment Settings Payment Method Options Card Mandate Options - Network string
- Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
- Request
Three stringDSecure - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.
- Mandate
Options SubscriptionPayment Settings Payment Method Options Card Mandate Options - Network string
- Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
- Request
Three stringDSecure - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.
- mandate_
options object - network string
- Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
- request_
three_ stringd_ secure - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.
- mandate
Options SubscriptionPayment Settings Payment Method Options Card Mandate Options - network String
- Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
- request
Three StringDSecure - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.
- mandate
Options SubscriptionPayment Settings Payment Method Options Card Mandate Options - network string
- Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
- request
Three stringDSecure - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.
- mandate_
options SubscriptionPayment Settings Payment Method Options Card Mandate Options - network str
- Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
- request_
three_ strd_ secure - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.
- mandate
Options Property Map - network String
- Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
- request
Three StringDSecure - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.
SubscriptionPaymentSettingsPaymentMethodOptionsCardMandateOptions, SubscriptionPaymentSettingsPaymentMethodOptionsCardMandateOptionsArgs
- Amount double
- Amount to be charged for future payments, specified in the presentment currency.
- Amount
Type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - Description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- Amount float64
- Amount to be charged for future payments, specified in the presentment currency.
- Amount
Type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - Description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- amount number
- Amount to be charged for future payments, specified in the presentment currency.
- amount_
type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- amount Double
- Amount to be charged for future payments, specified in the presentment currency.
- amount
Type String - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description String
- A description of the mandate or subscription that is meant to be displayed to the customer.
- amount number
- Amount to be charged for future payments, specified in the presentment currency.
- amount
Type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- amount float
- Amount to be charged for future payments, specified in the presentment currency.
- amount_
type str - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description str
- A description of the mandate or subscription that is meant to be displayed to the customer.
- amount Number
- Amount to be charged for future payments, specified in the presentment currency.
- amount
Type String - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description String
- A description of the mandate or subscription that is meant to be displayed to the customer.
SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalance, SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceArgs
- Bank
Transfer SubscriptionPayment Settings Payment Method Options Customer Balance Bank Transfer - Funding
Type string - The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_transfer.
- Bank
Transfer SubscriptionPayment Settings Payment Method Options Customer Balance Bank Transfer - Funding
Type string - The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_transfer.
- bank_
transfer object - funding_
type string - The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_transfer.
- bank
Transfer SubscriptionPayment Settings Payment Method Options Customer Balance Bank Transfer - funding
Type String - The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_transfer.
- bank
Transfer SubscriptionPayment Settings Payment Method Options Customer Balance Bank Transfer - funding
Type string - The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_transfer.
- bank_
transfer SubscriptionPayment Settings Payment Method Options Customer Balance Bank Transfer - funding_
type str - The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_transfer.
- bank
Transfer Property Map - funding
Type String - The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_transfer.
SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransfer, SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs
- Eu
Bank SubscriptionTransfer Payment Settings Payment Method Options Customer Balance Bank Transfer Eu Bank Transfer - Type string
- The bank transfer type that can be used for funding. Permitted values include:
eu_bank_transfer,gb_bank_transfer,jp_bank_transfer,mx_bank_transfer, orus_bank_transfer.
- Eu
Bank SubscriptionTransfer Payment Settings Payment Method Options Customer Balance Bank Transfer Eu Bank Transfer - Type string
- The bank transfer type that can be used for funding. Permitted values include:
eu_bank_transfer,gb_bank_transfer,jp_bank_transfer,mx_bank_transfer, orus_bank_transfer.
- eu_
bank_ objecttransfer - type string
- The bank transfer type that can be used for funding. Permitted values include:
eu_bank_transfer,gb_bank_transfer,jp_bank_transfer,mx_bank_transfer, orus_bank_transfer.
- eu
Bank SubscriptionTransfer Payment Settings Payment Method Options Customer Balance Bank Transfer Eu Bank Transfer - type String
- The bank transfer type that can be used for funding. Permitted values include:
eu_bank_transfer,gb_bank_transfer,jp_bank_transfer,mx_bank_transfer, orus_bank_transfer.
- eu
Bank SubscriptionTransfer Payment Settings Payment Method Options Customer Balance Bank Transfer Eu Bank Transfer - type string
- The bank transfer type that can be used for funding. Permitted values include:
eu_bank_transfer,gb_bank_transfer,jp_bank_transfer,mx_bank_transfer, orus_bank_transfer.
- eu_
bank_ Subscriptiontransfer Payment Settings Payment Method Options Customer Balance Bank Transfer Eu Bank Transfer - type str
- The bank transfer type that can be used for funding. Permitted values include:
eu_bank_transfer,gb_bank_transfer,jp_bank_transfer,mx_bank_transfer, orus_bank_transfer.
- eu
Bank Property MapTransfer - type String
- The bank transfer type that can be used for funding. Permitted values include:
eu_bank_transfer,gb_bank_transfer,jp_bank_transfer,mx_bank_transfer, orus_bank_transfer.
SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, SubscriptionPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs
- Country string
- The desired country code of the bank account information. Permitted values include:
DE,FR,IE, orNL.
- Country string
- The desired country code of the bank account information. Permitted values include:
DE,FR,IE, orNL.
- country string
- The desired country code of the bank account information. Permitted values include:
DE,FR,IE, orNL.
- country String
- The desired country code of the bank account information. Permitted values include:
DE,FR,IE, orNL.
- country string
- The desired country code of the bank account information. Permitted values include:
DE,FR,IE, orNL.
- country str
- The desired country code of the bank account information. Permitted values include:
DE,FR,IE, orNL.
- country String
- The desired country code of the bank account information. Permitted values include:
DE,FR,IE, orNL.
SubscriptionPaymentSettingsPaymentMethodOptionsPayto, SubscriptionPaymentSettingsPaymentMethodOptionsPaytoArgs
SubscriptionPaymentSettingsPaymentMethodOptionsPaytoMandateOptions, SubscriptionPaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs
- Amount double
- The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
- Amount
Type string - Only
maximumis supported. - Purpose string
- The purpose for which payments are made. Has a default value based on your merchant category code.
- Amount float64
- The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
- Amount
Type string - Only
maximumis supported. - Purpose string
- The purpose for which payments are made. Has a default value based on your merchant category code.
- amount number
- The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
- amount_
type string - Only
maximumis supported. - purpose string
- The purpose for which payments are made. Has a default value based on your merchant category code.
- amount Double
- The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
- amount
Type String - Only
maximumis supported. - purpose String
- The purpose for which payments are made. Has a default value based on your merchant category code.
- amount number
- The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
- amount
Type string - Only
maximumis supported. - purpose string
- The purpose for which payments are made. Has a default value based on your merchant category code.
- amount float
- The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
- amount_
type str - Only
maximumis supported. - purpose str
- The purpose for which payments are made. Has a default value based on your merchant category code.
- amount Number
- The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
- amount
Type String - Only
maximumis supported. - purpose String
- The purpose for which payments are made. Has a default value based on your merchant category code.
SubscriptionPaymentSettingsPaymentMethodOptionsPix, SubscriptionPaymentSettingsPaymentMethodOptionsPixArgs
- Expires
After doubleSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- Mandate
Options SubscriptionPayment Settings Payment Method Options Pix Mandate Options
- Expires
After float64Seconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- Mandate
Options SubscriptionPayment Settings Payment Method Options Pix Mandate Options
- expires_
after_ numberseconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- mandate_
options object
- expires
After DoubleSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- mandate
Options SubscriptionPayment Settings Payment Method Options Pix Mandate Options
- expires
After numberSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- mandate
Options SubscriptionPayment Settings Payment Method Options Pix Mandate Options
- expires_
after_ floatseconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- mandate_
options SubscriptionPayment Settings Payment Method Options Pix Mandate Options
- expires
After NumberSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- mandate
Options Property Map
SubscriptionPaymentSettingsPaymentMethodOptionsPixMandateOptions, SubscriptionPaymentSettingsPaymentMethodOptionsPixMandateOptionsArgs
- Amount double
- Amount to be charged for future payments.
- Amount
Includes stringIof - Determines if the amount includes the IOF tax.
- End
Date string - Date when the mandate expires and no further payments will be charged, in
YYYY-MM-DD. - Payment
Schedule string - Schedule at which the future payments will be charged.
- Amount float64
- Amount to be charged for future payments.
- Amount
Includes stringIof - Determines if the amount includes the IOF tax.
- End
Date string - Date when the mandate expires and no further payments will be charged, in
YYYY-MM-DD. - Payment
Schedule string - Schedule at which the future payments will be charged.
- amount number
- Amount to be charged for future payments.
- amount_
includes_ stringiof - Determines if the amount includes the IOF tax.
- end_
date string - Date when the mandate expires and no further payments will be charged, in
YYYY-MM-DD. - payment_
schedule string - Schedule at which the future payments will be charged.
- amount Double
- Amount to be charged for future payments.
- amount
Includes StringIof - Determines if the amount includes the IOF tax.
- end
Date String - Date when the mandate expires and no further payments will be charged, in
YYYY-MM-DD. - payment
Schedule String - Schedule at which the future payments will be charged.
- amount number
- Amount to be charged for future payments.
- amount
Includes stringIof - Determines if the amount includes the IOF tax.
- end
Date string - Date when the mandate expires and no further payments will be charged, in
YYYY-MM-DD. - payment
Schedule string - Schedule at which the future payments will be charged.
- amount float
- Amount to be charged for future payments.
- amount_
includes_ striof - Determines if the amount includes the IOF tax.
- end_
date str - Date when the mandate expires and no further payments will be charged, in
YYYY-MM-DD. - payment_
schedule str - Schedule at which the future payments will be charged.
- amount Number
- Amount to be charged for future payments.
- amount
Includes StringIof - Determines if the amount includes the IOF tax.
- end
Date String - Date when the mandate expires and no further payments will be charged, in
YYYY-MM-DD. - payment
Schedule String - Schedule at which the future payments will be charged.
SubscriptionPaymentSettingsPaymentMethodOptionsUpi, SubscriptionPaymentSettingsPaymentMethodOptionsUpiArgs
SubscriptionPaymentSettingsPaymentMethodOptionsUpiMandateOptions, SubscriptionPaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs
- Amount double
- Amount to be charged for future payments.
- Amount
Type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - Description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- End
Date double - End date of the mandate or subscription.
- Amount float64
- Amount to be charged for future payments.
- Amount
Type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - Description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- End
Date float64 - End date of the mandate or subscription.
- amount number
- Amount to be charged for future payments.
- amount_
type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- end_
date number - End date of the mandate or subscription.
- amount Double
- Amount to be charged for future payments.
- amount
Type String - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description String
- A description of the mandate or subscription that is meant to be displayed to the customer.
- end
Date Double - End date of the mandate or subscription.
- amount number
- Amount to be charged for future payments.
- amount
Type string - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description string
- A description of the mandate or subscription that is meant to be displayed to the customer.
- end
Date number - End date of the mandate or subscription.
- amount float
- Amount to be charged for future payments.
- amount_
type str - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description str
- A description of the mandate or subscription that is meant to be displayed to the customer.
- end_
date float - End date of the mandate or subscription.
- amount Number
- Amount to be charged for future payments.
- amount
Type String - One of
fixedormaximum. Iffixed, theamountparam refers to the exact amount to be charged in future payments. Ifmaximum, the amount charged can be up to the value passed for theamountparam. - description String
- A description of the mandate or subscription that is meant to be displayed to the customer.
- end
Date Number - End date of the mandate or subscription.
SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccount, SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountArgs
- Financial
Connections SubscriptionPayment Settings Payment Method Options Us Bank Account Financial Connections - Verification
Method string - Bank account verification method. The default value is
automatic.
- Financial
Connections SubscriptionPayment Settings Payment Method Options Us Bank Account Financial Connections - Verification
Method string - Bank account verification method. The default value is
automatic.
- financial_
connections object - verification_
method string - Bank account verification method. The default value is
automatic.
- financial
Connections SubscriptionPayment Settings Payment Method Options Us Bank Account Financial Connections - verification
Method String - Bank account verification method. The default value is
automatic.
- financial
Connections SubscriptionPayment Settings Payment Method Options Us Bank Account Financial Connections - verification
Method string - Bank account verification method. The default value is
automatic.
- financial_
connections SubscriptionPayment Settings Payment Method Options Us Bank Account Financial Connections - verification_
method str - Bank account verification method. The default value is
automatic.
- financial
Connections Property Map - verification
Method String - Bank account verification method. The default value is
automatic.
SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections, SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs
- Filters
Subscription
Payment Settings Payment Method Options Us Bank Account Financial Connections Filters - Permissions List<string>
- The list of permissions to request. The
payment_methodpermission must be included. - Prefetches List<string>
- Data features requested to be retrieved upon account creation.
- Filters
Subscription
Payment Settings Payment Method Options Us Bank Account Financial Connections Filters - Permissions []string
- The list of permissions to request. The
payment_methodpermission must be included. - Prefetches []string
- Data features requested to be retrieved upon account creation.
- filters object
- permissions list(string)
- The list of permissions to request. The
payment_methodpermission must be included. - prefetches list(string)
- Data features requested to be retrieved upon account creation.
- filters
Subscription
Payment Settings Payment Method Options Us Bank Account Financial Connections Filters - permissions List<String>
- The list of permissions to request. The
payment_methodpermission must be included. - prefetches List<String>
- Data features requested to be retrieved upon account creation.
- filters
Subscription
Payment Settings Payment Method Options Us Bank Account Financial Connections Filters - permissions string[]
- The list of permissions to request. The
payment_methodpermission must be included. - prefetches string[]
- Data features requested to be retrieved upon account creation.
- filters
Subscription
Payment Settings Payment Method Options Us Bank Account Financial Connections Filters - permissions Sequence[str]
- The list of permissions to request. The
payment_methodpermission must be included. - prefetches Sequence[str]
- Data features requested to be retrieved upon account creation.
- filters Property Map
- permissions List<String>
- The list of permissions to request. The
payment_methodpermission must be included. - prefetches List<String>
- Data features requested to be retrieved upon account creation.
SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFilters, SubscriptionPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs
- Account
Subcategories List<string> - The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checkingandsavings.
- Account
Subcategories []string - The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checkingandsavings.
- account_
subcategories list(string) - The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checkingandsavings.
- account
Subcategories List<String> - The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checkingandsavings.
- account
Subcategories string[] - The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checkingandsavings.
- account_
subcategories Sequence[str] - The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checkingandsavings.
- account
Subcategories List<String> - The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checkingandsavings.
SubscriptionPendingInvoiceItemInterval, SubscriptionPendingInvoiceItemIntervalArgs
- Interval string
- Specifies invoicing frequency. Either
day,week,monthoryear. - Interval
Count double - The number of intervals between invoices. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks).
- Interval string
- Specifies invoicing frequency. Either
day,week,monthoryear. - Interval
Count float64 - The number of intervals between invoices. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks).
- interval string
- Specifies invoicing frequency. Either
day,week,monthoryear. - interval_
count number - The number of intervals between invoices. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks).
- interval String
- Specifies invoicing frequency. Either
day,week,monthoryear. - interval
Count Double - The number of intervals between invoices. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks).
- interval string
- Specifies invoicing frequency. Either
day,week,monthoryear. - interval
Count number - The number of intervals between invoices. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks).
- interval str
- Specifies invoicing frequency. Either
day,week,monthoryear. - interval_
count float - The number of intervals between invoices. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks).
- interval String
- Specifies invoicing frequency. Either
day,week,monthoryear. - interval
Count Number - The number of intervals between invoices. For example,
interval=monthandinterval_count=3bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks).
SubscriptionPendingUpdate, SubscriptionPendingUpdateArgs
- Billing
Cycle doubleAnchor - If the update is applied, determines the date of the first full invoice, and, for plans with
monthoryearintervals, the day of the month for subsequent invoices. The timestamp is in UTC format. - Discount string
- The pending subscription-level discount that will be applied when the pending update is applied.
- Expires
At double - The point after which the changes reflected by this update will be discarded and no longer applied.
- Metadata Dictionary<string, string>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- Trial
End double - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
- Trial
From boolPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more.
- Billing
Cycle float64Anchor - If the update is applied, determines the date of the first full invoice, and, for plans with
monthoryearintervals, the day of the month for subsequent invoices. The timestamp is in UTC format. - Discount string
- The pending subscription-level discount that will be applied when the pending update is applied.
- Expires
At float64 - The point after which the changes reflected by this update will be discarded and no longer applied.
- Metadata map[string]string
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- Trial
End float64 - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
- Trial
From boolPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more.
- billing_
cycle_ numberanchor - If the update is applied, determines the date of the first full invoice, and, for plans with
monthoryearintervals, the day of the month for subsequent invoices. The timestamp is in UTC format. - discount string
- The pending subscription-level discount that will be applied when the pending update is applied.
- expires_
at number - The point after which the changes reflected by this update will be discarded and no longer applied.
- metadata map(string)
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- trial_
end number - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
- trial_
from_ boolplan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more.
- billing
Cycle DoubleAnchor - If the update is applied, determines the date of the first full invoice, and, for plans with
monthoryearintervals, the day of the month for subsequent invoices. The timestamp is in UTC format. - discount String
- The pending subscription-level discount that will be applied when the pending update is applied.
- expires
At Double - The point after which the changes reflected by this update will be discarded and no longer applied.
- metadata Map<String,String>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- trial
End Double - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
- trial
From BooleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more.
- billing
Cycle numberAnchor - If the update is applied, determines the date of the first full invoice, and, for plans with
monthoryearintervals, the day of the month for subsequent invoices. The timestamp is in UTC format. - discount string
- The pending subscription-level discount that will be applied when the pending update is applied.
- expires
At number - The point after which the changes reflected by this update will be discarded and no longer applied.
- metadata {[key: string]: string}
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- trial
End number - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
- trial
From booleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more.
- billing_
cycle_ floatanchor - If the update is applied, determines the date of the first full invoice, and, for plans with
monthoryearintervals, the day of the month for subsequent invoices. The timestamp is in UTC format. - discount str
- The pending subscription-level discount that will be applied when the pending update is applied.
- expires_
at float - The point after which the changes reflected by this update will be discarded and no longer applied.
- metadata Mapping[str, str]
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- trial_
end float - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
- trial_
from_ boolplan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more.
- billing
Cycle NumberAnchor - If the update is applied, determines the date of the first full invoice, and, for plans with
monthoryearintervals, the day of the month for subsequent invoices. The timestamp is in UTC format. - discount String
- The pending subscription-level discount that will be applied when the pending update is applied.
- expires
At Number - The point after which the changes reflected by this update will be discarded and no longer applied.
- metadata Map<String>
- Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- trial
End Number - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
- trial
From BooleanPlan - Indicates if a plan's
trial_period_daysshould be applied to the subscription. Settingtrial_endper subscription is preferred, and this defaults tofalse. Setting this flag totruetogether withtrial_endis not allowed. See Using trial periods on subscriptions to learn more.
SubscriptionPresentmentDetails, SubscriptionPresentmentDetailsArgs
- Presentment
Currency string - Currency used for customer payments.
- Presentment
Currency string - Currency used for customer payments.
- presentment_
currency string - Currency used for customer payments.
- presentment
Currency String - Currency used for customer payments.
- presentment
Currency string - Currency used for customer payments.
- presentment_
currency str - Currency used for customer payments.
- presentment
Currency String - Currency used for customer payments.
SubscriptionTransferData, SubscriptionTransferDataArgs
- Destination string
- The account where funds from the payment will be transferred to upon payment success.
- Amount
Percent double - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
- Destination string
- The account where funds from the payment will be transferred to upon payment success.
- Amount
Percent float64 - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
- destination string
- The account where funds from the payment will be transferred to upon payment success.
- amount_
percent number - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
- destination String
- The account where funds from the payment will be transferred to upon payment success.
- amount
Percent Double - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
- destination string
- The account where funds from the payment will be transferred to upon payment success.
- amount
Percent number - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
- destination str
- The account where funds from the payment will be transferred to upon payment success.
- amount_
percent float - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
- destination String
- The account where funds from the payment will be transferred to upon payment success.
- amount
Percent Number - A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
SubscriptionTrialSettings, SubscriptionTrialSettingsArgs
- End
Behavior SubscriptionTrial Settings End Behavior - Defines how a subscription behaves when a trial ends.
- End
Behavior SubscriptionTrial Settings End Behavior - Defines how a subscription behaves when a trial ends.
- end_
behavior object - Defines how a subscription behaves when a trial ends.
- end
Behavior SubscriptionTrial Settings End Behavior - Defines how a subscription behaves when a trial ends.
- end
Behavior SubscriptionTrial Settings End Behavior - Defines how a subscription behaves when a trial ends.
- end_
behavior SubscriptionTrial Settings End Behavior - Defines how a subscription behaves when a trial ends.
- end
Behavior Property Map - Defines how a subscription behaves when a trial ends.
SubscriptionTrialSettingsEndBehavior, SubscriptionTrialSettingsEndBehaviorArgs
- Missing
Payment stringMethod - Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
- Missing
Payment stringMethod - Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
- missing_
payment_ stringmethod - Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
- missing
Payment StringMethod - Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
- missing
Payment stringMethod - Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
- missing_
payment_ strmethod - Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
- missing
Payment StringMethod - Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
Package Details
- Repository
- stripe stripe/terraform-provider-stripe
- License
- Notes
- This Pulumi package is based on the
stripeTerraform Provider.
published on Friday, Aug 14, 2026 by Pulumi