published on Friday, Aug 14, 2026 by Pulumi
published on Friday, Aug 14, 2026 by Pulumi
Invoices are statements of amounts owed by a customer, and are either generated one-off, or generated periodically from a subscription.
They contain invoice items, and proration adjustments that may be caused by subscription upgrades/downgrades (if necessary).
If your invoice is configured to be billed through automatic charges, Stripe automatically finalizes your invoice and attempts payment. Note that finalizing the invoice, when automatic, does not happen immediately as the invoice is created. Stripe waits until one hour after the last webhook was successfully sent (or the last webhook timed out after failing). If you (and the platforms you may have connected to) have no webhooks configured, Stripe waits one hour after creation to finalize the invoice.
If your invoice is configured to be billed by sending an email, then based on your email settings, Stripe will email the invoice to your customer and await payment. These emails can contain a link to a hosted page to pay the invoice.
Stripe applies any customer credit on the account before determining the amount due for the invoice (i.e., the amount that will be actually charged). If the amount due for the invoice is less than Stripe’s minimum allowed charge per currency, the invoice is automatically marked paid, and we add the amount due to the customer’s credit balance which is applied to the next invoice.
More details on the customer’s credit balance are here.
Related guide: Send invoices to customers
Create Invoice Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Invoice(name: string, args?: InvoiceArgs, opts?: CustomResourceOptions);@overload
def Invoice(resource_name: str,
args: Optional[InvoiceArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def Invoice(resource_name: str,
opts: Optional[ResourceOptions] = None,
account_tax_ids: Optional[Sequence[str]] = None,
application_fee_amount: Optional[float] = None,
auto_advance: Optional[bool] = None,
automatic_tax: Optional[InvoiceAutomaticTaxArgs] = None,
automatically_finalizes_at: Optional[float] = None,
collection_method: Optional[str] = None,
currency: Optional[str] = None,
custom_fields: Optional[Sequence[InvoiceCustomFieldArgs]] = 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[InvoiceDiscountArgs]] = None,
due_date: Optional[float] = None,
effective_at: Optional[float] = None,
footer: Optional[str] = None,
from_invoice: Optional[InvoiceFromInvoiceArgs] = None,
issuer: Optional[InvoiceIssuerArgs] = None,
metadata: Optional[Mapping[str, str]] = None,
number: Optional[str] = None,
on_behalf_of: Optional[str] = None,
payment_settings: Optional[InvoicePaymentSettingsArgs] = None,
pending_invoice_items_behavior: Optional[str] = None,
rendering: Optional[InvoiceRenderingArgs] = None,
shipping_cost: Optional[InvoiceShippingCostArgs] = None,
shipping_details: Optional[InvoiceShippingDetailsArgs] = None,
statement_descriptor: Optional[str] = None,
subscription: Optional[str] = None,
transfer_data: Optional[InvoiceTransferDataArgs] = None)func NewInvoice(ctx *Context, name string, args *InvoiceArgs, opts ...ResourceOption) (*Invoice, error)public Invoice(string name, InvoiceArgs? args = null, CustomResourceOptions? opts = null)
public Invoice(String name, InvoiceArgs args)
public Invoice(String name, InvoiceArgs args, CustomResourceOptions options)
type: stripe:Invoice
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "stripe_invoice" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args InvoiceArgs
- 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 InvoiceArgs
- 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 InvoiceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InvoiceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InvoiceArgs
- 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 invoiceResource = new Stripe.Invoice("invoiceResource", new()
{
AccountTaxIds = new[]
{
"string",
},
ApplicationFeeAmount = 0.0,
AutoAdvance = false,
AutomaticTax = new Stripe.Inputs.InvoiceAutomaticTaxArgs
{
Enabled = false,
DisabledReason = "string",
Liability = new Stripe.Inputs.InvoiceAutomaticTaxLiabilityArgs
{
Type = "string",
Account = "string",
},
Provider = "string",
Status = "string",
},
AutomaticallyFinalizesAt = 0.0,
CollectionMethod = "string",
Currency = "string",
CustomFields = new[]
{
new Stripe.Inputs.InvoiceCustomFieldArgs
{
Name = "string",
Value = "string",
},
},
Customer = "string",
CustomerAccount = "string",
DaysUntilDue = 0.0,
DefaultPaymentMethod = "string",
DefaultSource = "string",
DefaultTaxRates = new[]
{
"string",
},
Description = "string",
Discounts = new[]
{
new Stripe.Inputs.InvoiceDiscountArgs
{
Coupon = "string",
Discount = "string",
PromotionCode = "string",
},
},
DueDate = 0.0,
EffectiveAt = 0.0,
Footer = "string",
FromInvoice = new Stripe.Inputs.InvoiceFromInvoiceArgs
{
Action = "string",
Invoice = "string",
},
Issuer = new Stripe.Inputs.InvoiceIssuerArgs
{
Type = "string",
Account = "string",
},
Metadata =
{
{ "string", "string" },
},
Number = "string",
OnBehalfOf = "string",
PaymentSettings = new Stripe.Inputs.InvoicePaymentSettingsArgs
{
DefaultMandate = "string",
PaymentMethodOptions = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsArgs
{
AcssDebit = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsAcssDebitArgs
{
MandateOptions = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs
{
TransactionType = "string",
},
VerificationMethod = "string",
},
Bancontact = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsBancontactArgs
{
PreferredLanguage = "string",
},
Card = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsCardArgs
{
Installments = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsArgs
{
Enabled = false,
Plan = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsPlanArgs
{
Type = "string",
Count = 0.0,
Interval = "string",
},
},
RequestThreeDSecure = "string",
},
CustomerBalance = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceArgs
{
BankTransfer = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs
{
EuBankTransfer = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs
{
Country = "string",
},
Type = "string",
},
FundingType = "string",
},
Payto = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsPaytoArgs
{
MandateOptions = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs
{
Amount = 0.0,
AmountType = "string",
Purpose = "string",
},
},
Pix = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsPixArgs
{
AmountIncludesIof = "string",
ExpiresAfterSeconds = 0.0,
},
Upi = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsUpiArgs
{
MandateOptions = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs
{
Amount = 0.0,
AmountType = "string",
Description = "string",
EndDate = 0.0,
},
},
UsBankAccount = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountArgs
{
FinancialConnections = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs
{
Filters = new Stripe.Inputs.InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs
{
AccountSubcategories = new[]
{
"string",
},
},
Permissions = new[]
{
"string",
},
Prefetches = new[]
{
"string",
},
},
VerificationMethod = "string",
},
},
PaymentMethodTypes = new[]
{
"string",
},
},
PendingInvoiceItemsBehavior = "string",
Rendering = new Stripe.Inputs.InvoiceRenderingArgs
{
AmountTaxDisplay = "string",
Pdf = new Stripe.Inputs.InvoiceRenderingPdfArgs
{
PageSize = "string",
},
Template = "string",
TemplateVersion = 0.0,
},
ShippingCost = new Stripe.Inputs.InvoiceShippingCostArgs
{
AmountSubtotal = 0.0,
AmountTax = 0.0,
AmountTotal = 0.0,
ShippingRate = "string",
ShippingRateData = new Stripe.Inputs.InvoiceShippingCostShippingRateDataArgs
{
DisplayName = "string",
DeliveryEstimate = new Stripe.Inputs.InvoiceShippingCostShippingRateDataDeliveryEstimateArgs
{
Maximum = new Stripe.Inputs.InvoiceShippingCostShippingRateDataDeliveryEstimateMaximumArgs
{
Unit = "string",
Value = 0.0,
},
Minimum = new Stripe.Inputs.InvoiceShippingCostShippingRateDataDeliveryEstimateMinimumArgs
{
Unit = "string",
Value = 0.0,
},
},
FixedAmount = new Stripe.Inputs.InvoiceShippingCostShippingRateDataFixedAmountArgs
{
Amount = 0.0,
Currency = "string",
CurrencyOptions =
{
{ "string", new Stripe.Inputs.InvoiceShippingCostShippingRateDataFixedAmountCurrencyOptionsArgs
{
Amount = 0.0,
TaxBehavior = "string",
} },
},
},
Metadata =
{
{ "string", "string" },
},
TaxBehavior = "string",
TaxCode = "string",
Type = "string",
},
Taxes = new[]
{
new Stripe.Inputs.InvoiceShippingCostTaxArgs
{
Amount = 0.0,
Rate = "string",
TaxabilityReason = "string",
TaxableAmount = 0.0,
},
},
},
ShippingDetails = new Stripe.Inputs.InvoiceShippingDetailsArgs
{
Address = new Stripe.Inputs.InvoiceShippingDetailsAddressArgs
{
City = "string",
Country = "string",
Line1 = "string",
Line2 = "string",
PostalCode = "string",
State = "string",
},
Name = "string",
Carrier = "string",
Phone = "string",
TrackingNumber = "string",
},
StatementDescriptor = "string",
Subscription = "string",
TransferData = new Stripe.Inputs.InvoiceTransferDataArgs
{
Destination = "string",
Amount = 0.0,
},
});
example, err := stripe.NewInvoice(ctx, "invoiceResource", &stripe.InvoiceArgs{
AccountTaxIds: pulumi.StringArray{
pulumi.String("string"),
},
ApplicationFeeAmount: pulumi.Float64(0),
AutoAdvance: pulumi.Bool(false),
AutomaticTax: &stripe.InvoiceAutomaticTaxArgs{
Enabled: pulumi.Bool(false),
DisabledReason: pulumi.String("string"),
Liability: &stripe.InvoiceAutomaticTaxLiabilityArgs{
Type: pulumi.String("string"),
Account: pulumi.String("string"),
},
Provider: pulumi.String("string"),
Status: pulumi.String("string"),
},
AutomaticallyFinalizesAt: pulumi.Float64(0),
CollectionMethod: pulumi.String("string"),
Currency: pulumi.String("string"),
CustomFields: stripe.InvoiceCustomFieldArray{
&stripe.InvoiceCustomFieldArgs{
Name: pulumi.String("string"),
Value: 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.InvoiceDiscountArray{
&stripe.InvoiceDiscountArgs{
Coupon: pulumi.String("string"),
Discount: pulumi.String("string"),
PromotionCode: pulumi.String("string"),
},
},
DueDate: pulumi.Float64(0),
EffectiveAt: pulumi.Float64(0),
Footer: pulumi.String("string"),
FromInvoice: &stripe.InvoiceFromInvoiceArgs{
Action: pulumi.String("string"),
Invoice: pulumi.String("string"),
},
Issuer: &stripe.InvoiceIssuerArgs{
Type: pulumi.String("string"),
Account: pulumi.String("string"),
},
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
Number: pulumi.String("string"),
OnBehalfOf: pulumi.String("string"),
PaymentSettings: &stripe.InvoicePaymentSettingsArgs{
DefaultMandate: pulumi.String("string"),
PaymentMethodOptions: &stripe.InvoicePaymentSettingsPaymentMethodOptionsArgs{
AcssDebit: &stripe.InvoicePaymentSettingsPaymentMethodOptionsAcssDebitArgs{
MandateOptions: &stripe.InvoicePaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs{
TransactionType: pulumi.String("string"),
},
VerificationMethod: pulumi.String("string"),
},
Bancontact: &stripe.InvoicePaymentSettingsPaymentMethodOptionsBancontactArgs{
PreferredLanguage: pulumi.String("string"),
},
Card: &stripe.InvoicePaymentSettingsPaymentMethodOptionsCardArgs{
Installments: &stripe.InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsArgs{
Enabled: pulumi.Bool(false),
Plan: &stripe.InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsPlanArgs{
Type: pulumi.String("string"),
Count: pulumi.Float64(0),
Interval: pulumi.String("string"),
},
},
RequestThreeDSecure: pulumi.String("string"),
},
CustomerBalance: &stripe.InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceArgs{
BankTransfer: &stripe.InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs{
EuBankTransfer: &stripe.InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs{
Country: pulumi.String("string"),
},
Type: pulumi.String("string"),
},
FundingType: pulumi.String("string"),
},
Payto: &stripe.InvoicePaymentSettingsPaymentMethodOptionsPaytoArgs{
MandateOptions: &stripe.InvoicePaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs{
Amount: pulumi.Float64(0),
AmountType: pulumi.String("string"),
Purpose: pulumi.String("string"),
},
},
Pix: &stripe.InvoicePaymentSettingsPaymentMethodOptionsPixArgs{
AmountIncludesIof: pulumi.String("string"),
ExpiresAfterSeconds: pulumi.Float64(0),
},
Upi: &stripe.InvoicePaymentSettingsPaymentMethodOptionsUpiArgs{
MandateOptions: &stripe.InvoicePaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs{
Amount: pulumi.Float64(0),
AmountType: pulumi.String("string"),
Description: pulumi.String("string"),
EndDate: pulumi.Float64(0),
},
},
UsBankAccount: &stripe.InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountArgs{
FinancialConnections: &stripe.InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs{
Filters: &stripe.InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs{
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"),
},
},
PendingInvoiceItemsBehavior: pulumi.String("string"),
Rendering: &stripe.InvoiceRenderingArgs{
AmountTaxDisplay: pulumi.String("string"),
Pdf: &stripe.InvoiceRenderingPdfArgs{
PageSize: pulumi.String("string"),
},
Template: pulumi.String("string"),
TemplateVersion: pulumi.Float64(0),
},
ShippingCost: &stripe.InvoiceShippingCostArgs{
AmountSubtotal: pulumi.Float64(0),
AmountTax: pulumi.Float64(0),
AmountTotal: pulumi.Float64(0),
ShippingRate: pulumi.String("string"),
ShippingRateData: &stripe.InvoiceShippingCostShippingRateDataArgs{
DisplayName: pulumi.String("string"),
DeliveryEstimate: &stripe.InvoiceShippingCostShippingRateDataDeliveryEstimateArgs{
Maximum: &stripe.InvoiceShippingCostShippingRateDataDeliveryEstimateMaximumArgs{
Unit: pulumi.String("string"),
Value: pulumi.Float64(0),
},
Minimum: &stripe.InvoiceShippingCostShippingRateDataDeliveryEstimateMinimumArgs{
Unit: pulumi.String("string"),
Value: pulumi.Float64(0),
},
},
FixedAmount: &stripe.InvoiceShippingCostShippingRateDataFixedAmountArgs{
Amount: pulumi.Float64(0),
Currency: pulumi.String("string"),
CurrencyOptions: stripe.InvoiceShippingCostShippingRateDataFixedAmountCurrencyOptionsMap{
"string": &stripe.InvoiceShippingCostShippingRateDataFixedAmountCurrencyOptionsArgs{
Amount: pulumi.Float64(0),
TaxBehavior: pulumi.String("string"),
},
},
},
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
TaxBehavior: pulumi.String("string"),
TaxCode: pulumi.String("string"),
Type: pulumi.String("string"),
},
Taxes: stripe.InvoiceShippingCostTaxArray{
&stripe.InvoiceShippingCostTaxArgs{
Amount: pulumi.Float64(0),
Rate: pulumi.String("string"),
TaxabilityReason: pulumi.String("string"),
TaxableAmount: pulumi.Float64(0),
},
},
},
ShippingDetails: &stripe.InvoiceShippingDetailsArgs{
Address: &stripe.InvoiceShippingDetailsAddressArgs{
City: pulumi.String("string"),
Country: pulumi.String("string"),
Line1: pulumi.String("string"),
Line2: pulumi.String("string"),
PostalCode: pulumi.String("string"),
State: pulumi.String("string"),
},
Name: pulumi.String("string"),
Carrier: pulumi.String("string"),
Phone: pulumi.String("string"),
TrackingNumber: pulumi.String("string"),
},
StatementDescriptor: pulumi.String("string"),
Subscription: pulumi.String("string"),
TransferData: &stripe.InvoiceTransferDataArgs{
Destination: pulumi.String("string"),
Amount: pulumi.Float64(0),
},
})
resource "stripe_invoice" "invoiceResource" {
lifecycle {
create_before_destroy = true
}
account_tax_ids = ["string"]
application_fee_amount = 0
auto_advance = false
automatic_tax = {
enabled = false
disabled_reason = "string"
liability = {
type = "string"
account = "string"
}
provider = "string"
status = "string"
}
automatically_finalizes_at = 0
collection_method = "string"
currency = "string"
custom_fields {
name = "string"
value = "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"
}
due_date = 0
effective_at = 0
footer = "string"
from_invoice = {
action = "string"
invoice = "string"
}
issuer = {
type = "string"
account = "string"
}
metadata = {
"string" = "string"
}
number = "string"
on_behalf_of = "string"
payment_settings = {
default_mandate = "string"
payment_method_options = {
acss_debit = {
mandate_options = {
transaction_type = "string"
}
verification_method = "string"
}
bancontact = {
preferred_language = "string"
}
card = {
installments = {
enabled = false
plan = {
type = "string"
count = 0
interval = "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 = {
amount_includes_iof = "string"
expires_after_seconds = 0
}
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"]
}
pending_invoice_items_behavior = "string"
rendering = {
amount_tax_display = "string"
pdf = {
page_size = "string"
}
template = "string"
template_version = 0
}
shipping_cost = {
amount_subtotal = 0
amount_tax = 0
amount_total = 0
shipping_rate = "string"
shipping_rate_data = {
display_name = "string"
delivery_estimate = {
maximum = {
unit = "string"
value = 0
}
minimum = {
unit = "string"
value = 0
}
}
fixed_amount = {
amount = 0
currency = "string"
currency_options = {
"string" = {
amount = 0
tax_behavior = "string"
}
}
}
metadata = {
"string" = "string"
}
tax_behavior = "string"
tax_code = "string"
type = "string"
}
taxes = [{
amount = 0
rate = "string"
taxability_reason = "string"
taxable_amount = 0
}]
}
shipping_details = {
address = {
city = "string"
country = "string"
line1 = "string"
line2 = "string"
postal_code = "string"
state = "string"
}
name = "string"
carrier = "string"
phone = "string"
tracking_number = "string"
}
statement_descriptor = "string"
subscription = "string"
transfer_data = {
destination = "string"
amount = 0
}
}
var invoiceResource = new Invoice("invoiceResource", InvoiceArgs.builder()
.accountTaxIds("string")
.applicationFeeAmount(0.0)
.autoAdvance(false)
.automaticTax(InvoiceAutomaticTaxArgs.builder()
.enabled(false)
.disabledReason("string")
.liability(InvoiceAutomaticTaxLiabilityArgs.builder()
.type("string")
.account("string")
.build())
.provider("string")
.status("string")
.build())
.automaticallyFinalizesAt(0.0)
.collectionMethod("string")
.currency("string")
.customFields(InvoiceCustomFieldArgs.builder()
.name("string")
.value("string")
.build())
.customer("string")
.customerAccount("string")
.daysUntilDue(0.0)
.defaultPaymentMethod("string")
.defaultSource("string")
.defaultTaxRates("string")
.description("string")
.discounts(InvoiceDiscountArgs.builder()
.coupon("string")
.discount("string")
.promotionCode("string")
.build())
.dueDate(0.0)
.effectiveAt(0.0)
.footer("string")
.fromInvoice(InvoiceFromInvoiceArgs.builder()
.action("string")
.invoice("string")
.build())
.issuer(InvoiceIssuerArgs.builder()
.type("string")
.account("string")
.build())
.metadata(Map.of("string", "string"))
.number("string")
.onBehalfOf("string")
.paymentSettings(InvoicePaymentSettingsArgs.builder()
.defaultMandate("string")
.paymentMethodOptions(InvoicePaymentSettingsPaymentMethodOptionsArgs.builder()
.acssDebit(InvoicePaymentSettingsPaymentMethodOptionsAcssDebitArgs.builder()
.mandateOptions(InvoicePaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs.builder()
.transactionType("string")
.build())
.verificationMethod("string")
.build())
.bancontact(InvoicePaymentSettingsPaymentMethodOptionsBancontactArgs.builder()
.preferredLanguage("string")
.build())
.card(InvoicePaymentSettingsPaymentMethodOptionsCardArgs.builder()
.installments(InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsArgs.builder()
.enabled(false)
.plan(InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsPlanArgs.builder()
.type("string")
.count(0.0)
.interval("string")
.build())
.build())
.requestThreeDSecure("string")
.build())
.customerBalance(InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceArgs.builder()
.bankTransfer(InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs.builder()
.euBankTransfer(InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs.builder()
.country("string")
.build())
.type("string")
.build())
.fundingType("string")
.build())
.payto(InvoicePaymentSettingsPaymentMethodOptionsPaytoArgs.builder()
.mandateOptions(InvoicePaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs.builder()
.amount(0.0)
.amountType("string")
.purpose("string")
.build())
.build())
.pix(InvoicePaymentSettingsPaymentMethodOptionsPixArgs.builder()
.amountIncludesIof("string")
.expiresAfterSeconds(0.0)
.build())
.upi(InvoicePaymentSettingsPaymentMethodOptionsUpiArgs.builder()
.mandateOptions(InvoicePaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs.builder()
.amount(0.0)
.amountType("string")
.description("string")
.endDate(0.0)
.build())
.build())
.usBankAccount(InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountArgs.builder()
.financialConnections(InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs.builder()
.filters(InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs.builder()
.accountSubcategories("string")
.build())
.permissions("string")
.prefetches("string")
.build())
.verificationMethod("string")
.build())
.build())
.paymentMethodTypes("string")
.build())
.pendingInvoiceItemsBehavior("string")
.rendering(InvoiceRenderingArgs.builder()
.amountTaxDisplay("string")
.pdf(InvoiceRenderingPdfArgs.builder()
.pageSize("string")
.build())
.template("string")
.templateVersion(0.0)
.build())
.shippingCost(InvoiceShippingCostArgs.builder()
.amountSubtotal(0.0)
.amountTax(0.0)
.amountTotal(0.0)
.shippingRate("string")
.shippingRateData(InvoiceShippingCostShippingRateDataArgs.builder()
.displayName("string")
.deliveryEstimate(InvoiceShippingCostShippingRateDataDeliveryEstimateArgs.builder()
.maximum(InvoiceShippingCostShippingRateDataDeliveryEstimateMaximumArgs.builder()
.unit("string")
.value(0.0)
.build())
.minimum(InvoiceShippingCostShippingRateDataDeliveryEstimateMinimumArgs.builder()
.unit("string")
.value(0.0)
.build())
.build())
.fixedAmount(InvoiceShippingCostShippingRateDataFixedAmountArgs.builder()
.amount(0.0)
.currency("string")
.currencyOptions(Map.of("string", InvoiceShippingCostShippingRateDataFixedAmountCurrencyOptionsArgs.builder()
.amount(0.0)
.taxBehavior("string")
.build()))
.build())
.metadata(Map.of("string", "string"))
.taxBehavior("string")
.taxCode("string")
.type("string")
.build())
.taxes(InvoiceShippingCostTaxArgs.builder()
.amount(0.0)
.rate("string")
.taxabilityReason("string")
.taxableAmount(0.0)
.build())
.build())
.shippingDetails(InvoiceShippingDetailsArgs.builder()
.address(InvoiceShippingDetailsAddressArgs.builder()
.city("string")
.country("string")
.line1("string")
.line2("string")
.postalCode("string")
.state("string")
.build())
.name("string")
.carrier("string")
.phone("string")
.trackingNumber("string")
.build())
.statementDescriptor("string")
.subscription("string")
.transferData(InvoiceTransferDataArgs.builder()
.destination("string")
.amount(0.0)
.build())
.build());
invoice_resource = stripe.Invoice("invoiceResource",
account_tax_ids=["string"],
application_fee_amount=float(0),
auto_advance=False,
automatic_tax={
"enabled": False,
"disabled_reason": "string",
"liability": {
"type": "string",
"account": "string",
},
"provider": "string",
"status": "string",
},
automatically_finalizes_at=float(0),
collection_method="string",
currency="string",
custom_fields=[{
"name": "string",
"value": "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",
}],
due_date=float(0),
effective_at=float(0),
footer="string",
from_invoice={
"action": "string",
"invoice": "string",
},
issuer={
"type": "string",
"account": "string",
},
metadata={
"string": "string",
},
number="string",
on_behalf_of="string",
payment_settings={
"default_mandate": "string",
"payment_method_options": {
"acss_debit": {
"mandate_options": {
"transaction_type": "string",
},
"verification_method": "string",
},
"bancontact": {
"preferred_language": "string",
},
"card": {
"installments": {
"enabled": False,
"plan": {
"type": "string",
"count": float(0),
"interval": "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": {
"amount_includes_iof": "string",
"expires_after_seconds": float(0),
},
"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"],
},
pending_invoice_items_behavior="string",
rendering={
"amount_tax_display": "string",
"pdf": {
"page_size": "string",
},
"template": "string",
"template_version": float(0),
},
shipping_cost={
"amount_subtotal": float(0),
"amount_tax": float(0),
"amount_total": float(0),
"shipping_rate": "string",
"shipping_rate_data": {
"display_name": "string",
"delivery_estimate": {
"maximum": {
"unit": "string",
"value": float(0),
},
"minimum": {
"unit": "string",
"value": float(0),
},
},
"fixed_amount": {
"amount": float(0),
"currency": "string",
"currency_options": {
"string": {
"amount": float(0),
"tax_behavior": "string",
},
},
},
"metadata": {
"string": "string",
},
"tax_behavior": "string",
"tax_code": "string",
"type": "string",
},
"taxes": [{
"amount": float(0),
"rate": "string",
"taxability_reason": "string",
"taxable_amount": float(0),
}],
},
shipping_details={
"address": {
"city": "string",
"country": "string",
"line1": "string",
"line2": "string",
"postal_code": "string",
"state": "string",
},
"name": "string",
"carrier": "string",
"phone": "string",
"tracking_number": "string",
},
statement_descriptor="string",
subscription="string",
transfer_data={
"destination": "string",
"amount": float(0),
})
const invoiceResource = new stripe.Invoice("invoiceResource", {
accountTaxIds: ["string"],
applicationFeeAmount: 0,
autoAdvance: false,
automaticTax: {
enabled: false,
disabledReason: "string",
liability: {
type: "string",
account: "string",
},
provider: "string",
status: "string",
},
automaticallyFinalizesAt: 0,
collectionMethod: "string",
currency: "string",
customFields: [{
name: "string",
value: "string",
}],
customer: "string",
customerAccount: "string",
daysUntilDue: 0,
defaultPaymentMethod: "string",
defaultSource: "string",
defaultTaxRates: ["string"],
description: "string",
discounts: [{
coupon: "string",
discount: "string",
promotionCode: "string",
}],
dueDate: 0,
effectiveAt: 0,
footer: "string",
fromInvoice: {
action: "string",
invoice: "string",
},
issuer: {
type: "string",
account: "string",
},
metadata: {
string: "string",
},
number: "string",
onBehalfOf: "string",
paymentSettings: {
defaultMandate: "string",
paymentMethodOptions: {
acssDebit: {
mandateOptions: {
transactionType: "string",
},
verificationMethod: "string",
},
bancontact: {
preferredLanguage: "string",
},
card: {
installments: {
enabled: false,
plan: {
type: "string",
count: 0,
interval: "string",
},
},
requestThreeDSecure: "string",
},
customerBalance: {
bankTransfer: {
euBankTransfer: {
country: "string",
},
type: "string",
},
fundingType: "string",
},
payto: {
mandateOptions: {
amount: 0,
amountType: "string",
purpose: "string",
},
},
pix: {
amountIncludesIof: "string",
expiresAfterSeconds: 0,
},
upi: {
mandateOptions: {
amount: 0,
amountType: "string",
description: "string",
endDate: 0,
},
},
usBankAccount: {
financialConnections: {
filters: {
accountSubcategories: ["string"],
},
permissions: ["string"],
prefetches: ["string"],
},
verificationMethod: "string",
},
},
paymentMethodTypes: ["string"],
},
pendingInvoiceItemsBehavior: "string",
rendering: {
amountTaxDisplay: "string",
pdf: {
pageSize: "string",
},
template: "string",
templateVersion: 0,
},
shippingCost: {
amountSubtotal: 0,
amountTax: 0,
amountTotal: 0,
shippingRate: "string",
shippingRateData: {
displayName: "string",
deliveryEstimate: {
maximum: {
unit: "string",
value: 0,
},
minimum: {
unit: "string",
value: 0,
},
},
fixedAmount: {
amount: 0,
currency: "string",
currencyOptions: {
string: {
amount: 0,
taxBehavior: "string",
},
},
},
metadata: {
string: "string",
},
taxBehavior: "string",
taxCode: "string",
type: "string",
},
taxes: [{
amount: 0,
rate: "string",
taxabilityReason: "string",
taxableAmount: 0,
}],
},
shippingDetails: {
address: {
city: "string",
country: "string",
line1: "string",
line2: "string",
postalCode: "string",
state: "string",
},
name: "string",
carrier: "string",
phone: "string",
trackingNumber: "string",
},
statementDescriptor: "string",
subscription: "string",
transferData: {
destination: "string",
amount: 0,
},
});
type: stripe:Invoice
properties:
accountTaxIds:
- string
applicationFeeAmount: 0
autoAdvance: false
automaticTax:
disabledReason: string
enabled: false
liability:
account: string
type: string
provider: string
status: string
automaticallyFinalizesAt: 0
collectionMethod: string
currency: string
customFields:
- name: string
value: string
customer: string
customerAccount: string
daysUntilDue: 0
defaultPaymentMethod: string
defaultSource: string
defaultTaxRates:
- string
description: string
discounts:
- coupon: string
discount: string
promotionCode: string
dueDate: 0
effectiveAt: 0
footer: string
fromInvoice:
action: string
invoice: string
issuer:
account: string
type: string
metadata:
string: string
number: string
onBehalfOf: string
paymentSettings:
defaultMandate: string
paymentMethodOptions:
acssDebit:
mandateOptions:
transactionType: string
verificationMethod: string
bancontact:
preferredLanguage: string
card:
installments:
enabled: false
plan:
count: 0
interval: string
type: string
requestThreeDSecure: string
customerBalance:
bankTransfer:
euBankTransfer:
country: string
type: string
fundingType: string
payto:
mandateOptions:
amount: 0
amountType: string
purpose: string
pix:
amountIncludesIof: string
expiresAfterSeconds: 0
upi:
mandateOptions:
amount: 0
amountType: string
description: string
endDate: 0
usBankAccount:
financialConnections:
filters:
accountSubcategories:
- string
permissions:
- string
prefetches:
- string
verificationMethod: string
paymentMethodTypes:
- string
pendingInvoiceItemsBehavior: string
rendering:
amountTaxDisplay: string
pdf:
pageSize: string
template: string
templateVersion: 0
shippingCost:
amountSubtotal: 0
amountTax: 0
amountTotal: 0
shippingRate: string
shippingRateData:
deliveryEstimate:
maximum:
unit: string
value: 0
minimum:
unit: string
value: 0
displayName: string
fixedAmount:
amount: 0
currency: string
currencyOptions:
string:
amount: 0
taxBehavior: string
metadata:
string: string
taxBehavior: string
taxCode: string
type: string
taxes:
- amount: 0
rate: string
taxabilityReason: string
taxableAmount: 0
shippingDetails:
address:
city: string
country: string
line1: string
line2: string
postalCode: string
state: string
carrier: string
name: string
phone: string
trackingNumber: string
statementDescriptor: string
subscription: string
transferData:
amount: 0
destination: string
Invoice 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 Invoice resource accepts the following input properties:
- Account
Tax List<string>Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- Application
Fee doubleAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- Auto
Advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - Automatic
Tax InvoiceAutomatic Tax - Automatically
Finalizes doubleAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Custom
Fields List<InvoiceCustom Field> - Custom fields displayed on the invoice.
- Customer string
- The ID of the customer to bill.
- Customer
Account string - The ID of the account representing the customer to bill.
- Days
Until doubleDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - Default
Payment stringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- Default
Source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- Default
Tax List<string>Rates - The tax rates applied to this invoice, if any.
- Description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- Discounts
List<Invoice
Discount> - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - Due
Date double - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - Effective
At double - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - string
- Footer displayed on the invoice.
- From
Invoice InvoiceFrom Invoice - Details of the invoice that was cloned. See the revision documentation for more details.
- Issuer
Invoice
Issuer - 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.
- Number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- On
Behalf stringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- Payment
Settings InvoicePayment Settings - Pending
Invoice stringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - Rendering
Invoice
Rendering - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- Shipping
Cost InvoiceShipping Cost - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- Shipping
Details InvoiceShipping Details - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - Statement
Descriptor string - Extra information about an invoice for the customer's credit card statement.
- Subscription string
- Transfer
Data InvoiceTransfer Data - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- Account
Tax []stringIds - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- Application
Fee float64Amount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- Auto
Advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - Automatic
Tax InvoiceAutomatic Tax Args - Automatically
Finalizes float64At - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Custom
Fields []InvoiceCustom Field Args - Custom fields displayed on the invoice.
- Customer string
- The ID of the customer to bill.
- Customer
Account string - The ID of the account representing the customer to bill.
- Days
Until float64Due - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - Default
Payment stringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- Default
Source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- Default
Tax []stringRates - The tax rates applied to this invoice, if any.
- Description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- Discounts
[]Invoice
Discount Args - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - Due
Date float64 - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - Effective
At float64 - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - string
- Footer displayed on the invoice.
- From
Invoice InvoiceFrom Invoice Args - Details of the invoice that was cloned. See the revision documentation for more details.
- Issuer
Invoice
Issuer Args - 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.
- Number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- On
Behalf stringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- Payment
Settings InvoicePayment Settings Args - Pending
Invoice stringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - Rendering
Invoice
Rendering Args - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- Shipping
Cost InvoiceShipping Cost Args - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- Shipping
Details InvoiceShipping Details Args - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - Statement
Descriptor string - Extra information about an invoice for the customer's credit card statement.
- Subscription string
- Transfer
Data InvoiceTransfer Data Args - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- account_
tax_ list(string)ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- application_
fee_ numberamount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- auto_
advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic_
tax object - automatically_
finalizes_ numberat - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - collection_
method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- custom_
fields list(object) - Custom fields displayed on the invoice.
- customer string
- The ID of the customer to bill.
- customer_
account string - The ID of the account representing the customer to bill.
- days_
until_ numberdue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default_
payment_ stringmethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default_
source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default_
tax_ list(string)rates - The tax rates applied to this invoice, if any.
- description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts list(object)
- The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due_
date number - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective_
at number - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - string
- Footer displayed on the invoice.
- from_
invoice object - Details of the invoice that was cloned. See the revision documentation for more details.
- issuer 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.
- number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- on_
behalf_ stringof - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- payment_
settings object - pending_
invoice_ stringitems_ behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - rendering object
- The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping_
cost object - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping_
details object - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - statement_
descriptor string - Extra information about an invoice for the customer's credit card statement.
- subscription string
- transfer_
data object - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- account
Tax List<String>Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- application
Fee DoubleAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- auto
Advance Boolean - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic
Tax InvoiceAutomatic Tax - automatically
Finalizes DoubleAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- custom
Fields List<InvoiceCustom Field> - Custom fields displayed on the invoice.
- customer String
- The ID of the customer to bill.
- customer
Account String - The ID of the account representing the customer to bill.
- days
Until DoubleDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default
Payment StringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default
Source String - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default
Tax List<String>Rates - The tax rates applied to this invoice, if any.
- description String
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts
List<Invoice
Discount> - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due
Date Double - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective
At Double - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - String
- Footer displayed on the invoice.
- from
Invoice InvoiceFrom Invoice - Details of the invoice that was cloned. See the revision documentation for more details.
- issuer
Invoice
Issuer - 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.
- number String
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- on
Behalf StringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- payment
Settings InvoicePayment Settings - pending
Invoice StringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - rendering
Invoice
Rendering - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping
Cost InvoiceShipping Cost - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping
Details InvoiceShipping Details - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - statement
Descriptor String - Extra information about an invoice for the customer's credit card statement.
- subscription String
- transfer
Data InvoiceTransfer Data - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- account
Tax string[]Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- application
Fee numberAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- auto
Advance boolean - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic
Tax InvoiceAutomatic Tax - automatically
Finalizes numberAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- custom
Fields InvoiceCustom Field[] - Custom fields displayed on the invoice.
- customer string
- The ID of the customer to bill.
- customer
Account string - The ID of the account representing the customer to bill.
- days
Until numberDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default
Payment stringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default
Source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default
Tax string[]Rates - The tax rates applied to this invoice, if any.
- description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts
Invoice
Discount[] - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due
Date number - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective
At number - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - string
- Footer displayed on the invoice.
- from
Invoice InvoiceFrom Invoice - Details of the invoice that was cloned. See the revision documentation for more details.
- issuer
Invoice
Issuer - 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.
- number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- on
Behalf stringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- payment
Settings InvoicePayment Settings - pending
Invoice stringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - rendering
Invoice
Rendering - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping
Cost InvoiceShipping Cost - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping
Details InvoiceShipping Details - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - statement
Descriptor string - Extra information about an invoice for the customer's credit card statement.
- subscription string
- transfer
Data InvoiceTransfer Data - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- account_
tax_ Sequence[str]ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- application_
fee_ floatamount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- auto_
advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic_
tax InvoiceAutomatic Tax Args - automatically_
finalizes_ floatat - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - collection_
method str - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- custom_
fields Sequence[InvoiceCustom Field Args] - Custom fields displayed on the invoice.
- customer str
- The ID of the customer to bill.
- customer_
account str - The ID of the account representing the customer to bill.
- days_
until_ floatdue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default_
payment_ strmethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default_
source str - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default_
tax_ Sequence[str]rates - The tax rates applied to this invoice, if any.
- description str
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts
Sequence[Invoice
Discount Args] - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due_
date float - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective_
at float - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - str
- Footer displayed on the invoice.
- from_
invoice InvoiceFrom Invoice Args - Details of the invoice that was cloned. See the revision documentation for more details.
- issuer
Invoice
Issuer Args - 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.
- number str
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- on_
behalf_ strof - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- payment_
settings InvoicePayment Settings Args - pending_
invoice_ stritems_ behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - rendering
Invoice
Rendering Args - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping_
cost InvoiceShipping Cost Args - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping_
details InvoiceShipping Details Args - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - statement_
descriptor str - Extra information about an invoice for the customer's credit card statement.
- subscription str
- transfer_
data InvoiceTransfer Data Args - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- account
Tax List<String>Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- application
Fee NumberAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- auto
Advance Boolean - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic
Tax Property Map - automatically
Finalizes NumberAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- custom
Fields List<Property Map> - Custom fields displayed on the invoice.
- customer String
- The ID of the customer to bill.
- customer
Account String - The ID of the account representing the customer to bill.
- days
Until NumberDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default
Payment StringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default
Source String - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default
Tax List<String>Rates - The tax rates applied to this invoice, if any.
- description String
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts List<Property Map>
- The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due
Date Number - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective
At Number - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - String
- Footer displayed on the invoice.
- from
Invoice Property Map - Details of the invoice that was cloned. See the revision documentation for more details.
- issuer Property Map
- 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.
- number String
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- on
Behalf StringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- payment
Settings Property Map - pending
Invoice StringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - rendering Property Map
- The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping
Cost Property Map - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping
Details Property Map - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - statement
Descriptor String - Extra information about an invoice for the customer's credit card statement.
- subscription String
- transfer
Data Property Map - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
Outputs
All input properties are implicitly available as output properties. Additionally, the Invoice resource produces the following output properties:
- Account
Country string - The country of the business associated with this invoice, most often the business creating the invoice.
- Account
Name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- Amount
Due double - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - Amount
Overpaid double - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- Amount
Paid double - The amount, in cents (or local equivalent), that was paid.
- Amount
Paid doubleOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- Amount
Remaining double - The difference between amount_due and amount_paid, in cents (or local equivalent).
- Amount
Shipping double - This is the sum of all the shipping amounts.
- Application string
- ID of the Connect Application that created the invoice.
- Attempt
Count double - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- Attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - Billing
Reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- Confirmation
Secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- Created double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Customer
Address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - Customer
Email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - Customer
Name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - Customer
Phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - Customer
Shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - Customer
Tax List<InvoiceIds Customer Tax Id> - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - Ending
Balance double - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- Hosted
Invoice stringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- Id string
- The provider-assigned unique ID for this managed resource.
- Invoice
Pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- Last
Finalization InvoiceError Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- Latest
Revision string - The ID of the most recent non-draft revision of this invoice
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Next
Payment doubleAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Parent
Invoice
Parent - The parent that generated this invoice
- Period
End double - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Period
Start double - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Post
Payment doubleCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- Pre
Payment doubleCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- Receipt
Number string - This is the transaction number that appears on email receipts sent for this invoice.
- Starting
Balance double - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- Status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - Status
Transitions InvoiceStatus Transitions - Subtotal double
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- Subtotal
Excluding doubleTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- Test
Clock string - ID of the test clock this invoice belongs to.
- Threshold
Reason InvoiceThreshold Reason - Total double
- Total after discounts and taxes.
- Total
Discount List<InvoiceAmounts Total Discount Amount> - The aggregate amounts calculated per discount across all line items.
- Total
Excluding doubleTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- Total
Pretax List<InvoiceCredit Amounts Total Pretax Credit Amount> - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- Total
Taxes List<InvoiceTotal Tax> - The aggregate tax information of all line items.
- Webhooks
Delivered doubleAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- Account
Country string - The country of the business associated with this invoice, most often the business creating the invoice.
- Account
Name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- Amount
Due float64 - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - Amount
Overpaid float64 - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- Amount
Paid float64 - The amount, in cents (or local equivalent), that was paid.
- Amount
Paid float64Off Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- Amount
Remaining float64 - The difference between amount_due and amount_paid, in cents (or local equivalent).
- Amount
Shipping float64 - This is the sum of all the shipping amounts.
- Application string
- ID of the Connect Application that created the invoice.
- Attempt
Count float64 - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- Attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - Billing
Reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- Confirmation
Secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- Created float64
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Customer
Address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - Customer
Email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - Customer
Name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - Customer
Phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - Customer
Shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - Customer
Tax []InvoiceIds Customer Tax Id - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - Ending
Balance float64 - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- Hosted
Invoice stringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- Id string
- The provider-assigned unique ID for this managed resource.
- Invoice
Pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- Last
Finalization InvoiceError Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- Latest
Revision string - The ID of the most recent non-draft revision of this invoice
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Next
Payment float64Attempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Parent
Invoice
Parent - The parent that generated this invoice
- Period
End float64 - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Period
Start float64 - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Post
Payment float64Credit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- Pre
Payment float64Credit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- Receipt
Number string - This is the transaction number that appears on email receipts sent for this invoice.
- Starting
Balance float64 - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- Status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - Status
Transitions InvoiceStatus Transitions - Subtotal float64
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- Subtotal
Excluding float64Tax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- Test
Clock string - ID of the test clock this invoice belongs to.
- Threshold
Reason InvoiceThreshold Reason - Total float64
- Total after discounts and taxes.
- Total
Discount []InvoiceAmounts Total Discount Amount - The aggregate amounts calculated per discount across all line items.
- Total
Excluding float64Tax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- Total
Pretax []InvoiceCredit Amounts Total Pretax Credit Amount - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- Total
Taxes []InvoiceTotal Tax - The aggregate tax information of all line items.
- Webhooks
Delivered float64At - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account_
country string - The country of the business associated with this invoice, most often the business creating the invoice.
- account_
name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- amount_
due number - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount_
overpaid number - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount_
paid number - The amount, in cents (or local equivalent), that was paid.
- amount_
paid_ numberoff_ stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount_
remaining number - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount_
shipping number - This is the sum of all the shipping amounts.
- application string
- ID of the Connect Application that created the invoice.
- attempt_
count number - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - billing_
reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- confirmation_
secret object - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- customer_
address object - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer_
email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer_
name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer_
phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer_
shipping object - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer_
tax_ list(object)ids - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - ending_
balance number - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- hosted_
invoice_ stringurl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- id string
- The provider-assigned unique ID for this managed resource.
- invoice_
pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- last_
finalization_ objecterror - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest_
revision string - The ID of the most recent non-draft revision of this invoice
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - next_
payment_ numberattempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - object string
- String representing the object's type. Objects of the same type share the same value.
- parent object
- The parent that generated this invoice
- period_
end number - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period_
start number - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post_
payment_ numbercredit_ notes_ amount - Total amount of all post-payment credit notes issued for this invoice.
- pre_
payment_ numbercredit_ notes_ amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt_
number string - This is the transaction number that appears on email receipts sent for this invoice.
- starting_
balance number - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status_
transitions object - subtotal number
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal_
excluding_ numbertax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test_
clock string - ID of the test clock this invoice belongs to.
- threshold_
reason object - total number
- Total after discounts and taxes.
- total_
discount_ list(object)amounts - The aggregate amounts calculated per discount across all line items.
- total_
excluding_ numbertax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total_
pretax_ list(object)credit_ amounts - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total_
taxes list(object) - The aggregate tax information of all line items.
- webhooks_
delivered_ numberat - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account
Country String - The country of the business associated with this invoice, most often the business creating the invoice.
- account
Name String - The public name of the business associated with this invoice, most often the business creating the invoice.
- amount
Due Double - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount
Overpaid Double - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount
Paid Double - The amount, in cents (or local equivalent), that was paid.
- amount
Paid DoubleOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount
Remaining Double - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount
Shipping Double - This is the sum of all the shipping amounts.
- application String
- ID of the Connect Application that created the invoice.
- attempt
Count Double - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted Boolean
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - billing
Reason String - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- confirmation
Secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- created Double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- customer
Address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer
Email String - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer
Name String - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer
Phone String - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer
Shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer
Tax List<InvoiceIds Customer Tax Id> - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - ending
Balance Double - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- hosted
Invoice StringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- id String
- The provider-assigned unique ID for this managed resource.
- invoice
Pdf String - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- last
Finalization InvoiceError Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest
Revision String - The ID of the most recent non-draft revision of this invoice
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - next
Payment DoubleAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - object String
- String representing the object's type. Objects of the same type share the same value.
- parent
Invoice
Parent - The parent that generated this invoice
- period
End Double - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period
Start Double - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post
Payment DoubleCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- pre
Payment DoubleCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt
Number String - This is the transaction number that appears on email receipts sent for this invoice.
- starting
Balance Double - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- status String
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status
Transitions InvoiceStatus Transitions - subtotal Double
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal
Excluding DoubleTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test
Clock String - ID of the test clock this invoice belongs to.
- threshold
Reason InvoiceThreshold Reason - total Double
- Total after discounts and taxes.
- total
Discount List<InvoiceAmounts Total Discount Amount> - The aggregate amounts calculated per discount across all line items.
- total
Excluding DoubleTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total
Pretax List<InvoiceCredit Amounts Total Pretax Credit Amount> - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total
Taxes List<InvoiceTotal Tax> - The aggregate tax information of all line items.
- webhooks
Delivered DoubleAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account
Country string - The country of the business associated with this invoice, most often the business creating the invoice.
- account
Name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- amount
Due number - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount
Overpaid number - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount
Paid number - The amount, in cents (or local equivalent), that was paid.
- amount
Paid numberOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount
Remaining number - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount
Shipping number - This is the sum of all the shipping amounts.
- application string
- ID of the Connect Application that created the invoice.
- attempt
Count number - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted boolean
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - billing
Reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- confirmation
Secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- customer
Address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer
Email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer
Name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer
Phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer
Shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer
Tax InvoiceIds Customer Tax Id[] - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - ending
Balance number - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- hosted
Invoice stringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- id string
- The provider-assigned unique ID for this managed resource.
- invoice
Pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- last
Finalization InvoiceError Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest
Revision string - The ID of the most recent non-draft revision of this invoice
- livemode boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - next
Payment numberAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - object string
- String representing the object's type. Objects of the same type share the same value.
- parent
Invoice
Parent - The parent that generated this invoice
- period
End number - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period
Start number - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post
Payment numberCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- pre
Payment numberCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt
Number string - This is the transaction number that appears on email receipts sent for this invoice.
- starting
Balance number - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status
Transitions InvoiceStatus Transitions - subtotal number
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal
Excluding numberTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test
Clock string - ID of the test clock this invoice belongs to.
- threshold
Reason InvoiceThreshold Reason - total number
- Total after discounts and taxes.
- total
Discount InvoiceAmounts Total Discount Amount[] - The aggregate amounts calculated per discount across all line items.
- total
Excluding numberTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total
Pretax InvoiceCredit Amounts Total Pretax Credit Amount[] - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total
Taxes InvoiceTotal Tax[] - The aggregate tax information of all line items.
- webhooks
Delivered numberAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account_
country str - The country of the business associated with this invoice, most often the business creating the invoice.
- account_
name str - The public name of the business associated with this invoice, most often the business creating the invoice.
- amount_
due float - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount_
overpaid float - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount_
paid float - The amount, in cents (or local equivalent), that was paid.
- amount_
paid_ floatoff_ stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount_
remaining float - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount_
shipping float - This is the sum of all the shipping amounts.
- application str
- ID of the Connect Application that created the invoice.
- attempt_
count float - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - billing_
reason str - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- confirmation_
secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- created float
- Time at which the object was created. Measured in seconds since the Unix epoch.
- customer_
address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer_
email str - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer_
name str - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer_
phone str - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer_
shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer_
tax_ Sequence[Invoiceids Customer Tax Id] - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - ending_
balance float - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- hosted_
invoice_ strurl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- id str
- The provider-assigned unique ID for this managed resource.
- invoice_
pdf str - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- last_
finalization_ Invoiceerror Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest_
revision str - The ID of the most recent non-draft revision of this invoice
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - next_
payment_ floatattempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - object str
- String representing the object's type. Objects of the same type share the same value.
- parent
Invoice
Parent - The parent that generated this invoice
- period_
end float - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period_
start float - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post_
payment_ floatcredit_ notes_ amount - Total amount of all post-payment credit notes issued for this invoice.
- pre_
payment_ floatcredit_ notes_ amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt_
number str - This is the transaction number that appears on email receipts sent for this invoice.
- starting_
balance float - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- status str
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status_
transitions InvoiceStatus Transitions - subtotal float
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal_
excluding_ floattax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test_
clock str - ID of the test clock this invoice belongs to.
- threshold_
reason InvoiceThreshold Reason - total float
- Total after discounts and taxes.
- total_
discount_ Sequence[Invoiceamounts Total Discount Amount] - The aggregate amounts calculated per discount across all line items.
- total_
excluding_ floattax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total_
pretax_ Sequence[Invoicecredit_ amounts Total Pretax Credit Amount] - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total_
taxes Sequence[InvoiceTotal Tax] - The aggregate tax information of all line items.
- webhooks_
delivered_ floatat - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account
Country String - The country of the business associated with this invoice, most often the business creating the invoice.
- account
Name String - The public name of the business associated with this invoice, most often the business creating the invoice.
- amount
Due Number - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount
Overpaid Number - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount
Paid Number - The amount, in cents (or local equivalent), that was paid.
- amount
Paid NumberOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount
Remaining Number - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount
Shipping Number - This is the sum of all the shipping amounts.
- application String
- ID of the Connect Application that created the invoice.
- attempt
Count Number - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted Boolean
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - billing
Reason String - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- confirmation
Secret Property Map - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- created Number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- customer
Address Property Map - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer
Email String - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer
Name String - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer
Phone String - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer
Shipping Property Map - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer
Tax List<Property Map>Ids - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - ending
Balance Number - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- hosted
Invoice StringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- id String
- The provider-assigned unique ID for this managed resource.
- invoice
Pdf String - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- last
Finalization Property MapError - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest
Revision String - The ID of the most recent non-draft revision of this invoice
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - next
Payment NumberAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - object String
- String representing the object's type. Objects of the same type share the same value.
- parent Property Map
- The parent that generated this invoice
- period
End Number - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period
Start Number - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post
Payment NumberCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- pre
Payment NumberCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt
Number String - This is the transaction number that appears on email receipts sent for this invoice.
- starting
Balance Number - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- status String
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status
Transitions Property Map - subtotal Number
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal
Excluding NumberTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test
Clock String - ID of the test clock this invoice belongs to.
- threshold
Reason Property Map - total Number
- Total after discounts and taxes.
- total
Discount List<Property Map>Amounts - The aggregate amounts calculated per discount across all line items.
- total
Excluding NumberTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total
Pretax List<Property Map>Credit Amounts - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total
Taxes List<Property Map> - The aggregate tax information of all line items.
- webhooks
Delivered NumberAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
Look up Existing Invoice Resource
Get an existing Invoice 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?: InvoiceState, opts?: CustomResourceOptions): Invoice@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
account_country: Optional[str] = None,
account_name: Optional[str] = None,
account_tax_ids: Optional[Sequence[str]] = None,
amount_due: Optional[float] = None,
amount_overpaid: Optional[float] = None,
amount_paid: Optional[float] = None,
amount_paid_off_stripe: Optional[float] = None,
amount_remaining: Optional[float] = None,
amount_shipping: Optional[float] = None,
application: Optional[str] = None,
application_fee_amount: Optional[float] = None,
attempt_count: Optional[float] = None,
attempted: Optional[bool] = None,
auto_advance: Optional[bool] = None,
automatic_tax: Optional[InvoiceAutomaticTaxArgs] = None,
automatically_finalizes_at: Optional[float] = None,
billing_reason: Optional[str] = None,
collection_method: Optional[str] = None,
confirmation_secret: Optional[InvoiceConfirmationSecretArgs] = None,
created: Optional[float] = None,
currency: Optional[str] = None,
custom_fields: Optional[Sequence[InvoiceCustomFieldArgs]] = None,
customer: Optional[str] = None,
customer_account: Optional[str] = None,
customer_address: Optional[InvoiceCustomerAddressArgs] = None,
customer_email: Optional[str] = None,
customer_name: Optional[str] = None,
customer_phone: Optional[str] = None,
customer_shipping: Optional[InvoiceCustomerShippingArgs] = None,
customer_tax_ids: Optional[Sequence[InvoiceCustomerTaxIdArgs]] = 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[InvoiceDiscountArgs]] = None,
due_date: Optional[float] = None,
effective_at: Optional[float] = None,
ending_balance: Optional[float] = None,
footer: Optional[str] = None,
from_invoice: Optional[InvoiceFromInvoiceArgs] = None,
hosted_invoice_url: Optional[str] = None,
invoice_pdf: Optional[str] = None,
issuer: Optional[InvoiceIssuerArgs] = None,
last_finalization_error: Optional[InvoiceLastFinalizationErrorArgs] = None,
latest_revision: Optional[str] = None,
livemode: Optional[bool] = None,
metadata: Optional[Mapping[str, str]] = None,
next_payment_attempt: Optional[float] = None,
number: Optional[str] = None,
object: Optional[str] = None,
on_behalf_of: Optional[str] = None,
parent: Optional[InvoiceParentArgs] = None,
payment_settings: Optional[InvoicePaymentSettingsArgs] = None,
pending_invoice_items_behavior: Optional[str] = None,
period_end: Optional[float] = None,
period_start: Optional[float] = None,
post_payment_credit_notes_amount: Optional[float] = None,
pre_payment_credit_notes_amount: Optional[float] = None,
receipt_number: Optional[str] = None,
rendering: Optional[InvoiceRenderingArgs] = None,
shipping_cost: Optional[InvoiceShippingCostArgs] = None,
shipping_details: Optional[InvoiceShippingDetailsArgs] = None,
starting_balance: Optional[float] = None,
statement_descriptor: Optional[str] = None,
status: Optional[str] = None,
status_transitions: Optional[InvoiceStatusTransitionsArgs] = None,
subscription: Optional[str] = None,
subtotal: Optional[float] = None,
subtotal_excluding_tax: Optional[float] = None,
test_clock: Optional[str] = None,
threshold_reason: Optional[InvoiceThresholdReasonArgs] = None,
total: Optional[float] = None,
total_discount_amounts: Optional[Sequence[InvoiceTotalDiscountAmountArgs]] = None,
total_excluding_tax: Optional[float] = None,
total_pretax_credit_amounts: Optional[Sequence[InvoiceTotalPretaxCreditAmountArgs]] = None,
total_taxes: Optional[Sequence[InvoiceTotalTaxArgs]] = None,
transfer_data: Optional[InvoiceTransferDataArgs] = None,
webhooks_delivered_at: Optional[float] = None) -> Invoicefunc GetInvoice(ctx *Context, name string, id IDInput, state *InvoiceState, opts ...ResourceOption) (*Invoice, error)public static Invoice Get(string name, Input<string> id, InvoiceState? state, CustomResourceOptions? opts = null)public static Invoice get(String name, Output<String> id, InvoiceState state, CustomResourceOptions options)resources: _: type: stripe:Invoice get: id: ${id}import {
to = stripe_invoice.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.
- Account
Country string - The country of the business associated with this invoice, most often the business creating the invoice.
- Account
Name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- Account
Tax List<string>Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- Amount
Due double - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - Amount
Overpaid double - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- Amount
Paid double - The amount, in cents (or local equivalent), that was paid.
- Amount
Paid doubleOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- Amount
Remaining double - The difference between amount_due and amount_paid, in cents (or local equivalent).
- Amount
Shipping double - This is the sum of all the shipping amounts.
- Application string
- ID of the Connect Application that created the invoice.
- Application
Fee doubleAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- Attempt
Count double - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- Attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - Auto
Advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - Automatic
Tax InvoiceAutomatic Tax - Automatically
Finalizes doubleAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - Billing
Reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - Confirmation
Secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- 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.
- Custom
Fields List<InvoiceCustom Field> - Custom fields displayed on the invoice.
- Customer string
- The ID of the customer to bill.
- Customer
Account string - The ID of the account representing the customer to bill.
- Customer
Address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - Customer
Email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - Customer
Name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - Customer
Phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - Customer
Shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - Customer
Tax List<InvoiceIds Customer Tax Id> - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - Days
Until doubleDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - Default
Payment stringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- Default
Source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- Default
Tax List<string>Rates - The tax rates applied to this invoice, if any.
- Description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- Discounts
List<Invoice
Discount> - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - Due
Date double - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - Effective
At double - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - Ending
Balance double - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- string
- Footer displayed on the invoice.
- From
Invoice InvoiceFrom Invoice - Details of the invoice that was cloned. See the revision documentation for more details.
- Hosted
Invoice stringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- Invoice
Pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- Issuer
Invoice
Issuer - Last
Finalization InvoiceError Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- Latest
Revision string - The ID of the most recent non-draft revision of this invoice
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - 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
Payment doubleAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - Number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- Object string
- String representing the object's type. Objects of the same type share the same value.
- On
Behalf stringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- Parent
Invoice
Parent - The parent that generated this invoice
- Payment
Settings InvoicePayment Settings - Pending
Invoice stringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - Period
End double - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Period
Start double - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Post
Payment doubleCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- Pre
Payment doubleCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- Receipt
Number string - This is the transaction number that appears on email receipts sent for this invoice.
- Rendering
Invoice
Rendering - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- Shipping
Cost InvoiceShipping Cost - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- Shipping
Details InvoiceShipping Details - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - Starting
Balance double - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- Statement
Descriptor string - Extra information about an invoice for the customer's credit card statement.
- Status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - Status
Transitions InvoiceStatus Transitions - Subscription string
- Subtotal double
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- Subtotal
Excluding doubleTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- Test
Clock string - ID of the test clock this invoice belongs to.
- Threshold
Reason InvoiceThreshold Reason - Total double
- Total after discounts and taxes.
- Total
Discount List<InvoiceAmounts Total Discount Amount> - The aggregate amounts calculated per discount across all line items.
- Total
Excluding doubleTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- Total
Pretax List<InvoiceCredit Amounts Total Pretax Credit Amount> - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- Total
Taxes List<InvoiceTotal Tax> - The aggregate tax information of all line items.
- Transfer
Data InvoiceTransfer Data - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- Webhooks
Delivered doubleAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- Account
Country string - The country of the business associated with this invoice, most often the business creating the invoice.
- Account
Name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- Account
Tax []stringIds - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- Amount
Due float64 - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - Amount
Overpaid float64 - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- Amount
Paid float64 - The amount, in cents (or local equivalent), that was paid.
- Amount
Paid float64Off Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- Amount
Remaining float64 - The difference between amount_due and amount_paid, in cents (or local equivalent).
- Amount
Shipping float64 - This is the sum of all the shipping amounts.
- Application string
- ID of the Connect Application that created the invoice.
- Application
Fee float64Amount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- Attempt
Count float64 - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- Attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - Auto
Advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - Automatic
Tax InvoiceAutomatic Tax Args - Automatically
Finalizes float64At - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - Billing
Reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- Collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - Confirmation
Secret InvoiceConfirmation Secret Args - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- 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.
- Custom
Fields []InvoiceCustom Field Args - Custom fields displayed on the invoice.
- Customer string
- The ID of the customer to bill.
- Customer
Account string - The ID of the account representing the customer to bill.
- Customer
Address InvoiceCustomer Address Args - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - Customer
Email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - Customer
Name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - Customer
Phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - Customer
Shipping InvoiceCustomer Shipping Args - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - Customer
Tax []InvoiceIds Customer Tax Id Args - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - Days
Until float64Due - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - Default
Payment stringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- Default
Source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- Default
Tax []stringRates - The tax rates applied to this invoice, if any.
- Description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- Discounts
[]Invoice
Discount Args - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - Due
Date float64 - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - Effective
At float64 - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - Ending
Balance float64 - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- string
- Footer displayed on the invoice.
- From
Invoice InvoiceFrom Invoice Args - Details of the invoice that was cloned. See the revision documentation for more details.
- Hosted
Invoice stringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- Invoice
Pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- Issuer
Invoice
Issuer Args - Last
Finalization InvoiceError Last Finalization Error Args - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- Latest
Revision string - The ID of the most recent non-draft revision of this invoice
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - 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
Payment float64Attempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - Number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- Object string
- String representing the object's type. Objects of the same type share the same value.
- On
Behalf stringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- Parent
Invoice
Parent Args - The parent that generated this invoice
- Payment
Settings InvoicePayment Settings Args - Pending
Invoice stringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - Period
End float64 - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Period
Start float64 - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- Post
Payment float64Credit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- Pre
Payment float64Credit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- Receipt
Number string - This is the transaction number that appears on email receipts sent for this invoice.
- Rendering
Invoice
Rendering Args - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- Shipping
Cost InvoiceShipping Cost Args - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- Shipping
Details InvoiceShipping Details Args - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - Starting
Balance float64 - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- Statement
Descriptor string - Extra information about an invoice for the customer's credit card statement.
- Status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - Status
Transitions InvoiceStatus Transitions Args - Subscription string
- Subtotal float64
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- Subtotal
Excluding float64Tax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- Test
Clock string - ID of the test clock this invoice belongs to.
- Threshold
Reason InvoiceThreshold Reason Args - Total float64
- Total after discounts and taxes.
- Total
Discount []InvoiceAmounts Total Discount Amount Args - The aggregate amounts calculated per discount across all line items.
- Total
Excluding float64Tax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- Total
Pretax []InvoiceCredit Amounts Total Pretax Credit Amount Args - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- Total
Taxes []InvoiceTotal Tax Args - The aggregate tax information of all line items.
- Transfer
Data InvoiceTransfer Data Args - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- Webhooks
Delivered float64At - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account_
country string - The country of the business associated with this invoice, most often the business creating the invoice.
- account_
name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- account_
tax_ list(string)ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- amount_
due number - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount_
overpaid number - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount_
paid number - The amount, in cents (or local equivalent), that was paid.
- amount_
paid_ numberoff_ stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount_
remaining number - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount_
shipping number - This is the sum of all the shipping amounts.
- application string
- ID of the Connect Application that created the invoice.
- application_
fee_ numberamount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- attempt_
count number - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - auto_
advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic_
tax object - automatically_
finalizes_ numberat - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - billing_
reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- collection_
method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - confirmation_
secret object - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- 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.
- custom_
fields list(object) - Custom fields displayed on the invoice.
- customer string
- The ID of the customer to bill.
- customer_
account string - The ID of the account representing the customer to bill.
- customer_
address object - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer_
email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer_
name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer_
phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer_
shipping object - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer_
tax_ list(object)ids - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - days_
until_ numberdue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default_
payment_ stringmethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default_
source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default_
tax_ list(string)rates - The tax rates applied to this invoice, if any.
- description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts list(object)
- The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due_
date number - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective_
at number - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - ending_
balance number - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- string
- Footer displayed on the invoice.
- from_
invoice object - Details of the invoice that was cloned. See the revision documentation for more details.
- hosted_
invoice_ stringurl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- invoice_
pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- issuer object
- last_
finalization_ objecterror - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest_
revision string - The ID of the most recent non-draft revision of this invoice
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - 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_
payment_ numberattempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- object string
- String representing the object's type. Objects of the same type share the same value.
- on_
behalf_ stringof - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- parent object
- The parent that generated this invoice
- payment_
settings object - pending_
invoice_ stringitems_ behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - period_
end number - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period_
start number - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post_
payment_ numbercredit_ notes_ amount - Total amount of all post-payment credit notes issued for this invoice.
- pre_
payment_ numbercredit_ notes_ amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt_
number string - This is the transaction number that appears on email receipts sent for this invoice.
- rendering object
- The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping_
cost object - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping_
details object - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - starting_
balance number - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- statement_
descriptor string - Extra information about an invoice for the customer's credit card statement.
- status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status_
transitions object - subscription string
- subtotal number
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal_
excluding_ numbertax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test_
clock string - ID of the test clock this invoice belongs to.
- threshold_
reason object - total number
- Total after discounts and taxes.
- total_
discount_ list(object)amounts - The aggregate amounts calculated per discount across all line items.
- total_
excluding_ numbertax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total_
pretax_ list(object)credit_ amounts - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total_
taxes list(object) - The aggregate tax information of all line items.
- transfer_
data object - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- webhooks_
delivered_ numberat - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account
Country String - The country of the business associated with this invoice, most often the business creating the invoice.
- account
Name String - The public name of the business associated with this invoice, most often the business creating the invoice.
- account
Tax List<String>Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- amount
Due Double - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount
Overpaid Double - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount
Paid Double - The amount, in cents (or local equivalent), that was paid.
- amount
Paid DoubleOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount
Remaining Double - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount
Shipping Double - This is the sum of all the shipping amounts.
- application String
- ID of the Connect Application that created the invoice.
- application
Fee DoubleAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- attempt
Count Double - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted Boolean
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - auto
Advance Boolean - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic
Tax InvoiceAutomatic Tax - automatically
Finalizes DoubleAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - billing
Reason String - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - confirmation
Secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- 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.
- custom
Fields List<InvoiceCustom Field> - Custom fields displayed on the invoice.
- customer String
- The ID of the customer to bill.
- customer
Account String - The ID of the account representing the customer to bill.
- customer
Address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer
Email String - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer
Name String - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer
Phone String - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer
Shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer
Tax List<InvoiceIds Customer Tax Id> - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - days
Until DoubleDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default
Payment StringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default
Source String - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default
Tax List<String>Rates - The tax rates applied to this invoice, if any.
- description String
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts
List<Invoice
Discount> - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due
Date Double - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective
At Double - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - ending
Balance Double - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- String
- Footer displayed on the invoice.
- from
Invoice InvoiceFrom Invoice - Details of the invoice that was cloned. See the revision documentation for more details.
- hosted
Invoice StringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- invoice
Pdf String - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- issuer
Invoice
Issuer - last
Finalization InvoiceError Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest
Revision String - The ID of the most recent non-draft revision of this invoice
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - 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
Payment DoubleAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - number String
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- object String
- String representing the object's type. Objects of the same type share the same value.
- on
Behalf StringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- parent
Invoice
Parent - The parent that generated this invoice
- payment
Settings InvoicePayment Settings - pending
Invoice StringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - period
End Double - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period
Start Double - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post
Payment DoubleCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- pre
Payment DoubleCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt
Number String - This is the transaction number that appears on email receipts sent for this invoice.
- rendering
Invoice
Rendering - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping
Cost InvoiceShipping Cost - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping
Details InvoiceShipping Details - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - starting
Balance Double - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- statement
Descriptor String - Extra information about an invoice for the customer's credit card statement.
- status String
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status
Transitions InvoiceStatus Transitions - subscription String
- subtotal Double
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal
Excluding DoubleTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test
Clock String - ID of the test clock this invoice belongs to.
- threshold
Reason InvoiceThreshold Reason - total Double
- Total after discounts and taxes.
- total
Discount List<InvoiceAmounts Total Discount Amount> - The aggregate amounts calculated per discount across all line items.
- total
Excluding DoubleTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total
Pretax List<InvoiceCredit Amounts Total Pretax Credit Amount> - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total
Taxes List<InvoiceTotal Tax> - The aggregate tax information of all line items.
- transfer
Data InvoiceTransfer Data - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- webhooks
Delivered DoubleAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account
Country string - The country of the business associated with this invoice, most often the business creating the invoice.
- account
Name string - The public name of the business associated with this invoice, most often the business creating the invoice.
- account
Tax string[]Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- amount
Due number - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount
Overpaid number - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount
Paid number - The amount, in cents (or local equivalent), that was paid.
- amount
Paid numberOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount
Remaining number - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount
Shipping number - This is the sum of all the shipping amounts.
- application string
- ID of the Connect Application that created the invoice.
- application
Fee numberAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- attempt
Count number - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted boolean
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - auto
Advance boolean - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic
Tax InvoiceAutomatic Tax - automatically
Finalizes numberAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - billing
Reason string - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- collection
Method string - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - confirmation
Secret InvoiceConfirmation Secret - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- 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.
- custom
Fields InvoiceCustom Field[] - Custom fields displayed on the invoice.
- customer string
- The ID of the customer to bill.
- customer
Account string - The ID of the account representing the customer to bill.
- customer
Address InvoiceCustomer Address - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer
Email string - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer
Name string - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer
Phone string - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer
Shipping InvoiceCustomer Shipping - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer
Tax InvoiceIds Customer Tax Id[] - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - days
Until numberDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default
Payment stringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default
Source string - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default
Tax string[]Rates - The tax rates applied to this invoice, if any.
- description string
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts
Invoice
Discount[] - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due
Date number - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective
At number - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - ending
Balance number - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- string
- Footer displayed on the invoice.
- from
Invoice InvoiceFrom Invoice - Details of the invoice that was cloned. See the revision documentation for more details.
- hosted
Invoice stringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- invoice
Pdf string - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- issuer
Invoice
Issuer - last
Finalization InvoiceError Last Finalization Error - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest
Revision string - The ID of the most recent non-draft revision of this invoice
- livemode boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - 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
Payment numberAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - number string
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- object string
- String representing the object's type. Objects of the same type share the same value.
- on
Behalf stringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- parent
Invoice
Parent - The parent that generated this invoice
- payment
Settings InvoicePayment Settings - pending
Invoice stringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - period
End number - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period
Start number - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post
Payment numberCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- pre
Payment numberCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt
Number string - This is the transaction number that appears on email receipts sent for this invoice.
- rendering
Invoice
Rendering - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping
Cost InvoiceShipping Cost - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping
Details InvoiceShipping Details - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - starting
Balance number - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- statement
Descriptor string - Extra information about an invoice for the customer's credit card statement.
- status string
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status
Transitions InvoiceStatus Transitions - subscription string
- subtotal number
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal
Excluding numberTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test
Clock string - ID of the test clock this invoice belongs to.
- threshold
Reason InvoiceThreshold Reason - total number
- Total after discounts and taxes.
- total
Discount InvoiceAmounts Total Discount Amount[] - The aggregate amounts calculated per discount across all line items.
- total
Excluding numberTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total
Pretax InvoiceCredit Amounts Total Pretax Credit Amount[] - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total
Taxes InvoiceTotal Tax[] - The aggregate tax information of all line items.
- transfer
Data InvoiceTransfer Data - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- webhooks
Delivered numberAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account_
country str - The country of the business associated with this invoice, most often the business creating the invoice.
- account_
name str - The public name of the business associated with this invoice, most often the business creating the invoice.
- account_
tax_ Sequence[str]ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- amount_
due float - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount_
overpaid float - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount_
paid float - The amount, in cents (or local equivalent), that was paid.
- amount_
paid_ floatoff_ stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount_
remaining float - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount_
shipping float - This is the sum of all the shipping amounts.
- application str
- ID of the Connect Application that created the invoice.
- application_
fee_ floatamount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- attempt_
count float - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted bool
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - auto_
advance bool - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic_
tax InvoiceAutomatic Tax Args - automatically_
finalizes_ floatat - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - billing_
reason str - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- collection_
method str - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - confirmation_
secret InvoiceConfirmation Secret Args - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- 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.
- custom_
fields Sequence[InvoiceCustom Field Args] - Custom fields displayed on the invoice.
- customer str
- The ID of the customer to bill.
- customer_
account str - The ID of the account representing the customer to bill.
- customer_
address InvoiceCustomer Address Args - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer_
email str - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer_
name str - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer_
phone str - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer_
shipping InvoiceCustomer Shipping Args - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer_
tax_ Sequence[Invoiceids Customer Tax Id Args] - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - days_
until_ floatdue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default_
payment_ strmethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default_
source str - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default_
tax_ Sequence[str]rates - The tax rates applied to this invoice, if any.
- description str
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts
Sequence[Invoice
Discount Args] - The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due_
date float - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective_
at float - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - ending_
balance float - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- str
- Footer displayed on the invoice.
- from_
invoice InvoiceFrom Invoice Args - Details of the invoice that was cloned. See the revision documentation for more details.
- hosted_
invoice_ strurl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- invoice_
pdf str - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- issuer
Invoice
Issuer Args - last_
finalization_ Invoiceerror Last Finalization Error Args - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest_
revision str - The ID of the most recent non-draft revision of this invoice
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - 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_
payment_ floatattempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - number str
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- object str
- String representing the object's type. Objects of the same type share the same value.
- on_
behalf_ strof - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- parent
Invoice
Parent Args - The parent that generated this invoice
- payment_
settings InvoicePayment Settings Args - pending_
invoice_ stritems_ behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - period_
end float - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period_
start float - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post_
payment_ floatcredit_ notes_ amount - Total amount of all post-payment credit notes issued for this invoice.
- pre_
payment_ floatcredit_ notes_ amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt_
number str - This is the transaction number that appears on email receipts sent for this invoice.
- rendering
Invoice
Rendering Args - The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping_
cost InvoiceShipping Cost Args - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping_
details InvoiceShipping Details Args - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - starting_
balance float - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- statement_
descriptor str - Extra information about an invoice for the customer's credit card statement.
- status str
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status_
transitions InvoiceStatus Transitions Args - subscription str
- subtotal float
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal_
excluding_ floattax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test_
clock str - ID of the test clock this invoice belongs to.
- threshold_
reason InvoiceThreshold Reason Args - total float
- Total after discounts and taxes.
- total_
discount_ Sequence[Invoiceamounts Total Discount Amount Args] - The aggregate amounts calculated per discount across all line items.
- total_
excluding_ floattax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total_
pretax_ Sequence[Invoicecredit_ amounts Total Pretax Credit Amount Args] - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total_
taxes Sequence[InvoiceTotal Tax Args] - The aggregate tax information of all line items.
- transfer_
data InvoiceTransfer Data Args - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- webhooks_
delivered_ floatat - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
- account
Country String - The country of the business associated with this invoice, most often the business creating the invoice.
- account
Name String - The public name of the business associated with this invoice, most often the business creating the invoice.
- account
Tax List<String>Ids - The account tax IDs associated with the invoice. Only editable when the invoice is a draft.
- amount
Due Number - Final amount due at this time for this invoice. If the invoice's total is smaller than the minimum charge amount, for example, or if there is account credit that can be applied to the invoice, the
amount_duemay be 0. If there is a positivestarting_balancefor the invoice (the customer owes money), theamount_duewill also take that into account. The charge that gets generated for the invoice will be for the amount specified inamount_due. - amount
Overpaid Number - Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's credit balance.
- amount
Paid Number - The amount, in cents (or local equivalent), that was paid.
- amount
Paid NumberOff Stripe - Amount, in cents (or local equivalent), that was paid on the invoice outside of Stripe.
- amount
Remaining Number - The difference between amount_due and amount_paid, in cents (or local equivalent).
- amount
Shipping Number - This is the sum of all the shipping amounts.
- application String
- ID of the Connect Application that created the invoice.
- application
Fee NumberAmount - A fee in cents (or local equivalent) that will be applied to the invoice and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the Stripe-Account header in order to take an application fee. For more information, see the application fees documentation.
- attempt
Count Number - Number of payment attempts made for this invoice, from the perspective of the payment retry schedule. Any payment attempt counts as the first attempt, and subsequently only automatic retries increment the attempt count. In other words, manual payment attempts after the first attempt do not affect the retry schedule. If a failure is returned with a non-retryable return code, the invoice can no longer be retried unless a new payment method is obtained. Retries will continue to be scheduled, and attempt_count will continue to increment, but retries will only be executed if a new payment method is obtained.
- attempted Boolean
- Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour after the
invoice.createdwebhook, for example, so you might not want to display that invoice as unpaid to your users. - auto
Advance Boolean - Controls whether Stripe performs automatic collection of the invoice. If
false, the invoice's state doesn't automatically advance without an explicit action. - automatic
Tax Property Map - automatically
Finalizes NumberAt - The time when this invoice is currently scheduled to be automatically finalized. The field will be
nullif the invoice is not scheduled to finalize in the future. If the invoice is not in the draft state, this field will always benull- seefinalized_atfor the time when an already-finalized invoice was finalized. - billing
Reason String - Indicates the reason why the invoice was created.
manual: Unrelated to a subscription, for example, created via the invoice editor.subscription: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.subscription_create: A new subscription was created.subscription_cycle: A subscription advanced into a new period.subscription_threshold: A subscription reached a billing threshold.subscription_update: A subscription was updated.upcoming: Reserved for upcoming invoices created through the Create Preview Invoice API or when aninvoice.upcomingevent is generated for an upcoming invoice on a subscription.
- collection
Method String - Either
charge_automatically, orsend_invoice. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. - confirmation
Secret Property Map - The confirmation secret associated with this invoice. Currently, this contains the client_secret of the PaymentIntent that Stripe creates during invoice finalization.
- 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.
- custom
Fields List<Property Map> - Custom fields displayed on the invoice.
- customer String
- The ID of the customer to bill.
- customer
Account String - The ID of the account representing the customer to bill.
- customer
Address Property Map - The customer's address. Until the invoice is finalized, this field will equal
customer.address. Once the invoice is finalized, this field will no longer be updated. - customer
Email String - The customer's email. Until the invoice is finalized, this field will equal
customer.email. Once the invoice is finalized, this field will no longer be updated. - customer
Name String - The customer's name. Until the invoice is finalized, this field will equal
customer.name. Once the invoice is finalized, this field will no longer be updated. - customer
Phone String - The customer's phone number. Until the invoice is finalized, this field will equal
customer.phone. Once the invoice is finalized, this field will no longer be updated. - customer
Shipping Property Map - The customer's shipping information. Until the invoice is finalized, this field will equal
customer.shipping. Once the invoice is finalized, this field will no longer be updated. - customer
Tax List<Property Map>Ids - The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax IDs as
customer.tax_ids. Once the invoice is finalized, this field will no longer be updated. - days
Until NumberDue - The number of days from when the invoice is created until it is due. Valid only for invoices where
collection_method=send_invoice. - default
Payment StringMethod - ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
- default
Source String - ID of the default payment source for the invoice. It must belong to the customer associated with the invoice and be in a chargeable state. If not set, defaults to the subscription's default source, if any, or to the customer's default source.
- default
Tax List<String>Rates - The tax rates applied to this invoice, if any.
- description String
- An arbitrary string attached to the object. Often useful for displaying to users. Referenced as 'memo' in the Dashboard.
- discounts List<Property Map>
- The discounts applied to the invoice. Line item discounts are applied before invoice discounts. Use
expand[]=discountsto expand each discount. - due
Date Number - The date on which payment for this invoice is due. This value will be
nullfor invoices wherecollection_method=charge_automatically. - effective
At Number - The date when this invoice is in effect. Same as
finalized_atunless overwritten. When defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF and receipt. - ending
Balance Number - Ending customer balance after the invoice is finalized. Invoices are finalized approximately an hour after successful webhook delivery or when payment collection is attempted for the invoice. If the invoice has not been finalized yet, this will be null.
- String
- Footer displayed on the invoice.
- from
Invoice Property Map - Details of the invoice that was cloned. See the revision documentation for more details.
- hosted
Invoice StringUrl - The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the invoice has not been finalized yet, this will be null.
- invoice
Pdf String - The link to download the PDF for the invoice. If the invoice has not been finalized yet, this will be null.
- issuer Property Map
- last
Finalization Property MapError - The error encountered during the previous attempt to finalize the invoice. This field is cleared when the invoice is successfully finalized.
- latest
Revision String - The ID of the most recent non-draft revision of this invoice
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - 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
Payment NumberAttempt - The time at which payment will next be attempted. This value will be
nullfor invoices wherecollection_method=send_invoice. - number String
- A unique, identifying string that appears on emails sent to the customer for this invoice. This starts with the customer's unique invoice_prefix if it is specified.
- object String
- String representing the object's type. Objects of the same type share the same value.
- on
Behalf StringOf - The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.
- parent Property Map
- The parent that generated this invoice
- payment
Settings Property Map - pending
Invoice StringItems Behavior - How to handle pending invoice items on invoice creation. Defaults to
excludeif the parameter is omitted. - period
End Number - The latest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- period
Start Number - The earliest timestamp at which invoice items can be associated with this invoice. Use the line item period to get the service period for each price.
- post
Payment NumberCredit Notes Amount - Total amount of all post-payment credit notes issued for this invoice.
- pre
Payment NumberCredit Notes Amount - Total amount of all pre-payment credit notes issued for this invoice.
- receipt
Number String - This is the transaction number that appears on email receipts sent for this invoice.
- rendering Property Map
- The rendering-related settings that control how the invoice is displayed on customer-facing surfaces such as PDF and Hosted Invoice Page.
- shipping
Cost Property Map - The details of the cost of shipping, including the ShippingRate applied on the invoice.
- shipping
Details Property Map - Shipping details for the invoice. The Invoice PDF will use the
shipping_detailsvalue if it is set, otherwise the PDF will render the shipping address from the customer. - starting
Balance Number - Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
- statement
Descriptor String - Extra information about an invoice for the customer's credit card statement.
- status String
- The status of the invoice, one of
draft,open,paid,uncollectible, orvoid. Learn more - status
Transitions Property Map - subscription String
- subtotal Number
- Total of all subscriptions, invoice items, and prorations on the invoice before any invoice level discount or exclusive tax is applied. Item discounts are already incorporated
- subtotal
Excluding NumberTax - The integer amount in cents (or local equivalent) representing the subtotal of the invoice before any invoice level discount or tax is applied. Item discounts are already incorporated
- test
Clock String - ID of the test clock this invoice belongs to.
- threshold
Reason Property Map - total Number
- Total after discounts and taxes.
- total
Discount List<Property Map>Amounts - The aggregate amounts calculated per discount across all line items.
- total
Excluding NumberTax - The integer amount in cents (or local equivalent) representing the total amount of the invoice including all discounts but excluding all tax.
- total
Pretax List<Property Map>Credit Amounts - Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
- total
Taxes List<Property Map> - The aggregate tax information of all line items.
- transfer
Data Property Map - If specified, the funds from the invoice will be transferred to the destination and the ID of the resulting transfer will be found on the invoice's charge.
- webhooks
Delivered NumberAt - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have been exhausted. This field tracks the time when webhooks for this invoice were successfully delivered. If the invoice had no webhooks to deliver, this will be set while the invoice is being created.
Supporting Types
InvoiceAutomaticTax, InvoiceAutomaticTaxArgs
- Enabled bool
- Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified tax rates, negative amounts, or
tax_behavior=unspecified) cannot be added to automatic tax invoices. - Disabled
Reason string - If Stripe disabled automatic tax, this enum describes why.
- Liability
Invoice
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.
- Provider string
- The tax provider powering automatic tax.
- Status string
- The status of the most recent automated tax calculation for this invoice.
- Enabled bool
- Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified tax rates, negative amounts, or
tax_behavior=unspecified) cannot be added to automatic tax invoices. - Disabled
Reason string - If Stripe disabled automatic tax, this enum describes why.
- Liability
Invoice
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.
- Provider string
- The tax provider powering automatic tax.
- Status string
- The status of the most recent automated tax calculation for this invoice.
- enabled bool
- Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified tax rates, negative amounts, or
tax_behavior=unspecified) cannot be added to automatic tax invoices. - 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.
- provider string
- The tax provider powering automatic tax.
- status string
- The status of the most recent automated tax calculation for this invoice.
- enabled Boolean
- Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified tax rates, negative amounts, or
tax_behavior=unspecified) cannot be added to automatic tax invoices. - disabled
Reason String - If Stripe disabled automatic tax, this enum describes why.
- liability
Invoice
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.
- provider String
- The tax provider powering automatic tax.
- status String
- The status of the most recent automated tax calculation for this invoice.
- enabled boolean
- Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified tax rates, negative amounts, or
tax_behavior=unspecified) cannot be added to automatic tax invoices. - disabled
Reason string - If Stripe disabled automatic tax, this enum describes why.
- liability
Invoice
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.
- provider string
- The tax provider powering automatic tax.
- status string
- The status of the most recent automated tax calculation for this invoice.
- enabled bool
- Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified tax rates, negative amounts, or
tax_behavior=unspecified) cannot be added to automatic tax invoices. - disabled_
reason str - If Stripe disabled automatic tax, this enum describes why.
- liability
Invoice
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.
- provider str
- The tax provider powering automatic tax.
- status str
- The status of the most recent automated tax calculation for this invoice.
- enabled Boolean
- Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified tax rates, negative amounts, or
tax_behavior=unspecified) cannot be added to automatic tax invoices. - 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.
- provider String
- The tax provider powering automatic tax.
- status String
- The status of the most recent automated tax calculation for this invoice.
InvoiceAutomaticTaxLiability, InvoiceAutomaticTaxLiabilityArgs
InvoiceConfirmationSecret, InvoiceConfirmationSecretArgs
- Client
Secret string - The client_secret of the payment that Stripe creates for the invoice after finalization.
- Type string
- The type of clientsecret. Currently this is always paymentintent, referencing the default payment_intent that Stripe creates during invoice finalization
- Client
Secret string - The client_secret of the payment that Stripe creates for the invoice after finalization.
- Type string
- The type of clientsecret. Currently this is always paymentintent, referencing the default payment_intent that Stripe creates during invoice finalization
- client_
secret string - The client_secret of the payment that Stripe creates for the invoice after finalization.
- type string
- The type of clientsecret. Currently this is always paymentintent, referencing the default payment_intent that Stripe creates during invoice finalization
- client
Secret String - The client_secret of the payment that Stripe creates for the invoice after finalization.
- type String
- The type of clientsecret. Currently this is always paymentintent, referencing the default payment_intent that Stripe creates during invoice finalization
- client
Secret string - The client_secret of the payment that Stripe creates for the invoice after finalization.
- type string
- The type of clientsecret. Currently this is always paymentintent, referencing the default payment_intent that Stripe creates during invoice finalization
- client_
secret str - The client_secret of the payment that Stripe creates for the invoice after finalization.
- type str
- The type of clientsecret. Currently this is always paymentintent, referencing the default payment_intent that Stripe creates during invoice finalization
- client
Secret String - The client_secret of the payment that Stripe creates for the invoice after finalization.
- type String
- The type of clientsecret. Currently this is always paymentintent, referencing the default payment_intent that Stripe creates during invoice finalization
InvoiceCustomField, InvoiceCustomFieldArgs
InvoiceCustomerAddress, InvoiceCustomerAddressArgs
- City string
- City, district, suburb, town, or village.
- Country string
- Two-letter country code (ISO 3166-1 alpha-2).
- Line1 string
- Address line 1, such as the street, PO Box, or company name.
- Line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- Postal
Code string - ZIP or postal code.
- State string
- State, county, province, or region (ISO 3166-2).
- City string
- City, district, suburb, town, or village.
- Country string
- Two-letter country code (ISO 3166-1 alpha-2).
- Line1 string
- Address line 1, such as the street, PO Box, or company name.
- Line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- Postal
Code string - ZIP or postal code.
- State string
- State, county, province, or region (ISO 3166-2).
- city string
- City, district, suburb, town, or village.
- country string
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 string
- Address line 1, such as the street, PO Box, or company name.
- line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- postal_
code string - ZIP or postal code.
- state string
- State, county, province, or region (ISO 3166-2).
- city String
- City, district, suburb, town, or village.
- country String
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 String
- Address line 1, such as the street, PO Box, or company name.
- line2 String
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code String - ZIP or postal code.
- state String
- State, county, province, or region (ISO 3166-2).
- city string
- City, district, suburb, town, or village.
- country string
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 string
- Address line 1, such as the street, PO Box, or company name.
- line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code string - ZIP or postal code.
- state string
- State, county, province, or region (ISO 3166-2).
- city str
- City, district, suburb, town, or village.
- country str
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 str
- Address line 1, such as the street, PO Box, or company name.
- line2 str
- Address line 2, such as the apartment, suite, unit, or building.
- postal_
code str - ZIP or postal code.
- state str
- State, county, province, or region (ISO 3166-2).
- city String
- City, district, suburb, town, or village.
- country String
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 String
- Address line 1, such as the street, PO Box, or company name.
- line2 String
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code String - ZIP or postal code.
- state String
- State, county, province, or region (ISO 3166-2).
InvoiceCustomerShipping, InvoiceCustomerShippingArgs
- Address
Invoice
Customer Shipping Address - Carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- Name string
- Recipient name.
- Phone string
- Recipient phone (including extension).
- Tracking
Number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- Address
Invoice
Customer Shipping Address - Carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- Name string
- Recipient name.
- Phone string
- Recipient phone (including extension).
- Tracking
Number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address object
- carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- name string
- Recipient name.
- phone string
- Recipient phone (including extension).
- tracking_
number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address
Invoice
Customer Shipping Address - carrier String
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- name String
- Recipient name.
- phone String
- Recipient phone (including extension).
- tracking
Number String - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address
Invoice
Customer Shipping Address - carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- name string
- Recipient name.
- phone string
- Recipient phone (including extension).
- tracking
Number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address
Invoice
Customer Shipping Address - carrier str
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- name str
- Recipient name.
- phone str
- Recipient phone (including extension).
- tracking_
number str - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address Property Map
- carrier String
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- name String
- Recipient name.
- phone String
- Recipient phone (including extension).
- tracking
Number String - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
InvoiceCustomerShippingAddress, InvoiceCustomerShippingAddressArgs
- City string
- City, district, suburb, town, or village.
- Country string
- Two-letter country code (ISO 3166-1 alpha-2).
- Line1 string
- Address line 1, such as the street, PO Box, or company name.
- Line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- Postal
Code string - ZIP or postal code.
- State string
- State, county, province, or region (ISO 3166-2).
- City string
- City, district, suburb, town, or village.
- Country string
- Two-letter country code (ISO 3166-1 alpha-2).
- Line1 string
- Address line 1, such as the street, PO Box, or company name.
- Line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- Postal
Code string - ZIP or postal code.
- State string
- State, county, province, or region (ISO 3166-2).
- city string
- City, district, suburb, town, or village.
- country string
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 string
- Address line 1, such as the street, PO Box, or company name.
- line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- postal_
code string - ZIP or postal code.
- state string
- State, county, province, or region (ISO 3166-2).
- city String
- City, district, suburb, town, or village.
- country String
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 String
- Address line 1, such as the street, PO Box, or company name.
- line2 String
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code String - ZIP or postal code.
- state String
- State, county, province, or region (ISO 3166-2).
- city string
- City, district, suburb, town, or village.
- country string
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 string
- Address line 1, such as the street, PO Box, or company name.
- line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code string - ZIP or postal code.
- state string
- State, county, province, or region (ISO 3166-2).
- city str
- City, district, suburb, town, or village.
- country str
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 str
- Address line 1, such as the street, PO Box, or company name.
- line2 str
- Address line 2, such as the apartment, suite, unit, or building.
- postal_
code str - ZIP or postal code.
- state str
- State, county, province, or region (ISO 3166-2).
- city String
- City, district, suburb, town, or village.
- country String
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 String
- Address line 1, such as the street, PO Box, or company name.
- line2 String
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code String - ZIP or postal code.
- state String
- State, county, province, or region (ISO 3166-2).
InvoiceCustomerTaxId, InvoiceCustomerTaxIdArgs
- Type string
- The type of the tax ID, one of
ad_nrt,ar_cuit,eu_vat,bo_tin,br_cnpj,br_cpf,cn_tin,co_nit,cr_tin,do_rcn,ec_ruc,eu_oss_vat,hr_oib,pe_ruc,ro_tin,rs_pib,sv_nit,uy_ruc,ve_rif,vn_tin,gb_vat,nz_gst,au_abn,au_arn,in_gst,no_vat,no_voec,za_vat,ch_vat,mx_rfc,sg_uen,ru_inn,ru_kpp,ca_bn,hk_br,es_cif,pl_nip,it_cf,fo_vat,gi_tin,py_ruc,tw_vat,th_vat,jp_cn,jp_rn,jp_trn,li_uid,li_vat,lk_vat,my_itn,us_ein,kr_brn,ca_qst,ca_gst_hst,ca_pst_bc,ca_pst_mb,ca_pst_sk,my_sst,sg_gst,ae_trn,cl_tin,sa_vat,id_npwp,my_frp,il_vat,ge_vat,ua_vat,is_vat,bg_uic,hu_tin,si_tin,ke_pin,tr_tin,eg_tin,ph_tin,al_tin,bh_vat,kz_bin,ng_tin,om_vat,de_stn,ch_uid,tz_vat,uz_vat,uz_tin,md_vat,ma_vat,by_tin,ao_tin,bs_tin,bb_tin,cd_nif,mr_nif,me_pib,zw_tin,ba_tin,gn_nif,mk_vat,sr_fin,sn_ninea,am_tin,np_pan,tj_tin,ug_tin,zm_tin,kh_tin,aw_tin,az_tin,bd_bin,bj_ifu,et_tin,kg_tin,la_tin,cm_niu,cv_nif,bf_ifu, orunknown - Value string
- The value of the tax ID.
- Type string
- The type of the tax ID, one of
ad_nrt,ar_cuit,eu_vat,bo_tin,br_cnpj,br_cpf,cn_tin,co_nit,cr_tin,do_rcn,ec_ruc,eu_oss_vat,hr_oib,pe_ruc,ro_tin,rs_pib,sv_nit,uy_ruc,ve_rif,vn_tin,gb_vat,nz_gst,au_abn,au_arn,in_gst,no_vat,no_voec,za_vat,ch_vat,mx_rfc,sg_uen,ru_inn,ru_kpp,ca_bn,hk_br,es_cif,pl_nip,it_cf,fo_vat,gi_tin,py_ruc,tw_vat,th_vat,jp_cn,jp_rn,jp_trn,li_uid,li_vat,lk_vat,my_itn,us_ein,kr_brn,ca_qst,ca_gst_hst,ca_pst_bc,ca_pst_mb,ca_pst_sk,my_sst,sg_gst,ae_trn,cl_tin,sa_vat,id_npwp,my_frp,il_vat,ge_vat,ua_vat,is_vat,bg_uic,hu_tin,si_tin,ke_pin,tr_tin,eg_tin,ph_tin,al_tin,bh_vat,kz_bin,ng_tin,om_vat,de_stn,ch_uid,tz_vat,uz_vat,uz_tin,md_vat,ma_vat,by_tin,ao_tin,bs_tin,bb_tin,cd_nif,mr_nif,me_pib,zw_tin,ba_tin,gn_nif,mk_vat,sr_fin,sn_ninea,am_tin,np_pan,tj_tin,ug_tin,zm_tin,kh_tin,aw_tin,az_tin,bd_bin,bj_ifu,et_tin,kg_tin,la_tin,cm_niu,cv_nif,bf_ifu, orunknown - Value string
- The value of the tax ID.
- type string
- The type of the tax ID, one of
ad_nrt,ar_cuit,eu_vat,bo_tin,br_cnpj,br_cpf,cn_tin,co_nit,cr_tin,do_rcn,ec_ruc,eu_oss_vat,hr_oib,pe_ruc,ro_tin,rs_pib,sv_nit,uy_ruc,ve_rif,vn_tin,gb_vat,nz_gst,au_abn,au_arn,in_gst,no_vat,no_voec,za_vat,ch_vat,mx_rfc,sg_uen,ru_inn,ru_kpp,ca_bn,hk_br,es_cif,pl_nip,it_cf,fo_vat,gi_tin,py_ruc,tw_vat,th_vat,jp_cn,jp_rn,jp_trn,li_uid,li_vat,lk_vat,my_itn,us_ein,kr_brn,ca_qst,ca_gst_hst,ca_pst_bc,ca_pst_mb,ca_pst_sk,my_sst,sg_gst,ae_trn,cl_tin,sa_vat,id_npwp,my_frp,il_vat,ge_vat,ua_vat,is_vat,bg_uic,hu_tin,si_tin,ke_pin,tr_tin,eg_tin,ph_tin,al_tin,bh_vat,kz_bin,ng_tin,om_vat,de_stn,ch_uid,tz_vat,uz_vat,uz_tin,md_vat,ma_vat,by_tin,ao_tin,bs_tin,bb_tin,cd_nif,mr_nif,me_pib,zw_tin,ba_tin,gn_nif,mk_vat,sr_fin,sn_ninea,am_tin,np_pan,tj_tin,ug_tin,zm_tin,kh_tin,aw_tin,az_tin,bd_bin,bj_ifu,et_tin,kg_tin,la_tin,cm_niu,cv_nif,bf_ifu, orunknown - value string
- The value of the tax ID.
- type String
- The type of the tax ID, one of
ad_nrt,ar_cuit,eu_vat,bo_tin,br_cnpj,br_cpf,cn_tin,co_nit,cr_tin,do_rcn,ec_ruc,eu_oss_vat,hr_oib,pe_ruc,ro_tin,rs_pib,sv_nit,uy_ruc,ve_rif,vn_tin,gb_vat,nz_gst,au_abn,au_arn,in_gst,no_vat,no_voec,za_vat,ch_vat,mx_rfc,sg_uen,ru_inn,ru_kpp,ca_bn,hk_br,es_cif,pl_nip,it_cf,fo_vat,gi_tin,py_ruc,tw_vat,th_vat,jp_cn,jp_rn,jp_trn,li_uid,li_vat,lk_vat,my_itn,us_ein,kr_brn,ca_qst,ca_gst_hst,ca_pst_bc,ca_pst_mb,ca_pst_sk,my_sst,sg_gst,ae_trn,cl_tin,sa_vat,id_npwp,my_frp,il_vat,ge_vat,ua_vat,is_vat,bg_uic,hu_tin,si_tin,ke_pin,tr_tin,eg_tin,ph_tin,al_tin,bh_vat,kz_bin,ng_tin,om_vat,de_stn,ch_uid,tz_vat,uz_vat,uz_tin,md_vat,ma_vat,by_tin,ao_tin,bs_tin,bb_tin,cd_nif,mr_nif,me_pib,zw_tin,ba_tin,gn_nif,mk_vat,sr_fin,sn_ninea,am_tin,np_pan,tj_tin,ug_tin,zm_tin,kh_tin,aw_tin,az_tin,bd_bin,bj_ifu,et_tin,kg_tin,la_tin,cm_niu,cv_nif,bf_ifu, orunknown - value String
- The value of the tax ID.
- type string
- The type of the tax ID, one of
ad_nrt,ar_cuit,eu_vat,bo_tin,br_cnpj,br_cpf,cn_tin,co_nit,cr_tin,do_rcn,ec_ruc,eu_oss_vat,hr_oib,pe_ruc,ro_tin,rs_pib,sv_nit,uy_ruc,ve_rif,vn_tin,gb_vat,nz_gst,au_abn,au_arn,in_gst,no_vat,no_voec,za_vat,ch_vat,mx_rfc,sg_uen,ru_inn,ru_kpp,ca_bn,hk_br,es_cif,pl_nip,it_cf,fo_vat,gi_tin,py_ruc,tw_vat,th_vat,jp_cn,jp_rn,jp_trn,li_uid,li_vat,lk_vat,my_itn,us_ein,kr_brn,ca_qst,ca_gst_hst,ca_pst_bc,ca_pst_mb,ca_pst_sk,my_sst,sg_gst,ae_trn,cl_tin,sa_vat,id_npwp,my_frp,il_vat,ge_vat,ua_vat,is_vat,bg_uic,hu_tin,si_tin,ke_pin,tr_tin,eg_tin,ph_tin,al_tin,bh_vat,kz_bin,ng_tin,om_vat,de_stn,ch_uid,tz_vat,uz_vat,uz_tin,md_vat,ma_vat,by_tin,ao_tin,bs_tin,bb_tin,cd_nif,mr_nif,me_pib,zw_tin,ba_tin,gn_nif,mk_vat,sr_fin,sn_ninea,am_tin,np_pan,tj_tin,ug_tin,zm_tin,kh_tin,aw_tin,az_tin,bd_bin,bj_ifu,et_tin,kg_tin,la_tin,cm_niu,cv_nif,bf_ifu, orunknown - value string
- The value of the tax ID.
- type str
- The type of the tax ID, one of
ad_nrt,ar_cuit,eu_vat,bo_tin,br_cnpj,br_cpf,cn_tin,co_nit,cr_tin,do_rcn,ec_ruc,eu_oss_vat,hr_oib,pe_ruc,ro_tin,rs_pib,sv_nit,uy_ruc,ve_rif,vn_tin,gb_vat,nz_gst,au_abn,au_arn,in_gst,no_vat,no_voec,za_vat,ch_vat,mx_rfc,sg_uen,ru_inn,ru_kpp,ca_bn,hk_br,es_cif,pl_nip,it_cf,fo_vat,gi_tin,py_ruc,tw_vat,th_vat,jp_cn,jp_rn,jp_trn,li_uid,li_vat,lk_vat,my_itn,us_ein,kr_brn,ca_qst,ca_gst_hst,ca_pst_bc,ca_pst_mb,ca_pst_sk,my_sst,sg_gst,ae_trn,cl_tin,sa_vat,id_npwp,my_frp,il_vat,ge_vat,ua_vat,is_vat,bg_uic,hu_tin,si_tin,ke_pin,tr_tin,eg_tin,ph_tin,al_tin,bh_vat,kz_bin,ng_tin,om_vat,de_stn,ch_uid,tz_vat,uz_vat,uz_tin,md_vat,ma_vat,by_tin,ao_tin,bs_tin,bb_tin,cd_nif,mr_nif,me_pib,zw_tin,ba_tin,gn_nif,mk_vat,sr_fin,sn_ninea,am_tin,np_pan,tj_tin,ug_tin,zm_tin,kh_tin,aw_tin,az_tin,bd_bin,bj_ifu,et_tin,kg_tin,la_tin,cm_niu,cv_nif,bf_ifu, orunknown - value str
- The value of the tax ID.
- type String
- The type of the tax ID, one of
ad_nrt,ar_cuit,eu_vat,bo_tin,br_cnpj,br_cpf,cn_tin,co_nit,cr_tin,do_rcn,ec_ruc,eu_oss_vat,hr_oib,pe_ruc,ro_tin,rs_pib,sv_nit,uy_ruc,ve_rif,vn_tin,gb_vat,nz_gst,au_abn,au_arn,in_gst,no_vat,no_voec,za_vat,ch_vat,mx_rfc,sg_uen,ru_inn,ru_kpp,ca_bn,hk_br,es_cif,pl_nip,it_cf,fo_vat,gi_tin,py_ruc,tw_vat,th_vat,jp_cn,jp_rn,jp_trn,li_uid,li_vat,lk_vat,my_itn,us_ein,kr_brn,ca_qst,ca_gst_hst,ca_pst_bc,ca_pst_mb,ca_pst_sk,my_sst,sg_gst,ae_trn,cl_tin,sa_vat,id_npwp,my_frp,il_vat,ge_vat,ua_vat,is_vat,bg_uic,hu_tin,si_tin,ke_pin,tr_tin,eg_tin,ph_tin,al_tin,bh_vat,kz_bin,ng_tin,om_vat,de_stn,ch_uid,tz_vat,uz_vat,uz_tin,md_vat,ma_vat,by_tin,ao_tin,bs_tin,bb_tin,cd_nif,mr_nif,me_pib,zw_tin,ba_tin,gn_nif,mk_vat,sr_fin,sn_ninea,am_tin,np_pan,tj_tin,ug_tin,zm_tin,kh_tin,aw_tin,az_tin,bd_bin,bj_ifu,et_tin,kg_tin,la_tin,cm_niu,cv_nif,bf_ifu, orunknown - value String
- The value of the tax ID.
InvoiceDiscount, InvoiceDiscountArgs
- 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.
InvoiceFromInvoice, InvoiceFromInvoiceArgs
InvoiceIssuer, InvoiceIssuerArgs
InvoiceLastFinalizationError, InvoiceLastFinalizationErrorArgs
- Advice
Code string - For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- Charge string
- For card errors, the ID of the failed charge.
- Code string
- For some errors that could be handled programmatically, a short string indicating the error code reported.
- Decline
Code string - For card errors resulting from a card issuer decline, a short string indicating the card issuer's reason for the decline if they provide one.
- Doc
Url string - A URL to more information about the error code reported.
- Message string
- A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- Network
Advice stringCode - For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- Network
Decline stringCode - For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- Param string
- If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- Payment
Intent string - A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.
- Payment
Method string PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.
Related guides: Payment Methods and More Payment Scenarios.
- Payment
Method stringType - If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- Request
Log stringUrl - A URL to the request log entry in your dashboard.
- Setup
Intent string A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments. For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment. Later, you can use PaymentIntents to drive the payment flow.
Create a SetupIntent when you're ready to collect your customer's payment credentials. Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid. The SetupIntent transitions through multiple statuses as it guides you through the setup process.
Successful SetupIntents result in payment credentials that are optimized for future payments. For example, cardholders in certain regions might need to be run through Strong Customer Authentication during payment method collection to streamline later off-session payments. If you use the SetupIntent with a Customer, it automatically attaches the resulting payment method to that Customer after successful setup. We recommend using SetupIntents or setup_future_usage on PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
Related guide: Setup Intents API
- Source string
- Type string
- The type of error returned. One of
api_error,card_error,idempotency_error, orinvalid_request_error
- Advice
Code string - For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- Charge string
- For card errors, the ID of the failed charge.
- Code string
- For some errors that could be handled programmatically, a short string indicating the error code reported.
- Decline
Code string - For card errors resulting from a card issuer decline, a short string indicating the card issuer's reason for the decline if they provide one.
- Doc
Url string - A URL to more information about the error code reported.
- Message string
- A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- Network
Advice stringCode - For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- Network
Decline stringCode - For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- Param string
- If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- Payment
Intent string - A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.
- Payment
Method string PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.
Related guides: Payment Methods and More Payment Scenarios.
- Payment
Method stringType - If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- Request
Log stringUrl - A URL to the request log entry in your dashboard.
- Setup
Intent string A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments. For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment. Later, you can use PaymentIntents to drive the payment flow.
Create a SetupIntent when you're ready to collect your customer's payment credentials. Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid. The SetupIntent transitions through multiple statuses as it guides you through the setup process.
Successful SetupIntents result in payment credentials that are optimized for future payments. For example, cardholders in certain regions might need to be run through Strong Customer Authentication during payment method collection to streamline later off-session payments. If you use the SetupIntent with a Customer, it automatically attaches the resulting payment method to that Customer after successful setup. We recommend using SetupIntents or setup_future_usage on PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
Related guide: Setup Intents API
- Source string
- Type string
- The type of error returned. One of
api_error,card_error,idempotency_error, orinvalid_request_error
- advice_
code string - For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- charge string
- For card errors, the ID of the failed charge.
- code string
- For some errors that could be handled programmatically, a short string indicating the error code reported.
- decline_
code string - For card errors resulting from a card issuer decline, a short string indicating the card issuer's reason for the decline if they provide one.
- doc_
url string - A URL to more information about the error code reported.
- message string
- A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- network_
advice_ stringcode - For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- network_
decline_ stringcode - For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- param string
- If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- payment_
intent string - A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.
- payment_
method string PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.
Related guides: Payment Methods and More Payment Scenarios.
- payment_
method_ stringtype - If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- request_
log_ stringurl - A URL to the request log entry in your dashboard.
- setup_
intent string A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments. For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment. Later, you can use PaymentIntents to drive the payment flow.
Create a SetupIntent when you're ready to collect your customer's payment credentials. Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid. The SetupIntent transitions through multiple statuses as it guides you through the setup process.
Successful SetupIntents result in payment credentials that are optimized for future payments. For example, cardholders in certain regions might need to be run through Strong Customer Authentication during payment method collection to streamline later off-session payments. If you use the SetupIntent with a Customer, it automatically attaches the resulting payment method to that Customer after successful setup. We recommend using SetupIntents or setup_future_usage on PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
Related guide: Setup Intents API
- source string
- type string
- The type of error returned. One of
api_error,card_error,idempotency_error, orinvalid_request_error
- advice
Code String - For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- charge String
- For card errors, the ID of the failed charge.
- code String
- For some errors that could be handled programmatically, a short string indicating the error code reported.
- decline
Code String - For card errors resulting from a card issuer decline, a short string indicating the card issuer's reason for the decline if they provide one.
- doc
Url String - A URL to more information about the error code reported.
- message String
- A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- network
Advice StringCode - For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- network
Decline StringCode - For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- param String
- If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- payment
Intent String - A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.
- payment
Method String PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.
Related guides: Payment Methods and More Payment Scenarios.
- payment
Method StringType - If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- request
Log StringUrl - A URL to the request log entry in your dashboard.
- setup
Intent String A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments. For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment. Later, you can use PaymentIntents to drive the payment flow.
Create a SetupIntent when you're ready to collect your customer's payment credentials. Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid. The SetupIntent transitions through multiple statuses as it guides you through the setup process.
Successful SetupIntents result in payment credentials that are optimized for future payments. For example, cardholders in certain regions might need to be run through Strong Customer Authentication during payment method collection to streamline later off-session payments. If you use the SetupIntent with a Customer, it automatically attaches the resulting payment method to that Customer after successful setup. We recommend using SetupIntents or setup_future_usage on PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
Related guide: Setup Intents API
- source String
- type String
- The type of error returned. One of
api_error,card_error,idempotency_error, orinvalid_request_error
- advice
Code string - For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- charge string
- For card errors, the ID of the failed charge.
- code string
- For some errors that could be handled programmatically, a short string indicating the error code reported.
- decline
Code string - For card errors resulting from a card issuer decline, a short string indicating the card issuer's reason for the decline if they provide one.
- doc
Url string - A URL to more information about the error code reported.
- message string
- A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- network
Advice stringCode - For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- network
Decline stringCode - For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- param string
- If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- payment
Intent string - A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.
- payment
Method string PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.
Related guides: Payment Methods and More Payment Scenarios.
- payment
Method stringType - If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- request
Log stringUrl - A URL to the request log entry in your dashboard.
- setup
Intent string A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments. For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment. Later, you can use PaymentIntents to drive the payment flow.
Create a SetupIntent when you're ready to collect your customer's payment credentials. Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid. The SetupIntent transitions through multiple statuses as it guides you through the setup process.
Successful SetupIntents result in payment credentials that are optimized for future payments. For example, cardholders in certain regions might need to be run through Strong Customer Authentication during payment method collection to streamline later off-session payments. If you use the SetupIntent with a Customer, it automatically attaches the resulting payment method to that Customer after successful setup. We recommend using SetupIntents or setup_future_usage on PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
Related guide: Setup Intents API
- source string
- type string
- The type of error returned. One of
api_error,card_error,idempotency_error, orinvalid_request_error
- advice_
code str - For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- charge str
- For card errors, the ID of the failed charge.
- code str
- For some errors that could be handled programmatically, a short string indicating the error code reported.
- decline_
code str - For card errors resulting from a card issuer decline, a short string indicating the card issuer's reason for the decline if they provide one.
- doc_
url str - A URL to more information about the error code reported.
- message str
- A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- network_
advice_ strcode - For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- network_
decline_ strcode - For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- param str
- If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- payment_
intent str - A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.
- payment_
method str PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.
Related guides: Payment Methods and More Payment Scenarios.
- payment_
method_ strtype - If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- request_
log_ strurl - A URL to the request log entry in your dashboard.
- setup_
intent str A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments. For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment. Later, you can use PaymentIntents to drive the payment flow.
Create a SetupIntent when you're ready to collect your customer's payment credentials. Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid. The SetupIntent transitions through multiple statuses as it guides you through the setup process.
Successful SetupIntents result in payment credentials that are optimized for future payments. For example, cardholders in certain regions might need to be run through Strong Customer Authentication during payment method collection to streamline later off-session payments. If you use the SetupIntent with a Customer, it automatically attaches the resulting payment method to that Customer after successful setup. We recommend using SetupIntents or setup_future_usage on PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
Related guide: Setup Intents API
- source str
- type str
- The type of error returned. One of
api_error,card_error,idempotency_error, orinvalid_request_error
- advice
Code String - For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- charge String
- For card errors, the ID of the failed charge.
- code String
- For some errors that could be handled programmatically, a short string indicating the error code reported.
- decline
Code String - For card errors resulting from a card issuer decline, a short string indicating the card issuer's reason for the decline if they provide one.
- doc
Url String - A URL to more information about the error code reported.
- message String
- A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- network
Advice StringCode - For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- network
Decline StringCode - For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- param String
- If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- payment
Intent String - A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.
- payment
Method String PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or save them to Customer objects to store instrument details for future payments.
Related guides: Payment Methods and More Payment Scenarios.
- payment
Method StringType - If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- request
Log StringUrl - A URL to the request log entry in your dashboard.
- setup
Intent String A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments. For example, you can use a SetupIntent to set up and save your customer's card without immediately collecting a payment. Later, you can use PaymentIntents to drive the payment flow.
Create a SetupIntent when you're ready to collect your customer's payment credentials. Don't maintain long-lived, unconfirmed SetupIntents because they might not be valid. The SetupIntent transitions through multiple statuses as it guides you through the setup process.
Successful SetupIntents result in payment credentials that are optimized for future payments. For example, cardholders in certain regions might need to be run through Strong Customer Authentication during payment method collection to streamline later off-session payments. If you use the SetupIntent with a Customer, it automatically attaches the resulting payment method to that Customer after successful setup. We recommend using SetupIntents or setup_future_usage on PaymentIntents to save payment methods to prevent saving invalid or unoptimized payment methods.
By using SetupIntents, you can reduce friction for your customers, even as regulations change over time.
Related guide: Setup Intents API
- source String
- type String
- The type of error returned. One of
api_error,card_error,idempotency_error, orinvalid_request_error
InvoiceParent, InvoiceParentArgs
- Quote
Details InvoiceParent Quote Details - Details about the quote that generated this invoice
- Subscription
Details InvoiceParent Subscription Details - Details about the subscription that generated this invoice
- Type string
- The type of parent that generated this invoice
- Quote
Details InvoiceParent Quote Details - Details about the quote that generated this invoice
- Subscription
Details InvoiceParent Subscription Details - Details about the subscription that generated this invoice
- Type string
- The type of parent that generated this invoice
- quote_
details object - Details about the quote that generated this invoice
- subscription_
details object - Details about the subscription that generated this invoice
- type string
- The type of parent that generated this invoice
- quote
Details InvoiceParent Quote Details - Details about the quote that generated this invoice
- subscription
Details InvoiceParent Subscription Details - Details about the subscription that generated this invoice
- type String
- The type of parent that generated this invoice
- quote
Details InvoiceParent Quote Details - Details about the quote that generated this invoice
- subscription
Details InvoiceParent Subscription Details - Details about the subscription that generated this invoice
- type string
- The type of parent that generated this invoice
- quote_
details InvoiceParent Quote Details - Details about the quote that generated this invoice
- subscription_
details InvoiceParent Subscription Details - Details about the subscription that generated this invoice
- type str
- The type of parent that generated this invoice
- quote
Details Property Map - Details about the quote that generated this invoice
- subscription
Details Property Map - Details about the subscription that generated this invoice
- type String
- The type of parent that generated this invoice
InvoiceParentQuoteDetails, InvoiceParentQuoteDetailsArgs
- Quote string
- The quote that generated this invoice
- Quote string
- The quote that generated this invoice
- quote string
- The quote that generated this invoice
- quote String
- The quote that generated this invoice
- quote string
- The quote that generated this invoice
- quote str
- The quote that generated this invoice
- quote String
- The quote that generated this invoice
InvoiceParentSubscriptionDetails, InvoiceParentSubscriptionDetailsArgs
- Metadata Dictionary<string, string>
- Set of key-value pairs defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. Note: This attribute is populated only for invoices created on or after June 29, 2023.
- Subscription string
- The subscription that generated this invoice
- Subscription
Proration doubleDate - Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
- Metadata map[string]string
- Set of key-value pairs defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. Note: This attribute is populated only for invoices created on or after June 29, 2023.
- Subscription string
- The subscription that generated this invoice
- Subscription
Proration float64Date - Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
- metadata map(string)
- Set of key-value pairs defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. Note: This attribute is populated only for invoices created on or after June 29, 2023.
- subscription string
- The subscription that generated this invoice
- subscription_
proration_ numberdate - Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
- metadata Map<String,String>
- Set of key-value pairs defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. Note: This attribute is populated only for invoices created on or after June 29, 2023.
- subscription String
- The subscription that generated this invoice
- subscription
Proration DoubleDate - Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
- metadata {[key: string]: string}
- Set of key-value pairs defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. Note: This attribute is populated only for invoices created on or after June 29, 2023.
- subscription string
- The subscription that generated this invoice
- subscription
Proration numberDate - Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
- metadata Mapping[str, str]
- Set of key-value pairs defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. Note: This attribute is populated only for invoices created on or after June 29, 2023.
- subscription str
- The subscription that generated this invoice
- subscription_
proration_ floatdate - Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
- metadata Map<String>
- Set of key-value pairs defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. Note: This attribute is populated only for invoices created on or after June 29, 2023.
- subscription String
- The subscription that generated this invoice
- subscription
Proration NumberDate - Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
InvoicePaymentSettings, InvoicePaymentSettingsArgs
- Default
Mandate string - ID of the mandate to be used for this invoice. It must correspond to the payment method used to pay the invoice, including the invoice's defaultpaymentmethod or default_source, if set.
- Payment
Method InvoiceOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to the invoice’s PaymentIntent.
- Payment
Method List<string>Types - The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. 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.
- Default
Mandate string - ID of the mandate to be used for this invoice. It must correspond to the payment method used to pay the invoice, including the invoice's defaultpaymentmethod or default_source, if set.
- Payment
Method InvoiceOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to the invoice’s PaymentIntent.
- Payment
Method []stringTypes - The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. 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.
- default_
mandate string - ID of the mandate to be used for this invoice. It must correspond to the payment method used to pay the invoice, including the invoice's defaultpaymentmethod or default_source, if set.
- payment_
method_ objectoptions - Payment-method-specific configuration to provide to the invoice’s PaymentIntent.
- payment_
method_ list(string)types - The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. 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.
- default
Mandate String - ID of the mandate to be used for this invoice. It must correspond to the payment method used to pay the invoice, including the invoice's defaultpaymentmethod or default_source, if set.
- payment
Method InvoiceOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to the invoice’s PaymentIntent.
- payment
Method List<String>Types - The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. 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.
- default
Mandate string - ID of the mandate to be used for this invoice. It must correspond to the payment method used to pay the invoice, including the invoice's defaultpaymentmethod or default_source, if set.
- payment
Method InvoiceOptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to the invoice’s PaymentIntent.
- payment
Method string[]Types - The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. 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.
- default_
mandate str - ID of the mandate to be used for this invoice. It must correspond to the payment method used to pay the invoice, including the invoice's defaultpaymentmethod or default_source, if set.
- payment_
method_ Invoiceoptions Payment Settings Payment Method Options - Payment-method-specific configuration to provide to the invoice’s PaymentIntent.
- payment_
method_ Sequence[str]types - The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. 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.
- default
Mandate String - ID of the mandate to be used for this invoice. It must correspond to the payment method used to pay the invoice, including the invoice's defaultpaymentmethod or default_source, if set.
- payment
Method Property MapOptions - Payment-method-specific configuration to provide to the invoice’s PaymentIntent.
- payment
Method List<String>Types - The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. 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.
InvoicePaymentSettingsPaymentMethodOptions, InvoicePaymentSettingsPaymentMethodOptionsArgs
- Acss
Debit InvoicePayment Settings Payment Method Options Acss Debit - If paying by
acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent. - Bancontact
Invoice
Payment Settings Payment Method Options Bancontact - If paying by
bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent. - Card
Invoice
Payment Settings Payment Method Options Card - If paying by
card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent. - Customer
Balance InvoicePayment Settings Payment Method Options Customer Balance - If paying by
customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent. - Payto
Invoice
Payment Settings Payment Method Options Payto - If paying by
payto, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent. - Pix
Invoice
Payment Settings Payment Method Options Pix - If paying by
pix, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent. - Upi
Invoice
Payment Settings Payment Method Options Upi - If paying by
upi, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent. - Us
Bank InvoiceAccount Payment Settings Payment Method Options Us Bank Account - If paying by
us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
- Acss
Debit InvoicePayment Settings Payment Method Options Acss Debit - If paying by
acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent. - Bancontact
Invoice
Payment Settings Payment Method Options Bancontact - If paying by
bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent. - Card
Invoice
Payment Settings Payment Method Options Card - If paying by
card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent. - Customer
Balance InvoicePayment Settings Payment Method Options Customer Balance - If paying by
customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent. - Payto
Invoice
Payment Settings Payment Method Options Payto - If paying by
payto, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent. - Pix
Invoice
Payment Settings Payment Method Options Pix - If paying by
pix, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent. - Upi
Invoice
Payment Settings Payment Method Options Upi - If paying by
upi, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent. - Us
Bank InvoiceAccount Payment Settings Payment Method Options Us Bank Account - If paying by
us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
- acss_
debit object - If paying by
acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent. - bancontact object
- If paying by
bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent. - card object
- If paying by
card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent. - customer_
balance object - If paying by
customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent. - payto object
- If paying by
payto, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent. - pix object
- If paying by
pix, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent. - upi object
- If paying by
upi, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent. - us_
bank_ objectaccount - If paying by
us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
- acss
Debit InvoicePayment Settings Payment Method Options Acss Debit - If paying by
acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent. - bancontact
Invoice
Payment Settings Payment Method Options Bancontact - If paying by
bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent. - card
Invoice
Payment Settings Payment Method Options Card - If paying by
card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent. - customer
Balance InvoicePayment Settings Payment Method Options Customer Balance - If paying by
customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent. - payto
Invoice
Payment Settings Payment Method Options Payto - If paying by
payto, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent. - pix
Invoice
Payment Settings Payment Method Options Pix - If paying by
pix, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent. - upi
Invoice
Payment Settings Payment Method Options Upi - If paying by
upi, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent. - us
Bank InvoiceAccount Payment Settings Payment Method Options Us Bank Account - If paying by
us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
- acss
Debit InvoicePayment Settings Payment Method Options Acss Debit - If paying by
acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent. - bancontact
Invoice
Payment Settings Payment Method Options Bancontact - If paying by
bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent. - card
Invoice
Payment Settings Payment Method Options Card - If paying by
card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent. - customer
Balance InvoicePayment Settings Payment Method Options Customer Balance - If paying by
customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent. - payto
Invoice
Payment Settings Payment Method Options Payto - If paying by
payto, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent. - pix
Invoice
Payment Settings Payment Method Options Pix - If paying by
pix, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent. - upi
Invoice
Payment Settings Payment Method Options Upi - If paying by
upi, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent. - us
Bank InvoiceAccount Payment Settings Payment Method Options Us Bank Account - If paying by
us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
- acss_
debit InvoicePayment Settings Payment Method Options Acss Debit - If paying by
acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent. - bancontact
Invoice
Payment Settings Payment Method Options Bancontact - If paying by
bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent. - card
Invoice
Payment Settings Payment Method Options Card - If paying by
card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent. - customer_
balance InvoicePayment Settings Payment Method Options Customer Balance - If paying by
customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent. - payto
Invoice
Payment Settings Payment Method Options Payto - If paying by
payto, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent. - pix
Invoice
Payment Settings Payment Method Options Pix - If paying by
pix, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent. - upi
Invoice
Payment Settings Payment Method Options Upi - If paying by
upi, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent. - us_
bank_ Invoiceaccount Payment Settings Payment Method Options Us Bank Account - If paying by
us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
- acss
Debit Property Map - If paying by
acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent. - bancontact Property Map
- If paying by
bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent. - card Property Map
- If paying by
card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent. - customer
Balance Property Map - If paying by
customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent. - payto Property Map
- If paying by
payto, this sub-hash contains details about the PayTo payment method options to pass to the invoice’s PaymentIntent. - pix Property Map
- If paying by
pix, this sub-hash contains details about the Pix payment method options to pass to the invoice’s PaymentIntent. - upi Property Map
- If paying by
upi, this sub-hash contains details about the UPI payment method options to pass to the invoice’s PaymentIntent. - us
Bank Property MapAccount - If paying by
us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.
InvoicePaymentSettingsPaymentMethodOptionsAcssDebit, InvoicePaymentSettingsPaymentMethodOptionsAcssDebitArgs
- Mandate
Options InvoicePayment Settings Payment Method Options Acss Debit Mandate Options - Verification
Method string - Bank account verification method. The default value is
automatic.
- Mandate
Options InvoicePayment 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 InvoicePayment Settings Payment Method Options Acss Debit Mandate Options - verification
Method String - Bank account verification method. The default value is
automatic.
- mandate
Options InvoicePayment Settings Payment Method Options Acss Debit Mandate Options - verification
Method string - Bank account verification method. The default value is
automatic.
- mandate_
options InvoicePayment 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.
InvoicePaymentSettingsPaymentMethodOptionsAcssDebitMandateOptions, InvoicePaymentSettingsPaymentMethodOptionsAcssDebitMandateOptionsArgs
- 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.
InvoicePaymentSettingsPaymentMethodOptionsBancontact, InvoicePaymentSettingsPaymentMethodOptionsBancontactArgs
- 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.
InvoicePaymentSettingsPaymentMethodOptionsCard, InvoicePaymentSettingsPaymentMethodOptionsCardArgs
- Installments
Invoice
Payment Settings Payment Method Options Card Installments - 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.
- Installments
Invoice
Payment Settings Payment Method Options Card Installments - 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.
- installments object
- 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.
- installments
Invoice
Payment Settings Payment Method Options Card Installments - 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.
- installments
Invoice
Payment Settings Payment Method Options Card Installments - 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.
- installments
Invoice
Payment Settings Payment Method Options Card Installments - 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.
- installments Property Map
- 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.
InvoicePaymentSettingsPaymentMethodOptionsCardInstallments, InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsArgs
- Enabled bool
- Whether Installments are enabled for this Invoice.
- Plan
Invoice
Payment Settings Payment Method Options Card Installments Plan - The selected installment plan to use for this invoice.
- Enabled bool
- Whether Installments are enabled for this Invoice.
- Plan
Invoice
Payment Settings Payment Method Options Card Installments Plan - The selected installment plan to use for this invoice.
- enabled Boolean
- Whether Installments are enabled for this Invoice.
- plan
Invoice
Payment Settings Payment Method Options Card Installments Plan - The selected installment plan to use for this invoice.
- enabled boolean
- Whether Installments are enabled for this Invoice.
- plan
Invoice
Payment Settings Payment Method Options Card Installments Plan - The selected installment plan to use for this invoice.
- enabled bool
- Whether Installments are enabled for this Invoice.
- plan
Invoice
Payment Settings Payment Method Options Card Installments Plan - The selected installment plan to use for this invoice.
- enabled Boolean
- Whether Installments are enabled for this Invoice.
- plan Property Map
- The selected installment plan to use for this invoice.
InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsPlan, InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsPlanArgs
- Type string
- Type of installment plan, one of
fixed_count,bonus, orrevolving. - Count double
- For
fixed_countinstallment plans, this is required. It represents the number of installment payments your customer will make to their credit card. - Interval string
- For
fixed_countinstallment plans, this is required. It represents the interval between installment payments your customer will make to their credit card. One ofmonth.
- Type string
- Type of installment plan, one of
fixed_count,bonus, orrevolving. - Count float64
- For
fixed_countinstallment plans, this is required. It represents the number of installment payments your customer will make to their credit card. - Interval string
- For
fixed_countinstallment plans, this is required. It represents the interval between installment payments your customer will make to their credit card. One ofmonth.
- type string
- Type of installment plan, one of
fixed_count,bonus, orrevolving. - count number
- For
fixed_countinstallment plans, this is required. It represents the number of installment payments your customer will make to their credit card. - interval string
- For
fixed_countinstallment plans, this is required. It represents the interval between installment payments your customer will make to their credit card. One ofmonth.
- type String
- Type of installment plan, one of
fixed_count,bonus, orrevolving. - count Double
- For
fixed_countinstallment plans, this is required. It represents the number of installment payments your customer will make to their credit card. - interval String
- For
fixed_countinstallment plans, this is required. It represents the interval between installment payments your customer will make to their credit card. One ofmonth.
- type string
- Type of installment plan, one of
fixed_count,bonus, orrevolving. - count number
- For
fixed_countinstallment plans, this is required. It represents the number of installment payments your customer will make to their credit card. - interval string
- For
fixed_countinstallment plans, this is required. It represents the interval between installment payments your customer will make to their credit card. One ofmonth.
- type str
- Type of installment plan, one of
fixed_count,bonus, orrevolving. - count float
- For
fixed_countinstallment plans, this is required. It represents the number of installment payments your customer will make to their credit card. - interval str
- For
fixed_countinstallment plans, this is required. It represents the interval between installment payments your customer will make to their credit card. One ofmonth.
- type String
- Type of installment plan, one of
fixed_count,bonus, orrevolving. - count Number
- For
fixed_countinstallment plans, this is required. It represents the number of installment payments your customer will make to their credit card. - interval String
- For
fixed_countinstallment plans, this is required. It represents the interval between installment payments your customer will make to their credit card. One ofmonth.
InvoicePaymentSettingsPaymentMethodOptionsCustomerBalance, InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceArgs
- Bank
Transfer InvoicePayment 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 InvoicePayment 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 InvoicePayment 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 InvoicePayment 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 InvoicePayment 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.
InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransfer, InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferArgs
- Eu
Bank InvoiceTransfer 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 InvoiceTransfer 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 InvoiceTransfer 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 InvoiceTransfer 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_ Invoicetransfer 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.
InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, InvoicePaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransferArgs
- 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.
InvoicePaymentSettingsPaymentMethodOptionsPayto, InvoicePaymentSettingsPaymentMethodOptionsPaytoArgs
InvoicePaymentSettingsPaymentMethodOptionsPaytoMandateOptions, InvoicePaymentSettingsPaymentMethodOptionsPaytoMandateOptionsArgs
- 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.
InvoicePaymentSettingsPaymentMethodOptionsPix, InvoicePaymentSettingsPaymentMethodOptionsPixArgs
- Amount
Includes stringIof - Determines if the amount includes the IOF tax.
- Expires
After doubleSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- Amount
Includes stringIof - Determines if the amount includes the IOF tax.
- Expires
After float64Seconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- amount_
includes_ stringiof - Determines if the amount includes the IOF tax.
- expires_
after_ numberseconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- amount
Includes StringIof - Determines if the amount includes the IOF tax.
- expires
After DoubleSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- amount
Includes stringIof - Determines if the amount includes the IOF tax.
- expires
After numberSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- amount_
includes_ striof - Determines if the amount includes the IOF tax.
- expires_
after_ floatseconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
- amount
Includes StringIof - Determines if the amount includes the IOF tax.
- expires
After NumberSeconds - The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
InvoicePaymentSettingsPaymentMethodOptionsUpi, InvoicePaymentSettingsPaymentMethodOptionsUpiArgs
InvoicePaymentSettingsPaymentMethodOptionsUpiMandateOptions, InvoicePaymentSettingsPaymentMethodOptionsUpiMandateOptionsArgs
- 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.
InvoicePaymentSettingsPaymentMethodOptionsUsBankAccount, InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountArgs
- Financial
Connections InvoicePayment Settings Payment Method Options Us Bank Account Financial Connections - Verification
Method string - Bank account verification method. The default value is
automatic.
- Financial
Connections InvoicePayment 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 InvoicePayment Settings Payment Method Options Us Bank Account Financial Connections - verification
Method String - Bank account verification method. The default value is
automatic.
- financial
Connections InvoicePayment Settings Payment Method Options Us Bank Account Financial Connections - verification
Method string - Bank account verification method. The default value is
automatic.
- financial_
connections InvoicePayment 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.
InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections, InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsArgs
- Filters
Invoice
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
Invoice
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
Invoice
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
Invoice
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
Invoice
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.
InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFilters, InvoicePaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnectionsFiltersArgs
- 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.
InvoiceRendering, InvoiceRenderingArgs
- Amount
Tax stringDisplay - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
- Pdf
Invoice
Rendering Pdf - Invoice pdf rendering options
- Template string
- ID of the rendering template that the invoice is formatted by.
- Template
Version double - Version of the rendering template that the invoice is using.
- Amount
Tax stringDisplay - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
- Pdf
Invoice
Rendering Pdf - Invoice pdf rendering options
- Template string
- ID of the rendering template that the invoice is formatted by.
- Template
Version float64 - Version of the rendering template that the invoice is using.
- amount_
tax_ stringdisplay - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
- pdf object
- Invoice pdf rendering options
- template string
- ID of the rendering template that the invoice is formatted by.
- template_
version number - Version of the rendering template that the invoice is using.
- amount
Tax StringDisplay - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
- pdf
Invoice
Rendering Pdf - Invoice pdf rendering options
- template String
- ID of the rendering template that the invoice is formatted by.
- template
Version Double - Version of the rendering template that the invoice is using.
- amount
Tax stringDisplay - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
- pdf
Invoice
Rendering Pdf - Invoice pdf rendering options
- template string
- ID of the rendering template that the invoice is formatted by.
- template
Version number - Version of the rendering template that the invoice is using.
- amount_
tax_ strdisplay - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
- pdf
Invoice
Rendering Pdf - Invoice pdf rendering options
- template str
- ID of the rendering template that the invoice is formatted by.
- template_
version float - Version of the rendering template that the invoice is using.
- amount
Tax StringDisplay - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
- pdf Property Map
- Invoice pdf rendering options
- template String
- ID of the rendering template that the invoice is formatted by.
- template
Version Number - Version of the rendering template that the invoice is using.
InvoiceRenderingPdf, InvoiceRenderingPdfArgs
- Page
Size string - Page size of invoice pdf. Options include a4, letter, and auto. If set to auto, page size will be switched to a4 or letter based on customer locale.
- Page
Size string - Page size of invoice pdf. Options include a4, letter, and auto. If set to auto, page size will be switched to a4 or letter based on customer locale.
- page_
size string - Page size of invoice pdf. Options include a4, letter, and auto. If set to auto, page size will be switched to a4 or letter based on customer locale.
- page
Size String - Page size of invoice pdf. Options include a4, letter, and auto. If set to auto, page size will be switched to a4 or letter based on customer locale.
- page
Size string - Page size of invoice pdf. Options include a4, letter, and auto. If set to auto, page size will be switched to a4 or letter based on customer locale.
- page_
size str - Page size of invoice pdf. Options include a4, letter, and auto. If set to auto, page size will be switched to a4 or letter based on customer locale.
- page
Size String - Page size of invoice pdf. Options include a4, letter, and auto. If set to auto, page size will be switched to a4 or letter based on customer locale.
InvoiceShippingCost, InvoiceShippingCostArgs
- Amount
Subtotal double - Total shipping cost before any taxes are applied.
- Amount
Tax double - Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
- Amount
Total double - Total shipping cost after taxes are applied.
- Shipping
Rate string - The ID of the ShippingRate for this invoice.
- Shipping
Rate InvoiceData Shipping Cost Shipping Rate Data - Parameters to create a new ad-hoc shipping rate for this order.
- Taxes
List<Invoice
Shipping Cost Tax> - The taxes applied to the shipping rate.
- Amount
Subtotal float64 - Total shipping cost before any taxes are applied.
- Amount
Tax float64 - Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
- Amount
Total float64 - Total shipping cost after taxes are applied.
- Shipping
Rate string - The ID of the ShippingRate for this invoice.
- Shipping
Rate InvoiceData Shipping Cost Shipping Rate Data - Parameters to create a new ad-hoc shipping rate for this order.
- Taxes
[]Invoice
Shipping Cost Tax - The taxes applied to the shipping rate.
- amount_
subtotal number - Total shipping cost before any taxes are applied.
- amount_
tax number - Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
- amount_
total number - Total shipping cost after taxes are applied.
- shipping_
rate string - The ID of the ShippingRate for this invoice.
- shipping_
rate_ objectdata - Parameters to create a new ad-hoc shipping rate for this order.
- taxes list(object)
- The taxes applied to the shipping rate.
- amount
Subtotal Double - Total shipping cost before any taxes are applied.
- amount
Tax Double - Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
- amount
Total Double - Total shipping cost after taxes are applied.
- shipping
Rate String - The ID of the ShippingRate for this invoice.
- shipping
Rate InvoiceData Shipping Cost Shipping Rate Data - Parameters to create a new ad-hoc shipping rate for this order.
- taxes
List<Invoice
Shipping Cost Tax> - The taxes applied to the shipping rate.
- amount
Subtotal number - Total shipping cost before any taxes are applied.
- amount
Tax number - Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
- amount
Total number - Total shipping cost after taxes are applied.
- shipping
Rate string - The ID of the ShippingRate for this invoice.
- shipping
Rate InvoiceData Shipping Cost Shipping Rate Data - Parameters to create a new ad-hoc shipping rate for this order.
- taxes
Invoice
Shipping Cost Tax[] - The taxes applied to the shipping rate.
- amount_
subtotal float - Total shipping cost before any taxes are applied.
- amount_
tax float - Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
- amount_
total float - Total shipping cost after taxes are applied.
- shipping_
rate str - The ID of the ShippingRate for this invoice.
- shipping_
rate_ Invoicedata Shipping Cost Shipping Rate Data - Parameters to create a new ad-hoc shipping rate for this order.
- taxes
Sequence[Invoice
Shipping Cost Tax] - The taxes applied to the shipping rate.
- amount
Subtotal Number - Total shipping cost before any taxes are applied.
- amount
Tax Number - Total tax amount applied due to shipping costs. If no tax was applied, defaults to 0.
- amount
Total Number - Total shipping cost after taxes are applied.
- shipping
Rate String - The ID of the ShippingRate for this invoice.
- shipping
Rate Property MapData - Parameters to create a new ad-hoc shipping rate for this order.
- taxes List<Property Map>
- The taxes applied to the shipping rate.
InvoiceShippingCostShippingRateData, InvoiceShippingCostShippingRateDataArgs
- Display
Name string - The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
- Delivery
Estimate InvoiceShipping Cost Shipping Rate Data Delivery Estimate - The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
- Fixed
Amount InvoiceShipping Cost Shipping Rate Data Fixed Amount - Describes a fixed amount to charge for shipping. Must be present if type is
fixed_amount. - 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. - Tax
Behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. - Tax
Code string - A tax code ID. The Shipping tax code is
txcd_92010001. - Type string
- The type of calculation to use on the shipping rate.
- Display
Name string - The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
- Delivery
Estimate InvoiceShipping Cost Shipping Rate Data Delivery Estimate - The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
- Fixed
Amount InvoiceShipping Cost Shipping Rate Data Fixed Amount - Describes a fixed amount to charge for shipping. Must be present if type is
fixed_amount. - 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. - Tax
Behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. - Tax
Code string - A tax code ID. The Shipping tax code is
txcd_92010001. - Type string
- The type of calculation to use on the shipping rate.
- display_
name string - The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
- delivery_
estimate object - The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
- fixed_
amount object - Describes a fixed amount to charge for shipping. Must be present if type is
fixed_amount. - 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. - tax_
behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. - tax_
code string - A tax code ID. The Shipping tax code is
txcd_92010001. - type string
- The type of calculation to use on the shipping rate.
- display
Name String - The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
- delivery
Estimate InvoiceShipping Cost Shipping Rate Data Delivery Estimate - The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
- fixed
Amount InvoiceShipping Cost Shipping Rate Data Fixed Amount - Describes a fixed amount to charge for shipping. Must be present if type is
fixed_amount. - 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. - tax
Behavior String - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. - tax
Code String - A tax code ID. The Shipping tax code is
txcd_92010001. - type String
- The type of calculation to use on the shipping rate.
- display
Name string - The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
- delivery
Estimate InvoiceShipping Cost Shipping Rate Data Delivery Estimate - The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
- fixed
Amount InvoiceShipping Cost Shipping Rate Data Fixed Amount - Describes a fixed amount to charge for shipping. Must be present if type is
fixed_amount. - 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. - tax
Behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. - tax
Code string - A tax code ID. The Shipping tax code is
txcd_92010001. - type string
- The type of calculation to use on the shipping rate.
- display_
name str - The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
- delivery_
estimate InvoiceShipping Cost Shipping Rate Data Delivery Estimate - The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
- fixed_
amount InvoiceShipping Cost Shipping Rate Data Fixed Amount - Describes a fixed amount to charge for shipping. Must be present if type is
fixed_amount. - 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. - tax_
behavior str - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. - tax_
code str - A tax code ID. The Shipping tax code is
txcd_92010001. - type str
- The type of calculation to use on the shipping rate.
- display
Name String - The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
- delivery
Estimate Property Map - The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
- fixed
Amount Property Map - Describes a fixed amount to charge for shipping. Must be present if type is
fixed_amount. - 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. - tax
Behavior String - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified. - tax
Code String - A tax code ID. The Shipping tax code is
txcd_92010001. - type String
- The type of calculation to use on the shipping rate.
InvoiceShippingCostShippingRateDataDeliveryEstimate, InvoiceShippingCostShippingRateDataDeliveryEstimateArgs
- Maximum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Maximum - The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
- Minimum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Minimum - The lower bound of the estimated range. If empty, represents no lower bound.
- Maximum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Maximum - The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
- Minimum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Minimum - The lower bound of the estimated range. If empty, represents no lower bound.
- maximum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Maximum - The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
- minimum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Minimum - The lower bound of the estimated range. If empty, represents no lower bound.
- maximum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Maximum - The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
- minimum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Minimum - The lower bound of the estimated range. If empty, represents no lower bound.
- maximum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Maximum - The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
- minimum
Invoice
Shipping Cost Shipping Rate Data Delivery Estimate Minimum - The lower bound of the estimated range. If empty, represents no lower bound.
- maximum Property Map
- The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
- minimum Property Map
- The lower bound of the estimated range. If empty, represents no lower bound.
InvoiceShippingCostShippingRateDataDeliveryEstimateMaximum, InvoiceShippingCostShippingRateDataDeliveryEstimateMaximumArgs
InvoiceShippingCostShippingRateDataDeliveryEstimateMinimum, InvoiceShippingCostShippingRateDataDeliveryEstimateMinimumArgs
InvoiceShippingCostShippingRateDataFixedAmount, InvoiceShippingCostShippingRateDataFixedAmountArgs
- Amount double
- A non-negative integer in cents representing how much to charge.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Currency
Options Dictionary<string, InvoiceShipping Cost Shipping Rate Data Fixed Amount Currency Options> - Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- Amount float64
- A non-negative integer in cents representing how much to charge.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Currency
Options map[string]InvoiceShipping Cost Shipping Rate Data Fixed Amount Currency Options - Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- amount number
- A non-negative integer in cents representing how much to charge.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency_
options map(object) - Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- amount Double
- A non-negative integer in cents representing how much to charge.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency
Options Map<String,InvoiceShipping Cost Shipping Rate Data Fixed Amount Currency Options> - Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- amount number
- A non-negative integer in cents representing how much to charge.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency
Options {[key: string]: InvoiceShipping Cost Shipping Rate Data Fixed Amount Currency Options} - Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- amount float
- A non-negative integer in cents representing how much to charge.
- currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency_
options Mapping[str, InvoiceShipping Cost Shipping Rate Data Fixed Amount Currency Options] - Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- amount Number
- A non-negative integer in cents representing how much to charge.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency
Options Map<Property Map> - Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
InvoiceShippingCostShippingRateDataFixedAmountCurrencyOptions, InvoiceShippingCostShippingRateDataFixedAmountCurrencyOptionsArgs
- Amount double
- A non-negative integer in cents representing how much to charge.
- Tax
Behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified.
- Amount float64
- A non-negative integer in cents representing how much to charge.
- Tax
Behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified.
- amount number
- A non-negative integer in cents representing how much to charge.
- tax_
behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified.
- amount Double
- A non-negative integer in cents representing how much to charge.
- tax
Behavior String - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified.
- amount number
- A non-negative integer in cents representing how much to charge.
- tax
Behavior string - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified.
- amount float
- A non-negative integer in cents representing how much to charge.
- tax_
behavior str - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified.
- amount Number
- A non-negative integer in cents representing how much to charge.
- tax
Behavior String - Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of
inclusive,exclusive, orunspecified.
InvoiceShippingCostTax, InvoiceShippingCostTaxArgs
- Amount double
- Amount of tax applied for this rate.
- Rate string
- Tax rates can be applied to invoices, subscriptions and Checkout Sessions to collect tax.
- Taxability
Reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- Taxable
Amount double - The amount on which tax is calculated, in cents (or local equivalent).
- Amount float64
- Amount of tax applied for this rate.
- Rate string
- Tax rates can be applied to invoices, subscriptions and Checkout Sessions to collect tax.
- Taxability
Reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- Taxable
Amount float64 - The amount on which tax is calculated, in cents (or local equivalent).
- amount number
- Amount of tax applied for this rate.
- rate string
- Tax rates can be applied to invoices, subscriptions and Checkout Sessions to collect tax.
- taxability_
reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable_
amount number - The amount on which tax is calculated, in cents (or local equivalent).
- amount Double
- Amount of tax applied for this rate.
- rate String
- Tax rates can be applied to invoices, subscriptions and Checkout Sessions to collect tax.
- taxability
Reason String - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable
Amount Double - The amount on which tax is calculated, in cents (or local equivalent).
- amount number
- Amount of tax applied for this rate.
- rate string
- Tax rates can be applied to invoices, subscriptions and Checkout Sessions to collect tax.
- taxability
Reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable
Amount number - The amount on which tax is calculated, in cents (or local equivalent).
- amount float
- Amount of tax applied for this rate.
- rate str
- Tax rates can be applied to invoices, subscriptions and Checkout Sessions to collect tax.
- taxability_
reason str - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable_
amount float - The amount on which tax is calculated, in cents (or local equivalent).
- amount Number
- Amount of tax applied for this rate.
- rate String
- Tax rates can be applied to invoices, subscriptions and Checkout Sessions to collect tax.
- taxability
Reason String - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable
Amount Number - The amount on which tax is calculated, in cents (or local equivalent).
InvoiceShippingDetails, InvoiceShippingDetailsArgs
- Address
Invoice
Shipping Details Address - Name string
- Recipient name.
- Carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- Phone string
- Recipient phone (including extension).
- Tracking
Number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- Address
Invoice
Shipping Details Address - Name string
- Recipient name.
- Carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- Phone string
- Recipient phone (including extension).
- Tracking
Number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address object
- name string
- Recipient name.
- carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- phone string
- Recipient phone (including extension).
- tracking_
number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address
Invoice
Shipping Details Address - name String
- Recipient name.
- carrier String
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- phone String
- Recipient phone (including extension).
- tracking
Number String - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address
Invoice
Shipping Details Address - name string
- Recipient name.
- carrier string
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- phone string
- Recipient phone (including extension).
- tracking
Number string - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address
Invoice
Shipping Details Address - name str
- Recipient name.
- carrier str
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- phone str
- Recipient phone (including extension).
- tracking_
number str - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- address Property Map
- name String
- Recipient name.
- carrier String
- The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- phone String
- Recipient phone (including extension).
- tracking
Number String - The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
InvoiceShippingDetailsAddress, InvoiceShippingDetailsAddressArgs
- City string
- City, district, suburb, town, or village.
- Country string
- Two-letter country code (ISO 3166-1 alpha-2).
- Line1 string
- Address line 1, such as the street, PO Box, or company name.
- Line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- Postal
Code string - ZIP or postal code.
- State string
- State, county, province, or region (ISO 3166-2).
- City string
- City, district, suburb, town, or village.
- Country string
- Two-letter country code (ISO 3166-1 alpha-2).
- Line1 string
- Address line 1, such as the street, PO Box, or company name.
- Line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- Postal
Code string - ZIP or postal code.
- State string
- State, county, province, or region (ISO 3166-2).
- city string
- City, district, suburb, town, or village.
- country string
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 string
- Address line 1, such as the street, PO Box, or company name.
- line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- postal_
code string - ZIP or postal code.
- state string
- State, county, province, or region (ISO 3166-2).
- city String
- City, district, suburb, town, or village.
- country String
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 String
- Address line 1, such as the street, PO Box, or company name.
- line2 String
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code String - ZIP or postal code.
- state String
- State, county, province, or region (ISO 3166-2).
- city string
- City, district, suburb, town, or village.
- country string
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 string
- Address line 1, such as the street, PO Box, or company name.
- line2 string
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code string - ZIP or postal code.
- state string
- State, county, province, or region (ISO 3166-2).
- city str
- City, district, suburb, town, or village.
- country str
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 str
- Address line 1, such as the street, PO Box, or company name.
- line2 str
- Address line 2, such as the apartment, suite, unit, or building.
- postal_
code str - ZIP or postal code.
- state str
- State, county, province, or region (ISO 3166-2).
- city String
- City, district, suburb, town, or village.
- country String
- Two-letter country code (ISO 3166-1 alpha-2).
- line1 String
- Address line 1, such as the street, PO Box, or company name.
- line2 String
- Address line 2, such as the apartment, suite, unit, or building.
- postal
Code String - ZIP or postal code.
- state String
- State, county, province, or region (ISO 3166-2).
InvoiceStatusTransitions, InvoiceStatusTransitionsArgs
- Finalized
At double - The time that the invoice draft was finalized.
- Marked
Uncollectible doubleAt - The time that the invoice was marked uncollectible.
- Paid
At double - The time that the invoice was paid.
- Voided
At double - The time that the invoice was voided.
- Finalized
At float64 - The time that the invoice draft was finalized.
- Marked
Uncollectible float64At - The time that the invoice was marked uncollectible.
- Paid
At float64 - The time that the invoice was paid.
- Voided
At float64 - The time that the invoice was voided.
- finalized_
at number - The time that the invoice draft was finalized.
- marked_
uncollectible_ numberat - The time that the invoice was marked uncollectible.
- paid_
at number - The time that the invoice was paid.
- voided_
at number - The time that the invoice was voided.
- finalized
At Double - The time that the invoice draft was finalized.
- marked
Uncollectible DoubleAt - The time that the invoice was marked uncollectible.
- paid
At Double - The time that the invoice was paid.
- voided
At Double - The time that the invoice was voided.
- finalized
At number - The time that the invoice draft was finalized.
- marked
Uncollectible numberAt - The time that the invoice was marked uncollectible.
- paid
At number - The time that the invoice was paid.
- voided
At number - The time that the invoice was voided.
- finalized_
at float - The time that the invoice draft was finalized.
- marked_
uncollectible_ floatat - The time that the invoice was marked uncollectible.
- paid_
at float - The time that the invoice was paid.
- voided_
at float - The time that the invoice was voided.
- finalized
At Number - The time that the invoice draft was finalized.
- marked
Uncollectible NumberAt - The time that the invoice was marked uncollectible.
- paid
At Number - The time that the invoice was paid.
- voided
At Number - The time that the invoice was voided.
InvoiceThresholdReason, InvoiceThresholdReasonArgs
- Amount
Gte double - The total invoice amount threshold boundary if it triggered the threshold invoice.
- Item
Reasons List<InvoiceThreshold Reason Item Reason> - Indicates which line items triggered a threshold invoice.
- Amount
Gte float64 - The total invoice amount threshold boundary if it triggered the threshold invoice.
- Item
Reasons []InvoiceThreshold Reason Item Reason - Indicates which line items triggered a threshold invoice.
- amount_
gte number - The total invoice amount threshold boundary if it triggered the threshold invoice.
- item_
reasons list(object) - Indicates which line items triggered a threshold invoice.
- amount
Gte Double - The total invoice amount threshold boundary if it triggered the threshold invoice.
- item
Reasons List<InvoiceThreshold Reason Item Reason> - Indicates which line items triggered a threshold invoice.
- amount
Gte number - The total invoice amount threshold boundary if it triggered the threshold invoice.
- item
Reasons InvoiceThreshold Reason Item Reason[] - Indicates which line items triggered a threshold invoice.
- amount_
gte float - The total invoice amount threshold boundary if it triggered the threshold invoice.
- item_
reasons Sequence[InvoiceThreshold Reason Item Reason] - Indicates which line items triggered a threshold invoice.
- amount
Gte Number - The total invoice amount threshold boundary if it triggered the threshold invoice.
- item
Reasons List<Property Map> - Indicates which line items triggered a threshold invoice.
InvoiceThresholdReasonItemReason, InvoiceThresholdReasonItemReasonArgs
- Line
Item List<string>Ids - The IDs of the line items that triggered the threshold invoice.
- Usage
Gte double - The quantity threshold boundary that applied to the given line item.
- Line
Item []stringIds - The IDs of the line items that triggered the threshold invoice.
- Usage
Gte float64 - The quantity threshold boundary that applied to the given line item.
- line_
item_ list(string)ids - The IDs of the line items that triggered the threshold invoice.
- usage_
gte number - The quantity threshold boundary that applied to the given line item.
- line
Item List<String>Ids - The IDs of the line items that triggered the threshold invoice.
- usage
Gte Double - The quantity threshold boundary that applied to the given line item.
- line
Item string[]Ids - The IDs of the line items that triggered the threshold invoice.
- usage
Gte number - The quantity threshold boundary that applied to the given line item.
- line_
item_ Sequence[str]ids - The IDs of the line items that triggered the threshold invoice.
- usage_
gte float - The quantity threshold boundary that applied to the given line item.
- line
Item List<String>Ids - The IDs of the line items that triggered the threshold invoice.
- usage
Gte Number - The quantity threshold boundary that applied to the given line item.
InvoiceTotalDiscountAmount, InvoiceTotalDiscountAmountArgs
InvoiceTotalPretaxCreditAmount, InvoiceTotalPretaxCreditAmountArgs
- Amount double
- The amount, in cents (or local equivalent), of the pretax credit amount.
- Credit
Balance stringTransaction - The credit balance transaction that was applied to get this pretax credit amount.
- Discount string
- The discount that was applied to get this pretax credit amount.
- Type string
- Type of the pretax credit amount referenced.
- Amount float64
- The amount, in cents (or local equivalent), of the pretax credit amount.
- Credit
Balance stringTransaction - The credit balance transaction that was applied to get this pretax credit amount.
- Discount string
- The discount that was applied to get this pretax credit amount.
- Type string
- Type of the pretax credit amount referenced.
- amount number
- The amount, in cents (or local equivalent), of the pretax credit amount.
- credit_
balance_ stringtransaction - The credit balance transaction that was applied to get this pretax credit amount.
- discount string
- The discount that was applied to get this pretax credit amount.
- type string
- Type of the pretax credit amount referenced.
- amount Double
- The amount, in cents (or local equivalent), of the pretax credit amount.
- credit
Balance StringTransaction - The credit balance transaction that was applied to get this pretax credit amount.
- discount String
- The discount that was applied to get this pretax credit amount.
- type String
- Type of the pretax credit amount referenced.
- amount number
- The amount, in cents (or local equivalent), of the pretax credit amount.
- credit
Balance stringTransaction - The credit balance transaction that was applied to get this pretax credit amount.
- discount string
- The discount that was applied to get this pretax credit amount.
- type string
- Type of the pretax credit amount referenced.
- amount float
- The amount, in cents (or local equivalent), of the pretax credit amount.
- credit_
balance_ strtransaction - The credit balance transaction that was applied to get this pretax credit amount.
- discount str
- The discount that was applied to get this pretax credit amount.
- type str
- Type of the pretax credit amount referenced.
- amount Number
- The amount, in cents (or local equivalent), of the pretax credit amount.
- credit
Balance StringTransaction - The credit balance transaction that was applied to get this pretax credit amount.
- discount String
- The discount that was applied to get this pretax credit amount.
- type String
- Type of the pretax credit amount referenced.
InvoiceTotalTax, InvoiceTotalTaxArgs
- Amount double
- The amount of the tax, in cents (or local equivalent).
- Tax
Behavior string - Whether this tax is inclusive or exclusive.
- Tax
Rate InvoiceDetails Total Tax Tax Rate Details - Additional details about the tax rate. Only present when
typeistax_rate_details. - Taxability
Reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- Taxable
Amount double - The amount on which tax is calculated, in cents (or local equivalent).
- Type string
- The type of tax information.
- Amount float64
- The amount of the tax, in cents (or local equivalent).
- Tax
Behavior string - Whether this tax is inclusive or exclusive.
- Tax
Rate InvoiceDetails Total Tax Tax Rate Details - Additional details about the tax rate. Only present when
typeistax_rate_details. - Taxability
Reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- Taxable
Amount float64 - The amount on which tax is calculated, in cents (or local equivalent).
- Type string
- The type of tax information.
- amount number
- The amount of the tax, in cents (or local equivalent).
- tax_
behavior string - Whether this tax is inclusive or exclusive.
- tax_
rate_ objectdetails - Additional details about the tax rate. Only present when
typeistax_rate_details. - taxability_
reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable_
amount number - The amount on which tax is calculated, in cents (or local equivalent).
- type string
- The type of tax information.
- amount Double
- The amount of the tax, in cents (or local equivalent).
- tax
Behavior String - Whether this tax is inclusive or exclusive.
- tax
Rate InvoiceDetails Total Tax Tax Rate Details - Additional details about the tax rate. Only present when
typeistax_rate_details. - taxability
Reason String - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable
Amount Double - The amount on which tax is calculated, in cents (or local equivalent).
- type String
- The type of tax information.
- amount number
- The amount of the tax, in cents (or local equivalent).
- tax
Behavior string - Whether this tax is inclusive or exclusive.
- tax
Rate InvoiceDetails Total Tax Tax Rate Details - Additional details about the tax rate. Only present when
typeistax_rate_details. - taxability
Reason string - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable
Amount number - The amount on which tax is calculated, in cents (or local equivalent).
- type string
- The type of tax information.
- amount float
- The amount of the tax, in cents (or local equivalent).
- tax_
behavior str - Whether this tax is inclusive or exclusive.
- tax_
rate_ Invoicedetails Total Tax Tax Rate Details - Additional details about the tax rate. Only present when
typeistax_rate_details. - taxability_
reason str - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable_
amount float - The amount on which tax is calculated, in cents (or local equivalent).
- type str
- The type of tax information.
- amount Number
- The amount of the tax, in cents (or local equivalent).
- tax
Behavior String - Whether this tax is inclusive or exclusive.
- tax
Rate Property MapDetails - Additional details about the tax rate. Only present when
typeistax_rate_details. - taxability
Reason String - The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
- taxable
Amount Number - The amount on which tax is calculated, in cents (or local equivalent).
- type String
- The type of tax information.
InvoiceTotalTaxTaxRateDetails, InvoiceTotalTaxTaxRateDetailsArgs
- Tax
Rate string - ID of the tax rate
- Tax
Rate string - ID of the tax rate
- tax_
rate string - ID of the tax rate
- tax
Rate String - ID of the tax rate
- tax
Rate string - ID of the tax rate
- tax_
rate str - ID of the tax rate
- tax
Rate String - ID of the tax rate
InvoiceTransferData, InvoiceTransferDataArgs
- Destination string
- ID of an existing, connected Stripe account.
- Amount double
- The amount that will be transferred automatically when the invoice is paid. If no amount is set, the full amount is transferred.
- Destination string
- ID of an existing, connected Stripe account.
- Amount float64
- The amount that will be transferred automatically when the invoice is paid. If no amount is set, the full amount is transferred.
- destination string
- ID of an existing, connected Stripe account.
- amount number
- The amount that will be transferred automatically when the invoice is paid. If no amount is set, the full amount is transferred.
- destination String
- ID of an existing, connected Stripe account.
- amount Double
- The amount that will be transferred automatically when the invoice is paid. If no amount is set, the full amount is transferred.
- destination string
- ID of an existing, connected Stripe account.
- amount number
- The amount that will be transferred automatically when the invoice is paid. If no amount is set, the full amount is transferred.
- destination str
- ID of an existing, connected Stripe account.
- amount float
- The amount that will be transferred automatically when the invoice is paid. If no amount is set, the full amount is transferred.
- destination String
- ID of an existing, connected Stripe account.
- amount Number
- The amount that will be transferred automatically when the invoice is paid. If no amount is set, the full amount is transferred.
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