stripe · stripe-openapi · May 19, 2023 · May 8, 2023 · May 9, 2023 · May 15, 2023
diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION
@@ -1 +1 @@
-v309
+v344
diff --git a/stripe/api_resources/account.py b/stripe/api_resources/account.py
@@ -22,7 +22,10 @@
     operations=["retrieve", "update", "list"],
     resource_plural="capabilities",
 )
-@nested_resource_class_methods("login_link", operations=["create"])
+@nested_resource_class_methods(
+    "login_link",
+    operations=["create"],
+)
 @nested_resource_class_methods(
     "person",
     operations=["create", "retrieve", "update", "delete", "list"],

diff --git a/stripe/api_resources/account_link.py b/stripe/api_resources/account_link.py
@@ -10,7 +10,7 @@ class AccountLink(CreateableAPIResource):
     Account Links are the means by which a Connect platform grants a connected account permission to access
     Stripe-hosted applications, such as Connect Onboarding.
 
-    Related guide: [Connect Onboarding](https://stripe.com/docs/connect/connect-onboarding).
+    Related guide: [Connect Onboarding](https://stripe.com/docs/connect/connect-onboarding)
     """
 
     OBJECT_NAME = "account_link"
diff --git a/stripe/api_resources/application_fee_refund.py b/stripe/api_resources/application_fee_refund.py
@@ -14,7 +14,7 @@ class ApplicationFeeRefund(UpdateableAPIResource):
     has previously been created but not yet refunded. Funds will be refunded to
     the Stripe account from which the fee was originally collected.
 
-    Related guide: [Refunding Application Fees](https://stripe.com/docs/connect/destination-charges#refunding-app-fee).
+    Related guide: [Refunding application fees](https://stripe.com/docs/connect/destination-charges#refunding-app-fee)
     """
 
     OBJECT_NAME = "fee_refund"

diff --git a/stripe/api_resources/apps/secret.py b/stripe/api_resources/apps/secret.py
@@ -16,7 +16,7 @@ class Secret(CreateableAPIResource, ListableAPIResource):
 
     A `user` scoped secret is accessible by the app backend and one specific Dashboard user. Use the `user` scope for per-user secrets like per-user OAuth tokens, where different users might have different permissions.
 
-    Related guide: [Store data between page reloads](https://stripe.com/docs/stripe-apps/store-auth-data-custom-objects).
+    Related guide: [Store data between page reloads](https://stripe.com/docs/stripe-apps/store-auth-data-custom-objects)
     """
 
     OBJECT_NAME = "apps.secret"

diff --git a/stripe/api_resources/balance.py b/stripe/api_resources/balance.py
@@ -17,7 +17,7 @@ class Balance(SingletonAPIResource):
     The available and pending amounts for each currency are broken down further by
     payment source types.
 
-    Related guide: [Understanding Connect Account Balances](https://stripe.com/docs/connect/account-balances).
+    Related guide: [Understanding Connect account balances](https://stripe.com/docs/connect/account-balances)
     """
 
     OBJECT_NAME = "balance"

diff --git a/stripe/api_resources/balance_transaction.py b/stripe/api_resources/balance_transaction.py
@@ -10,7 +10,7 @@ class BalanceTransaction(ListableAPIResource):
     Balance transactions represent funds moving through your Stripe account.
     They're created for every type of transaction that comes into or flows out of your Stripe account balance.
 
-    Related guide: [Balance Transaction Types](https://stripe.com/docs/reports/balance-transaction-types).
+    Related guide: [Balance transaction types](https://stripe.com/docs/reports/balance-transaction-types)
     """
 
     OBJECT_NAME = "balance_transaction"
diff --git a/stripe/api_resources/bank_account.py b/stripe/api_resources/bank_account.py
@@ -20,7 +20,7 @@ class BankAccount(DeletableAPIResource, UpdateableAPIResource, VerifyMixin):
     destinations on `Account` objects for [Custom accounts](https://stripe.com/docs/connect/custom-accounts).
     They can be bank accounts or debit cards as well, and are documented in the links above.
 
-    Related guide: [Bank Debits and Transfers](https://stripe.com/docs/payments/bank-debits-transfers).
+    Related guide: [Bank debits and transfers](https://stripe.com/docs/payments/bank-debits-transfers)
     """
 
     OBJECT_NAME = "bank_account"

diff --git a/stripe/api_resources/capability.py b/stripe/api_resources/capability.py
@@ -12,7 +12,7 @@ class Capability(UpdateableAPIResource):
     """
     This is an object representing a capability for a Stripe account.
 
-    Related guide: [Account capabilities](https://stripe.com/docs/connect/account-capabilities).
+    Related guide: [Account capabilities](https://stripe.com/docs/connect/account-capabilities)
     """
 
     OBJECT_NAME = "capability"

diff --git a/stripe/api_resources/card.py b/stripe/api_resources/card.py
@@ -17,7 +17,7 @@ class Card(DeletableAPIResource, UpdateableAPIResource):
     later. You can also store multiple debit cards on a recipient in order to
     transfer to those cards later.
 
-    Related guide: [Card Payments with Sources](https://stripe.com/docs/sources/cards).
+    Related guide: [Card payments with Sources](https://stripe.com/docs/sources/cards)
     """
 
     OBJECT_NAME = "card"

diff --git a/stripe/api_resources/charge.py b/stripe/api_resources/charge.py
@@ -20,7 +20,7 @@ class Charge(
     retrieve and refund individual charges as well as list all charges. Charges
     are identified by a unique, random ID.
 
-    Related guide: [Accept a payment with the Charges API](https://stripe.com/docs/payments/accept-a-payment-charges).
+    Related guide: [Accept a payment with the Charges API](https://stripe.com/docs/payments/accept-a-payment-charges)
     """
 
     OBJECT_NAME = "charge"

diff --git a/stripe/api_resources/checkout/session.py b/stripe/api_resources/checkout/session.py
@@ -22,7 +22,7 @@ class Session(CreateableAPIResource, ListableAPIResource):
     You can create a Checkout Session on your server and redirect to its URL
     to begin Checkout.
 
-    Related guide: [Checkout Quickstart](https://stripe.com/docs/checkout/quickstart).
+    Related guide: [Checkout quickstart](https://stripe.com/docs/checkout/quickstart)
     """
 
     OBJECT_NAME = "checkout.session"

diff --git a/stripe/api_resources/credit_note.py b/stripe/api_resources/credit_note.py
@@ -16,7 +16,7 @@ class CreditNote(
     """
     Issue a credit note to adjust an invoice's amount after the invoice is finalized.
 
-    Related guide: [Credit Notes](https://stripe.com/docs/billing/invoices/credit-notes).
+    Related guide: [Credit notes](https://stripe.com/docs/billing/invoices/credit-notes)
     """
 
     OBJECT_NAME = "credit_note"

diff --git a/stripe/api_resources/customer.py b/stripe/api_resources/customer.py
@@ -40,7 +40,7 @@ class Customer(
     """
     This object represents a customer of your business. It lets you create recurring charges and track payments that belong to the same customer.
 
-    Related guide: [Save a card during payment](https://stripe.com/docs/payments/save-during-payment).
+    Related guide: [Save a card during payment](https://stripe.com/docs/payments/save-during-payment)
     """
 
     OBJECT_NAME = "customer"

diff --git a/stripe/api_resources/customer_balance_transaction.py b/stripe/api_resources/customer_balance_transaction.py
@@ -10,12 +10,12 @@
 
 class CustomerBalanceTransaction(APIResource):
     """
-    Each customer has a [`balance`](https://stripe.com/docs/api/customers/object#customer_object-balance) value,
+    Each customer has a [Balance](https://stripe.com/docs/api/customers/object#customer_object-balance) value,
     which denotes a debit or credit that's automatically applied to their next invoice upon finalization.
     You may modify the value directly by using the [update customer API](https://stripe.com/docs/api/customers/update),
     or by creating a Customer Balance Transaction, which increments or decrements the customer's `balance` by the specified `amount`.
 
-    Related guide: [Customer Balance](https://stripe.com/docs/billing/customer/balance) to learn more.
+    Related guide: [Customer balance](https://stripe.com/docs/billing/customer/balance)
     """
 
     OBJECT_NAME = "customer_balance_transaction"

diff --git a/stripe/api_resources/dispute.py b/stripe/api_resources/dispute.py
@@ -15,7 +15,7 @@ class Dispute(ListableAPIResource, UpdateableAPIResource):
     information about the dispute process in our [Disputes and
     Fraud](https://stripe.com/docs/disputes) documentation.
 
-    Related guide: [Disputes and Fraud](https://stripe.com/docs/disputes).
+    Related guide: [Disputes and fraud](https://stripe.com/docs/disputes)
     """
 
     OBJECT_NAME = "dispute"

diff --git a/stripe/api_resources/file.py b/stripe/api_resources/file.py
@@ -16,7 +16,7 @@ class File(ListableAPIResource):
     been created by Stripe (for example, the results of a [Sigma scheduled
     query](https://stripe.com/docs/api#scheduled_queries)).
 
-    Related guide: [File Upload Guide](https://stripe.com/docs/file-upload).
+    Related guide: [File upload guide](https://stripe.com/docs/file-upload)
     """
 
     OBJECT_NAME = "file"

diff --git a/stripe/api_resources/funding_instructions.py b/stripe/api_resources/funding_instructions.py
@@ -11,7 +11,7 @@ class FundingInstructions(StripeObject):
     automatically applied to future invoices and payments using the `customer_balance` payment method.
     Customers can fund this balance by initiating a bank transfer to any account in the
     `financial_addresses` field.
-    Related guide: [Customer Balance - Funding Instructions](https://stripe.com/docs/payments/customer-balance/funding-instructions) to learn more
+    Related guide: [Customer balance funding instructions](https://stripe.com/docs/payments/customer-balance/funding-instructions)
     """
 
     OBJECT_NAME = "funding_instructions"
diff --git a/stripe/api_resources/invoice.py b/stripe/api_resources/invoice.py
@@ -49,7 +49,7 @@ class Invoice(
     More details on the customer's credit balance are
     [here](https://stripe.com/docs/billing/customer/balance).
 
-    Related guide: [Send Invoices to Customers](https://stripe.com/docs/billing/invoices/sending).
+    Related guide: [Send invoices to customers](https://stripe.com/docs/billing/invoices/sending)
     """
 
     OBJECT_NAME = "invoice"

diff --git a/stripe/api_resources/issuing/authorization.py b/stripe/api_resources/issuing/authorization.py
@@ -13,7 +13,7 @@ class Authorization(ListableAPIResource, UpdateableAPIResource):
     object is created. [Authorizations](https://stripe.com/docs/issuing/purchases/authorizations) must be approved for the
     purchase to be completed successfully.
 
-    Related guide: [Issued Card Authorizations](https://stripe.com/docs/issuing/purchases/authorizations).
+    Related guide: [Issued card authorizations](https://stripe.com/docs/issuing/purchases/authorizations)
     """
 
     OBJECT_NAME = "issuing.authorization"

diff --git a/stripe/api_resources/issuing/cardholder.py b/stripe/api_resources/issuing/cardholder.py
@@ -15,7 +15,7 @@ class Cardholder(
     """
     An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards.
 
-    Related guide: [How to create a Cardholder](https://stripe.com/docs/issuing/cards#create-cardholder)
+    Related guide: [How to create a cardholder](https://stripe.com/docs/issuing/cards#create-cardholder)
     """
 
     OBJECT_NAME = "issuing.cardholder"
diff --git a/stripe/api_resources/issuing/dispute.py b/stripe/api_resources/issuing/dispute.py
@@ -16,7 +16,7 @@ class Dispute(
     """
     As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with.
 
-    Related guide: [Disputing Transactions](https://stripe.com/docs/issuing/purchases/disputes)
+    Related guide: [Issuing disputes](https://stripe.com/docs/issuing/purchases/disputes)
     """
 
     OBJECT_NAME = "issuing.dispute"

diff --git a/stripe/api_resources/issuing/transaction.py b/stripe/api_resources/issuing/transaction.py
@@ -12,7 +12,7 @@ class Transaction(ListableAPIResource, UpdateableAPIResource):
     your Stripe account, such as a completed purchase or refund, is represented by an Issuing
     `Transaction` object.
 
-    Related guide: [Issued Card Transactions](https://stripe.com/docs/issuing/purchases/transactions).
+    Related guide: [Issued card transactions](https://stripe.com/docs/issuing/purchases/transactions)
     """
 
     OBJECT_NAME = "issuing.transaction"
diff --git a/stripe/api_resources/payment_intent.py b/stripe/api_resources/payment_intent.py
@@ -26,7 +26,7 @@ class PaymentIntent(
     throughout its lifetime as it interfaces with Stripe.js to perform
     authentication flows and ultimately creates at most one successful charge.
 
-    Related guide: [Payment Intents API](https://stripe.com/docs/payments/payment-intents).
+    Related guide: [Payment Intents API](https://stripe.com/docs/payments/payment-intents)
     """
 
     OBJECT_NAME = "payment_intent"

diff --git a/stripe/api_resources/payout.py b/stripe/api_resources/payout.py
@@ -19,7 +19,7 @@ class Payout(
     schedules](https://stripe.com/docs/connect/manage-payout-schedule), depending on your country and
     industry.
 
-    Related guide: [Receiving Payouts](https://stripe.com/docs/payouts).
+    Related guide: [Receiving payouts](https://stripe.com/docs/payouts)
     """
 
     OBJECT_NAME = "payout"

diff --git a/stripe/api_resources/person.py b/stripe/api_resources/person.py
@@ -15,7 +15,7 @@ class Person(UpdateableAPIResource):
     A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account.
     See the [Standard onboarding](https://stripe.com/docs/connect/standard-accounts) or [Express onboarding documentation](https://stripe.com/docs/connect/express-accounts) for information about platform pre-filling and account onboarding steps.
 
-    Related guide: [Handling Identity Verification with the API](https://stripe.com/docs/connect/identity-verification-api#person-information).
+    Related guide: [Handling identity verification with the API](https://stripe.com/docs/connect/identity-verification-api#person-information)
     """
 
     OBJECT_NAME = "person"

diff --git a/stripe/api_resources/radar/early_fraud_warning.py b/stripe/api_resources/radar/early_fraud_warning.py
@@ -10,7 +10,7 @@ class EarlyFraudWarning(ListableAPIResource):
     An early fraud warning indicates that the card issuer has notified us that a
     charge may be fraudulent.
 
-    Related guide: [Early Fraud Warnings](https://stripe.com/docs/disputes/measuring#early-fraud-warnings).
+    Related guide: [Early fraud warnings](https://stripe.com/docs/disputes/measuring#early-fraud-warnings)
     """
 
     OBJECT_NAME = "radar.early_fraud_warning"
diff --git a/stripe/api_resources/radar/value_list.py b/stripe/api_resources/radar/value_list.py
@@ -17,7 +17,7 @@ class ValueList(
     """
     Value lists allow you to group values together which can then be referenced in rules.
 
-    Related guide: [Default Stripe Lists](https://stripe.com/docs/radar/lists#managing-list-items).
+    Related guide: [Default Stripe lists](https://stripe.com/docs/radar/lists#managing-list-items)
     """
 
     OBJECT_NAME = "radar.value_list"
diff --git a/stripe/api_resources/radar/value_list_item.py b/stripe/api_resources/radar/value_list_item.py
@@ -15,7 +15,7 @@ class ValueListItem(
     """
     Value list items allow you to add specific values to a given Radar value list, which can then be used in rules.
 
-    Related guide: [Managing List Items](https://stripe.com/docs/radar/lists#managing-list-items).
+    Related guide: [Managing list items](https://stripe.com/docs/radar/lists#managing-list-items)
     """
 
     OBJECT_NAME = "radar.value_list_item"
diff --git a/stripe/api_resources/refund.py b/stripe/api_resources/refund.py
@@ -19,7 +19,7 @@ class Refund(
     but not yet refunded. Funds will be refunded to the credit or debit card that
     was originally charged.
 
-    Related guide: [Refunds](https://stripe.com/docs/refunds).
+    Related guide: [Refunds](https://stripe.com/docs/refunds)
     """
 
     OBJECT_NAME = "refund"

diff --git a/stripe/api_resources/reversal.py b/stripe/api_resources/reversal.py
@@ -22,7 +22,7 @@ class Reversal(UpdateableAPIResource):
     transfer only if the destination account has enough balance to cover the
     reversal.
 
-    Related guide: [Reversing Transfers](https://stripe.com/docs/connect/charges-transfers#reversing-transfers).
+    Related guide: [Reversing transfers](https://stripe.com/docs/connect/charges-transfers#reversing-transfers)
     """
 
     OBJECT_NAME = "transfer_reversal"

diff --git a/stripe/api_resources/setup_intent.py b/stripe/api_resources/setup_intent.py
@@ -35,7 +35,7 @@ class SetupIntent(
     By using SetupIntents, you ensure that your customers experience the minimum set of required friction,
     even as regulations change over time.
 
-    Related guide: [Setup Intents API](https://stripe.com/docs/payments/setup-intents).
+    Related guide: [Setup Intents API](https://stripe.com/docs/payments/setup-intents)
     """
 
     OBJECT_NAME = "setup_intent"

diff --git a/stripe/api_resources/subscription.py b/stripe/api_resources/subscription.py
@@ -20,7 +20,7 @@ class Subscription(
     """
     Subscriptions allow you to charge a customer on a recurring basis.
 
-    Related guide: [Creating Subscriptions](https://stripe.com/docs/billing/subscriptions/creating).
+    Related guide: [Creating subscriptions](https://stripe.com/docs/billing/subscriptions/creating)
     """
 
     OBJECT_NAME = "subscription"

diff --git a/stripe/api_resources/subscription_item.py b/stripe/api_resources/subscription_item.py
@@ -9,7 +9,10 @@
 from stripe.api_resources.abstract import nested_resource_class_methods
 
 
-@nested_resource_class_methods("usage_record", operations=["create"])
+@nested_resource_class_methods(
+    "usage_record",
+    operations=["create"],
+)
 @nested_resource_class_methods(
     "usage_record_summary",
     operations=["list"],

diff --git a/stripe/api_resources/subscription_schedule.py b/stripe/api_resources/subscription_schedule.py
@@ -16,7 +16,7 @@ class SubscriptionSchedule(
     """
     A subscription schedule allows you to create and manage the lifecycle of a subscription by predefining expected changes.
 
-    Related guide: [Subscription Schedules](https://stripe.com/docs/billing/subscriptions/subscription-schedules).
+    Related guide: [Subscription schedules](https://stripe.com/docs/billing/subscriptions/subscription-schedules)
     """
 
     OBJECT_NAME = "subscription_schedule"

diff --git a/stripe/api_resources/tax/calculation.py b/stripe/api_resources/tax/calculation.py
@@ -10,7 +10,7 @@ class Calculation(CreateableAPIResource):
     """
     A Tax Calculation allows you to calculate the tax to collect from your customer.
 
-    Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom).
+    Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom)
     """
 
     OBJECT_NAME = "tax.calculation"

diff --git a/stripe/api_resources/tax/transaction.py b/stripe/api_resources/tax/transaction.py
@@ -10,7 +10,7 @@ class Transaction(APIResource):
     """
     A Tax Transaction records the tax collected from or refunded to your customer.
 
-    Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom#tax-transaction).
+    Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom#tax-transaction)
     """
 
     OBJECT_NAME = "tax.transaction"

diff --git a/stripe/api_resources/tax_id.py b/stripe/api_resources/tax_id.py
@@ -13,7 +13,7 @@ class TaxId(APIResource):
     You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers).
     A customer's tax IDs are displayed on invoices and credit notes issued for the customer.
 
-    Related guide: [Customer Tax Identification Numbers](https://stripe.com/docs/billing/taxes/tax-ids).
+    Related guide: [Customer tax identification numbers](https://stripe.com/docs/billing/taxes/tax-ids)
     """
 
     OBJECT_NAME = "tax_id"

diff --git a/stripe/api_resources/tax_rate.py b/stripe/api_resources/tax_rate.py
@@ -15,7 +15,7 @@ class TaxRate(
     """
     Tax rates can be applied to [invoices](https://stripe.com/docs/billing/invoices/tax-rates), [subscriptions](https://stripe.com/docs/billing/subscriptions/taxes) and [Checkout Sessions](https://stripe.com/docs/payments/checkout/set-up-a-subscription#tax-rates) to collect tax.
 
-    Related guide: [Tax Rates](https://stripe.com/docs/billing/taxes/tax-rates).
+    Related guide: [Tax rates](https://stripe.com/docs/billing/taxes/tax-rates)
     """
 
     OBJECT_NAME = "tax_rate"
diff --git a/stripe/api_resources/terminal/connection_token.py b/stripe/api_resources/terminal/connection_token.py
@@ -9,7 +9,7 @@ class ConnectionToken(CreateableAPIResource):
     """
     A Connection Token is used by the Stripe Terminal SDK to connect to a reader.
 
-    Related guide: [Fleet Management](https://stripe.com/docs/terminal/fleet/locations).
+    Related guide: [Fleet management](https://stripe.com/docs/terminal/fleet/locations)
     """
 
     OBJECT_NAME = "terminal.connection_token"
diff --git a/stripe/api_resources/terminal/location.py b/stripe/api_resources/terminal/location.py
@@ -17,7 +17,7 @@ class Location(
     """
     A Location represents a grouping of readers.
 
-    Related guide: [Fleet Management](https://stripe.com/docs/terminal/fleet/locations).
+    Related guide: [Fleet management](https://stripe.com/docs/terminal/fleet/locations)
     """
 
     OBJECT_NAME = "terminal.location"
diff --git a/stripe/api_resources/terminal/reader.py b/stripe/api_resources/terminal/reader.py
@@ -21,7 +21,7 @@ class Reader(
     """
     A Reader represents a physical device for accepting payment details.
 
-    Related guide: [Connecting to a Reader](https://stripe.com/docs/terminal/payments/connect-reader).
+    Related guide: [Connecting to a reader](https://stripe.com/docs/terminal/payments/connect-reader)
     """
 
     OBJECT_NAME = "terminal.reader"

diff --git a/stripe/api_resources/token.py b/stripe/api_resources/token.py
@@ -28,7 +28,7 @@ class Token(CreateableAPIResource):
     [Radar](https://stripe.com/docs/radar), our integrated solution for automatic fraud protection,
     performs best with integrations that use client-side tokenization.
 
-    Related guide: [Accept a payment](https://stripe.com/docs/payments/accept-a-payment-charges#web-create-token)
+    Related guide: [Accept a payment with Charges and Tokens](https://stripe.com/docs/payments/accept-a-payment-charges#web-create-token)
     """
 
     OBJECT_NAME = "token"