diff --git a/API_VERSION b/API_VERSION index e91c9d844..93be1cef5 100644 --- a/API_VERSION +++ b/API_VERSION @@ -1 +1 @@ -91ef4c6abe8dcdab3a855d81aa624693a6a4da9f \ No newline at end of file +88aa59022b32620f4d66d6196e3b42d5a0f86bbb \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index c652fddd0..08ffb3183 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -36,6 +36,11 @@ This release changes the pinned API version to `2025-11-17.preview`. * Remove support for thin events `V2PaymentsOffSessionPaymentAuthorizationAttemptFailedEvent`, `V2PaymentsOffSessionPaymentAuthorizationAttemptStartedEvent`, `V2PaymentsOffSessionPaymentCanceledEvent`, `V2PaymentsOffSessionPaymentCreatedEvent`, `V2PaymentsOffSessionPaymentFailedEvent`, `V2PaymentsOffSessionPaymentRequiresCaptureEvent`, and `V2PaymentsOffSessionPaymentSucceededEvent` with related object `v2.payments.OffSessionPayment` * [#1670](https://github.com/stripe/stripe-python/pull/1670) Ramya/merge python beta +## 14.0.1 - 2025-11-21 +* [#1684](https://github.com/stripe/stripe-python/pull/1684) Update generated code + * `stripe.error` module is now accessible globally. Fixes [#1682](https://github.com/stripe/stripe-python/issues/1682) +* [#1681](https://github.com/stripe/stripe-python/pull/1681) Throw a specific error when accessing `payment_intent` property on `Invoice` object to ease debugging. + ## 14.0.0 - 2025-11-18 This release changes the pinned API version to `2025-11-17.clover`. diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION index 927a37ae7..16739433e 100644 --- a/OPENAPI_VERSION +++ b/OPENAPI_VERSION @@ -1 +1 @@ -v2125 \ No newline at end of file +v2140 \ No newline at end of file diff --git a/justfile b/justfile index 184ad0e23..a37014e03 100644 --- a/justfile +++ b/justfile @@ -71,6 +71,9 @@ install group: venv # always log deps in CI, but don't do it locally python -I -m pip install -r deps/{{ group }}-requirements.txt --disable-pip-version-check {{ if env("CI", "") == "true" {""} else if is_dependency() == "true" {"--quiet"} else {""} }} +update-certs: + curl -o stripe/data/ca-certificates.crt https://curl.se/ca/cacert.pem + # create a virtualenv if it doesn't exist; always installs the local package [private] venv: diff --git a/stripe/__init__.py b/stripe/__init__.py index 4594dbd24..dac404516 100644 --- a/stripe/__init__.py +++ b/stripe/__init__.py @@ -143,6 +143,7 @@ def add_beta_version( if TYPE_CHECKING: from stripe import ( + _error as error, apps as apps, billing as billing, billing_portal as billing_portal, @@ -159,6 +160,7 @@ def add_beta_version( privacy as privacy, radar as radar, reporting as reporting, + reserve as reserve, sigma as sigma, tax as tax, terminal as terminal, @@ -322,6 +324,7 @@ def add_beta_version( AuthenticationError as AuthenticationError, BlockedByStripeError as BlockedByStripeError, CardError as CardError, + ControlledByAlternateResourceError as ControlledByAlternateResourceError, ControlledByDashboardError as ControlledByDashboardError, FeatureNotEnabledError as FeatureNotEnabledError, FinancialAccountNotOpenError as FinancialAccountNotOpenError, @@ -509,6 +512,7 @@ def add_beta_version( from stripe._reporting_service import ReportingService as ReportingService from stripe._request_options import RequestOptions as RequestOptions from stripe._requestor_options import RequestorOptions as RequestorOptions + from stripe._reserve_service import ReserveService as ReserveService from stripe._reserve_transaction import ( ReserveTransaction as ReserveTransaction, ) @@ -618,6 +622,7 @@ def add_beta_version( # name -> (import_target, is_submodule) _import_map = { + "error": ("stripe._error", True), "apps": ("stripe.apps", True), "billing": ("stripe.billing", True), "billing_portal": ("stripe.billing_portal", True), @@ -634,6 +639,7 @@ def add_beta_version( "privacy": ("stripe.privacy", True), "radar": ("stripe.radar", True), "reporting": ("stripe.reporting", True), + "reserve": ("stripe.reserve", True), "sigma": ("stripe.sigma", True), "tax": ("stripe.tax", True), "terminal": ("stripe.terminal", True), @@ -763,6 +769,7 @@ def add_beta_version( "AuthenticationError": ("stripe._error", False), "BlockedByStripeError": ("stripe._error", False), "CardError": ("stripe._error", False), + "ControlledByAlternateResourceError": ("stripe._error", False), "ControlledByDashboardError": ("stripe._error", False), "FeatureNotEnabledError": ("stripe._error", False), "FinancialAccountNotOpenError": ("stripe._error", False), @@ -919,6 +926,7 @@ def add_beta_version( "ReportingService": ("stripe._reporting_service", False), "RequestOptions": ("stripe._request_options", False), "RequestorOptions": ("stripe._requestor_options", False), + "ReserveService": ("stripe._reserve_service", False), "ReserveTransaction": ("stripe._reserve_transaction", False), "Reversal": ("stripe._reversal", False), "Review": ("stripe._review", False), diff --git a/stripe/_account.py b/stripe/_account.py index 4f63f5a23..2d4bd8396 100644 --- a/stripe/_account.py +++ b/stripe/_account.py @@ -145,7 +145,7 @@ class SupportAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ annual_revenue: Optional[AnnualRevenue] @@ -581,7 +581,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class AddressKana(StripeObject): @@ -704,7 +704,7 @@ class Verification(StripeObject): class Document(StripeObject): back: Optional[ExpandableField["File"]] """ - The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](https://docs.stripe.com/file-upload#uploading-a-file). + The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](https://docs.stripe.com/file-upload#uploading-a-file). """ details: Optional[str] """ @@ -716,7 +716,7 @@ class Document(StripeObject): """ front: Optional[ExpandableField["File"]] """ - The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](https://docs.stripe.com/file-upload#uploading-a-file). + The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. Note that `additional_verification` files are [not downloadable](https://docs.stripe.com/file-upload#uploading-a-file). """ document: Document @@ -733,7 +733,7 @@ class Document(StripeObject): """ directors_provided: Optional[bool] """ - Whether the company's directors have been provided. This Boolean will be `true` if you've manually indicated that all directors are provided via [the `directors_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-directors_provided). + Whether the company's directors have been provided. This Boolean will be `true` if you've manually indicated that all directors are provided via [the `directors_provided` parameter](https://docs.stripe.com/api/accounts/update#update_account-company-directors_provided). """ directorship_declaration: Optional[DirectorshipDeclaration] """ @@ -741,7 +741,7 @@ class Document(StripeObject): """ executives_provided: Optional[bool] """ - Whether the company's executives have been provided. This Boolean will be `true` if you've manually indicated that all executives are provided via [the `executives_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-executives_provided), or if Stripe determined that sufficient executives were provided. + Whether the company's executives have been provided. This Boolean will be `true` if you've manually indicated that all executives are provided via [the `executives_provided` parameter](https://docs.stripe.com/api/accounts/update#update_account-company-executives_provided), or if Stripe determined that sufficient executives were provided. """ export_license_id: Optional[str] """ @@ -765,7 +765,7 @@ class Document(StripeObject): """ owners_provided: Optional[bool] """ - Whether the company's owners have been provided. This Boolean will be `true` if you've manually indicated that all owners are provided via [the `owners_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-owners_provided), or if Stripe determined that sufficient owners were provided. Stripe determines ownership requirements using both the number of owners provided and their total percent ownership (calculated by adding the `percent_ownership` of each owner together). + Whether the company's owners have been provided. This Boolean will be `true` if you've manually indicated that all owners are provided via [the `owners_provided` parameter](https://docs.stripe.com/api/accounts/update#update_account-company-owners_provided), or if Stripe determined that sufficient owners were provided. Stripe determines ownership requirements using both the number of owners provided and their total percent ownership (calculated by adding the `percent_ownership` of each owner together). """ ownership_declaration: Optional[OwnershipDeclaration] """ @@ -817,7 +817,7 @@ class Document(StripeObject): ] ] """ - The category identifying the legal structure of the company or legal entity. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`. See [Business structure](https://stripe.com/docs/connect/identity-verification#business-structure) for more details. + The category identifying the legal structure of the company or legal entity. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`. See [Business structure](https://docs.stripe.com/connect/identity-verification#business-structure) for more details. """ tax_id_provided: Optional[bool] """ @@ -896,7 +896,7 @@ class StripeDashboard(StripeObject): fees: Optional[Fees] is_controller: Optional[bool] """ - `true` if the Connect application retrieving the resource controls the account and can therefore exercise [platform controls](https://stripe.com/docs/connect/platform-controls-for-standard-accounts). Otherwise, this field is null. + `true` if the Connect application retrieving the resource controls the account and can therefore exercise [platform controls](https://docs.stripe.com/connect/platform-controls-for-standard-accounts). Otherwise, this field is null. """ losses: Optional[Losses] requirement_collection: Optional[Literal["application", "stripe"]] @@ -920,11 +920,11 @@ class FutureRequirements(StripeObject): class Alternative(StripeObject): alternative_fields_due: List[str] """ - Fields that can be provided to satisfy all fields in `original_fields_due`. + Fields that can be provided to resolve all fields in `original_fields_due`. """ original_fields_due: List[str] """ - Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`. + Fields that are due and can be resolved by providing all fields in `alternative_fields_due`. """ class Error(StripeObject): @@ -1042,7 +1042,7 @@ class Error(StripeObject): alternatives: Optional[List[Alternative]] """ - Fields that are due and can be satisfied by providing the corresponding alternative fields instead. + Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again. """ current_deadline: Optional[int] """ @@ -1050,7 +1050,7 @@ class Error(StripeObject): """ currently_due: Optional[List[str]] """ - Fields that need to be collected to keep the account enabled. If not collected by `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash. + Fields that need to be resolved to keep the account enabled. If not resolved by `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash. """ disabled_reason: Optional[ Literal[ @@ -1076,7 +1076,7 @@ class Error(StripeObject): """ errors: Optional[List[Error]] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ eventually_due: Optional[List[str]] """ @@ -1084,29 +1084,29 @@ class Error(StripeObject): """ past_due: Optional[List[str]] """ - Fields that weren't collected by `requirements.current_deadline`. These fields need to be collected to enable the capability on the account. New fields will never appear here; `future_requirements.past_due` will always be a subset of `requirements.past_due`. + Fields that haven't been resolved by `requirements.current_deadline`. These fields need to be resolved to enable the capability on the account. `future_requirements.past_due` is a subset of `requirements.past_due`. """ pending_verification: Optional[List[str]] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`. Fields might appear in `eventually_due` or `currently_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"alternatives": Alternative, "errors": Error} class Groups(StripeObject): payments_pricing: Optional[str] """ - The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://stripe.com/docs/connect/platform-pricing-tools) for details. + The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://docs.stripe.com/connect/platform-pricing-tools) for details. """ class Requirements(StripeObject): class Alternative(StripeObject): alternative_fields_due: List[str] """ - Fields that can be provided to satisfy all fields in `original_fields_due`. + Fields that can be provided to resolve all fields in `original_fields_due`. """ original_fields_due: List[str] """ - Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`. + Fields that are due and can be resolved by providing all fields in `alternative_fields_due`. """ class Error(StripeObject): @@ -1224,7 +1224,7 @@ class Error(StripeObject): alternatives: Optional[List[Alternative]] """ - Fields that are due and can be satisfied by providing the corresponding alternative fields instead. + Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again. """ current_deadline: Optional[int] """ @@ -1232,7 +1232,7 @@ class Error(StripeObject): """ currently_due: Optional[List[str]] """ - Fields that need to be collected to keep the account enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the account is disabled. + Fields that need to be resolved to keep the account enabled. If not resolved by `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled. """ disabled_reason: Optional[ Literal[ @@ -1254,11 +1254,11 @@ class Error(StripeObject): ] ] """ - If the account is disabled, this enum describes why. [Learn more about handling verification issues](https://stripe.com/docs/connect/handling-api-verification). + If the account is disabled, this enum describes why. [Learn more about handling verification issues](https://docs.stripe.com/connect/handling-api-verification). """ errors: Optional[List[Error]] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ eventually_due: Optional[List[str]] """ @@ -1266,11 +1266,11 @@ class Error(StripeObject): """ past_due: Optional[List[str]] """ - Fields that weren't collected by `current_deadline`. These fields need to be collected to enable the account. + Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the account. """ pending_verification: Optional[List[str]] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"alternatives": Alternative, "errors": Error} @@ -1302,7 +1302,7 @@ class Payouts(StripeObject): ] ] """ - Represents the rejected reason of the account. Empty if account is not rejected, or rejected by Stripe. Please see [this page for more details](https://stripe.com/docs/connect/) + Represents the rejected reason of the account. Empty if account is not rejected, or rejected by Stripe. Please see [this page for more details](https://docs.stripe.com/connect/) """ _inner_class_types = {"charges": Charges, "payouts": Payouts} @@ -1640,7 +1640,7 @@ class TosAcceptance(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["account"] """ diff --git a/stripe/_account_link.py b/stripe/_account_link.py index 15043e9ee..704721339 100644 --- a/stripe/_account_link.py +++ b/stripe/_account_link.py @@ -15,7 +15,7 @@ class AccountLink(CreateableAPIResource["AccountLink"]): 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/custom/hosted-onboarding) + Related guide: [Connect Onboarding](https://docs.stripe.com/connect/custom/hosted-onboarding) """ OBJECT_NAME: ClassVar[Literal["account_link"]] = "account_link" diff --git a/stripe/_account_notice.py b/stripe/_account_notice.py index 92687e375..0338c413f 100644 --- a/stripe/_account_notice.py +++ b/stripe/_account_notice.py @@ -27,7 +27,7 @@ class AccountNotice( """ A notice to a Connected account. Notice can be sent by Stripe on your behalf or you can opt to send the notices yourself. - See the [guide to send notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) to your connected accounts. + See the [guide to send notices](https://docs.stripe.com/issuing/compliance-us/issuing-regulated-customer-notices) to your connected accounts. """ OBJECT_NAME: ClassVar[Literal["account_notice"]] = "account_notice" @@ -49,15 +49,15 @@ class Email(StripeObject): class LinkedObjects(StripeObject): capability: Optional[str] """ - Associated [Capability](https://stripe.com/docs/api/capabilities) + Associated [Capability](https://docs.stripe.com/api/capabilities) """ issuing_credit_underwriting_record: Optional[str] """ - Associated [Credit Underwriting Record](https://stripe.com/docs/api/issuing/credit_underwriting_record) + Associated [Credit Underwriting Record](https://docs.stripe.com/api/issuing/credit_underwriting_record) """ issuing_dispute: Optional[str] """ - Associated [Issuing Dispute](https://stripe.com/docs/api/issuing/disputes) + Associated [Issuing Dispute](https://docs.stripe.com/api/issuing/disputes) """ created: int @@ -86,7 +86,7 @@ class LinkedObjects(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["account_notice"] """ @@ -108,7 +108,7 @@ class LinkedObjects(StripeObject): "issuing.dispute_won", ] """ - Reason the notice is being sent. The reason determines what copy the notice must contain. See the [regulated customer notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) guide. All reasons might not apply to your integration, and Stripe might add new reasons in the future, so we recommend an internal warning when you receive an unknown reason. + Reason the notice is being sent. The reason determines what copy the notice must contain. See the [regulated customer notices](https://docs.stripe.com/issuing/compliance-us/issuing-regulated-customer-notices) guide. All reasons might not apply to your integration, and Stripe might add new reasons in the future, so we recommend an internal warning when you receive an unknown reason. """ sent_at: Optional[int] """ diff --git a/stripe/_account_session.py b/stripe/_account_session.py index 8f2585fdc..6f8ac6b51 100644 --- a/stripe/_account_session.py +++ b/stripe/_account_session.py @@ -19,7 +19,7 @@ class AccountSession(CreateableAPIResource["AccountSession"]): to your user. Do not save AccountSessions to your database as they expire relatively quickly, and cannot be used more than once. - Related guide: [Connect embedded components](https://stripe.com/docs/connect/get-started-connect-embedded-components) + Related guide: [Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components) """ OBJECT_NAME: ClassVar[Literal["account_session"]] = "account_session" @@ -502,7 +502,7 @@ class Features(StripeObject): The client secret can be used to provide access to `account` from your frontend. It should not be stored, logged, or exposed to anyone other than the connected account. Make sure that you have TLS enabled on any page that includes the client secret. - Refer to our docs to [setup Connect embedded components](https://stripe.com/docs/connect/get-started-connect-embedded-components) and learn about how `client_secret` should be handled. + Refer to our docs to [setup Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components) and learn about how `client_secret` should be handled. """ components: Components expires_at: int diff --git a/stripe/_api_requestor.py b/stripe/_api_requestor.py index 141769402..e196fd9cc 100644 --- a/stripe/_api_requestor.py +++ b/stripe/_api_requestor.py @@ -390,6 +390,8 @@ def specific_v2_api_error(self, rbody, rcode, resp, rheaders, error_data): return error.AlreadyExistsError(**error_args) elif type == "blocked_by_stripe": return error.BlockedByStripeError(**error_args) + elif type == "controlled_by_alternate_resource": + return error.ControlledByAlternateResourceError(**error_args) elif type == "controlled_by_dashboard": return error.ControlledByDashboardError(**error_args) elif type == "feature_not_enabled": @@ -411,8 +413,6 @@ def specific_v2_api_error(self, rbody, rcode, resp, rheaders, error_data): return error.NotCancelableError(**error_args) elif type == "quota_exceeded": return error.QuotaExceededError(**error_args) - elif type == "rate_limit": - return error.RateLimitError(**error_args) elif type == "recipient_not_notifiable": return error.RecipientNotNotifiableError(**error_args) elif type == "temporary_session_expired": diff --git a/stripe/_api_version.py b/stripe/_api_version.py index fa105a51e..5061061bc 100644 --- a/stripe/_api_version.py +++ b/stripe/_api_version.py @@ -1,4 +1,4 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec class _ApiVersion: - CURRENT = "2025-11-17.preview" + CURRENT = "2025-12-15.preview" diff --git a/stripe/_application_fee_refund.py b/stripe/_application_fee_refund.py index 4ae51aeb3..0c4dc4d76 100644 --- a/stripe/_application_fee_refund.py +++ b/stripe/_application_fee_refund.py @@ -17,7 +17,7 @@ class ApplicationFeeRefund(UpdateableAPIResource["ApplicationFeeRefund"]): 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://docs.stripe.com/connect/destination-charges#refunding-app-fee) """ OBJECT_NAME: ClassVar[Literal["fee_refund"]] = "fee_refund" @@ -47,7 +47,7 @@ class ApplicationFeeRefund(UpdateableAPIResource["ApplicationFeeRefund"]): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["fee_refund"] """ diff --git a/stripe/_balance.py b/stripe/_balance.py index e3a5e8475..4824ba22c 100644 --- a/stripe/_balance.py +++ b/stripe/_balance.py @@ -16,7 +16,7 @@ class Balance(SingletonAPIResource["Balance"]): The top-level `available` and `pending` comprise your "payments balance." - Related guide: [Balances and settlement time](https://stripe.com/docs/payments/balances), [Understanding Connect account balances](https://stripe.com/docs/connect/account-balances) + Related guide: [Balances and settlement time](https://docs.stripe.com/payments/balances), [Understanding Connect account balances](https://docs.stripe.com/connect/account-balances) """ OBJECT_NAME: ClassVar[Literal["balance"]] = "balance" @@ -256,7 +256,7 @@ class SourceTypes(StripeObject): available: List[Available] """ - Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://stripe.com/docs/api#transfers) or [Payouts API](https://stripe.com/docs/api#payouts). You can find the available balance for each currency and payment type in the `source_types` property. + Available funds that you can transfer or pay out automatically by Stripe or explicitly through the [Transfers API](https://api.stripe.com#transfers) or [Payouts API](https://api.stripe.com#payouts). You can find the available balance for each currency and payment type in the `source_types` property. """ connect_reserved: Optional[List[ConnectReserved]] """ diff --git a/stripe/_balance_settings.py b/stripe/_balance_settings.py index bda6ce9b4..2f0b8bb42 100644 --- a/stripe/_balance_settings.py +++ b/stripe/_balance_settings.py @@ -59,7 +59,7 @@ class Schedule(StripeObject): """ schedule: Optional[Schedule] """ - Details on when funds from charges are available, and when they are paid out to an external account. See our [Setting Bank and Debit Card Payouts](https://stripe.com/docs/connect/bank-transfers#payout-information) documentation for details. + Details on when funds from charges are available, and when they are paid out to an external account. See our [Setting Bank and Debit Card Payouts](https://docs.stripe.com/connect/bank-transfers#payout-information) documentation for details. """ statement_descriptor: Optional[str] """ diff --git a/stripe/_balance_transaction.py b/stripe/_balance_transaction.py index e8393984c..b6be1dfcf 100644 --- a/stripe/_balance_transaction.py +++ b/stripe/_balance_transaction.py @@ -39,7 +39,7 @@ class BalanceTransaction(ListableAPIResource["BalanceTransaction"]): Balance transactions represent funds moving through your Stripe account. Stripe creates them for every type of transaction that enters or leaves your Stripe account balance. - Related guide: [Balance transaction types](https://stripe.com/docs/reports/balance-transaction-types) + Related guide: [Balance transaction types](https://docs.stripe.com/reports/balance-transaction-types) """ OBJECT_NAME: ClassVar[Literal["balance_transaction"]] = ( diff --git a/stripe/_bank_account.py b/stripe/_bank_account.py index f90c571fb..9aae072ef 100644 --- a/stripe/_bank_account.py +++ b/stripe/_bank_account.py @@ -152,19 +152,19 @@ class Error(StripeObject): currently_due: Optional[List[str]] """ - Fields that need to be collected to keep the external account enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the account is disabled. + Fields that need to be resolved to keep the external account enabled. If not resolved by `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled. """ errors: Optional[List[Error]] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ past_due: Optional[List[str]] """ - Fields that weren't collected by `current_deadline`. These fields need to be collected to enable the external account. + Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the external account. """ pending_verification: Optional[List[str]] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"errors": Error} @@ -284,19 +284,19 @@ class Error(StripeObject): currently_due: Optional[List[str]] """ - Fields that need to be collected to keep the external account enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the account is disabled. + Fields that need to be resolved to keep the external account enabled. If not resolved by `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled. """ errors: Optional[List[Error]] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ past_due: Optional[List[str]] """ - Fields that weren't collected by `current_deadline`. These fields need to be collected to enable the external account. + Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the external account. """ pending_verification: Optional[List[str]] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"errors": Error} @@ -350,7 +350,7 @@ class Error(StripeObject): """ future_requirements: Optional[FutureRequirements] """ - Information about the [upcoming new requirements for the bank account](https://stripe.com/docs/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when. + Information about the [upcoming new requirements for the bank account](https://docs.stripe.com/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when. """ id: str """ @@ -362,7 +362,7 @@ class Error(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["bank_account"] """ diff --git a/stripe/_capability.py b/stripe/_capability.py index 352e2aaa9..b23abe29e 100644 --- a/stripe/_capability.py +++ b/stripe/_capability.py @@ -13,7 +13,7 @@ class Capability(UpdateableAPIResource["Capability"]): """ 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://docs.stripe.com/connect/account-capabilities) """ OBJECT_NAME: ClassVar[Literal["capability"]] = "capability" @@ -22,11 +22,11 @@ class FutureRequirements(StripeObject): class Alternative(StripeObject): alternative_fields_due: List[str] """ - Fields that can be provided to satisfy all fields in `original_fields_due`. + Fields that can be provided to resolve all fields in `original_fields_due`. """ original_fields_due: List[str] """ - Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`. + Fields that are due and can be resolved by providing all fields in `alternative_fields_due`. """ class Error(StripeObject): @@ -144,7 +144,7 @@ class Error(StripeObject): alternatives: Optional[List[Alternative]] """ - Fields that are due and can be satisfied by providing the corresponding alternative fields instead. + Fields that are due and can be resolved by providing the corresponding alternative fields instead. Multiple alternatives can reference the same `original_fields_due`. When this happens, any of these alternatives can serve as a pathway for attempting to resolve the fields. Additionally, providing `original_fields_due` again also serves as a pathway for attempting to resolve the fields. """ current_deadline: Optional[int] """ @@ -152,7 +152,7 @@ class Error(StripeObject): """ currently_due: List[str] """ - Fields that need to be collected to keep the capability enabled. If not collected by `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash. + Fields that need to be resolved to keep the capability enabled. If not resolved by `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash. """ disabled_reason: Optional[ Literal[ @@ -173,7 +173,7 @@ class Error(StripeObject): """ errors: List[Error] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ eventually_due: List[str] """ @@ -181,11 +181,11 @@ class Error(StripeObject): """ past_due: List[str] """ - Fields that weren't collected by `requirements.current_deadline`. These fields need to be collected to enable the capability on the account. New fields will never appear here; `future_requirements.past_due` will always be a subset of `requirements.past_due`. + Fields that haven't been resolved by `requirements.current_deadline`. These fields need to be resolved to enable the capability on the account. `future_requirements.past_due` is a subset of `requirements.past_due`. """ pending_verification: List[str] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`. Fields might appear in `eventually_due` or `currently_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"alternatives": Alternative, "errors": Error} @@ -193,11 +193,11 @@ class Requirements(StripeObject): class Alternative(StripeObject): alternative_fields_due: List[str] """ - Fields that can be provided to satisfy all fields in `original_fields_due`. + Fields that can be provided to resolve all fields in `original_fields_due`. """ original_fields_due: List[str] """ - Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`. + Fields that are due and can be resolved by providing all fields in `alternative_fields_due`. """ class Error(StripeObject): @@ -315,7 +315,7 @@ class Error(StripeObject): alternatives: Optional[List[Alternative]] """ - Fields that are due and can be satisfied by providing the corresponding alternative fields instead. + Fields that are due and can be resolved by providing the corresponding alternative fields instead. Multiple alternatives can reference the same `original_fields_due`. When this happens, any of these alternatives can serve as a pathway for attempting to resolve the fields. Additionally, providing `original_fields_due` again also serves as a pathway for attempting to resolve the fields. """ current_deadline: Optional[int] """ @@ -323,7 +323,7 @@ class Error(StripeObject): """ currently_due: List[str] """ - Fields that need to be collected to keep the capability enabled. If not collected by `current_deadline`, these fields appear in `past_due` as well, and the capability is disabled. + Fields that need to be resolved to keep the capability enabled. If not resolved by `current_deadline`, these fields will appear in `past_due` as well, and the capability is disabled. """ disabled_reason: Optional[ Literal[ @@ -340,11 +340,11 @@ class Error(StripeObject): ] ] """ - Description of why the capability is disabled. [Learn more about handling verification issues](https://stripe.com/docs/connect/handling-api-verification). + Description of why the capability is disabled. [Learn more about handling verification issues](https://docs.stripe.com/connect/handling-api-verification). """ errors: List[Error] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ eventually_due: List[str] """ @@ -352,11 +352,11 @@ class Error(StripeObject): """ past_due: List[str] """ - Fields that weren't collected by `current_deadline`. These fields need to be collected to enable the capability on the account. + Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the capability on the account. """ pending_verification: List[str] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"alternatives": Alternative, "errors": Error} diff --git a/stripe/_card.py b/stripe/_card.py index cc999fc82..4e0ffc9d7 100644 --- a/stripe/_card.py +++ b/stripe/_card.py @@ -22,7 +22,7 @@ class Card(DeletableAPIResource["Card"], UpdateableAPIResource["Card"]): 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://docs.stripe.com/sources/cards) """ OBJECT_NAME: ClassVar[Literal["card"]] = "card" @@ -150,7 +150,7 @@ class Networks(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: Optional[str] """ diff --git a/stripe/_cash_balance.py b/stripe/_cash_balance.py index 6aab8c917..acd08a752 100644 --- a/stripe/_cash_balance.py +++ b/stripe/_cash_balance.py @@ -26,7 +26,7 @@ class Settings(StripeObject): available: Optional[Dict[str, int]] """ - A hash of all cash balances available to this customer. You cannot delete a customer with any cash balances, even if the balance is 0. Amounts are represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + A hash of all cash balances available to this customer. You cannot delete a customer with any cash balances, even if the balance is 0. Amounts are represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ customer: str """ @@ -34,7 +34,7 @@ class Settings(StripeObject): """ customer_account: Optional[str] """ - The ID of the account whose cash balance this object represents. + The ID of an Account representing a customer whose cash balance this object represents. """ livemode: bool """ diff --git a/stripe/_charge.py b/stripe/_charge.py index 261090c00..b758323cd 100644 --- a/stripe/_charge.py +++ b/stripe/_charge.py @@ -61,7 +61,7 @@ class Charge( ): """ The `Charge` object represents a single attempt to move money into your Stripe account. - PaymentIntent confirmation is the most common way to create Charges, but [Account Debits](https://stripe.com/docs/connect/account-debits) may also create Charges. + PaymentIntent confirmation is the most common way to create Charges, but [Account Debits](https://docs.stripe.com/connect/account-debits) may also create Charges. Some legacy payment flows create Charges directly, which is not recommended for new integrations. """ @@ -91,7 +91,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -162,7 +162,7 @@ class Rule(StripeObject): Literal["confirm_card_data", "do_not_try_again", "try_again_later"] ] """ - An enumerated value providing a more detailed explanation on [how to proceed with an error](https://stripe.com/docs/declines#retrying-issuer-declines). + An enumerated value providing a more detailed explanation on [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines). """ network_advice_code: Optional[str] """ @@ -174,11 +174,11 @@ class Rule(StripeObject): """ network_status: Optional[str] """ - Possible values are `approved_by_network`, `declined_by_network`, `not_sent_to_network`, and `reversed_after_approval`. The value `reversed_after_approval` indicates the payment was [blocked by Stripe](https://stripe.com/docs/declines#blocked-payments) after bank authorization, and may temporarily appear as "pending" on a cardholder's statement. + Possible values are `approved_by_network`, `declined_by_network`, `not_sent_to_network`, and `reversed_after_approval`. The value `reversed_after_approval` indicates the payment was [blocked by Stripe](https://docs.stripe.com/declines#blocked-payments) after bank authorization, and may temporarily appear as "pending" on a cardholder's statement. """ reason: Optional[str] """ - An enumerated value providing a more detailed explanation of the outcome's `type`. Charges blocked by Radar's default block rule have the value `highest_risk_level`. Charges placed in review by Radar's default review rule have the value `elevated_risk_level`. Charges blocked because the payment is unlikely to be authorized have the value `low_probability_of_authorization`. Charges authorized, blocked, or placed in review by custom rules have the value `rule`. See [understanding declines](https://stripe.com/docs/declines) for more details. + An enumerated value providing a more detailed explanation of the outcome's `type`. Charges blocked by Radar's default block rule have the value `highest_risk_level`. Charges placed in review by Radar's default review rule have the value `elevated_risk_level`. Charges blocked because the payment is unlikely to be authorized have the value `low_probability_of_authorization`. Charges authorized, blocked, or placed in review by custom rules have the value `rule`. See [understanding declines](https://docs.stripe.com/declines) for more details. """ risk_level: Optional[str] """ @@ -198,7 +198,7 @@ class Rule(StripeObject): """ type: str """ - Possible values are `authorized`, `manual_review`, `issuer_declined`, `blocked`, and `invalid`. See [understanding declines](https://stripe.com/docs/declines) and [Radar reviews](https://stripe.com/docs/radar/reviews) for details. + Possible values are `authorized`, `manual_review`, `issuer_declined`, `blocked`, and `invalid`. See [understanding declines](https://docs.stripe.com/declines) and [Radar reviews](https://docs.stripe.com/radar/reviews) for details. """ _inner_class_types = {"rule": Rule} @@ -252,6 +252,10 @@ class AcssDebit(StripeObject): """ Name of the bank associated with the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -276,11 +280,11 @@ class AcssDebit(StripeObject): class Affirm(StripeObject): location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ transaction_id: Optional[str] """ @@ -376,6 +380,10 @@ class AuBecsDebit(StripeObject): """ Bank-State-Branch number of the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -390,6 +398,10 @@ class AuBecsDebit(StripeObject): """ class BacsDebit(StripeObject): + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -648,7 +660,7 @@ class BillingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class ShippingAddress(StripeObject): @@ -674,7 +686,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ billing_address: Optional[BillingAddress] @@ -725,7 +737,7 @@ class BillingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class ShippingAddress(StripeObject): @@ -751,7 +763,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ billing_address: Optional[BillingAddress] @@ -869,7 +881,7 @@ class ShippingAddress(StripeObject): """ Installment details for this payment. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ issuer: Optional[str] """ @@ -1047,7 +1059,7 @@ class Wallet(StripeObject): """ incremental_authorization_supported: bool """ - Whether this [PaymentIntent](https://stripe.com/docs/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). + Whether this [PaymentIntent](https://docs.stripe.com/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). """ issuer: Optional[str] """ @@ -1277,6 +1289,7 @@ class Ideal(StripeObject): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -1290,7 +1303,7 @@ class Ideal(StripeObject): ] ] """ - The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. + The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `mollie`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. """ bic: Optional[ Literal[ @@ -1304,6 +1317,7 @@ class Ideal(StripeObject): "HANDNL2A", "INGBNL2A", "KNABNL2H", + "MLLENL2A", "MOYONL21", "NNBANL2G", "NTSBDEB1", @@ -1639,6 +1653,10 @@ class NzBankAccount(StripeObject): """ The numeric code for the bank account's bank branch. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ last4: str """ Last four digits of the bank account number. @@ -1715,11 +1733,11 @@ class Payco(StripeObject): class Paynow(StripeObject): location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ reference: Optional[str] """ @@ -1764,7 +1782,7 @@ class Shipping(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class VerifiedAddress(StripeObject): @@ -1790,7 +1808,7 @@ class VerifiedAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ country: Optional[str] @@ -1982,6 +2000,10 @@ class SepaDebit(StripeObject): """ Two-letter ISO code representing the country the bank account is located in. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -1992,7 +2014,7 @@ class SepaDebit(StripeObject): """ mandate: Optional[str] """ - Find the ID of the mandate used for this payment under the [payment_method_details.sepa_debit.mandate](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-sepa_debit-mandate) property on the Charge. Use this mandate ID to [retrieve the Mandate](https://stripe.com/docs/api/mandates/retrieve). + Find the ID of the mandate used for this payment under the [payment_method_details.sepa_debit.mandate](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-sepa_debit-mandate) property on the Charge. Use this mandate ID to [retrieve the Mandate](https://docs.stripe.com/api/mandates/retrieve). """ class Shopeepay(StripeObject): @@ -2083,6 +2105,10 @@ class UsBankAccount(StripeObject): """ Name of the bank associated with the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -2114,11 +2140,11 @@ class WechatPay(StripeObject): """ location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ transaction_id: Optional[str] """ @@ -2190,7 +2216,7 @@ class Zip(StripeObject): twint: Optional[Twint] type: str """ - The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) for the full list of possible types. + The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type) for the full list of possible types. An additional hash is included on `payment_method_details` with a name matching this value. It contains information specific to the payment method. """ @@ -2278,7 +2304,7 @@ class PresentmentDetails(StripeObject): class RadarOptions(StripeObject): session: Optional[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ class Shipping(StripeObject): @@ -2305,7 +2331,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -2339,7 +2365,7 @@ class TransferData(StripeObject): amount: int """ - Amount intended to be collected by this payment. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). + Amount intended to be collected by this payment. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). """ amount_captured: int """ @@ -2355,11 +2381,11 @@ class TransferData(StripeObject): """ application_fee: Optional[ExpandableField["ApplicationFee"]] """ - The application fee (if any) for the charge. [See the Connect documentation](https://stripe.com/docs/connect/direct-charges#collect-fees) for details. + The application fee (if any) for the charge. [See the Connect documentation](https://docs.stripe.com/connect/direct-charges#collect-fees) for details. """ application_fee_amount: Optional[int] """ - The amount of the application fee (if any) requested for the charge. [See the Connect documentation](https://stripe.com/docs/connect/direct-charges#collect-fees) for details. + The amount of the application fee (if any) requested for the charge. [See the Connect documentation](https://docs.stripe.com/connect/direct-charges#collect-fees) for details. """ authorization_code: Optional[str] """ @@ -2406,7 +2432,7 @@ class TransferData(StripeObject): """ failure_code: Optional[str] """ - Error code explaining reason for charge failure if available (see [the errors section](https://stripe.com/docs/error-codes) for a list of codes). + Error code explaining reason for charge failure if available (see [the errors section](https://docs.stripe.com/error-codes) for a list of codes). """ failure_message: Optional[str] """ @@ -2427,7 +2453,7 @@ class TransferData(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["charge"] """ @@ -2435,11 +2461,11 @@ class TransferData(StripeObject): """ on_behalf_of: Optional[ExpandableField["Account"]] """ - The account (if any) the charge was made on behalf of without triggering an automatic transfer. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers) for details. + The account (if any) the charge was made on behalf of without triggering an automatic transfer. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers) for details. """ outcome: Optional[Outcome] """ - Details about whether the payment was accepted, and why. See [understanding declines](https://stripe.com/docs/declines) for details. + Details about whether the payment was accepted, and why. See [understanding declines](https://docs.stripe.com/declines) for details. """ paid: bool """ @@ -2460,7 +2486,7 @@ class TransferData(StripeObject): presentment_details: Optional[PresentmentDetails] radar_options: Optional[RadarOptions] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ receipt_email: Optional[str] """ @@ -2518,11 +2544,11 @@ class TransferData(StripeObject): """ transfer_data: Optional[TransferData] """ - An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://stripe.com/docs/connect/destination-charges) for details. + An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://docs.stripe.com/connect/destination-charges) for details. """ transfer_group: Optional[str] """ - A string that identifies this transaction as part of a group. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details. + A string that identifies this transaction as part of a group. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details. """ @classmethod diff --git a/stripe/_confirmation_token.py b/stripe/_confirmation_token.py index 1be116035..bdcc75018 100644 --- a/stripe/_confirmation_token.py +++ b/stripe/_confirmation_token.py @@ -26,8 +26,8 @@ class ConfirmationToken(APIResource["ConfirmationToken"]): is successful, values present on the ConfirmationToken are written onto the Intent. To learn more about how to use ConfirmationToken, visit the related guides: - - [Finalize payments on the server](https://stripe.com/docs/payments/finalize-payments-on-the-server) - - [Build two-step confirmation](https://stripe.com/docs/payments/build-a-two-step-confirmation). + - [Finalize payments on the server](https://docs.stripe.com/payments/finalize-payments-on-the-server) + - [Build two-step confirmation](https://docs.stripe.com/payments/build-a-two-step-confirmation). """ OBJECT_NAME: ClassVar[Literal["confirmation_token"]] = "confirmation_token" @@ -197,7 +197,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -372,7 +372,7 @@ class Wallet(StripeObject): """ incremental_authorization_supported: bool """ - Whether this [PaymentIntent](https://stripe.com/docs/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). + Whether this [PaymentIntent](https://docs.stripe.com/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). """ issuer: Optional[str] """ @@ -501,7 +501,7 @@ class BillingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class ShippingAddress(StripeObject): @@ -527,7 +527,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ billing_address: Optional[BillingAddress] @@ -578,7 +578,7 @@ class BillingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class ShippingAddress(StripeObject): @@ -604,7 +604,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ billing_address: Optional[BillingAddress] @@ -961,6 +961,7 @@ class Ideal(StripeObject): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -974,7 +975,7 @@ class Ideal(StripeObject): ] ] """ - The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. + The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `mollie`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. """ bic: Optional[ Literal[ @@ -988,6 +989,7 @@ class Ideal(StripeObject): "HANDNL2A", "INGBNL2A", "KNABNL2H", + "MLLENL2A", "MOYONL21", "NNBANL2G", "NTSBDEB1", @@ -1707,7 +1709,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -1765,7 +1767,7 @@ class Address(StripeObject): """ Indicates that you intend to make future payments with this ConfirmationToken's payment method. - The presence of this property will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. + The presence of this property will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. """ setup_intent: Optional[str] """ diff --git a/stripe/_coupon.py b/stripe/_coupon.py index 7fc819f5f..7bf7e6a19 100644 --- a/stripe/_coupon.py +++ b/stripe/_coupon.py @@ -27,8 +27,8 @@ class Coupon( ): """ A coupon contains information about a percent-off or amount-off discount you - might want to apply to a customer. Coupons may be applied to [subscriptions](https://stripe.com/docs/api#subscriptions), [invoices](https://stripe.com/docs/api#invoices), - [checkout sessions](https://stripe.com/docs/api/checkout/sessions), [quotes](https://stripe.com/docs/api#quotes), and more. Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge) or [payment intents](https://stripe.com/docs/api/payment_intents). + might want to apply to a customer. Coupons may be applied to [subscriptions](https://api.stripe.com#subscriptions), [invoices](https://api.stripe.com#invoices), + [checkout sessions](https://docs.stripe.com/api/checkout/sessions), [quotes](https://api.stripe.com#quotes), and more. Coupons do not work with conventional one-off [charges](https://api.stripe.com#create_charge) or [payment intents](https://docs.stripe.com/api/payment_intents). """ OBJECT_NAME: ClassVar[Literal["coupon"]] = "coupon" @@ -102,7 +102,7 @@ class Script(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: Optional[str] """ diff --git a/stripe/_credit_note.py b/stripe/_credit_note.py index 631acc50b..921d368a2 100644 --- a/stripe/_credit_note.py +++ b/stripe/_credit_note.py @@ -52,7 +52,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://docs.stripe.com/billing/invoices/credit-notes) """ OBJECT_NAME: ClassVar[Literal["credit_note"]] = "credit_note" @@ -180,6 +180,9 @@ class Tax(StripeObject): class TotalTax(StripeObject): class TaxRateDetails(StripeObject): tax_rate: str + """ + ID of the tax rate + """ amount: int """ @@ -246,7 +249,7 @@ class TaxRateDetails(StripeObject): """ customer_account: Optional[str] """ - ID of the account. + ID of the account representing the customer. """ customer_balance_transaction: Optional[ ExpandableField["CustomerBalanceTransaction"] @@ -288,7 +291,7 @@ class TaxRateDetails(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ number: str """ @@ -336,7 +339,7 @@ class TaxRateDetails(StripeObject): """ status: Literal["issued", "void"] """ - Status of this credit note, one of `issued` or `void`. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding). + Status of this credit note, one of `issued` or `void`. Learn more about [voiding credit notes](https://docs.stripe.com/billing/invoices/credit-notes#voiding). """ subtotal: int """ diff --git a/stripe/_credit_note_line_item.py b/stripe/_credit_note_line_item.py index b8f4d4cb6..826e71e7b 100644 --- a/stripe/_credit_note_line_item.py +++ b/stripe/_credit_note_line_item.py @@ -65,6 +65,9 @@ class TaxCalculationReference(StripeObject): class Tax(StripeObject): class TaxRateDetails(StripeObject): tax_rate: str + """ + ID of the tax rate + """ amount: int """ diff --git a/stripe/_customer.py b/stripe/_customer.py index 435766419..5c3e48163 100644 --- a/stripe/_customer.py +++ b/stripe/_customer.py @@ -127,7 +127,7 @@ class Customer( UpdateableAPIResource["Customer"], ): """ - This object represents a customer of your business. Use it to [create recurring charges](https://stripe.com/docs/invoicing/customer), [save payment](https://stripe.com/docs/payments/save-during-payment) and contact information, + This object represents a customer of your business. Use it to [create recurring charges](https://docs.stripe.com/invoicing/customer), [save payment](https://docs.stripe.com/payments/save-during-payment) and contact information, and track payments that belong to the same customer. """ @@ -156,7 +156,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class InvoiceSettings(StripeObject): @@ -225,7 +225,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -293,7 +293,7 @@ class Location(StripeObject): """ balance: Optional[int] """ - The current balance, if any, that's stored on the customer in their default currency. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that's added to their next invoice. The balance only considers amounts that Stripe hasn't successfully applied to any invoice. It doesn't reflect unpaid invoices. This balance is only taken into account after invoices finalize. For multi-currency balances, see [invoice_credit_balance](https://stripe.com/docs/api/customers/object#customer_object-invoice_credit_balance). + The current balance, if any, that's stored on the customer in their default currency. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that's added to their next invoice. The balance only considers amounts that Stripe hasn't successfully applied to any invoice. It doesn't reflect unpaid invoices. This balance is only taken into account after invoices finalize. For multi-currency balances, see [invoice_credit_balance](https://docs.stripe.com/api/customers/object#customer_object-invoice_credit_balance). """ business_name: Optional[str] """ @@ -312,13 +312,16 @@ class Location(StripeObject): Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) the customer can be charged in for recurring billing purposes. """ customer_account: Optional[str] + """ + The ID of an Account representing a customer. You can use this ID with any v1 API that accepts a customer_account parameter. + """ default_source: Optional[ ExpandableField[Union["Account", "BankAccount", "Card", "Source"]] ] """ ID of the default payment source for the customer. - If you use payment methods created through the PaymentMethods API, see the [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) field instead. + If you use payment methods created through the PaymentMethods API, see the [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) field instead. """ deleted: Optional[Literal[True]] """ @@ -328,7 +331,7 @@ class Location(StripeObject): """ Tracks the most recent state change on any invoice belonging to the customer. Paying an invoice or marking it uncollectible via the API will set this field to false. An automatic payment failure or passing the `invoice.due_date` will set this field to `true`. - If an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`. + If an invoice becomes uncollectible by [dunning](https://docs.stripe.com/billing/automatic-collection), `delinquent` doesn't reset to `false`. If you care whether the customer has paid their most recent subscription invoice, use `subscription.status` instead. Paying or marking uncollectible any customer invoice regardless of whether it is the latest invoice for a subscription will always set this field to `false`. """ @@ -367,7 +370,7 @@ class Location(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: Optional[str] """ diff --git a/stripe/_customer_balance_transaction.py b/stripe/_customer_balance_transaction.py index b502e98fa..dafe4b81b 100644 --- a/stripe/_customer_balance_transaction.py +++ b/stripe/_customer_balance_transaction.py @@ -15,12 +15,12 @@ class CustomerBalanceTransaction(APIResource["CustomerBalanceTransaction"]): """ - Each customer has a [Balance](https://stripe.com/docs/api/customers/object#customer_object-balance) value, + Each customer has a [Balance](https://docs.stripe.com/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), + You may modify the value directly by using the [update customer API](https://docs.stripe.com/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) + Related guide: [Customer balance](https://docs.stripe.com/billing/customer/balance) """ OBJECT_NAME: ClassVar[Literal["customer_balance_transaction"]] = ( @@ -51,6 +51,9 @@ class CustomerBalanceTransaction(APIResource["CustomerBalanceTransaction"]): The ID of the customer the transaction belongs to. """ customer_account: Optional[str] + """ + The ID of an Account representing a customer that the transaction belongs to. + """ description: Optional[str] """ An arbitrary string attached to the object. Often useful for displaying to users. @@ -73,7 +76,7 @@ class CustomerBalanceTransaction(APIResource["CustomerBalanceTransaction"]): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["customer_balance_transaction"] """ @@ -94,7 +97,7 @@ class CustomerBalanceTransaction(APIResource["CustomerBalanceTransaction"]): "unspent_receiver_credit", ] """ - Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_overpaid`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, `unapplied_from_invoice`, `checkout_session_subscription_payment`, or `checkout_session_subscription_payment_canceled`. See the [Customer Balance page](https://stripe.com/docs/billing/customer/balance#types) to learn more about transaction types. + Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_overpaid`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, `unapplied_from_invoice`, `checkout_session_subscription_payment`, or `checkout_session_subscription_payment_canceled`. See the [Customer Balance page](https://docs.stripe.com/billing/customer/balance#types) to learn more about transaction types. """ def instance_url(self): diff --git a/stripe/_customer_cash_balance_transaction.py b/stripe/_customer_cash_balance_transaction.py index 573464ecf..e2aba6550 100644 --- a/stripe/_customer_cash_balance_transaction.py +++ b/stripe/_customer_cash_balance_transaction.py @@ -27,17 +27,17 @@ class CustomerCashBalanceTransaction(StripeObject): class AdjustedForOverdraft(StripeObject): balance_transaction: ExpandableField["BalanceTransaction"] """ - The [Balance Transaction](https://stripe.com/docs/api/balance_transactions/object) that corresponds to funds taken out of your Stripe balance. + The [Balance Transaction](https://docs.stripe.com/api/balance_transactions/object) that corresponds to funds taken out of your Stripe balance. """ linked_transaction: ExpandableField["CustomerCashBalanceTransaction"] """ - The [Cash Balance Transaction](https://stripe.com/docs/api/cash_balance_transactions/object) that brought the customer balance negative, triggering the clawback of funds. + The [Cash Balance Transaction](https://docs.stripe.com/api/cash_balance_transactions/object) that brought the customer balance negative, triggering the clawback of funds. """ class AppliedToPayment(StripeObject): payment_intent: ExpandableField["PaymentIntent"] """ - The [Payment Intent](https://stripe.com/docs/api/payment_intents/object) that funds were applied to. + The [Payment Intent](https://docs.stripe.com/api/payment_intents/object) that funds were applied to. """ class Funded(StripeObject): @@ -125,19 +125,19 @@ class UsBankTransfer(StripeObject): class RefundedFromPayment(StripeObject): refund: ExpandableField["Refund"] """ - The [Refund](https://stripe.com/docs/api/refunds/object) that moved these funds into the customer's cash balance. + The [Refund](https://docs.stripe.com/api/refunds/object) that moved these funds into the customer's cash balance. """ class TransferredToBalance(StripeObject): balance_transaction: ExpandableField["BalanceTransaction"] """ - The [Balance Transaction](https://stripe.com/docs/api/balance_transactions/object) that corresponds to funds transferred to your Stripe balance. + The [Balance Transaction](https://docs.stripe.com/api/balance_transactions/object) that corresponds to funds transferred to your Stripe balance. """ class UnappliedFromPayment(StripeObject): payment_intent: ExpandableField["PaymentIntent"] """ - The [Payment Intent](https://stripe.com/docs/api/payment_intents/object) that funds were unapplied from. + The [Payment Intent](https://docs.stripe.com/api/payment_intents/object) that funds were unapplied from. """ adjusted_for_overdraft: Optional[AdjustedForOverdraft] @@ -155,9 +155,12 @@ class UnappliedFromPayment(StripeObject): The customer whose available cash balance changed as a result of this transaction. """ customer_account: Optional[str] + """ + The ID of an Account representing a customer whose available cash balance changed as a result of this transaction. + """ ending_balance: int """ - The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ funded: Optional[Funded] id: str @@ -170,7 +173,7 @@ class UnappliedFromPayment(StripeObject): """ net_amount: int """ - The amount by which the cash balance changed, represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance. + The amount by which the cash balance changed, represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance. """ object: Literal["customer_cash_balance_transaction"] """ @@ -190,7 +193,7 @@ class UnappliedFromPayment(StripeObject): "unapplied_from_payment", ] """ - The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://stripe.com/docs/payments/customer-balance#types) to learn more about these types. + The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://docs.stripe.com/payments/customer-balance#types) to learn more about these types. """ unapplied_from_payment: Optional[UnappliedFromPayment] _inner_class_types = { diff --git a/stripe/_discount.py b/stripe/_discount.py index 6a5f2c92a..1637edc79 100644 --- a/stripe/_discount.py +++ b/stripe/_discount.py @@ -13,10 +13,10 @@ class Discount(StripeObject): """ - A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). + A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. - Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts) + Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts) """ OBJECT_NAME: ClassVar[Literal["discount"]] = "discount" @@ -41,7 +41,7 @@ class Source(StripeObject): """ customer_account: Optional[str] """ - The ID of the account associated with this discount. + The ID of the account representing the customer associated with this discount. """ deleted: Optional[Literal[True]] """ diff --git a/stripe/_dispute.py b/stripe/_dispute.py index 3a88f8922..71f056937 100644 --- a/stripe/_dispute.py +++ b/stripe/_dispute.py @@ -28,7 +28,7 @@ class Dispute( When this happens, you have the opportunity to respond to the dispute with evidence that shows that the charge is legitimate. - Related guide: [Disputes and fraud](https://stripe.com/docs/disputes) + Related guide: [Disputes and fraud](https://docs.stripe.com/disputes) """ OBJECT_NAME: ClassVar[Literal["dispute"]] = "dispute" @@ -60,7 +60,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ customer_account_id: Optional[str] @@ -123,7 +123,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ charge: str @@ -482,7 +482,7 @@ class SmartDisputes(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ network_reason_code: Optional[str] """ @@ -499,7 +499,7 @@ class SmartDisputes(StripeObject): payment_method_details: Optional[PaymentMethodDetails] reason: str """ - Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://stripe.com/docs/disputes/categories). + Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `noncompliant`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Learn more about [dispute reasons](https://docs.stripe.com/disputes/categories). """ smart_disputes: Optional[SmartDisputes] status: Literal[ diff --git a/stripe/_ephemeral_key.py b/stripe/_ephemeral_key.py index 830e86b51..3b7d0b66b 100644 --- a/stripe/_ephemeral_key.py +++ b/stripe/_ephemeral_key.py @@ -141,16 +141,43 @@ async def delete_async( # pyright: ignore[reportGeneralTypeIssues] ) @classmethod - def create(cls, **params): + def create(cls, **params) -> "EphemeralKey": + """ + Creates a short-lived API key for a given resource. + """ if params.get("stripe_version") is None: raise ValueError( "stripe_version must be specified to create an ephemeral key" ) url = cls.class_url() - return cls._static_request( - "post", - url, - params=params, - base_address="api", + return cast( + "EphemeralKey", + cls._static_request( + "post", + url, + params=params, + base_address="api", + ), + ) + + @classmethod + async def create_async(cls, **params) -> "EphemeralKey": + """ + Creates a short-lived API key for a given resource. + """ + if params.get("stripe_version") is None: + raise ValueError( + "stripe_version must be specified to create an ephemeral key" + ) + + url = cls.class_url() + return cast( + "EphemeralKey", + await cls._static_request_async( + "post", + url, + params=params, + base_address="api", + ), ) diff --git a/stripe/_error.py b/stripe/_error.py index 145e0783f..ecba79e36 100644 --- a/stripe/_error.py +++ b/stripe/_error.py @@ -200,6 +200,10 @@ class BlockedByStripeError(StripeError): pass +class ControlledByAlternateResourceError(StripeError): + pass + + class ControlledByDashboardError(StripeError): pass diff --git a/stripe/_event.py b/stripe/_event.py index 47b561f2a..f13013153 100644 --- a/stripe/_event.py +++ b/stripe/_event.py @@ -39,7 +39,7 @@ class Event(ListableAPIResource["Event"]): class Data(StripeObject): object: Dict[str, "Any"] """ - Object containing the API resource relevant to the event. For example, an `invoice.created` event will have a full [invoice object](https://stripe.com/docs/api#invoice_object) as the value of the object key. + Object containing the API resource relevant to the event. For example, an `invoice.created` event will have a full [invoice object](https://api.stripe.com#invoice_object) as the value of the object key. """ previous_attributes: Optional[Dict[str, "Any"]] """ diff --git a/stripe/_exchange_rate.py b/stripe/_exchange_rate.py index 4e7bdfff4..1414c522f 100644 --- a/stripe/_exchange_rate.py +++ b/stripe/_exchange_rate.py @@ -23,13 +23,13 @@ class ExchangeRate(ListableAPIResource["ExchangeRate"]): rate (for example, to dynamically price an item for a user with a default payment in a foreign currency). - Please refer to our [Exchange Rates API](https://stripe.com/docs/fx-rates) guide for more details. + Please refer to our [Exchange Rates API](https://docs.stripe.com/fx-rates) guide for more details. *[Note: this integration path is supported but no longer recommended]* Additionally, you can guarantee that a charge is made with an exchange rate that you expect is current. To do so, you must pass in the exchange_rate to charges endpoints. If the value is no longer up to date, the charge won't go through. Please refer to our - [Using with charges](https://stripe.com/docs/exchange-rates) guide for more details. + [Using with charges](https://docs.stripe.com/exchange-rates) guide for more details. ----- diff --git a/stripe/_file.py b/stripe/_file.py index 78a817632..c20e8ec31 100644 --- a/stripe/_file.py +++ b/stripe/_file.py @@ -16,12 +16,12 @@ class File(CreateableAPIResource["File"], ListableAPIResource["File"]): """ This object represents files hosted on Stripe's servers. You can upload - files with the [create file](https://stripe.com/docs/api#create_file) request + files with the [create file](https://api.stripe.com#create_file) request (for example, when uploading dispute evidence). Stripe also creates files independently (for example, the results of a [Sigma scheduled query](https://docs.stripe.com/api#scheduled_queries)). - Related guide: [File upload guide](https://stripe.com/docs/file-upload) + Related guide: [File upload guide](https://docs.stripe.com/file-upload) """ OBJECT_NAME: ClassVar[Literal["file"]] = "file" @@ -43,7 +43,7 @@ class File(CreateableAPIResource["File"], ListableAPIResource["File"]): """ links: Optional[ListObject["FileLink"]] """ - A list of [file links](https://stripe.com/docs/api#file_links) that point at this file. + A list of [file links](https://api.stripe.com#file_links) that point at this file. """ object: Literal["file"] """ @@ -71,7 +71,7 @@ class File(CreateableAPIResource["File"], ListableAPIResource["File"]): "terminal_reader_splashscreen", ] """ - The [purpose](https://stripe.com/docs/file-upload#uploading-a-file) of the uploaded file. + The [purpose](https://docs.stripe.com/file-upload#uploading-a-file) of the uploaded file. """ size: int """ diff --git a/stripe/_file_link.py b/stripe/_file_link.py index d72e14894..620bede1d 100644 --- a/stripe/_file_link.py +++ b/stripe/_file_link.py @@ -55,7 +55,7 @@ class FileLink( """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["file_link"] """ diff --git a/stripe/_funding_instructions.py b/stripe/_funding_instructions.py index 2ca103b74..5e7841e77 100644 --- a/stripe/_funding_instructions.py +++ b/stripe/_funding_instructions.py @@ -7,11 +7,11 @@ class FundingInstructions(StripeObject): """ - Each customer has a [`balance`](https://stripe.com/docs/api/customers/object#customer_object-balance) that is + Each customer has a [`balance`](https://docs.stripe.com/api/customers/object#customer_object-balance) that is 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) + Related guide: [Customer balance funding instructions](https://docs.stripe.com/payments/customer-balance/funding-instructions) """ OBJECT_NAME: ClassVar[Literal["funding_instructions"]] = ( @@ -44,7 +44,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -70,7 +70,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -124,7 +124,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -150,7 +150,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -200,7 +200,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -226,7 +226,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -272,7 +272,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -298,7 +298,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -348,7 +348,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -374,7 +374,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -428,7 +428,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -454,7 +454,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress diff --git a/stripe/_invoice.py b/stripe/_invoice.py index 5f31a991e..61e81e0c4 100644 --- a/stripe/_invoice.py +++ b/stripe/_invoice.py @@ -93,13 +93,13 @@ class Invoice( 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](https://stripe.com/docs/api#invoiceitems), and proration adjustments + They contain [invoice items](https://api.stripe.com#invoiceitems), 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](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection), does + [when automatic](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection), 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 @@ -119,9 +119,9 @@ class Invoice( customer's credit balance which is applied to the next invoice. More details on the customer's credit balance are - [here](https://stripe.com/docs/billing/customer/balance). + [here](https://docs.stripe.com/billing/customer/balance). - Related guide: [Send invoices to customers](https://stripe.com/docs/billing/invoices/sending) + Related guide: [Send invoices to customers](https://docs.stripe.com/billing/invoices/sending) """ OBJECT_NAME: ClassVar[Literal["invoice"]] = "invoice" @@ -182,7 +182,7 @@ class Liability(StripeObject): """ enabled: bool """ - Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. + Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. """ liability: Optional[Liability] """ @@ -243,7 +243,7 @@ class CustomerAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class CustomerShipping(StripeObject): @@ -270,7 +270,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -437,7 +437,7 @@ class Issuer(StripeObject): class LastFinalizationError(StripeObject): advice_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://stripe.com/docs/declines#retrying-issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines) if they provide one. """ charge: Optional[str] """ @@ -451,6 +451,7 @@ class LastFinalizationError(StripeObject): "account_information_mismatch", "account_invalid", "account_number_invalid", + "account_token_required_for_v2_account", "acss_debit_session_incomplete", "alipay_upgrade_required", "amount_too_large", @@ -634,15 +635,15 @@ class LastFinalizationError(StripeObject): ] ] """ - For some errors that could be handled programmatically, a short string indicating the [error code](https://stripe.com/docs/error-codes) reported. + For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported. """ decline_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://stripe.com/docs/declines#issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://docs.stripe.com/declines#issuer-declines) if they provide one. """ doc_url: Optional[str] """ - A URL to more information about the [error code](https://stripe.com/docs/error-codes) reported. + A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported. """ message: Optional[str] """ @@ -668,19 +669,19 @@ class LastFinalizationError(StripeObject): see the history of payment attempts for a particular session. A PaymentIntent transitions through - [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses) + [multiple statuses](https://docs.stripe.com/payments/paymentintents/lifecycle) 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://docs.stripe.com/payments/payment-intents) """ payment_method: Optional["PaymentMethod"] """ PaymentMethod objects represent your customer's payment instruments. - You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to + You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. - Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios). + Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios). """ payment_method_type: Optional[str] """ @@ -694,7 +695,7 @@ class LastFinalizationError(StripeObject): """ 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](https://stripe.com/docs/api#payment_intents) to drive the payment flow. + Later, you can use [PaymentIntents](https://api.stripe.com#payment_intents) 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. @@ -705,9 +706,9 @@ class LastFinalizationError(StripeObject): For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents). - If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer), + If you use the SetupIntent with a [Customer](https://api.stripe.com#setup_intent_object-customer), it automatically attaches the resulting payment method to that Customer after successful setup. - We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on + We recommend using SetupIntents or [setup_future_usage](https://api.stripe.com#payment_intent_object-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. @@ -755,12 +756,12 @@ class PauseCollection(StripeObject): metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) 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.* """ pause_collection: Optional[PauseCollection] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ subscription: ExpandableField["Subscription"] """ @@ -832,7 +833,7 @@ class Installments(StripeObject): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ _inner_class_types = {"installments": Installments} @@ -864,6 +865,38 @@ class IdBankTransfer(StripeObject): class Konbini(StripeObject): pass + class Payto(StripeObject): + class MandateOptions(StripeObject): + amount: Optional[int] + """ + 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: Optional[Literal["fixed", "maximum"]] + """ + Only `maximum` is supported. + """ + purpose: Optional[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + mandate_options: Optional[MandateOptions] + _inner_class_types = {"mandate_options": MandateOptions} + class Pix(StripeObject): amount_includes_iof: Optional[Literal["always", "never"]] """ @@ -973,6 +1006,10 @@ class Filters(StripeObject): """ If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: Optional[Payto] + """ + If paying by `payto`, this sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: Optional[Pix] """ If paying by `pix`, this sub-hash contains details about the Pix payment method options to pass to the invoice's PaymentIntent. @@ -996,6 +1033,7 @@ class Filters(StripeObject): "customer_balance": CustomerBalance, "id_bank_transfer": IdBankTransfer, "konbini": Konbini, + "payto": Payto, "pix": Pix, "sepa_debit": SepaDebit, "upi": Upi, @@ -1046,6 +1084,7 @@ class Filters(StripeObject): "payco", "paynow", "paypal", + "payto", "pix", "promptpay", "revolut_pay", @@ -1175,7 +1214,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -1283,6 +1322,9 @@ class TotalPretaxCreditAmount(StripeObject): class TotalTax(StripeObject): class TaxRateDetails(StripeObject): tax_rate: str + """ + ID of the tax rate + """ amount: int """ @@ -1377,7 +1419,7 @@ class TaxRateDetails(StripeObject): """ auto_advance: Optional[bool] """ - Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. + Controls whether Stripe performs [automatic collection](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. """ automatic_tax: AutomaticTax automatically_finalizes_at: Optional[int] @@ -1430,11 +1472,11 @@ class TaxRateDetails(StripeObject): """ customer: Optional[ExpandableField["Customer"]] """ - The ID of the customer who will be billed. + The ID of the customer to bill. """ customer_account: Optional[str] """ - The ID of the account who will be billed. + The ID of the account representing the customer to bill. """ customer_address: Optional[CustomerAddress] """ @@ -1514,7 +1556,7 @@ class TaxRateDetails(StripeObject): """ from_invoice: Optional[FromInvoice] """ - Details of the invoice that was cloned. See the [revision documentation](https://stripe.com/docs/invoicing/invoice-revisions) for more details. + Details of the invoice that was cloned. See the [revision documentation](https://docs.stripe.com/invoicing/invoice-revisions) for more details. """ hosted_invoice_url: Optional[str] """ @@ -1547,7 +1589,7 @@ class TaxRateDetails(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ next_payment_attempt: Optional[int] """ @@ -1563,7 +1605,7 @@ class TaxRateDetails(StripeObject): """ on_behalf_of: Optional[ExpandableField["Account"]] """ - 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](https://stripe.com/docs/billing/invoices/connect) documentation for details. + 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](https://docs.stripe.com/billing/invoices/connect) documentation for details. """ parent: Optional[Parent] """ @@ -1616,7 +1658,7 @@ class TaxRateDetails(StripeObject): """ status: Optional[Literal["draft", "open", "paid", "uncollectible", "void"]] """ - The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://stripe.com/docs/billing/invoices/workflow#workflow-overview) + The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://docs.stripe.com/billing/invoices/workflow#workflow-overview) """ status_transitions: StatusTransitions subtotal: int @@ -1658,7 +1700,7 @@ class TaxRateDetails(StripeObject): """ webhooks_delivered_at: Optional[int] """ - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have [been exhausted](https://stripe.com/docs/billing/webhooks#understand). 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. + Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have [been exhausted](https://docs.stripe.com/billing/webhooks#understand). 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. """ @classmethod diff --git a/stripe/_invoice_item.py b/stripe/_invoice_item.py index d329c6572..e97100c56 100644 --- a/stripe/_invoice_item.py +++ b/stripe/_invoice_item.py @@ -16,6 +16,7 @@ from stripe._discount import Discount from stripe._invoice import Invoice from stripe._margin import Margin + from stripe._price import Price from stripe._tax_rate import TaxRate from stripe.params._invoice_item_create_params import ( InvoiceItemCreateParams, @@ -40,14 +41,14 @@ class InvoiceItem( UpdateableAPIResource["InvoiceItem"], ): """ - Invoice Items represent the component lines of an [invoice](https://stripe.com/docs/api/invoices). When you create an invoice item with an `invoice` field, it is attached to the specified invoice and included as [an invoice line item](https://stripe.com/docs/api/invoices/line_item) within [invoice.lines](https://stripe.com/docs/api/invoices/object#invoice_object-lines). + Invoice Items represent the component lines of an [invoice](https://docs.stripe.com/api/invoices). When you create an invoice item with an `invoice` field, it is attached to the specified invoice and included as [an invoice line item](https://docs.stripe.com/api/invoices/line_item) within [invoice.lines](https://docs.stripe.com/api/invoices/object#invoice_object-lines). Invoice Items can be created before you are ready to actually send the invoice. This can be particularly useful when combined - with a [subscription](https://stripe.com/docs/api/subscriptions). Sometimes you want to add a charge or credit to a customer, but actually charge + with a [subscription](https://docs.stripe.com/api/subscriptions). Sometimes you want to add a charge or credit to a customer, but actually charge or credit the customer's card only at the end of a regular billing cycle. This is useful for combining several charges (to minimize per-transaction fees), or for having Stripe tabulate your usage-based billing totals. - Related guides: [Integrate with the Invoicing API](https://stripe.com/docs/invoicing/integration), [Subscription Invoices](https://stripe.com/docs/billing/invoices/subscription#adding-upcoming-invoice-items). + Related guides: [Integrate with the Invoicing API](https://docs.stripe.com/invoicing/integration), [Subscription Invoices](https://docs.stripe.com/billing/invoices/subscription#adding-upcoming-invoice-items). """ OBJECT_NAME: ClassVar[Literal["invoiceitem"]] = "invoiceitem" @@ -85,7 +86,7 @@ class Period(StripeObject): class Pricing(StripeObject): class PriceDetails(StripeObject): - price: str + price: ExpandableField["Price"] """ The ID of the price this item is associated with. """ @@ -132,11 +133,11 @@ class DiscountAmount(StripeObject): """ customer: ExpandableField["Customer"] """ - The ID of the customer who will be billed when this invoice item is billed. + The ID of the customer to bill for this invoice item. """ customer_account: Optional[str] """ - The ID of the account who will be billed when this invoice item is billed. + The ID of the account to bill for this invoice item. """ date: int """ @@ -176,7 +177,7 @@ class DiscountAmount(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ net_amount: Optional[int] """ diff --git a/stripe/_invoice_line_item.py b/stripe/_invoice_line_item.py index dd276c973..94255477c 100644 --- a/stripe/_invoice_line_item.py +++ b/stripe/_invoice_line_item.py @@ -10,6 +10,7 @@ if TYPE_CHECKING: from stripe._discount import Discount from stripe._margin import Margin + from stripe._price import Price from stripe._subscription import Subscription from stripe.billing._credit_balance_transaction import ( CreditBalanceTransaction, @@ -18,9 +19,9 @@ class InvoiceLineItem(UpdateableAPIResource["InvoiceLineItem"]): """ - Invoice Line Items represent the individual lines within an [invoice](https://stripe.com/docs/api/invoices) and only exist within the context of an invoice. + Invoice Line Items represent the individual lines within an [invoice](https://docs.stripe.com/api/invoices) and only exist within the context of an invoice. - Each line item is backed by either an [invoice item](https://stripe.com/docs/api/invoiceitems) or a [subscription item](https://stripe.com/docs/api/subscription_items). + Each line item is backed by either an [invoice item](https://docs.stripe.com/api/invoiceitems) or a [subscription item](https://docs.stripe.com/api/subscription_items). """ OBJECT_NAME: ClassVar[Literal["line_item"]] = "line_item" @@ -175,7 +176,7 @@ class PretaxCreditAmount(StripeObject): class Pricing(StripeObject): class PriceDetails(StripeObject): - price: str + price: ExpandableField["Price"] """ The ID of the price this item is associated with. """ @@ -208,6 +209,9 @@ class TaxCalculationReference(StripeObject): class Tax(StripeObject): class TaxRateDetails(StripeObject): tax_rate: str + """ + ID of the tax rate + """ amount: int """ @@ -298,7 +302,7 @@ class TaxRateDetails(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Note that for line items with `type=subscription`, `metadata` reflects the current metadata from the subscription associated with the line item, unless the invoice line was directly updated with different metadata after creation. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Note that for line items with `type=subscription`, `metadata` reflects the current metadata from the subscription associated with the line item, unless the invoice line was directly updated with different metadata after creation. """ object: Literal["line_item"] """ @@ -322,6 +326,10 @@ class TaxRateDetails(StripeObject): The quantity of the subscription, if the line item is a subscription or a proration. """ subscription: Optional[ExpandableField["Subscription"]] + subtotal: int + """ + The subtotal of the line item, in cents (or local equivalent), before any discounts or taxes. + """ tax_calculation_reference: Optional[TaxCalculationReference] """ The tax calculation identifiers of the line item. diff --git a/stripe/_invoice_payment.py b/stripe/_invoice_payment.py index a66e08069..2ae5a43a2 100644 --- a/stripe/_invoice_payment.py +++ b/stripe/_invoice_payment.py @@ -24,7 +24,7 @@ class InvoicePayment(ListableAPIResource["InvoicePayment"]): """ Invoice Payments represent payments made against invoices. Invoice Payments can be accessed in two ways: - 1. By expanding the `payments` field on the [Invoice](https://stripe.com/docs/api#invoice) resource. + 1. By expanding the `payments` field on the [Invoice](https://api.stripe.com#invoice) resource. 2. By using the Invoice Payment retrieve and list endpoints. Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices. diff --git a/stripe/_invoice_rendering_template.py b/stripe/_invoice_rendering_template.py index 93965201c..3991ec483 100644 --- a/stripe/_invoice_rendering_template.py +++ b/stripe/_invoice_rendering_template.py @@ -46,7 +46,7 @@ class InvoiceRenderingTemplate( """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ nickname: Optional[str] """ diff --git a/stripe/_line_item.py b/stripe/_line_item.py index 582a837c4..fda967a9d 100644 --- a/stripe/_line_item.py +++ b/stripe/_line_item.py @@ -31,10 +31,10 @@ class Discount(StripeObject): """ discount: "DiscountResource" """ - A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). + A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. - Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts) + Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts) """ class Display(StripeObject): @@ -126,7 +126,7 @@ class Tax(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["item"] """ diff --git a/stripe/_login_link.py b/stripe/_login_link.py index d3cc679d6..cbe2ae3cb 100644 --- a/stripe/_login_link.py +++ b/stripe/_login_link.py @@ -8,7 +8,7 @@ class LoginLink(StripeObject): """ Login Links are single-use URLs that takes an Express account to the login page for their Stripe dashboard. - A Login Link differs from an [Account Link](https://stripe.com/docs/api/account_links) in that it takes the user directly to their [Express dashboard for the specified account](https://stripe.com/docs/connect/integrate-express-dashboard#create-login-link) + A Login Link differs from an [Account Link](https://docs.stripe.com/api/account_links) in that it takes the user directly to their [Express dashboard for the specified account](https://docs.stripe.com/connect/integrate-express-dashboard#create-login-link) """ OBJECT_NAME: ClassVar[Literal["login_link"]] = "login_link" diff --git a/stripe/_margin.py b/stripe/_margin.py index d9b2e14ea..4274d6974 100644 --- a/stripe/_margin.py +++ b/stripe/_margin.py @@ -44,7 +44,7 @@ class Margin( """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: Optional[str] """ diff --git a/stripe/_object_classes.py b/stripe/_object_classes.py index f9829c366..b82e71fed 100644 --- a/stripe/_object_classes.py +++ b/stripe/_object_classes.py @@ -266,6 +266,9 @@ "refund": ("stripe._refund", "Refund"), "reporting.report_run": ("stripe.reporting._report_run", "ReportRun"), "reporting.report_type": ("stripe.reporting._report_type", "ReportType"), + "reserve.hold": ("stripe.reserve._hold", "Hold"), + "reserve.plan": ("stripe.reserve._plan", "Plan"), + "reserve.release": ("stripe.reserve._release", "Release"), "reserve_transaction": ( "stripe._reserve_transaction", "ReserveTransaction", diff --git a/stripe/_order.py b/stripe/_order.py index 0dbf7f649..fec2f9f49 100644 --- a/stripe/_order.py +++ b/stripe/_order.py @@ -82,7 +82,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -175,9 +175,9 @@ class AfterpayClearpay(StripeObject): """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -227,9 +227,9 @@ class Card(StripeObject): """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -616,7 +616,7 @@ class TransferData(StripeObject): ] ] """ - The list of [payment method types](https://stripe.com/docs/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). + The list of [payment method types](https://docs.stripe.com/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). """ return_url: Optional[str] """ @@ -750,7 +750,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -909,10 +909,10 @@ class Discount(StripeObject): """ discount: "DiscountResource" """ - A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). + A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. - Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts) + Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts) """ class Tax(StripeObject): @@ -980,11 +980,11 @@ class Tax(StripeObject): amount_subtotal: int """ - Order cost before any discounts or taxes are applied. A positive integer representing the subtotal of the order in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). + Order cost before any discounts or taxes are applied. A positive integer representing the subtotal of the order in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). """ amount_total: int """ - Total order cost after discounts and taxes are applied. A positive integer representing the cost of the order in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). To submit an order, the total must be either 0 or at least $0.50 USD or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). + Total order cost after discounts and taxes are applied. A positive integer representing the cost of the order in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). To submit an order, the total must be either 0 or at least $0.50 USD or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). """ application: Optional[ExpandableField["Application"]] """ @@ -1001,7 +1001,7 @@ class Tax(StripeObject): The client secret can be used to complete a payment for an Order from your frontend. It should not be stored, logged, embedded in URLs, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret. - Refer to our docs for [creating and processing an order](https://stripe.com/docs/orders-beta/create-and-process) to learn about how client_secret should be handled. + Refer to our docs for [creating and processing an order](https://docs.stripe.com/orders-beta/create-and-process) to learn about how client_secret should be handled. """ created: int """ @@ -1041,7 +1041,7 @@ class Tax(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["order"] """ diff --git a/stripe/_payment_attempt_record.py b/stripe/_payment_attempt_record.py index 4636a3773..894acec32 100644 --- a/stripe/_payment_attempt_record.py +++ b/stripe/_payment_attempt_record.py @@ -37,7 +37,7 @@ class Amount(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountAuthorized(StripeObject): @@ -47,7 +47,7 @@ class AmountAuthorized(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountCanceled(StripeObject): @@ -57,7 +57,7 @@ class AmountCanceled(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountFailed(StripeObject): @@ -67,7 +67,7 @@ class AmountFailed(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountGuaranteed(StripeObject): @@ -77,7 +77,7 @@ class AmountGuaranteed(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountRefunded(StripeObject): @@ -87,7 +87,7 @@ class AmountRefunded(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountRequested(StripeObject): @@ -97,7 +97,7 @@ class AmountRequested(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class CustomerDetails(StripeObject): @@ -168,6 +168,10 @@ class AcssDebit(StripeObject): """ Name of the bank associated with the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -192,11 +196,11 @@ class AcssDebit(StripeObject): class Affirm(StripeObject): location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ transaction_id: Optional[str] """ @@ -292,6 +296,10 @@ class AuBecsDebit(StripeObject): """ Bank-State-Branch number of the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -306,6 +314,10 @@ class AuBecsDebit(StripeObject): """ class BacsDebit(StripeObject): + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -389,7 +401,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -434,6 +446,24 @@ class Checks(StripeObject): Literal["fail", "pass", "unavailable", "unchecked"] ] + class Installments(StripeObject): + class Plan(StripeObject): + count: Optional[int] + """ + For `fixed_count` installment plans, this is the number of installment payments your customer will make to their credit card. + """ + interval: Optional[Literal["month"]] + """ + For `fixed_count` installment plans, this is the interval between installment payments your customer will make to their credit card. One of `month`. + """ + type: Literal["bonus", "fixed_count", "revolving"] + """ + Type of installment plan, one of `fixed_count`, `revolving`, or `bonus`. + """ + + plan: Optional[Plan] + _inner_class_types = {"plan": Plan} + class NetworkToken(StripeObject): used: bool """ @@ -492,6 +522,10 @@ class GooglePay(StripeObject): "google_pay": GooglePay, } + authorization_code: Optional[str] + """ + The authorization code of the payment. + """ brand: Literal[ "amex", "cartes_bancaires", @@ -521,6 +555,10 @@ class GooglePay(StripeObject): """ Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected. """ + description: Optional[str] + """ + A high-level description of the type of cards issued in this range. + """ exp_month: int """ Two-digit number representing the card's expiration month. @@ -539,6 +577,18 @@ class GooglePay(StripeObject): """ Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`. """ + iin: Optional[str] + """ + Issuer identification number of the card. + """ + installments: Optional[Installments] + """ + Installment details for this payment. + """ + issuer: Optional[str] + """ + The name of the card's issuing bank. + """ last4: str """ The last four digits of the card. @@ -566,6 +616,14 @@ class GooglePay(StripeObject): """ Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`. """ + network_advice_code: Optional[str] + """ + Advice code from the card network for the failed payment. + """ + network_decline_code: Optional[str] + """ + Decline code from the card network for the failed payment. + """ network_token: Optional[NetworkToken] """ If this card has network token credentials, this contains the details of the network token credentials. @@ -574,6 +632,12 @@ class GooglePay(StripeObject): """ This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise. """ + stored_credential_usage: Optional[ + Literal["recurring", "unscheduled"] + ] + """ + The transaction type that was passed for an off-session, Merchant-Initiated transaction, one of `recurring` or `unscheduled`. + """ three_d_secure: Optional[ThreeDSecure] """ Populated if this transaction used 3D Secure authentication. @@ -584,6 +648,7 @@ class GooglePay(StripeObject): """ _inner_class_types = { "checks": Checks, + "installments": Installments, "network_token": NetworkToken, "three_d_secure": ThreeDSecure, "wallet": Wallet, @@ -708,7 +773,7 @@ class Wallet(StripeObject): """ incremental_authorization_supported: bool """ - Whether this [PaymentIntent](https://stripe.com/docs/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). + Whether this [PaymentIntent](https://docs.stripe.com/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). """ issuer: Optional[str] """ @@ -948,6 +1013,7 @@ class Ideal(StripeObject): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -961,7 +1027,7 @@ class Ideal(StripeObject): ] ] """ - The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. + The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `mollie`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. """ bic: Optional[ Literal[ @@ -975,6 +1041,7 @@ class Ideal(StripeObject): "HANDNL2A", "INGBNL2A", "KNABNL2H", + "MLLENL2A", "MOYONL21", "NNBANL2G", "NTSBDEB1", @@ -1310,6 +1377,10 @@ class NzBankAccount(StripeObject): """ The numeric code for the bank account's bank branch. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ last4: str """ Last four digits of the bank account number. @@ -1386,11 +1457,11 @@ class Payco(StripeObject): class Paynow(StripeObject): location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ reference: Optional[str] """ @@ -1435,7 +1506,7 @@ class Shipping(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class VerifiedAddress(StripeObject): @@ -1461,7 +1532,7 @@ class VerifiedAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ country: Optional[str] @@ -1653,6 +1724,10 @@ class SepaDebit(StripeObject): """ Two-letter ISO code representing the country the bank account is located in. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -1663,7 +1738,7 @@ class SepaDebit(StripeObject): """ mandate: Optional[str] """ - Find the ID of the mandate used for this payment under the [payment_method_details.sepa_debit.mandate](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-sepa_debit-mandate) property on the Charge. Use this mandate ID to [retrieve the Mandate](https://stripe.com/docs/api/mandates/retrieve). + Find the ID of the mandate used for this payment under the [payment_method_details.sepa_debit.mandate](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-sepa_debit-mandate) property on the Charge. Use this mandate ID to [retrieve the Mandate](https://docs.stripe.com/api/mandates/retrieve). """ class Shopeepay(StripeObject): @@ -1754,6 +1829,10 @@ class UsBankAccount(StripeObject): """ Name of the bank associated with the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -1785,11 +1864,11 @@ class WechatPay(StripeObject): """ location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ transaction_id: Optional[str] """ @@ -1878,7 +1957,7 @@ class Zip(StripeObject): twint: Optional[Twint] type: str """ - The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) for the full list of possible types. + The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type) for the full list of possible types. An additional hash is included on `payment_method_details` with a name matching this value. It contains information specific to the payment method. """ @@ -1998,7 +2077,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -2073,7 +2152,7 @@ class Address(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["payment_attempt_record"] """ diff --git a/stripe/_payment_intent.py b/stripe/_payment_intent.py index 7c7a4b599..22fe9a7bb 100644 --- a/stripe/_payment_intent.py +++ b/stripe/_payment_intent.py @@ -96,11 +96,11 @@ class PaymentIntent( see the history of payment attempts for a particular session. A PaymentIntent transitions through - [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses) + [multiple statuses](https://docs.stripe.com/payments/paymentintents/lifecycle) 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://docs.stripe.com/payments/payment-intents) """ OBJECT_NAME: ClassVar[Literal["payment_intent"]] = "payment_intent" @@ -109,7 +109,7 @@ class AmountDetails(StripeObject): class Shipping(StripeObject): amount: Optional[int] """ - If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0. + If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0. """ from_postal_code: Optional[str] """ @@ -123,7 +123,7 @@ class Shipping(StripeObject): class Tax(StripeObject): total_tax_amount: Optional[int] """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ @@ -136,25 +136,39 @@ class Tip(StripeObject): discount_amount: Optional[int] """ - The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field. """ line_items: Optional[ListObject["PaymentIntentAmountDetailsLineItem"]] """ - A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items. + A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items. """ shipping: Optional[Shipping] tax: Optional[Tax] tip: Optional[Tip] _inner_class_types = {"shipping": Shipping, "tax": Tax, "tip": Tip} + class AsyncWorkflows(StripeObject): + class Inputs(StripeObject): + class Tax(StripeObject): + calculation: str + """ + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id + """ + + tax: Optional[Tax] + _inner_class_types = {"tax": Tax} + + inputs: Optional[Inputs] + _inner_class_types = {"inputs": Inputs} + class AutomaticPaymentMethods(StripeObject): allow_redirects: Optional[Literal["always", "never"]] """ Controls whether this PaymentIntent will accept redirect-based payment methods. - Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://stripe.com/docs/api/payment_intents/confirm) this PaymentIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the payment. + Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://docs.stripe.com/api/payment_intents/confirm) this PaymentIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the payment. """ enabled: bool """ @@ -166,7 +180,7 @@ class Inputs(StripeObject): class Tax(StripeObject): calculation: str """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ tax: Optional[Tax] @@ -178,7 +192,7 @@ class Tax(StripeObject): class LastPaymentError(StripeObject): advice_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://stripe.com/docs/declines#retrying-issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines) if they provide one. """ charge: Optional[str] """ @@ -192,6 +206,7 @@ class LastPaymentError(StripeObject): "account_information_mismatch", "account_invalid", "account_number_invalid", + "account_token_required_for_v2_account", "acss_debit_session_incomplete", "alipay_upgrade_required", "amount_too_large", @@ -375,15 +390,15 @@ class LastPaymentError(StripeObject): ] ] """ - For some errors that could be handled programmatically, a short string indicating the [error code](https://stripe.com/docs/error-codes) reported. + For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported. """ decline_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://stripe.com/docs/declines#issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://docs.stripe.com/declines#issuer-declines) if they provide one. """ doc_url: Optional[str] """ - A URL to more information about the [error code](https://stripe.com/docs/error-codes) reported. + A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported. """ message: Optional[str] """ @@ -409,19 +424,19 @@ class LastPaymentError(StripeObject): see the history of payment attempts for a particular session. A PaymentIntent transitions through - [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses) + [multiple statuses](https://docs.stripe.com/payments/paymentintents/lifecycle) 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://docs.stripe.com/payments/payment-intents) """ payment_method: Optional["PaymentMethod"] """ PaymentMethod objects represent your customer's payment instruments. - You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to + You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. - Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios). + Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios). """ payment_method_type: Optional[str] """ @@ -435,7 +450,7 @@ class LastPaymentError(StripeObject): """ 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](https://stripe.com/docs/api#payment_intents) to drive the payment flow. + Later, you can use [PaymentIntents](https://api.stripe.com#payment_intents) 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. @@ -446,9 +461,9 @@ class LastPaymentError(StripeObject): For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents). - If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer), + If you use the SetupIntent with a [Customer](https://api.stripe.com#setup_intent_object-customer), it automatically attaches the resulting payment method to that Customer after successful setup. - We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on + We recommend using SetupIntents or [setup_future_usage](https://api.stripe.com#payment_intent_object-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. @@ -567,7 +582,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -593,7 +608,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -647,7 +662,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -673,7 +688,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -723,7 +738,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -749,7 +764,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -795,7 +810,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -821,7 +836,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -871,7 +886,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -897,7 +912,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -951,7 +966,7 @@ class AccountHolderAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class BankAddress(StripeObject): @@ -977,7 +992,7 @@ class BankAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ account_holder_address: AccountHolderAddress @@ -1507,7 +1522,7 @@ class PickupAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class ReturnAddress(StripeObject): @@ -1533,7 +1548,7 @@ class ReturnAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ affiliate: Optional[Affiliate] @@ -1660,7 +1675,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class Affiliate(StripeObject): @@ -2126,7 +2141,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -2144,7 +2159,7 @@ class Address(StripeObject): """ Installment details for this payment. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ mandate_options: Optional[MandateOptions] """ @@ -2174,27 +2189,27 @@ class Address(StripeObject): Literal["if_available", "never"] ] """ - Request ability to [decrement the authorization](https://stripe.com/docs/payments/decremental-authorization) for this PaymentIntent. + Request ability to [decrement the authorization](https://docs.stripe.com/payments/decremental-authorization) for this PaymentIntent. """ request_extended_authorization: Optional[ Literal["if_available", "never"] ] """ - Request ability to [capture beyond the standard authorization validity window](https://stripe.com/docs/payments/extended-authorization) for this PaymentIntent. + Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this PaymentIntent. """ request_incremental_authorization: Optional[ Literal["if_available", "never"] ] """ - Request ability to [increment the authorization](https://stripe.com/docs/payments/incremental-authorization) for this PaymentIntent. + Request ability to [increment the authorization](https://docs.stripe.com/payments/incremental-authorization) for this PaymentIntent. """ request_multicapture: Optional[Literal["if_available", "never"]] """ - Request ability to make [multiple captures](https://stripe.com/docs/payments/multicapture) for this PaymentIntent. + Request ability to make [multiple captures](https://docs.stripe.com/payments/multicapture) for this PaymentIntent. """ request_overcapture: Optional[Literal["if_available", "never"]] """ - Request ability to [overcapture](https://stripe.com/docs/payments/overcapture) for this PaymentIntent. + Request ability to [overcapture](https://docs.stripe.com/payments/overcapture) for this PaymentIntent. """ request_partial_authorization: Optional[ Literal["if_available", "never"] @@ -2206,7 +2221,7 @@ class Address(StripeObject): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ require_cvc_recollection: Optional[bool] """ @@ -2254,11 +2269,11 @@ class Routing(StripeObject): """ request_extended_authorization: Optional[bool] """ - Request ability to capture this payment beyond the standard [authorization validity window](https://stripe.com/docs/terminal/features/extended-authorizations#authorization-validity) + Request ability to capture this payment beyond the standard [authorization validity window](https://docs.stripe.com/terminal/features/extended-authorizations#authorization-validity) """ request_incremental_authorization_support: Optional[bool] """ - Request ability to [increment](https://stripe.com/docs/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://stripe.com/docs/api/payment_intents/confirm) response to verify support. + Request ability to [increment](https://docs.stripe.com/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://docs.stripe.com/api/payment_intents/confirm) response to verify support. """ routing: Optional[Routing] _inner_class_types = {"routing": Routing} @@ -3348,7 +3363,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -3374,7 +3389,7 @@ class TransferData(StripeObject): amount: Optional[int] """ The amount transferred to the destination account. This transfer will occur automatically after the payment succeeds. If no amount is specified, by default the entire payment amount is transferred to the destination account. - The amount must be less than or equal to the [amount](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-amount), and must be a positive integer + The amount must be less than or equal to the [amount](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-amount), and must be a positive integer representing how much to transfer in the smallest currency unit (e.g., 100 cents to charge $1.00). """ destination: ExpandableField["Account"] @@ -3384,7 +3399,7 @@ class TransferData(StripeObject): amount: int """ - Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). + Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). """ amount_capturable: int """ @@ -3401,8 +3416,9 @@ class TransferData(StripeObject): """ application_fee_amount: Optional[int] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ + async_workflows: Optional[AsyncWorkflows] automatic_payment_methods: Optional[AutomaticPaymentMethods] """ Settings to configure compatible payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods) @@ -3436,7 +3452,7 @@ class TransferData(StripeObject): The client secret can be used to complete a payment from your frontend. It should not be stored, logged, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret. - Refer to our docs to [accept a payment](https://stripe.com/docs/payments/accept-a-payment?ui=elements) and learn about how `client_secret` should be handled. + Refer to our docs to [accept a payment](https://docs.stripe.com/payments/accept-a-payment?ui=elements) and learn about how `client_secret` should be handled. """ confirmation_method: Literal["automatic", "manual"] """ @@ -3456,15 +3472,15 @@ class TransferData(StripeObject): Payment methods attached to other Customers cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. """ customer_account: Optional[str] """ - ID of the Account this PaymentIntent belongs to, if one exists. + ID of the Account representing the customer that this PaymentIntent belongs to, if one exists. Payment methods attached to other Accounts cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. """ description: Optional[str] """ @@ -3550,7 +3566,7 @@ class TransferData(StripeObject): """ latest_charge: Optional[ExpandableField["Charge"]] """ - ID of the latest [Charge object](https://stripe.com/docs/api/charges) created by this PaymentIntent. This property is `null` until PaymentIntent confirmation is attempted. + ID of the latest [Charge object](https://docs.stripe.com/api/charges) created by this PaymentIntent. This property is `null` until PaymentIntent confirmation is attempted. """ livemode: bool """ @@ -3558,7 +3574,7 @@ class TransferData(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Learn more about [storing information in metadata](https://stripe.com/docs/payments/payment-intents/creating-payment-intents#storing-information-in-metadata). + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Learn more about [storing information in metadata](https://docs.stripe.com/payments/payment-intents/creating-payment-intents#storing-information-in-metadata). """ next_action: Optional[NextAction] """ @@ -3570,7 +3586,8 @@ class TransferData(StripeObject): """ on_behalf_of: Optional[ExpandableField["Account"]] """ - The account (if any) for which the funds of the PaymentIntent are intended. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts) for details. + You can specify the settlement merchant as the + connected account using the `on_behalf_of` attribute on the charge. See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts) for details. """ payment_details: Optional[PaymentDetails] payment_method: Optional[ExpandableField["PaymentMethod"]] @@ -3581,7 +3598,7 @@ class TransferData(StripeObject): PaymentMethodConfigurationDetails ] """ - Information about the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) used for this PaymentIntent. + Information about the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) used for this PaymentIntent. """ payment_method_options: Optional[PaymentMethodOptions] """ @@ -3650,15 +3667,15 @@ class TransferData(StripeObject): "succeeded", ] """ - Status of this PaymentIntent, one of `requires_payment_method`, `requires_confirmation`, `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`. Read more about each PaymentIntent [status](https://stripe.com/docs/payments/intents#intent-statuses). + Status of this PaymentIntent, one of `requires_payment_method`, `requires_confirmation`, `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`. Read more about each PaymentIntent [status](https://docs.stripe.com/payments/intents#intent-statuses). """ transfer_data: Optional[TransferData] """ - The data that automatically creates a Transfer after the payment finalizes. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The data that automatically creates a Transfer after the payment finalizes. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ transfer_group: Optional[str] """ - A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers). + A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers). """ @classmethod @@ -5411,6 +5428,7 @@ async def list_amount_details_line_items_async( _inner_class_types = { "amount_details": AmountDetails, + "async_workflows": AsyncWorkflows, "automatic_payment_methods": AutomaticPaymentMethods, "hooks": Hooks, "last_payment_error": LastPaymentError, diff --git a/stripe/_payment_intent_amount_details_line_item.py b/stripe/_payment_intent_amount_details_line_item.py index 2c1e291f8..789feefc7 100644 --- a/stripe/_payment_intent_amount_details_line_item.py +++ b/stripe/_payment_intent_amount_details_line_item.py @@ -53,14 +53,14 @@ class Paypal(StripeObject): class Tax(StripeObject): total_tax_amount: int """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ discount_amount: Optional[int] """ - The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The discount applied on this line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[discount_amount]` field. """ @@ -96,7 +96,7 @@ class Tax(StripeObject): """ unit_cost: int """ - The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. """ unit_of_measure: Optional[str] """ diff --git a/stripe/_payment_link.py b/stripe/_payment_link.py index c4eb91be0..7c3f317df 100644 --- a/stripe/_payment_link.py +++ b/stripe/_payment_link.py @@ -39,9 +39,9 @@ class PaymentLink( """ A payment link is a shareable URL that will take your customers to a hosted payment page. A payment link can be shared and used multiple times. - When a customer opens a payment link it will open a new [checkout session](https://stripe.com/docs/api/checkout/sessions) to render the payment page. You can use [checkout session events](https://stripe.com/docs/api/events/types#event_types-checkout.session.completed) to track payments through payment links. + When a customer opens a payment link it will open a new [checkout session](https://docs.stripe.com/api/checkout/sessions) to render the payment page. You can use [checkout session events](https://docs.stripe.com/api/events/types#event_types-checkout.session.completed) to track payments through payment links. - Related guide: [Payment Links API](https://stripe.com/docs/payment-links) + Related guide: [Payment Links API](https://docs.stripe.com/payment-links) """ OBJECT_NAME: ClassVar[Literal["payment_link"]] = "payment_link" @@ -301,7 +301,7 @@ class RenderingOptions(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ rendering_options: Optional[RenderingOptions] """ @@ -381,7 +381,7 @@ class PaymentIntentData(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on [Payment Intents](https://stripe.com/docs/api/payment_intents) generated from this payment link. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on [Payment Intents](https://docs.stripe.com/api/payment_intents) generated from this payment link. """ setup_future_usage: Optional[Literal["off_session", "on_session"]] """ @@ -397,7 +397,7 @@ class PaymentIntentData(StripeObject): """ transfer_group: Optional[str] """ - A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details. + A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers) for details. """ class PhoneNumberCollection(StripeObject): @@ -714,7 +714,7 @@ class EndBehavior(StripeObject): invoice_settings: InvoiceSettings metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on [Subscriptions](https://stripe.com/docs/api/subscriptions) generated from this payment link. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on [Subscriptions](https://docs.stripe.com/api/subscriptions) generated from this payment link. """ trial_period_days: Optional[int] """ @@ -811,7 +811,7 @@ class TransferData(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name_collection: Optional[NameCollection] object: Literal["payment_link"] diff --git a/stripe/_payment_method.py b/stripe/_payment_method.py index c4c9df8f8..26ed3b255 100644 --- a/stripe/_payment_method.py +++ b/stripe/_payment_method.py @@ -42,10 +42,10 @@ class PaymentMethod( ): """ PaymentMethod objects represent your customer's payment instruments. - You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to + You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. - Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios). + Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios). """ OBJECT_NAME: ClassVar[Literal["payment_method"]] = "payment_method" @@ -149,7 +149,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -319,7 +319,7 @@ class Wallet(StripeObject): """ incremental_authorization_supported: bool """ - Whether this [PaymentIntent](https://stripe.com/docs/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). + Whether this [PaymentIntent](https://docs.stripe.com/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). """ issuer: Optional[str] """ @@ -448,7 +448,7 @@ class BillingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class ShippingAddress(StripeObject): @@ -474,7 +474,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ billing_address: Optional[BillingAddress] @@ -525,7 +525,7 @@ class BillingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class ShippingAddress(StripeObject): @@ -551,7 +551,7 @@ class ShippingAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ billing_address: Optional[BillingAddress] @@ -931,6 +931,7 @@ class Ideal(StripeObject): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -944,7 +945,7 @@ class Ideal(StripeObject): ] ] """ - The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. + The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `mollie`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. """ bic: Optional[ Literal[ @@ -958,6 +959,7 @@ class Ideal(StripeObject): "HANDNL2A", "INGBNL2A", "KNABNL2H", + "MLLENL2A", "MOYONL21", "NNBANL2G", "NTSBDEB1", @@ -1269,7 +1271,7 @@ class Qris(StripeObject): class RadarOptions(StripeObject): session: Optional[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ class Rechnung(StripeObject): @@ -1522,7 +1524,7 @@ class Zip(StripeObject): mb_way: Optional[MbWay] metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ mobilepay: Optional[Mobilepay] multibanco: Optional[Multibanco] @@ -1545,7 +1547,7 @@ class Zip(StripeObject): qris: Optional[Qris] radar_options: Optional[RadarOptions] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: Optional[Rechnung] revolut_pay: Optional[RevolutPay] @@ -1983,7 +1985,7 @@ def list( cls, **params: Unpack["PaymentMethodListParams"] ) -> ListObject["PaymentMethod"]: """ - Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead. + Returns a list of all PaymentMethods. """ result = cls._static_request( "get", @@ -2003,7 +2005,7 @@ async def list_async( cls, **params: Unpack["PaymentMethodListParams"] ) -> ListObject["PaymentMethod"]: """ - Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead. + Returns a list of all PaymentMethods. """ result = await cls._static_request_async( "get", diff --git a/stripe/_payment_method_configuration.py b/stripe/_payment_method_configuration.py index f7f820a61..3dfffb0de 100644 --- a/stripe/_payment_method_configuration.py +++ b/stripe/_payment_method_configuration.py @@ -32,7 +32,7 @@ class PaymentMethodConfiguration( """ PaymentMethodConfigurations control which payment methods are displayed to your customers when you don't explicitly specify payment method types. You can have multiple configurations with different sets of payment methods for different scenarios. - There are two types of PaymentMethodConfigurations. Which is used depends on the [charge type](https://stripe.com/docs/connect/charges): + There are two types of PaymentMethodConfigurations. Which is used depends on the [charge type](https://docs.stripe.com/connect/charges): **Direct** configurations apply to payments created on your account, including Connect destination charges, Connect separate charges and transfers, and payments not involving Connect. @@ -41,9 +41,9 @@ class PaymentMethodConfiguration( Child configurations have a `parent` that sets default values and controls which settings connected accounts may override. You can specify a parent ID at payment time, and Stripe will automatically resolve the connected account's associated child configuration. Parent configurations are [managed in the dashboard](https://dashboard.stripe.com/settings/payment_methods/connected_accounts) and are not available in this API. Related guides: - - [Payment Method Configurations API](https://stripe.com/docs/connect/payment-method-configurations) - - [Multiple configurations on dynamic payment methods](https://stripe.com/docs/payments/multiple-payment-method-configs) - - [Multiple configurations for your Connect accounts](https://stripe.com/docs/connect/multiple-payment-method-configurations) + - [Payment Method Configurations API](https://docs.stripe.com/connect/payment-method-configurations) + - [Multiple configurations on dynamic payment methods](https://docs.stripe.com/payments/multiple-payment-method-configs) + - [Multiple configurations for your Connect accounts](https://docs.stripe.com/connect/multiple-payment-method-configurations) """ OBJECT_NAME: ClassVar[Literal["payment_method_configuration"]] = ( diff --git a/stripe/_payment_method_domain.py b/stripe/_payment_method_domain.py index bf61a3fc9..c60a1c116 100644 --- a/stripe/_payment_method_domain.py +++ b/stripe/_payment_method_domain.py @@ -36,7 +36,7 @@ class PaymentMethodDomain( A payment method domain represents a web domain that you have registered with Stripe. Stripe Elements use registered payment method domains to control where certain payment methods are shown. - Related guide: [Payment method domains](https://stripe.com/docs/payments/payment-methods/pmd-registration). + Related guide: [Payment method domains](https://docs.stripe.com/payments/payment-methods/pmd-registration). """ OBJECT_NAME: ClassVar[Literal["payment_method_domain"]] = ( diff --git a/stripe/_payment_method_service.py b/stripe/_payment_method_service.py index c843d0e31..77013f1de 100644 --- a/stripe/_payment_method_service.py +++ b/stripe/_payment_method_service.py @@ -36,7 +36,7 @@ def list( options: Optional["RequestOptions"] = None, ) -> "ListObject[PaymentMethod]": """ - Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead. + Returns a list of all PaymentMethods. """ return cast( "ListObject[PaymentMethod]", @@ -55,7 +55,7 @@ async def list_async( options: Optional["RequestOptions"] = None, ) -> "ListObject[PaymentMethod]": """ - Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead. + Returns a list of all PaymentMethods. """ return cast( "ListObject[PaymentMethod]", diff --git a/stripe/_payment_record.py b/stripe/_payment_record.py index 38b5e8589..fbf12dc78 100644 --- a/stripe/_payment_record.py +++ b/stripe/_payment_record.py @@ -53,7 +53,7 @@ class Amount(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountAuthorized(StripeObject): @@ -63,7 +63,7 @@ class AmountAuthorized(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountCanceled(StripeObject): @@ -73,7 +73,7 @@ class AmountCanceled(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountFailed(StripeObject): @@ -83,7 +83,7 @@ class AmountFailed(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountGuaranteed(StripeObject): @@ -93,7 +93,7 @@ class AmountGuaranteed(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountRefunded(StripeObject): @@ -103,7 +103,7 @@ class AmountRefunded(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class AmountRequested(StripeObject): @@ -113,7 +113,7 @@ class AmountRequested(StripeObject): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ class CustomerDetails(StripeObject): @@ -184,6 +184,10 @@ class AcssDebit(StripeObject): """ Name of the bank associated with the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -208,11 +212,11 @@ class AcssDebit(StripeObject): class Affirm(StripeObject): location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ transaction_id: Optional[str] """ @@ -308,6 +312,10 @@ class AuBecsDebit(StripeObject): """ Bank-State-Branch number of the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -322,6 +330,10 @@ class AuBecsDebit(StripeObject): """ class BacsDebit(StripeObject): + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -405,7 +417,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -450,6 +462,24 @@ class Checks(StripeObject): Literal["fail", "pass", "unavailable", "unchecked"] ] + class Installments(StripeObject): + class Plan(StripeObject): + count: Optional[int] + """ + For `fixed_count` installment plans, this is the number of installment payments your customer will make to their credit card. + """ + interval: Optional[Literal["month"]] + """ + For `fixed_count` installment plans, this is the interval between installment payments your customer will make to their credit card. One of `month`. + """ + type: Literal["bonus", "fixed_count", "revolving"] + """ + Type of installment plan, one of `fixed_count`, `revolving`, or `bonus`. + """ + + plan: Optional[Plan] + _inner_class_types = {"plan": Plan} + class NetworkToken(StripeObject): used: bool """ @@ -508,6 +538,10 @@ class GooglePay(StripeObject): "google_pay": GooglePay, } + authorization_code: Optional[str] + """ + The authorization code of the payment. + """ brand: Literal[ "amex", "cartes_bancaires", @@ -537,6 +571,10 @@ class GooglePay(StripeObject): """ Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected. """ + description: Optional[str] + """ + A high-level description of the type of cards issued in this range. + """ exp_month: int """ Two-digit number representing the card's expiration month. @@ -555,6 +593,18 @@ class GooglePay(StripeObject): """ Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`. """ + iin: Optional[str] + """ + Issuer identification number of the card. + """ + installments: Optional[Installments] + """ + Installment details for this payment. + """ + issuer: Optional[str] + """ + The name of the card's issuing bank. + """ last4: str """ The last four digits of the card. @@ -582,6 +632,14 @@ class GooglePay(StripeObject): """ Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`. """ + network_advice_code: Optional[str] + """ + Advice code from the card network for the failed payment. + """ + network_decline_code: Optional[str] + """ + Decline code from the card network for the failed payment. + """ network_token: Optional[NetworkToken] """ If this card has network token credentials, this contains the details of the network token credentials. @@ -590,6 +648,12 @@ class GooglePay(StripeObject): """ This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise. """ + stored_credential_usage: Optional[ + Literal["recurring", "unscheduled"] + ] + """ + The transaction type that was passed for an off-session, Merchant-Initiated transaction, one of `recurring` or `unscheduled`. + """ three_d_secure: Optional[ThreeDSecure] """ Populated if this transaction used 3D Secure authentication. @@ -600,6 +664,7 @@ class GooglePay(StripeObject): """ _inner_class_types = { "checks": Checks, + "installments": Installments, "network_token": NetworkToken, "three_d_secure": ThreeDSecure, "wallet": Wallet, @@ -724,7 +789,7 @@ class Wallet(StripeObject): """ incremental_authorization_supported: bool """ - Whether this [PaymentIntent](https://stripe.com/docs/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). + Whether this [PaymentIntent](https://docs.stripe.com/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support). """ issuer: Optional[str] """ @@ -964,6 +1029,7 @@ class Ideal(StripeObject): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -977,7 +1043,7 @@ class Ideal(StripeObject): ] ] """ - The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. + The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `mollie`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. """ bic: Optional[ Literal[ @@ -991,6 +1057,7 @@ class Ideal(StripeObject): "HANDNL2A", "INGBNL2A", "KNABNL2H", + "MLLENL2A", "MOYONL21", "NNBANL2G", "NTSBDEB1", @@ -1326,6 +1393,10 @@ class NzBankAccount(StripeObject): """ The numeric code for the bank account's bank branch. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ last4: str """ Last four digits of the bank account number. @@ -1402,11 +1473,11 @@ class Payco(StripeObject): class Paynow(StripeObject): location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ reference: Optional[str] """ @@ -1451,7 +1522,7 @@ class Shipping(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class VerifiedAddress(StripeObject): @@ -1477,7 +1548,7 @@ class VerifiedAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ country: Optional[str] @@ -1669,6 +1740,10 @@ class SepaDebit(StripeObject): """ Two-letter ISO code representing the country the bank account is located in. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -1679,7 +1754,7 @@ class SepaDebit(StripeObject): """ mandate: Optional[str] """ - Find the ID of the mandate used for this payment under the [payment_method_details.sepa_debit.mandate](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-sepa_debit-mandate) property on the Charge. Use this mandate ID to [retrieve the Mandate](https://stripe.com/docs/api/mandates/retrieve). + Find the ID of the mandate used for this payment under the [payment_method_details.sepa_debit.mandate](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-sepa_debit-mandate) property on the Charge. Use this mandate ID to [retrieve the Mandate](https://docs.stripe.com/api/mandates/retrieve). """ class Shopeepay(StripeObject): @@ -1770,6 +1845,10 @@ class UsBankAccount(StripeObject): """ Name of the bank associated with the bank account. """ + expected_debit_date: Optional[str] + """ + Estimated date to debit the customer's bank account. A date string in YYYY-MM-DD format. + """ fingerprint: Optional[str] """ Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same. @@ -1801,11 +1880,11 @@ class WechatPay(StripeObject): """ location: Optional[str] """ - ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to. + ID of the [location](https://docs.stripe.com/api/terminal/locations) that this transaction's reader is assigned to. """ reader: Optional[str] """ - ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on. + ID of the [reader](https://docs.stripe.com/api/terminal/readers) this transaction was made on. """ transaction_id: Optional[str] """ @@ -1894,7 +1973,7 @@ class Zip(StripeObject): twint: Optional[Twint] type: str """ - The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) for the full list of possible types. + The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type) for the full list of possible types. An additional hash is included on `payment_method_details` with a name matching this value. It contains information specific to the payment method. """ @@ -2014,7 +2093,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -2093,7 +2172,7 @@ class Address(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["payment_record"] """ @@ -2107,6 +2186,10 @@ class Address(StripeObject): """ Processor information associated with this payment. """ + reported_by: Literal["self", "stripe"] + """ + Indicates who reported the payment. + """ shipping_details: Optional[ShippingDetails] """ Shipping information for this payment. diff --git a/stripe/_payout.py b/stripe/_payout.py index e707c2e2f..93d1652cb 100644 --- a/stripe/_payout.py +++ b/stripe/_payout.py @@ -36,7 +36,7 @@ class Payout( schedules](https://docs.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://docs.stripe.com/payouts) """ OBJECT_NAME: ClassVar[Literal["payout"]] = "payout" @@ -57,11 +57,11 @@ class TraceId(StripeObject): """ application_fee: Optional[ExpandableField["ApplicationFee"]] """ - The application fee (if any) for the payout. [See the Connect documentation](https://stripe.com/docs/connect/instant-payouts#monetization-and-fees) for details. + The application fee (if any) for the payout. [See the Connect documentation](https://docs.stripe.com/connect/instant-payouts#monetization-and-fees) for details. """ application_fee_amount: Optional[int] """ - The amount of the application fee (if any) requested for the payout. [See the Connect documentation](https://stripe.com/docs/connect/instant-payouts#monetization-and-fees) for details. + The amount of the application fee (if any) requested for the payout. [See the Connect documentation](https://docs.stripe.com/connect/instant-payouts#monetization-and-fees) for details. """ arrival_date: int """ @@ -69,7 +69,7 @@ class TraceId(StripeObject): """ automatic: bool """ - Returns `true` if the payout is created by an [automated payout schedule](https://stripe.com/docs/payouts#payout-schedule) and `false` if it's [requested manually](https://stripe.com/docs/payouts#manual-payouts). + Returns `true` if the payout is created by an [automated payout schedule](https://docs.stripe.com/payouts#payout-schedule) and `false` if it's [requested manually](https://stripe.com/docs/payouts#manual-payouts). """ balance_transaction: Optional[ExpandableField["BalanceTransaction"]] """ @@ -99,7 +99,7 @@ class TraceId(StripeObject): """ failure_code: Optional[str] """ - Error code that provides a reason for a payout failure, if available. View our [list of failure codes](https://stripe.com/docs/api#payout_failures). + Error code that provides a reason for a payout failure, if available. View our [list of failure codes](https://docs.stripe.com/api#payout_failures). """ failure_message: Optional[str] """ @@ -115,7 +115,7 @@ class TraceId(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ method: str """ @@ -137,7 +137,7 @@ class TraceId(StripeObject): "completed", "in_progress", "not_applicable" ] """ - If `completed`, you can use the [Balance Transactions API](https://stripe.com/docs/api/balance_transactions/list#balance_transaction_list-payout) to list all balance transactions that are paid out in this payout. + If `completed`, you can use the [Balance Transactions API](https://docs.stripe.com/api/balance_transactions/list#balance_transaction_list-payout) to list all balance transactions that are paid out in this payout. """ reversed_by: Optional[ExpandableField["Payout"]] """ diff --git a/stripe/_person.py b/stripe/_person.py index 3b3608855..553ae9b7d 100644 --- a/stripe/_person.py +++ b/stripe/_person.py @@ -67,7 +67,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class AddressKana(StripeObject): @@ -148,11 +148,11 @@ class FutureRequirements(StripeObject): class Alternative(StripeObject): alternative_fields_due: List[str] """ - Fields that can be provided to satisfy all fields in `original_fields_due`. + Fields that can be provided to resolve all fields in `original_fields_due`. """ original_fields_due: List[str] """ - Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`. + Fields that are due and can be resolved by providing all fields in `alternative_fields_due`. """ class Error(StripeObject): @@ -270,15 +270,15 @@ class Error(StripeObject): alternatives: Optional[List[Alternative]] """ - Fields that are due and can be satisfied by providing the corresponding alternative fields instead. + Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again. """ currently_due: List[str] """ - Fields that need to be collected to keep the person's account enabled. If not collected by the account's `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash, and may immediately become `past_due`, but the account may also be given a grace period depending on the account's enablement state prior to transition. + Fields that need to be resolved to keep the person's account enabled. If not resolved by the account's `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash, and may immediately become `past_due`, but the account may also be given a grace period depending on the account's enablement state prior to transition. """ errors: List[Error] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ eventually_due: List[str] """ @@ -286,11 +286,11 @@ class Error(StripeObject): """ past_due: List[str] """ - Fields that weren't collected by the account's `requirements.current_deadline`. These fields need to be collected to enable the person's account. New fields will never appear here; `future_requirements.past_due` will always be a subset of `requirements.past_due`. + Fields that haven't been resolved by the account's `requirements.current_deadline`. These fields need to be resolved to enable the person's account. `future_requirements.past_due` is a subset of `requirements.past_due`. """ pending_verification: List[str] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due` or `currently_due`. Fields might appear in `eventually_due` or `currently_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"alternatives": Alternative, "errors": Error} @@ -317,7 +317,7 @@ class RegisteredAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class Relationship(StripeObject): @@ -358,11 +358,11 @@ class Requirements(StripeObject): class Alternative(StripeObject): alternative_fields_due: List[str] """ - Fields that can be provided to satisfy all fields in `original_fields_due`. + Fields that can be provided to resolve all fields in `original_fields_due`. """ original_fields_due: List[str] """ - Fields that are due and can be satisfied by providing all fields in `alternative_fields_due`. + Fields that are due and can be resolved by providing all fields in `alternative_fields_due`. """ class Error(StripeObject): @@ -480,15 +480,15 @@ class Error(StripeObject): alternatives: Optional[List[Alternative]] """ - Fields that are due and can be satisfied by providing the corresponding alternative fields instead. + Fields that are due and can be resolved by providing the corresponding alternative fields instead. Many alternatives can list the same `original_fields_due`, and any of these alternatives can serve as a pathway for attempting to resolve the fields again. Re-providing `original_fields_due` also serves as a pathway for attempting to resolve the fields again. """ currently_due: List[str] """ - Fields that need to be collected to keep the person's account enabled. If not collected by the account's `current_deadline`, these fields appear in `past_due` as well, and the account is disabled. + Fields that need to be resolved to keep the person's account enabled. If not resolved by the account's `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled. """ errors: List[Error] """ - Fields that are `currently_due` and need to be collected again because validation or verification failed. + Details about validation and verification failures for `due` requirements that must be resolved. """ eventually_due: List[str] """ @@ -496,11 +496,11 @@ class Error(StripeObject): """ past_due: List[str] """ - Fields that weren't collected by the account's `current_deadline`. These fields need to be collected to enable the person's account. + Fields that haven't been resolved by `current_deadline`. These fields need to be resolved to enable the person's account. """ pending_verification: List[str] """ - Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending. + Fields that are being reviewed, or might become required depending on the results of a review. If the review fails, these fields can move to `eventually_due`, `currently_due`, `past_due` or `alternatives`. Fields might appear in `eventually_due`, `currently_due`, `past_due` or `alternatives` and in `pending_verification` if one verification fails but another is still pending. """ _inner_class_types = {"alternatives": Alternative, "errors": Error} @@ -587,7 +587,7 @@ class Verification(StripeObject): class AdditionalDocument(StripeObject): back: Optional[ExpandableField["File"]] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ details: Optional[str] """ @@ -599,13 +599,13 @@ class AdditionalDocument(StripeObject): """ front: Optional[ExpandableField["File"]] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ class Document(StripeObject): back: Optional[ExpandableField["File"]] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ details: Optional[str] """ @@ -617,7 +617,7 @@ class Document(StripeObject): """ front: Optional[ExpandableField["File"]] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ additional_document: Optional[AdditionalDocument] @@ -635,7 +635,7 @@ class Document(StripeObject): document: Optional[Document] status: str """ - The state of verification for the person. Possible values are `unverified`, `pending`, or `verified`. Please refer [guide](https://stripe.com/docs/connect/handling-api-verification) to handle verification updates. + The state of verification for the person. Possible values are `unverified`, `pending`, or `verified`. Please refer [guide](https://docs.stripe.com/connect/handling-api-verification) to handle verification updates. """ _inner_class_types = { "additional_document": AdditionalDocument, @@ -687,7 +687,7 @@ class Document(StripeObject): """ future_requirements: Optional[FutureRequirements] """ - Information about the [upcoming new requirements for this person](https://stripe.com/docs/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when. + Information about the [upcoming new requirements for this person](https://docs.stripe.com/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when. """ gender: Optional[str] """ @@ -723,7 +723,7 @@ class Document(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ nationality: Optional[str] """ diff --git a/stripe/_plan.py b/stripe/_plan.py index 644a58386..27ac67046 100644 --- a/stripe/_plan.py +++ b/stripe/_plan.py @@ -27,14 +27,14 @@ class Plan( UpdateableAPIResource["Plan"], ): """ - You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration. + You can now model subscriptions more flexibly using the [Prices API](https://api.stripe.com#prices). It replaces the Plans API and is backwards compatible to simplify your migration. Plans define the base price, currency, and billing cycle for recurring purchases of products. - [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme. + [Products](https://api.stripe.com#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single "gold" product that has plans for $10/month, $100/year, €9/month, and €90/year. - Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) and more about [products and prices](https://stripe.com/docs/products-prices/overview). + Related guides: [Set up a subscription](https://docs.stripe.com/billing/subscriptions/set-up-subscription) and more about [products and prices](https://docs.stripe.com/products-prices/overview). """ OBJECT_NAME: ClassVar[Literal["plan"]] = "plan" @@ -117,7 +117,7 @@ class TransformUsage(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ meter: Optional[str] """ @@ -149,7 +149,7 @@ class TransformUsage(StripeObject): """ trial_period_days: Optional[int] """ - Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan). + Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://docs.stripe.com/api#create_subscription-trial_from_plan). """ usage_type: Literal["licensed", "metered"] """ diff --git a/stripe/_price.py b/stripe/_price.py index 55ba588e1..accb94295 100644 --- a/stripe/_price.py +++ b/stripe/_price.py @@ -37,11 +37,11 @@ class Price( ): """ Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products. - [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme. + [Products](https://api.stripe.com#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single "gold" product that has prices for $10/month, $100/year, and €9 once. - Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), [create an invoice](https://stripe.com/docs/billing/invoices/create), and more about [products and prices](https://stripe.com/docs/products-prices/overview). + Related guides: [Set up a subscription](https://docs.stripe.com/billing/subscriptions/set-up-subscription), [create an invoice](https://docs.stripe.com/billing/invoices/create), and more about [products and prices](https://docs.stripe.com/products-prices/overview). """ OBJECT_NAME: ClassVar[Literal["price"]] = "price" @@ -91,7 +91,7 @@ class Tier(StripeObject): Literal["exclusive", "inclusive", "unspecified"] ] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tiers: Optional[List[Tier]] """ @@ -153,7 +153,7 @@ class Recurring(StripeObject): """ trial_period_days: Optional[int] """ - Default number of trial days when subscribing a customer to this price using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan). + Default number of trial days when subscribing a customer to this price using [`trial_from_plan=true`](https://docs.stripe.com/api#create_subscription-trial_from_plan). """ usage_type: Literal["licensed", "metered"] """ @@ -234,7 +234,7 @@ class TransformQuantity(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ migrate_to: Optional[MigrateTo] """ @@ -258,7 +258,7 @@ class TransformQuantity(StripeObject): """ tax_behavior: Optional[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tiers: Optional[List[Tier]] """ diff --git a/stripe/_product.py b/stripe/_product.py index aa29a9eae..3eac066e0 100644 --- a/stripe/_product.py +++ b/stripe/_product.py @@ -58,12 +58,12 @@ class Product( """ Products describe the specific goods or services you offer to your customers. For example, you might offer a Standard and Premium version of your goods or service; each version would be a separate Product. - They can be used in conjunction with [Prices](https://stripe.com/docs/api#prices) to configure pricing in Payment Links, Checkout, and Subscriptions. + They can be used in conjunction with [Prices](https://api.stripe.com#prices) to configure pricing in Payment Links, Checkout, and Subscriptions. - Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), - [share a Payment Link](https://stripe.com/docs/payment-links), - [accept payments with Checkout](https://stripe.com/docs/payments/accept-a-payment#create-product-prices-upfront), - and more about [Products and Prices](https://stripe.com/docs/products-prices/overview) + Related guides: [Set up a subscription](https://docs.stripe.com/billing/subscriptions/set-up-subscription), + [share a Payment Link](https://docs.stripe.com/payment-links), + [accept payments with Checkout](https://docs.stripe.com/payments/accept-a-payment#create-product-prices-upfront), + and more about [Products and Prices](https://docs.stripe.com/products-prices/overview) """ OBJECT_NAME: ClassVar[Literal["product"]] = "product" @@ -102,7 +102,7 @@ class PackageDimensions(StripeObject): """ default_price: Optional[ExpandableField["Price"]] """ - The ID of the [Price](https://stripe.com/docs/api/prices) object that is the default price for this product. + The ID of the [Price](https://docs.stripe.com/api/prices) object that is the default price for this product. """ deleted: Optional[Literal[True]] """ @@ -126,11 +126,11 @@ class PackageDimensions(StripeObject): """ marketing_features: List[MarketingFeature] """ - A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://stripe.com/docs/payments/checkout/pricing-table). + A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://docs.stripe.com/payments/checkout/pricing-table). """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: str """ @@ -154,7 +154,7 @@ class PackageDimensions(StripeObject): """ tax_code: Optional[ExpandableField["TaxCode"]] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ type: Literal["good", "service"] """ diff --git a/stripe/_promotion_code.py b/stripe/_promotion_code.py index d8527ca80..65e0bbcd5 100644 --- a/stripe/_promotion_code.py +++ b/stripe/_promotion_code.py @@ -36,7 +36,7 @@ class PromotionCode( A Promotion Code represents a customer-redeemable code for an underlying promotion. You can create multiple codes for a single promotion. - If you enable promotion codes in your [customer portal configuration](https://stripe.com/docs/customer-management/configure-portal), then customers can redeem a code themselves when updating a subscription in the portal. + If you enable promotion codes in your [customer portal configuration](https://docs.stripe.com/customer-management/configure-portal), then customers can redeem a code themselves when updating a subscription in the portal. Customers can also view the currently active promotion codes and coupons on each of their subscriptions in the portal. """ @@ -92,11 +92,11 @@ class CurrencyOptions(StripeObject): """ customer: Optional[ExpandableField["Customer"]] """ - The customer that this promotion code can be used by. + The customer who can use this promotion code. """ customer_account: Optional[str] """ - The account that this promotion code can be used by. + The account representing the customer who can use this promotion code. """ expires_at: Optional[int] """ @@ -116,7 +116,7 @@ class CurrencyOptions(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["promotion_code"] """ diff --git a/stripe/_quote.py b/stripe/_quote.py index df1e94337..d8f30f474 100644 --- a/stripe/_quote.py +++ b/stripe/_quote.py @@ -142,10 +142,10 @@ class Discount(StripeObject): """ discount: "DiscountResource" """ - A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). + A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. - Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts) + Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts) """ class Tax(StripeObject): @@ -240,10 +240,10 @@ class Discount(StripeObject): """ discount: "DiscountResource" """ - A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). + A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. - Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts) + Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts) """ class Tax(StripeObject): @@ -655,7 +655,7 @@ class Prebilling(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ prebilling: Optional[Prebilling] """ @@ -665,7 +665,7 @@ class Prebilling(StripeObject): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the quote is accepted. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations) when the quote is accepted. """ trial_period_days: Optional[int] """ @@ -798,7 +798,7 @@ class LineEndsAt(StripeObject): """ customer: Optional[str] """ - The customer which this quote belongs to. A customer is required before finalizing the quote. Once specified, it cannot be changed. + The customer who received this quote. A customer is required to finalize the quote. Once specified, you can't change it. """ description: Optional[str] """ @@ -812,7 +812,7 @@ class LineEndsAt(StripeObject): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations) when the quote is accepted. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations) when the quote is accepted. """ _inner_class_types = { "applies_to": AppliesTo, @@ -850,10 +850,10 @@ class Discount(StripeObject): """ discount: "DiscountResource" """ - A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). + A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. - Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts) + Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts) """ class Tax(StripeObject): @@ -973,11 +973,11 @@ class TransferData(StripeObject): """ customer: Optional[ExpandableField["Customer"]] """ - The customer which this quote belongs to. A customer is required before finalizing the quote. Once specified, it cannot be changed. + The customer who received this quote. A customer is required to finalize the quote. Once specified, you can't change it. """ customer_account: Optional[str] """ - The account which this quote belongs to. A customer or account is required before finalizing the quote. Once specified, it cannot be changed. + The account representing the customer who received this quote. A customer or account is required to finalize the quote. Once specified, you can't change it. """ default_tax_rates: Optional[List[ExpandableField["TaxRate"]]] """ @@ -1001,7 +1001,7 @@ class TransferData(StripeObject): """ from_quote: Optional[FromQuote] """ - Details of the quote that was cloned. See the [cloning documentation](https://stripe.com/docs/quotes/clone) for more details. + Details of the quote that was cloned. See the [cloning documentation](https://docs.stripe.com/quotes/clone) for more details. """ header: Optional[str] """ @@ -1030,11 +1030,11 @@ class TransferData(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ number: Optional[str] """ - A unique number that identifies this particular quote. This number is assigned once the quote is [finalized](https://stripe.com/docs/quotes/overview#finalize). + A unique number that identifies this particular quote. This number is assigned once the quote is [finalized](https://docs.stripe.com/quotes/overview#finalize). """ object: Literal["quote"] """ diff --git a/stripe/_quote_line.py b/stripe/_quote_line.py index 4f236c1cc..ab6e08c99 100644 --- a/stripe/_quote_line.py +++ b/stripe/_quote_line.py @@ -96,7 +96,7 @@ class Trial(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. """ price: ExpandableField["Price"] """ @@ -226,7 +226,7 @@ class Trial(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. """ price: ExpandableField["Price"] """ @@ -394,7 +394,7 @@ class Set(StripeObject): set: Optional[Set] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ type: Literal["remove", "set"] """ diff --git a/stripe/_quote_preview_invoice.py b/stripe/_quote_preview_invoice.py index e91fec608..dc008d963 100644 --- a/stripe/_quote_preview_invoice.py +++ b/stripe/_quote_preview_invoice.py @@ -35,13 +35,13 @@ class QuotePreviewInvoice(StripeObject): 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](https://stripe.com/docs/api#invoiceitems), and proration adjustments + They contain [invoice items](https://api.stripe.com#invoiceitems), 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](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection), does + [when automatic](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection), 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 @@ -61,9 +61,9 @@ class QuotePreviewInvoice(StripeObject): customer's credit balance which is applied to the next invoice. More details on the customer's credit balance are - [here](https://stripe.com/docs/billing/customer/balance). + [here](https://docs.stripe.com/billing/customer/balance). - Related guide: [Send invoices to customers](https://stripe.com/docs/billing/invoices/sending) + Related guide: [Send invoices to customers](https://docs.stripe.com/billing/invoices/sending) """ OBJECT_NAME: ClassVar[Literal["quote_preview_invoice"]] = ( @@ -140,7 +140,7 @@ class Liability(StripeObject): """ enabled: bool """ - Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. + Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. """ liability: Optional[Liability] """ @@ -201,7 +201,7 @@ class CustomerAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class CustomerShipping(StripeObject): @@ -228,7 +228,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -395,7 +395,7 @@ class Issuer(StripeObject): class LastFinalizationError(StripeObject): advice_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://stripe.com/docs/declines#retrying-issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines) if they provide one. """ charge: Optional[str] """ @@ -409,6 +409,7 @@ class LastFinalizationError(StripeObject): "account_information_mismatch", "account_invalid", "account_number_invalid", + "account_token_required_for_v2_account", "acss_debit_session_incomplete", "alipay_upgrade_required", "amount_too_large", @@ -592,15 +593,15 @@ class LastFinalizationError(StripeObject): ] ] """ - For some errors that could be handled programmatically, a short string indicating the [error code](https://stripe.com/docs/error-codes) reported. + For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported. """ decline_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://stripe.com/docs/declines#issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://docs.stripe.com/declines#issuer-declines) if they provide one. """ doc_url: Optional[str] """ - A URL to more information about the [error code](https://stripe.com/docs/error-codes) reported. + A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported. """ message: Optional[str] """ @@ -626,19 +627,19 @@ class LastFinalizationError(StripeObject): see the history of payment attempts for a particular session. A PaymentIntent transitions through - [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses) + [multiple statuses](https://docs.stripe.com/payments/paymentintents/lifecycle) 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://docs.stripe.com/payments/payment-intents) """ payment_method: Optional["PaymentMethod"] """ PaymentMethod objects represent your customer's payment instruments. - You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to + You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. - Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios). + Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios). """ payment_method_type: Optional[str] """ @@ -652,7 +653,7 @@ class LastFinalizationError(StripeObject): """ 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](https://stripe.com/docs/api#payment_intents) to drive the payment flow. + Later, you can use [PaymentIntents](https://api.stripe.com#payment_intents) 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. @@ -663,9 +664,9 @@ class LastFinalizationError(StripeObject): For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents). - If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer), + If you use the SetupIntent with a [Customer](https://api.stripe.com#setup_intent_object-customer), it automatically attaches the resulting payment method to that Customer after successful setup. - We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on + We recommend using SetupIntents or [setup_future_usage](https://api.stripe.com#payment_intent_object-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. @@ -713,12 +714,12 @@ class PauseCollection(StripeObject): metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) defined as subscription metadata when an invoice is created. Becomes an immutable snapshot of the subscription metadata at the time of invoice finalization. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) 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.* """ pause_collection: Optional[PauseCollection] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ subscription: ExpandableField["Subscription"] """ @@ -790,7 +791,7 @@ class Installments(StripeObject): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ _inner_class_types = {"installments": Installments} @@ -822,6 +823,38 @@ class IdBankTransfer(StripeObject): class Konbini(StripeObject): pass + class Payto(StripeObject): + class MandateOptions(StripeObject): + amount: Optional[int] + """ + 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: Optional[Literal["fixed", "maximum"]] + """ + Only `maximum` is supported. + """ + purpose: Optional[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + mandate_options: Optional[MandateOptions] + _inner_class_types = {"mandate_options": MandateOptions} + class Pix(StripeObject): amount_includes_iof: Optional[Literal["always", "never"]] """ @@ -931,6 +964,10 @@ class Filters(StripeObject): """ If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: Optional[Payto] + """ + If paying by `payto`, this sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: Optional[Pix] """ If paying by `pix`, this sub-hash contains details about the Pix payment method options to pass to the invoice's PaymentIntent. @@ -954,6 +991,7 @@ class Filters(StripeObject): "customer_balance": CustomerBalance, "id_bank_transfer": IdBankTransfer, "konbini": Konbini, + "payto": Payto, "pix": Pix, "sepa_debit": SepaDebit, "upi": Upi, @@ -1004,6 +1042,7 @@ class Filters(StripeObject): "payco", "paynow", "paypal", + "payto", "pix", "promptpay", "revolut_pay", @@ -1133,7 +1172,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -1241,6 +1280,9 @@ class TotalPretaxCreditAmount(StripeObject): class TotalTax(StripeObject): class TaxRateDetails(StripeObject): tax_rate: str + """ + ID of the tax rate + """ amount: int """ @@ -1385,7 +1427,7 @@ class TaxRateDetails(StripeObject): """ customer_account: Optional[str] """ - The ID of the account who will be billed. + The ID of the account representing the customer to bill. """ customer_address: Optional[CustomerAddress] """ @@ -1461,7 +1503,7 @@ class TaxRateDetails(StripeObject): """ from_invoice: Optional[FromInvoice] """ - Details of the invoice that was cloned. See the [revision documentation](https://stripe.com/docs/invoicing/invoice-revisions) for more details. + Details of the invoice that was cloned. See the [revision documentation](https://docs.stripe.com/invoicing/invoice-revisions) for more details. """ id: str """ @@ -1486,7 +1528,7 @@ class TaxRateDetails(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ next_payment_attempt: Optional[int] """ @@ -1502,7 +1544,7 @@ class TaxRateDetails(StripeObject): """ on_behalf_of: Optional[ExpandableField["Account"]] """ - 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](https://stripe.com/docs/billing/invoices/connect) documentation for details. + 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](https://docs.stripe.com/billing/invoices/connect) documentation for details. """ parent: Optional[Parent] """ @@ -1555,7 +1597,7 @@ class TaxRateDetails(StripeObject): """ status: Optional[Literal["draft", "open", "paid", "uncollectible", "void"]] """ - The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://stripe.com/docs/billing/invoices/workflow#workflow-overview) + The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://docs.stripe.com/billing/invoices/workflow#workflow-overview) """ status_transitions: StatusTransitions subscription: Optional[ExpandableField["Subscription"]] @@ -1598,7 +1640,7 @@ class TaxRateDetails(StripeObject): """ webhooks_delivered_at: Optional[int] """ - Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have [been exhausted](https://stripe.com/docs/billing/webhooks#understand). 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. + Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all webhook delivery attempts have [been exhausted](https://docs.stripe.com/billing/webhooks#understand). 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. """ _inner_class_types = { "amounts_due": AmountsDue, diff --git a/stripe/_quote_preview_subscription_schedule.py b/stripe/_quote_preview_subscription_schedule.py index e215bc847..2ec6331b8 100644 --- a/stripe/_quote_preview_subscription_schedule.py +++ b/stripe/_quote_preview_subscription_schedule.py @@ -147,7 +147,7 @@ class TransferData(StripeObject): automatic_tax: Optional[AutomaticTax] billing_cycle_anchor: Literal["automatic", "phase_start"] """ - Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: Optional[BillingThresholds] """ @@ -274,7 +274,7 @@ class Start(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ period: Period price: ExpandableField["Price"] @@ -436,7 +436,7 @@ class Trial(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. """ plan: ExpandableField["Plan"] """ @@ -504,7 +504,7 @@ class EndBehavior(StripeObject): automatic_tax: Optional[AutomaticTax] billing_cycle_anchor: Optional[Literal["automatic", "phase_start"]] """ - Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: Optional[BillingThresholds] """ @@ -550,7 +550,7 @@ class EndBehavior(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`. """ on_behalf_of: Optional[ExpandableField["Account"]] """ @@ -558,7 +558,7 @@ class EndBehavior(StripeObject): """ pause_collection: Optional[PauseCollection] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ proration_behavior: Literal[ "always_invoice", "create_prorations", "none" @@ -674,7 +674,7 @@ class Prebilling(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["quote_preview_subscription_schedule"] """ @@ -700,7 +700,7 @@ class Prebilling(StripeObject): "active", "canceled", "completed", "not_started", "released" ] """ - The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://stripe.com/docs/billing/subscriptions/subscription-schedules). + The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://docs.stripe.com/billing/subscriptions/subscription-schedules). """ subscription: Optional[ExpandableField["Subscription"]] """ diff --git a/stripe/_refund.py b/stripe/_refund.py index e9d412ad5..d865c06af 100644 --- a/stripe/_refund.py +++ b/stripe/_refund.py @@ -34,7 +34,7 @@ class Refund( refunded yet. Funds are refunded to the credit or debit card that's initially charged. - Related guide: [Refunds](https://stripe.com/docs/refunds) + Related guide: [Refunds](https://docs.stripe.com/refunds) """ OBJECT_NAME: ClassVar[Literal["refund"]] = "refund" @@ -428,7 +428,7 @@ class PresentmentDetails(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ next_action: Optional[NextAction] object: Literal["refund"] @@ -467,7 +467,7 @@ class PresentmentDetails(StripeObject): """ status: Optional[str] """ - Status of the refund. This can be `pending`, `requires_action`, `succeeded`, `failed`, or `canceled`. Learn more about [failed refunds](https://stripe.com/docs/refunds#failed-refunds). + Status of the refund. This can be `pending`, `requires_action`, `succeeded`, `failed`, or `canceled`. Learn more about [failed refunds](https://docs.stripe.com/refunds#failed-refunds). """ transfer_reversal: Optional[ExpandableField["Reversal"]] """ diff --git a/stripe/_reserve_service.py b/stripe/_reserve_service.py new file mode 100644 index 000000000..62a8ddcda --- /dev/null +++ b/stripe/_reserve_service.py @@ -0,0 +1,41 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._stripe_service import StripeService +from importlib import import_module +from typing_extensions import TYPE_CHECKING + +if TYPE_CHECKING: + from stripe.reserve._hold_service import HoldService + from stripe.reserve._plan_service import PlanService + from stripe.reserve._release_service import ReleaseService + +_subservices = { + "holds": ["stripe.reserve._hold_service", "HoldService"], + "plans": ["stripe.reserve._plan_service", "PlanService"], + "releases": ["stripe.reserve._release_service", "ReleaseService"], +} + + +class ReserveService(StripeService): + holds: "HoldService" + plans: "PlanService" + releases: "ReleaseService" + + def __init__(self, requestor): + super().__init__(requestor) + + def __getattr__(self, name): + try: + import_from, service = _subservices[name] + service_class = getattr( + import_module(import_from), + service, + ) + setattr( + self, + name, + service_class(self._requestor), + ) + return getattr(self, name) + except KeyError: + raise AttributeError() diff --git a/stripe/_reversal.py b/stripe/_reversal.py index 25bbb80c1..94654232f 100644 --- a/stripe/_reversal.py +++ b/stripe/_reversal.py @@ -14,7 +14,7 @@ class Reversal(UpdateableAPIResource["Reversal"]): """ - [Stripe Connect](https://stripe.com/docs/connect) platforms can reverse transfers made to a + [Stripe Connect](https://docs.stripe.com/connect) platforms can reverse transfers made to a connected account, either entirely or partially, and can also specify whether to refund any related application fees. Transfer reversals add to the platform's balance and subtract from the destination account's balance. @@ -22,11 +22,11 @@ class Reversal(UpdateableAPIResource["Reversal"]): Reversing a transfer that was made for a [destination charge](https://docs.stripe.com/docs/connect/destination-charges) is allowed only up to the amount of the charge. It is possible to reverse a - [transfer_group](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) + [transfer_group](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) transfer only if the destination account has enough balance to cover the reversal. - Related guide: [Reverse transfers](https://stripe.com/docs/connect/separate-charges-and-transfers#reverse-transfers) + Related guide: [Reverse transfers](https://docs.stripe.com/connect/separate-charges-and-transfers#reverse-transfers) """ OBJECT_NAME: ClassVar[Literal["transfer_reversal"]] = "transfer_reversal" @@ -56,7 +56,7 @@ class Reversal(UpdateableAPIResource["Reversal"]): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["transfer_reversal"] """ diff --git a/stripe/_review.py b/stripe/_review.py index d03e8462f..13a14b9d4 100644 --- a/stripe/_review.py +++ b/stripe/_review.py @@ -21,7 +21,7 @@ class Review(ListableAPIResource["Review"]): Reviews can be used to supplement automated fraud detection with human expertise. Learn more about [Radar](https://docs.stripe.com/radar) and reviewing payments - [here](https://stripe.com/docs/radar/reviews). + [here](https://docs.stripe.com/radar/reviews). """ OBJECT_NAME: ClassVar[Literal["review"]] = "review" diff --git a/stripe/_setup_attempt.py b/stripe/_setup_attempt.py index da132c07d..cd0e8c7f8 100644 --- a/stripe/_setup_attempt.py +++ b/stripe/_setup_attempt.py @@ -286,6 +286,7 @@ class Ideal(StripeObject): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -299,7 +300,7 @@ class Ideal(StripeObject): ] ] """ - The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. + The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `mollie`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`. """ bic: Optional[ Literal[ @@ -313,6 +314,7 @@ class Ideal(StripeObject): "HANDNL2A", "INGBNL2A", "KNABNL2H", + "MLLENL2A", "MOYONL21", "NNBANL2G", "NTSBDEB1", @@ -483,7 +485,7 @@ class UsBankAccount(StripeObject): class SetupError(StripeObject): advice_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://stripe.com/docs/declines#retrying-issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines) if they provide one. """ charge: Optional[str] """ @@ -497,6 +499,7 @@ class SetupError(StripeObject): "account_information_mismatch", "account_invalid", "account_number_invalid", + "account_token_required_for_v2_account", "acss_debit_session_incomplete", "alipay_upgrade_required", "amount_too_large", @@ -680,15 +683,15 @@ class SetupError(StripeObject): ] ] """ - For some errors that could be handled programmatically, a short string indicating the [error code](https://stripe.com/docs/error-codes) reported. + For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported. """ decline_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://stripe.com/docs/declines#issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://docs.stripe.com/declines#issuer-declines) if they provide one. """ doc_url: Optional[str] """ - A URL to more information about the [error code](https://stripe.com/docs/error-codes) reported. + A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported. """ message: Optional[str] """ @@ -714,19 +717,19 @@ class SetupError(StripeObject): see the history of payment attempts for a particular session. A PaymentIntent transitions through - [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses) + [multiple statuses](https://docs.stripe.com/payments/paymentintents/lifecycle) 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://docs.stripe.com/payments/payment-intents) """ payment_method: Optional["PaymentMethod"] """ PaymentMethod objects represent your customer's payment instruments. - You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to + You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. - Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios). + Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios). """ payment_method_type: Optional[str] """ @@ -740,7 +743,7 @@ class SetupError(StripeObject): """ 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](https://stripe.com/docs/api#payment_intents) to drive the payment flow. + Later, you can use [PaymentIntents](https://api.stripe.com#payment_intents) 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. @@ -751,9 +754,9 @@ class SetupError(StripeObject): For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents). - If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer), + If you use the SetupIntent with a [Customer](https://api.stripe.com#setup_intent_object-customer), it automatically attaches the resulting payment method to that Customer after successful setup. - We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on + We recommend using SetupIntents or [setup_future_usage](https://api.stripe.com#payment_intent_object-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. @@ -775,7 +778,7 @@ class SetupError(StripeObject): application: Optional[ExpandableField["Application"]] """ - The value of [application](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-application) on the SetupIntent at the time of this confirmation. + The value of [application](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-application) on the SetupIntent at the time of this confirmation. """ attach_to_self: Optional[bool] """ @@ -789,11 +792,11 @@ class SetupError(StripeObject): """ customer: Optional[ExpandableField["Customer"]] """ - The value of [customer](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-customer) on the SetupIntent at the time of this confirmation. + The value of [customer](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-customer) on the SetupIntent at the time of this confirmation. """ customer_account: Optional[str] """ - The value of [customer_account](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-customer_account) on the SetupIntent at the time of this confirmation. + The value of [customer_account](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-customer_account) on the SetupIntent at the time of this confirmation. """ flow_directions: Optional[List[Literal["inbound", "outbound"]]] """ @@ -815,7 +818,7 @@ class SetupError(StripeObject): """ on_behalf_of: Optional[ExpandableField["Account"]] """ - The value of [on_behalf_of](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-on_behalf_of) on the SetupIntent at the time of this confirmation. + The value of [on_behalf_of](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-on_behalf_of) on the SetupIntent at the time of this confirmation. """ payment_method: ExpandableField["PaymentMethod"] """ @@ -836,7 +839,7 @@ class SetupError(StripeObject): """ usage: str """ - The value of [usage](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-usage) on the SetupIntent at the time of this confirmation, one of `off_session` or `on_session`. + The value of [usage](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-usage) on the SetupIntent at the time of this confirmation, one of `off_session` or `on_session`. """ @classmethod diff --git a/stripe/_setup_intent.py b/stripe/_setup_intent.py index 8c5c84938..598980608 100644 --- a/stripe/_setup_intent.py +++ b/stripe/_setup_intent.py @@ -51,7 +51,7 @@ class SetupIntent( """ 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](https://stripe.com/docs/api#payment_intents) to drive the payment flow. + Later, you can use [PaymentIntents](https://api.stripe.com#payment_intents) 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. @@ -62,9 +62,9 @@ class SetupIntent( For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents). - If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer), + If you use the SetupIntent with a [Customer](https://api.stripe.com#setup_intent_object-customer), it automatically attaches the resulting payment method to that Customer after successful setup. - We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on + We recommend using SetupIntents or [setup_future_usage](https://api.stripe.com#payment_intent_object-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. @@ -79,7 +79,7 @@ class AutomaticPaymentMethods(StripeObject): """ Controls whether this SetupIntent will accept redirect-based payment methods. - Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://stripe.com/docs/api/setup_intents/confirm) this SetupIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the setup. + Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://docs.stripe.com/api/setup_intents/confirm) this SetupIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the setup. """ enabled: Optional[bool] """ @@ -89,7 +89,7 @@ class AutomaticPaymentMethods(StripeObject): class LastSetupError(StripeObject): advice_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://stripe.com/docs/declines#retrying-issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating [how to proceed with an error](https://docs.stripe.com/declines#retrying-issuer-declines) if they provide one. """ charge: Optional[str] """ @@ -103,6 +103,7 @@ class LastSetupError(StripeObject): "account_information_mismatch", "account_invalid", "account_number_invalid", + "account_token_required_for_v2_account", "acss_debit_session_incomplete", "alipay_upgrade_required", "amount_too_large", @@ -286,15 +287,15 @@ class LastSetupError(StripeObject): ] ] """ - For some errors that could be handled programmatically, a short string indicating the [error code](https://stripe.com/docs/error-codes) reported. + For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported. """ decline_code: Optional[str] """ - For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://stripe.com/docs/declines#issuer-declines) if they provide one. + For card errors resulting from a card issuer decline, a short string indicating the [card issuer's reason for the decline](https://docs.stripe.com/declines#issuer-declines) if they provide one. """ doc_url: Optional[str] """ - A URL to more information about the [error code](https://stripe.com/docs/error-codes) reported. + A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported. """ message: Optional[str] """ @@ -320,19 +321,19 @@ class LastSetupError(StripeObject): see the history of payment attempts for a particular session. A PaymentIntent transitions through - [multiple statuses](https://stripe.com/docs/payments/intents#intent-statuses) + [multiple statuses](https://docs.stripe.com/payments/paymentintents/lifecycle) 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://docs.stripe.com/payments/payment-intents) """ payment_method: Optional["PaymentMethod"] """ PaymentMethod objects represent your customer's payment instruments. - You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to + You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. - Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios). + Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios). """ payment_method_type: Optional[str] """ @@ -346,7 +347,7 @@ class LastSetupError(StripeObject): """ 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](https://stripe.com/docs/api#payment_intents) to drive the payment flow. + Later, you can use [PaymentIntents](https://api.stripe.com#payment_intents) 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. @@ -357,9 +358,9 @@ class LastSetupError(StripeObject): For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) might need to be run through [Strong Customer Authentication](https://docs.stripe.com/strong-customer-authentication) during payment method collection to streamline later [off-session payments](https://docs.stripe.com/payments/setup-intents). - If you use the SetupIntent with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer), + If you use the SetupIntent with a [Customer](https://api.stripe.com#setup_intent_object-customer), it automatically attaches the resulting payment method to that Customer after successful setup. - We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on + We recommend using SetupIntents or [setup_future_usage](https://api.stripe.com#payment_intent_object-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. @@ -606,7 +607,7 @@ class MandateOptions(StripeObject): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ _inner_class_types = {"mandate_options": MandateOptions} @@ -1000,7 +1001,7 @@ class MandateOptions(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ next_action: Optional[NextAction] """ @@ -1022,7 +1023,7 @@ class MandateOptions(StripeObject): PaymentMethodConfigurationDetails ] """ - Information about the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) used for this Setup Intent. + Information about the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) used for this Setup Intent. """ payment_method_options: Optional[PaymentMethodOptions] """ @@ -1045,7 +1046,7 @@ class MandateOptions(StripeObject): "succeeded", ] """ - [Status](https://stripe.com/docs/payments/intents#intent-statuses) of this SetupIntent, one of `requires_payment_method`, `requires_confirmation`, `requires_action`, `processing`, `canceled`, or `succeeded`. + [Status](https://docs.stripe.com/payments/intents#intent-statuses) of this SetupIntent, one of `requires_payment_method`, `requires_confirmation`, `requires_action`, `processing`, `canceled`, or `succeeded`. """ usage: str """ diff --git a/stripe/_shipping_rate.py b/stripe/_shipping_rate.py index 1389c7506..d62ef0b46 100644 --- a/stripe/_shipping_rate.py +++ b/stripe/_shipping_rate.py @@ -31,7 +31,7 @@ class ShippingRate( ): """ Shipping rates describe the price of shipping presented to your customers and - applied to a purchase. For more information, see [Charge for shipping](https://stripe.com/docs/payments/during-payment/charge-shipping). + applied to a purchase. For more information, see [Charge for shipping](https://docs.stripe.com/payments/during-payment/charge-shipping). """ OBJECT_NAME: ClassVar[Literal["shipping_rate"]] = "shipping_rate" @@ -120,7 +120,7 @@ class CurrencyOptions(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["shipping_rate"] """ @@ -132,7 +132,7 @@ class CurrencyOptions(StripeObject): """ tax_code: Optional[ExpandableField["TaxCode"]] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: Literal["fixed_amount"] """ diff --git a/stripe/_source.py b/stripe/_source.py index a7fb2315b..b032e7d85 100644 --- a/stripe/_source.py +++ b/stripe/_source.py @@ -28,11 +28,11 @@ class Source(CreateableAPIResource["Source"], UpdateableAPIResource["Source"]): just like a `Card` object: once chargeable, they can be charged, or can be attached to customers. - Stripe doesn't recommend using the deprecated [Sources API](https://stripe.com/docs/api/sources). - We recommend that you adopt the [PaymentMethods API](https://stripe.com/docs/api/payment_methods). + Stripe doesn't recommend using the deprecated [Sources API](https://docs.stripe.com/api/sources). + We recommend that you adopt the [PaymentMethods API](https://docs.stripe.com/api/payment_methods). This newer API provides access to our latest features and payment method types. - Related guides: [Sources API](https://stripe.com/docs/sources) and [Sources & Customers](https://stripe.com/docs/sources/customers). + Related guides: [Sources API](https://docs.stripe.com/sources) and [Sources & Customers](https://docs.stripe.com/sources/customers). """ OBJECT_NAME: ClassVar[Literal["source"]] = "source" @@ -224,7 +224,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class VerifiedAddress(StripeObject): @@ -250,7 +250,7 @@ class VerifiedAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -430,7 +430,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Optional[Address] @@ -550,7 +550,7 @@ class Wechat(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ multibanco: Optional[Multibanco] object: Literal["source"] @@ -601,7 +601,7 @@ class Wechat(StripeObject): "wechat", ] """ - The `type` of the source. The `type` is a payment method, one of `ach_credit_transfer`, `ach_debit`, `alipay`, `bancontact`, `card`, `card_present`, `eps`, `giropay`, `ideal`, `multibanco`, `klarna`, `p24`, `sepa_debit`, `sofort`, `three_d_secure`, or `wechat`. An additional hash is included on the source with a name matching this value. It contains additional information specific to the [payment method](https://stripe.com/docs/sources) used. + The `type` of the source. The `type` is a payment method, one of `ach_credit_transfer`, `ach_debit`, `alipay`, `bancontact`, `card`, `card_present`, `eps`, `giropay`, `ideal`, `multibanco`, `klarna`, `p24`, `sepa_debit`, `sofort`, `three_d_secure`, or `wechat`. An additional hash is included on the source with a name matching this value. It contains additional information specific to the [payment method](https://docs.stripe.com/sources) used. """ usage: Optional[str] """ diff --git a/stripe/_source_mandate_notification.py b/stripe/_source_mandate_notification.py index 2d6a62020..4d99bffe1 100644 --- a/stripe/_source_mandate_notification.py +++ b/stripe/_source_mandate_notification.py @@ -79,11 +79,11 @@ class SepaDebit(StripeObject): just like a `Card` object: once chargeable, they can be charged, or can be attached to customers. - Stripe doesn't recommend using the deprecated [Sources API](https://stripe.com/docs/api/sources). - We recommend that you adopt the [PaymentMethods API](https://stripe.com/docs/api/payment_methods). + Stripe doesn't recommend using the deprecated [Sources API](https://docs.stripe.com/api/sources). + We recommend that you adopt the [PaymentMethods API](https://docs.stripe.com/api/payment_methods). This newer API provides access to our latest features and payment method types. - Related guides: [Sources API](https://stripe.com/docs/sources) and [Sources & Customers](https://stripe.com/docs/sources/customers). + Related guides: [Sources API](https://docs.stripe.com/sources) and [Sources & Customers](https://docs.stripe.com/sources/customers). """ status: str """ diff --git a/stripe/_stripe_client.py b/stripe/_stripe_client.py index 9223fa8f2..7a36fb3f3 100644 --- a/stripe/_stripe_client.py +++ b/stripe/_stripe_client.py @@ -111,6 +111,7 @@ from stripe._radar_service import RadarService from stripe._refund_service import RefundService from stripe._reporting_service import ReportingService + from stripe._reserve_service import ReserveService from stripe._review_service import ReviewService from stripe._setup_attempt_service import SetupAttemptService from stripe._setup_intent_service import SetupIntentService @@ -978,6 +979,17 @@ def refunds(self) -> "RefundService": def reporting(self) -> "ReportingService": return self.v1.reporting + @property + @deprecated( + """ + StripeClient.reserve is deprecated, use StripeClient.v1.reserve instead. + All functionality under it has been copied over to StripeClient.v1.reserve. + See [migration guide](https://github.com/stripe/stripe-python/wiki/v1-namespace-in-StripeClient) for more on this and tips on migrating to the new v1 namespace. + """, + ) + def reserve(self) -> "ReserveService": + return self.v1.reserve + @property @deprecated( """ diff --git a/stripe/_stripe_object.py b/stripe/_stripe_object.py index 0f44342f4..6ce504aa6 100644 --- a/stripe/_stripe_object.py +++ b/stripe/_stripe_object.py @@ -216,6 +216,15 @@ def __getitem__(self, k: str) -> Any: % (k, k, ", ".join(list(self.keys()))) ) else: + from stripe._invoice import Invoice + + # super specific one-off case to help users debug this property disappearing + # see also: https://go/j/DEVSDK-2835 + if isinstance(self, Invoice) and k == "payment_intent": + raise KeyError( + "The 'payment_intent' attribute is no longer available on Invoice objects. See the docs for more details: https://docs.stripe.com/changelog/basil/2025-03-31/add-support-for-multiple-partial-payments-on-invoices#why-is-this-a-breaking-change" + ) + raise err def __delitem__(self, k: str) -> None: diff --git a/stripe/_subscription.py b/stripe/_subscription.py index a39d98f33..9ffdac30d 100644 --- a/stripe/_subscription.py +++ b/stripe/_subscription.py @@ -80,7 +80,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://docs.stripe.com/billing/subscriptions/creating) """ OBJECT_NAME: ClassVar[Literal["subscription"]] = "subscription" @@ -363,7 +363,7 @@ class MandateOptions(StripeObject): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ _inner_class_types = {"mandate_options": MandateOptions} @@ -395,6 +395,38 @@ class IdBankTransfer(StripeObject): class Konbini(StripeObject): pass + class Payto(StripeObject): + class MandateOptions(StripeObject): + amount: Optional[int] + """ + 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: Optional[Literal["fixed", "maximum"]] + """ + Only `maximum` is supported. + """ + purpose: Optional[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + mandate_options: Optional[MandateOptions] + _inner_class_types = {"mandate_options": MandateOptions} + class Pix(StripeObject): class MandateOptions(StripeObject): amount: Optional[int] @@ -528,6 +560,10 @@ class Filters(StripeObject): """ This sub-hash contains details about the Konbini payment method options to pass to invoices created by the subscription. """ + payto: Optional[Payto] + """ + This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription. + """ pix: Optional[Pix] """ This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription. @@ -551,6 +587,7 @@ class Filters(StripeObject): "customer_balance": CustomerBalance, "id_bank_transfer": IdBankTransfer, "konbini": Konbini, + "payto": Payto, "pix": Pix, "sepa_debit": SepaDebit, "upi": Upi, @@ -597,6 +634,7 @@ class Filters(StripeObject): "payco", "paynow", "paypal", + "payto", "pix", "promptpay", "revolut_pay", @@ -655,7 +693,7 @@ class PendingUpdate(StripeObject): """ trial_from_plan: Optional[bool] """ - Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. + Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://docs.stripe.com/billing/subscriptions/trials) to learn more. """ class Prebilling(StripeObject): @@ -716,7 +754,7 @@ class EndBehavior(StripeObject): """ billing_cycle_anchor: int """ - The reference point that aligns future [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle) dates. It sets the day of week for `week` intervals, the day of month for `month` and `year` intervals, and the month of year for `year` intervals. The timestamp is in UTC format. + The reference point that aligns future [billing cycle](https://docs.stripe.com/subscriptions/billing-cycle) dates. It sets the day of week for `week` intervals, the day of month for `month` and `year` intervals, and the month of year for `year` intervals. The timestamp is in UTC format. """ billing_cycle_anchor_config: Optional[BillingCycleAnchorConfig] """ @@ -768,7 +806,7 @@ class EndBehavior(StripeObject): """ customer_account: Optional[str] """ - ID of the account who owns the subscription. + ID of the account representing the customer who owns the subscription. """ days_until_due: Optional[int] """ @@ -776,7 +814,7 @@ class EndBehavior(StripeObject): """ default_payment_method: Optional[ExpandableField["PaymentMethod"]] """ - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_source: Optional[ ExpandableField[ @@ -784,7 +822,7 @@ class EndBehavior(StripeObject): ] ] """ - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_tax_rates: Optional[List["TaxRate"]] """ @@ -825,7 +863,7 @@ class EndBehavior(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ next_pending_invoice_item_invoice: Optional[int] """ @@ -837,11 +875,11 @@ class EndBehavior(StripeObject): """ on_behalf_of: Optional[ExpandableField["Account"]] """ - The account (if any) the charge was made on behalf of for charges associated with this subscription. See the [Connect documentation](https://stripe.com/docs/connect/subscriptions#on-behalf-of) for details. + The account (if any) the charge was made on behalf of for charges associated with this subscription. See the [Connect documentation](https://docs.stripe.com/connect/subscriptions#on-behalf-of) for details. """ pause_collection: Optional[PauseCollection] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ payment_settings: Optional[PaymentSettings] """ @@ -849,15 +887,15 @@ class EndBehavior(StripeObject): """ pending_invoice_item_interval: Optional[PendingInvoiceItemInterval] """ - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://stripe.com/docs/api#create_invoice) for the given subscription at the specified interval. + Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://docs.stripe.com/api#create_invoice) for the given subscription at the specified interval. """ pending_setup_intent: Optional[ExpandableField["SetupIntent"]] """ - You can use this [SetupIntent](https://stripe.com/docs/api/setup_intents) to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication#scenario-2). + You can use this [SetupIntent](https://docs.stripe.com/api/setup_intents) to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication#scenario-2). """ pending_update: Optional[PendingUpdate] """ - If specified, [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates) that will be applied to the subscription once the `latest_invoice` has been paid. + If specified, [pending updates](https://docs.stripe.com/billing/subscriptions/pending-updates) that will be applied to the subscription once the `latest_invoice` has been paid. """ prebilling: Optional[Prebilling] """ @@ -888,7 +926,7 @@ class EndBehavior(StripeObject): A subscription that is currently in a trial period is `trialing` and moves to `active` when the trial period is over. - A subscription can only enter a `paused` status [when a trial ends without a payment method](https://stripe.com/docs/billing/subscriptions/trials#create-free-trials-without-payment). A `paused` subscription doesn't generate invoices and can be resumed after your customer adds their payment method. The `paused` status is different from [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment), which still generates invoices and leaves the subscription's status unchanged. + A subscription can only enter a `paused` status [when a trial ends without a payment method](https://docs.stripe.com/billing/subscriptions/trials#create-free-trials-without-payment). A `paused` subscription doesn't generate invoices and can be resumed after your customer adds their payment method. The `paused` status is different from [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment), which still generates invoices and leaves the subscription's status unchanged. If subscription `collection_method=charge_automatically`, it becomes `past_due` when payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will become `canceled` or `unpaid` (depending on your subscriptions settings). diff --git a/stripe/_subscription_item.py b/stripe/_subscription_item.py index b080673ff..e49df77b5 100644 --- a/stripe/_subscription_item.py +++ b/stripe/_subscription_item.py @@ -96,7 +96,7 @@ class Trial(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["subscription_item"] """ @@ -104,27 +104,27 @@ class Trial(StripeObject): """ plan: "Plan" """ - You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration. + You can now model subscriptions more flexibly using the [Prices API](https://api.stripe.com#prices). It replaces the Plans API and is backwards compatible to simplify your migration. Plans define the base price, currency, and billing cycle for recurring purchases of products. - [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme. + [Products](https://api.stripe.com#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single "gold" product that has plans for $10/month, $100/year, €9/month, and €90/year. - Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) and more about [products and prices](https://stripe.com/docs/products-prices/overview). + Related guides: [Set up a subscription](https://docs.stripe.com/billing/subscriptions/set-up-subscription) and more about [products and prices](https://docs.stripe.com/products-prices/overview). """ price: "Price" """ Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products. - [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme. + [Products](https://api.stripe.com#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a single "gold" product that has prices for $10/month, $100/year, and €9 once. - Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), [create an invoice](https://stripe.com/docs/billing/invoices/create), and more about [products and prices](https://stripe.com/docs/products-prices/overview). + Related guides: [Set up a subscription](https://docs.stripe.com/billing/subscriptions/set-up-subscription), [create an invoice](https://docs.stripe.com/billing/invoices/create), and more about [products and prices](https://docs.stripe.com/products-prices/overview). """ quantity: Optional[int] """ - The [quantity](https://stripe.com/docs/subscriptions/quantities) of the plan to which the customer should be subscribed. + The [quantity](https://docs.stripe.com/subscriptions/quantities) of the plan to which the customer should be subscribed. """ subscription: str """ diff --git a/stripe/_subscription_schedule.py b/stripe/_subscription_schedule.py index f01f99ed9..83107998e 100644 --- a/stripe/_subscription_schedule.py +++ b/stripe/_subscription_schedule.py @@ -56,7 +56,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://docs.stripe.com/billing/subscriptions/subscription-schedules) """ OBJECT_NAME: ClassVar[Literal["subscription_schedule"]] = ( @@ -169,7 +169,7 @@ class TransferData(StripeObject): automatic_tax: Optional[AutomaticTax] billing_cycle_anchor: Literal["automatic", "phase_start"] """ - Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: Optional[BillingThresholds] """ @@ -296,7 +296,7 @@ class Start(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ period: Period price: ExpandableField["Price"] @@ -458,7 +458,7 @@ class Trial(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an item. Metadata on this item will update the underlying subscription item's `metadata` when the phase is entered. """ plan: ExpandableField["Plan"] """ @@ -526,7 +526,7 @@ class EndBehavior(StripeObject): automatic_tax: Optional[AutomaticTax] billing_cycle_anchor: Optional[Literal["automatic", "phase_start"]] """ - Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Possible values are `phase_start` or `automatic`. If `phase_start` then billing cycle anchor of the subscription is set to the start of the phase when entering the phase. If `automatic` then the billing cycle anchor is automatically modified as needed when entering the phase. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: Optional[BillingThresholds] """ @@ -572,7 +572,7 @@ class EndBehavior(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered. Updating the underlying subscription's `metadata` directly will not affect the current phase's `metadata`. """ on_behalf_of: Optional[ExpandableField["Account"]] """ @@ -580,7 +580,7 @@ class EndBehavior(StripeObject): """ pause_collection: Optional[PauseCollection] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ proration_behavior: Literal[ "always_invoice", "create_prorations", "none" @@ -695,7 +695,7 @@ class Prebilling(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["subscription_schedule"] """ @@ -721,7 +721,7 @@ class Prebilling(StripeObject): "active", "canceled", "completed", "not_started", "released" ] """ - The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://stripe.com/docs/billing/subscriptions/subscription-schedules). + The present status of the subscription schedule. Possible values are `not_started`, `active`, `completed`, `released`, and `canceled`. You can read more about the different states in our [behavior guide](https://docs.stripe.com/billing/subscriptions/subscription-schedules). """ subscription: Optional[ExpandableField["Subscription"]] """ diff --git a/stripe/_tax_id.py b/stripe/_tax_id.py index 19638b5d9..c724f2835 100644 --- a/stripe/_tax_id.py +++ b/stripe/_tax_id.py @@ -26,10 +26,10 @@ class TaxId( ListableAPIResource["TaxId"], ): """ - You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers) or account. + You can add one or multiple tax IDs to a [customer](https://docs.stripe.com/api/customers) or account. Customer and account tax IDs get displayed on related invoices and credit notes. - Related guides: [Customer tax identification numbers](https://stripe.com/docs/billing/taxes/tax-ids), [Account tax IDs](https://stripe.com/docs/invoicing/connect#account-tax-ids) + Related guides: [Customer tax identification numbers](https://docs.stripe.com/billing/taxes/tax-ids), [Account tax IDs](https://docs.stripe.com/invoicing/connect#account-tax-ids) """ OBJECT_NAME: ClassVar[Literal["tax_id"]] = "tax_id" @@ -49,7 +49,7 @@ class Owner(StripeObject): """ customer_account: Optional[str] """ - The account being referenced when `type` is `customer`. + The Account representing the customer being referenced when `type` is `customer`. """ type: Literal["account", "application", "customer", "self"] """ @@ -84,7 +84,7 @@ class Verification(StripeObject): """ customer_account: Optional[str] """ - ID of the account. + ID of the Account representing the customer. """ deleted: Optional[Literal[True]] """ diff --git a/stripe/_tax_rate.py b/stripe/_tax_rate.py index ec57166e9..017cbf94f 100644 --- a/stripe/_tax_rate.py +++ b/stripe/_tax_rate.py @@ -93,7 +93,7 @@ class FlatAmount(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["tax_rate"] """ diff --git a/stripe/_token.py b/stripe/_token.py index bf02e107e..4415cb529 100644 --- a/stripe/_token.py +++ b/stripe/_token.py @@ -17,7 +17,7 @@ class Token(CreateableAPIResource["Token"]): account details, or personally identifiable information (PII), directly from your customers in a secure manner. A token representing this information is returned to your server to use. Use our - [recommended payments integrations](https://stripe.com/docs/payments) to perform this process + [recommended payments integrations](https://docs.stripe.com/payments) to perform this process on the client-side. This guarantees that no sensitive card data touches your server, and allows your integration to operate in a PCI-compliant way. @@ -29,9 +29,9 @@ class Token(CreateableAPIResource["Token"]): Stripe, so we can't determine how it's handled or stored. You can't store or use tokens more than once. To store card or bank account - information for later use, create [Customer](https://stripe.com/docs/api#customers) + information for later use, create [Customer](https://docs.stripe.com/api#customers) objects or [External accounts](https://docs.stripe.com/api#external_accounts). - [Radar](https://stripe.com/docs/radar), our integrated solution for automatic fraud protection, + [Radar](https://docs.stripe.com/radar), our integrated solution for automatic fraud protection, performs best with integrations that use client-side tokenization. """ @@ -52,7 +52,7 @@ class Token(CreateableAPIResource["Token"]): 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://docs.stripe.com/sources/cards) """ client_ip: Optional[str] """ diff --git a/stripe/_topup.py b/stripe/_topup.py index e95ddfd20..dab41171d 100644 --- a/stripe/_topup.py +++ b/stripe/_topup.py @@ -29,7 +29,7 @@ class Topup( individual top-ups, as well as list all top-ups. Top-ups are identified by a unique, random ID. - Related guide: [Topping up your platform account](https://stripe.com/docs/connect/top-ups) + Related guide: [Topping up your platform account](https://docs.stripe.com/connect/top-ups) """ OBJECT_NAME: ClassVar[Literal["topup"]] = "topup" @@ -59,7 +59,7 @@ class Topup( """ failure_code: Optional[str] """ - Error code explaining reason for top-up failure if available (see [the errors section](https://stripe.com/docs/api#errors) for a list of codes). + Error code explaining reason for top-up failure if available (see [the errors section](https://docs.stripe.com/api#errors) for a list of codes). """ failure_message: Optional[str] """ @@ -75,7 +75,7 @@ class Topup( """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["topup"] """ diff --git a/stripe/_transfer.py b/stripe/_transfer.py index 231f789cb..4c78864b7 100644 --- a/stripe/_transfer.py +++ b/stripe/_transfer.py @@ -45,11 +45,11 @@ class Transfer( Before April 6, 2017, transfers also represented movement of funds from a Stripe account to a card or bank account. This behavior has since been split - out into a [Payout](https://stripe.com/docs/api#payout_object) object, with corresponding payout endpoints. For more + out into a [Payout](https://api.stripe.com#payout_object) object, with corresponding payout endpoints. For more information, read about the - [transfer/payout split](https://stripe.com/docs/transfer-payout-split). + [transfer/payout split](https://docs.stripe.com/transfer-payout-split). - Related guide: [Creating separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) + Related guide: [Creating separate charges and transfers](https://docs.stripe.com/connect/separate-charges-and-transfers) """ OBJECT_NAME: ClassVar[Literal["transfer"]] = "transfer" @@ -99,7 +99,7 @@ class Transfer( """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["transfer"] """ @@ -123,7 +123,7 @@ class Transfer( """ transfer_group: Optional[str] """ - A string that identifies this transaction as part of a group. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details. + A string that identifies this transaction as part of a group. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details. """ @classmethod diff --git a/stripe/_v1_services.py b/stripe/_v1_services.py index 0f739ecaa..3f5b59c87 100644 --- a/stripe/_v1_services.py +++ b/stripe/_v1_services.py @@ -74,6 +74,7 @@ from stripe._radar_service import RadarService from stripe._refund_service import RefundService from stripe._reporting_service import ReportingService + from stripe._reserve_service import ReserveService from stripe._review_service import ReviewService from stripe._setup_attempt_service import SetupAttemptService from stripe._setup_intent_service import SetupIntentService @@ -217,6 +218,7 @@ "radar": ["stripe._radar_service", "RadarService"], "refunds": ["stripe._refund_service", "RefundService"], "reporting": ["stripe._reporting_service", "ReportingService"], + "reserve": ["stripe._reserve_service", "ReserveService"], "reviews": ["stripe._review_service", "ReviewService"], "setup_attempts": ["stripe._setup_attempt_service", "SetupAttemptService"], "setup_intents": ["stripe._setup_intent_service", "SetupIntentService"], @@ -309,6 +311,7 @@ class V1Services(StripeService): radar: "RadarService" refunds: "RefundService" reporting: "ReportingService" + reserve: "ReserveService" reviews: "ReviewService" setup_attempts: "SetupAttemptService" setup_intents: "SetupIntentService" diff --git a/stripe/_webhook_endpoint.py b/stripe/_webhook_endpoint.py index 50c1d8cf0..100640ce0 100644 --- a/stripe/_webhook_endpoint.py +++ b/stripe/_webhook_endpoint.py @@ -78,7 +78,7 @@ class WebhookEndpoint( """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["webhook_endpoint"] """ diff --git a/stripe/apps/_secret.py b/stripe/apps/_secret.py index 9ff3f402a..d258c4ddc 100644 --- a/stripe/apps/_secret.py +++ b/stripe/apps/_secret.py @@ -26,7 +26,7 @@ class Secret(CreateableAPIResource["Secret"], ListableAPIResource["Secret"]): 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://docs.stripe.com/stripe-apps/store-auth-data-custom-objects) """ OBJECT_NAME: ClassVar[Literal["apps.secret"]] = "apps.secret" diff --git a/stripe/billing/_alert.py b/stripe/billing/_alert.py index e7b6b800c..3699c662c 100644 --- a/stripe/billing/_alert.py +++ b/stripe/billing/_alert.py @@ -85,7 +85,7 @@ class Filter(StripeObject): """ usage_threshold: Optional[UsageThreshold] """ - Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://stripe.com/docs/api/billing/meter). + Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://docs.stripe.com/api/billing/meter). """ @classmethod diff --git a/stripe/billing/_credit_grant.py b/stripe/billing/_credit_grant.py index 08444ed3d..2c091e302 100644 --- a/stripe/billing/_credit_grant.py +++ b/stripe/billing/_credit_grant.py @@ -106,7 +106,7 @@ class Price(StripeObject): """ customer_account: Optional[str] """ - ID of the account receiving the billing credits + ID of the account representing the customer receiving the billing credits """ effective_at: Optional[int] """ @@ -126,7 +126,7 @@ class Price(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: Optional[str] """ diff --git a/stripe/billing/_meter_event.py b/stripe/billing/_meter_event.py index 53dcfa569..8fa8003d3 100644 --- a/stripe/billing/_meter_event.py +++ b/stripe/billing/_meter_event.py @@ -40,7 +40,7 @@ class MeterEvent(CreateableAPIResource["MeterEvent"]): """ payload: Dict[str, str] """ - The payload of the event. This contains the fields corresponding to a meter's `customer_mapping.event_payload_key` (default is `stripe_customer_id`) and `value_settings.event_payload_key` (default is `value`). Read more about the [payload](https://stripe.com/docs/billing/subscriptions/usage-based/recording-usage#payload-key-overrides). + The payload of the event. This contains the fields corresponding to a meter's `customer_mapping.event_payload_key` (default is `stripe_customer_id`) and `value_settings.event_payload_key` (default is `value`). Read more about the [payload](https://docs.stripe.com/billing/subscriptions/usage-based/meters/configure#meter-configuration-attributes). """ timestamp: int """ diff --git a/stripe/billing_portal/_configuration.py b/stripe/billing_portal/_configuration.py index 451dca049..3dc14ebc1 100644 --- a/stripe/billing_portal/_configuration.py +++ b/stripe/billing_portal/_configuration.py @@ -167,6 +167,10 @@ class Condition(StripeObject): """ _inner_class_types = {"conditions": Condition} + billing_cycle_anchor: Optional[Literal["now", "unchanged"]] + """ + Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). + """ default_allowed_updates: List[ Literal["price", "promotion_code", "quantity"] ] @@ -219,7 +223,7 @@ class LoginPage(StripeObject): """ url: Optional[str] """ - A shareable URL to the hosted portal login page. Your customers will be able to log in with their [email](https://stripe.com/docs/api/customers/object#customer_object-email) and receive a link to their customer portal. + A shareable URL to the hosted portal login page. Your customers will be able to log in with their [email](https://docs.stripe.com/api/customers/object#customer_object-email) and receive a link to their customer portal. """ active: bool @@ -237,7 +241,7 @@ class LoginPage(StripeObject): """ default_return_url: Optional[str] """ - The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. + The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. """ features: Features id: str @@ -255,7 +259,7 @@ class LoginPage(StripeObject): login_page: LoginPage metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: Optional[str] """ diff --git a/stripe/billing_portal/_session.py b/stripe/billing_portal/_session.py index d1499dc8b..fe61bda62 100644 --- a/stripe/billing_portal/_session.py +++ b/stripe/billing_portal/_session.py @@ -114,15 +114,15 @@ class Discount(StripeObject): class Item(StripeObject): id: Optional[str] """ - The ID of the [subscription item](https://stripe.com/docs/api/subscriptions/object#subscription_object-items-data-id) to be updated. + The ID of the [subscription item](https://docs.stripe.com/api/subscriptions/object#subscription_object-items-data-id) to be updated. """ price: Optional[str] """ - The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products). + The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products). """ quantity: Optional[int] """ - [Quantity](https://stripe.com/docs/subscriptions/quantities) for this item that the customer should subscribe to through this flow. + [Quantity](https://docs.stripe.com/subscriptions/quantities) for this item that the customer should subscribe to through this flow. """ discounts: Optional[List[Discount]] @@ -131,7 +131,7 @@ class Item(StripeObject): """ items: List[Item] """ - The [subscription item](https://stripe.com/docs/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable. + The [subscription item](https://docs.stripe.com/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable. """ subscription: str """ @@ -186,7 +186,7 @@ class Item(StripeObject): """ flow: Optional[Flow] """ - Information about a specific flow for the customer to go through. See the [docs](https://stripe.com/docs/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows. + Information about a specific flow for the customer to go through. See the [docs](https://docs.stripe.com/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows. """ id: str """ @@ -256,7 +256,7 @@ class Item(StripeObject): """ on_behalf_of: Optional[str] """ - The account for which the session was created on behalf of. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays. + The account for which the session was created on behalf of. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://docs.stripe.com/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://docs.stripe.com/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays. """ return_url: Optional[str] """ diff --git a/stripe/capital/_financing_offer.py b/stripe/capital/_financing_offer.py index c776f8861..3bdbfdc47 100644 --- a/stripe/capital/_financing_offer.py +++ b/stripe/capital/_financing_offer.py @@ -120,7 +120,7 @@ class OfferedTerms(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["capital.financing_offer"] """ @@ -161,7 +161,7 @@ class OfferedTerms(StripeObject): """ type: Optional[Literal["cash_advance", "fixed_term_loan", "flex_loan"]] """ - See [financing_type](https://stripe.com/docs/api/capital/connect_financing_object#financing_offer_object-financing_type). + See [financing_type](https://docs.stripe.com/api/capital/connect_financing_object#financing_offer_object-financing_type). """ @classmethod diff --git a/stripe/capital/_financing_summary.py b/stripe/capital/_financing_summary.py index 5d1633562..69e9fa7ef 100644 --- a/stripe/capital/_financing_summary.py +++ b/stripe/capital/_financing_summary.py @@ -13,8 +13,9 @@ class FinancingSummary(SingletonAPIResource["FinancingSummary"]): """ - A financing object describes an account's current financing state. Used by Connect - platforms to read the state of Capital offered to their connected accounts. + A financing summary object describes a connected account's financing status in real time. + A financing status is either `accepted`, `delivered`, or `none`. + You can read the status of your connected accounts. """ OBJECT_NAME: ClassVar[Literal["capital.financing_summary"]] = ( @@ -82,10 +83,12 @@ class CurrentRepaymentInterval(StripeObject): Additional information about the financing summary. Describes currency, advance amount, fee amount, withhold rate, remaining amount, paid amount, current repayment interval, repayment start date, and advance payout date. + + Only present for financing offers with the `paid_out` status. """ financing_offer: Optional[str] """ - The Financing Offer ID this Financing Summary corresponds to + The unique identifier of the Financing Offer object that corresponds to the Financing Summary object. """ object: Literal["capital.financing_summary"] """ @@ -93,7 +96,7 @@ class CurrentRepaymentInterval(StripeObject): """ status: Optional[Literal["accepted", "delivered", "none"]] """ - Status of the Connected Account's financing. [/v1/capital/financing_summary](https://stripe.com/docs/api/capital/financing_summary) will only return `details` for `paid_out` financing. + The financing status of the connected account. """ @classmethod @@ -101,7 +104,7 @@ def retrieve( cls, **params: Unpack["FinancingSummaryRetrieveParams"] ) -> "FinancingSummary": """ - Retrieve the financing state for the account that was authenticated in the request. + Retrieve the financing summary object for the account. """ instance = cls(None, **params) instance.refresh() @@ -112,7 +115,7 @@ async def retrieve_async( cls, **params: Unpack["FinancingSummaryRetrieveParams"] ) -> "FinancingSummary": """ - Retrieve the financing state for the account that was authenticated in the request. + Retrieve the financing summary object for the account. """ instance = cls(None, **params) await instance.refresh_async() diff --git a/stripe/capital/_financing_summary_service.py b/stripe/capital/_financing_summary_service.py index cd97728db..189044120 100644 --- a/stripe/capital/_financing_summary_service.py +++ b/stripe/capital/_financing_summary_service.py @@ -19,7 +19,7 @@ def retrieve( options: Optional["RequestOptions"] = None, ) -> "FinancingSummary": """ - Retrieve the financing state for the account that was authenticated in the request. + Retrieve the financing summary object for the account. """ return cast( "FinancingSummary", @@ -38,7 +38,7 @@ async def retrieve_async( options: Optional["RequestOptions"] = None, ) -> "FinancingSummary": """ - Retrieve the financing state for the account that was authenticated in the request. + Retrieve the financing summary object for the account. """ return cast( "FinancingSummary", diff --git a/stripe/checkout/_session.py b/stripe/checkout/_session.py index 3139e3db4..54c4212bc 100644 --- a/stripe/checkout/_session.py +++ b/stripe/checkout/_session.py @@ -50,19 +50,19 @@ class Session( ): """ A Checkout Session represents your customer's session as they pay for - one-time purchases or subscriptions through [Checkout](https://stripe.com/docs/payments/checkout) - or [Payment Links](https://stripe.com/docs/payments/payment-links). We recommend creating a + one-time purchases or subscriptions through [Checkout](https://docs.stripe.com/payments/checkout) + or [Payment Links](https://docs.stripe.com/payments/payment-links). We recommend creating a new Session each time your customer attempts to pay. Once payment is successful, the Checkout Session will contain a reference - to the [Customer](https://stripe.com/docs/api/customers), and either the successful - [PaymentIntent](https://stripe.com/docs/api/payment_intents) or an active - [Subscription](https://stripe.com/docs/api/subscriptions). + to the [Customer](https://docs.stripe.com/api/customers), and either the successful + [PaymentIntent](https://docs.stripe.com/api/payment_intents) or an active + [Subscription](https://docs.stripe.com/api/subscriptions). 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://docs.stripe.com/checkout/quickstart) """ OBJECT_NAME: ClassVar[Literal["checkout.session"]] = "checkout.session" @@ -215,7 +215,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -599,7 +599,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class TaxId(StripeObject): @@ -823,7 +823,7 @@ class RenderingOptions(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ rendering_options: Optional[RenderingOptions] """ @@ -1151,7 +1151,7 @@ class Restrictions(StripeObject): """ request_three_d_secure: Literal["any", "automatic", "challenge"] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ restrictions: Optional[Restrictions] setup_future_usage: Optional[ @@ -2312,10 +2312,10 @@ class Discount(StripeObject): """ discount: "DiscountResource" """ - A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes). + A discount represents the actual application of a [coupon](https://api.stripe.com#coupons) or [promotion code](https://api.stripe.com#promotion_codes). It contains information about when the discount began, when it will end, and what it is applied to. - Related guide: [Applying discounts to subscriptions](https://stripe.com/docs/billing/subscriptions/discounts) + Related guide: [Applying discounts to subscriptions](https://docs.stripe.com/billing/subscriptions/discounts) """ class Tax(StripeObject): @@ -2430,7 +2430,7 @@ class Link(StripeObject): client_secret: Optional[str] """ The client secret of your Checkout Session. Applies to Checkout Sessions with `ui_mode: embedded` or `ui_mode: custom`. For `ui_mode: embedded`, the client secret is to be used when initializing Stripe.js embedded checkout. - For `ui_mode: custom`, use the client secret with [initCheckout](https://stripe.com/docs/js/custom_checkout/init) on your front end. + For `ui_mode: custom`, use the client secret with [initCheckout](https://docs.stripe.com/js/custom_checkout/init) on your front end. """ collected_information: Optional[CollectedInformation] """ @@ -2571,7 +2571,7 @@ class Link(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ mode: Literal["payment", "setup", "subscription"] """ @@ -2592,7 +2592,7 @@ class Link(StripeObject): """ payment_intent: Optional[ExpandableField["PaymentIntent"]] """ - The ID of the PaymentIntent for Checkout Sessions in `payment` mode. You can't confirm or cancel the PaymentIntent for a Checkout Session. To cancel, [expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead. + The ID of the PaymentIntent for Checkout Sessions in `payment` mode. You can't confirm or cancel the PaymentIntent for a Checkout Session. To cancel, [expire the Checkout Session](https://docs.stripe.com/api/checkout/sessions/expire) instead. """ payment_link: Optional[ExpandableField["PaymentLink"]] """ @@ -2636,7 +2636,7 @@ class Link(StripeObject): """ redirect_on_completion: Optional[Literal["always", "if_required", "never"]] """ - This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://stripe.com/docs/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`. + This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://docs.stripe.com/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`. """ return_url: Optional[str] """ @@ -2648,7 +2648,7 @@ class Link(StripeObject): """ setup_intent: Optional[ExpandableField["SetupIntent"]] """ - The ID of the SetupIntent for Checkout Sessions in `setup` mode. You can't confirm or cancel the SetupIntent for a Checkout Session. To cancel, [expire the Checkout Session](https://stripe.com/docs/api/checkout/sessions/expire) instead. + The ID of the SetupIntent for Checkout Sessions in `setup` mode. You can't confirm or cancel the SetupIntent for a Checkout Session. To cancel, [expire the Checkout Session](https://docs.stripe.com/api/checkout/sessions/expire) instead. """ shipping_address_collection: Optional[ShippingAddressCollection] """ @@ -2676,7 +2676,7 @@ class Link(StripeObject): """ subscription: Optional[ExpandableField["Subscription"]] """ - The ID of the [Subscription](https://stripe.com/docs/api/subscriptions) for Checkout Sessions in `subscription` mode. + The ID of the [Subscription](https://docs.stripe.com/api/subscriptions) for Checkout Sessions in `subscription` mode. """ success_url: Optional[str] """ @@ -2694,7 +2694,7 @@ class Link(StripeObject): """ url: Optional[str] """ - The URL to the Checkout Session. Applies to Checkout Sessions with `ui_mode: hosted`. Redirect customers to this URL to take them to Checkout. If you're using [Custom Domains](https://stripe.com/docs/payments/checkout/custom-domains), the URL will use your subdomain. Otherwise, it'll use `checkout.stripe.com.` + The URL to the Checkout Session. Applies to Checkout Sessions with `ui_mode: hosted`. Redirect customers to this URL to take them to Checkout. If you're using [Custom Domains](https://docs.stripe.com/payments/checkout/custom-domains), the URL will use your subdomain. Otherwise, it'll use `checkout.stripe.com.` This value is only present when the session is active. """ wallet_options: Optional[WalletOptions] diff --git a/stripe/climate/_order.py b/stripe/climate/_order.py index 477690ee9..2e92175f0 100644 --- a/stripe/climate/_order.py +++ b/stripe/climate/_order.py @@ -150,7 +150,7 @@ class Location(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ metric_tons: str """ diff --git a/stripe/data/ca-certificates.crt b/stripe/data/ca-certificates.crt index 26f135040..65be891ee 100644 --- a/stripe/data/ca-certificates.crt +++ b/stripe/data/ca-certificates.crt @@ -1,89 +1,25 @@ ## ## Bundle of CA Root Certificates ## -## Certificate data from Mozilla as of: Tue Apr 26 03:12:05 2022 GMT +## Certificate data from Mozilla as of: Tue Dec 2 04:12:02 2025 GMT +## +## Find updated versions here: https://curl.se/docs/caextract.html ## ## This is a bundle of X.509 certificates of public Certificate Authorities ## (CA). These were automatically extracted from Mozilla's root certificates ## file (certdata.txt). This file can be found in the mozilla source tree: -## https://hg.mozilla.org/releases/mozilla-release/raw-file/default/security/nss/lib/ckfw/builtins/certdata.txt +## https://raw.githubusercontent.com/mozilla-firefox/firefox/refs/heads/release/security/nss/lib/ckfw/builtins/certdata.txt ## ## It contains the certificates in PEM format and therefore ## can be directly used with curl / libcurl / php_curl, or with ## an Apache+mod_ssl webserver for SSL client authentication. ## Just configure this file as the SSLCACertificateFile. ## -## Conversion done with mk-ca-bundle.pl version 1.29. -## SHA256: 34a54d5191775c1bd37be6cfd3f09e831e072555dc3a2e51f4a2c4b0f8ada5cc +## Conversion done with mk-ca-bundle.pl version 1.30. +## SHA256: a903b3cd05231e39332515ef7ebe37e697262f39515a52015c23c62805b73cd0 ## -GlobalSign Root CA -================== ------BEGIN CERTIFICATE----- -MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkGA1UEBhMCQkUx -GTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jvb3QgQ0ExGzAZBgNVBAMTEkds -b2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAwMDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNV -BAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYD -VQQDExJHbG9iYWxTaWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDa -DuaZjc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavpxy0Sy6sc -THAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp1Wrjsok6Vjk4bwY8iGlb -Kk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdGsnUOhugZitVtbNV4FpWi6cgKOOvyJBNP -c1STE4U6G7weNLWLBYy5d4ux2x8gkasJU26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrX -gzT/LCrBbBlDSgeF59N89iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV -HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0BAQUF -AAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOzyj1hTdNGCbM+w6Dj -Y1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE38NflNUVyRRBnMRddWQVDf9VMOyG -j/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymPAbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhH -hm4qxFYxldBniYUr+WymXUadDKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveC -X4XSQRjbgbMEHMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A== ------END CERTIFICATE----- - -Entrust.net Premium 2048 Secure Server CA -========================================= ------BEGIN CERTIFICATE----- -MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChMLRW50cnVzdC5u -ZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBpbmNvcnAuIGJ5IHJlZi4gKGxp -bWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNV -BAMTKkVudHJ1c3QubmV0IENlcnRpZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQx -NzUwNTFaFw0yOTA3MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3 -d3d3LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxpYWIuKTEl -MCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEGA1UEAxMqRW50cnVzdC5u -ZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgpMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A -MIIBCgKCAQEArU1LqRKGsuqjIAcVFmQqK0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOL -Gp18EzoOH1u3Hs/lJBQesYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSr -hRSGlVuXMlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVTXTzW -nLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/HoZdenoVve8AjhUi -VBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH4QIDAQABo0IwQDAOBgNVHQ8BAf8E -BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJ -KoZIhvcNAQEFBQADggEBADubj1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPy -T/4xmf3IDExoU8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf -zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5bu/8j72gZyxKT -J1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+bYQLCIt+jerXmCHG8+c8eS9e -nNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/ErfF6adulZkMV8gzURZVE= ------END CERTIFICATE----- - -Baltimore CyberTrust Root -========================= ------BEGIN CERTIFICATE----- -MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJRTESMBAGA1UE -ChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYDVQQDExlCYWx0aW1vcmUgQ3li -ZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoXDTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMC -SUUxEjAQBgNVBAoTCUJhbHRpbW9yZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFs -dGltb3JlIEN5YmVyVHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKME -uyKrmD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjrIZ3AQSsB -UnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeKmpYcqWe4PwzV9/lSEy/C -G9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSuXmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9 -XbIGevOF6uvUA65ehD5f/xXtabz5OTZydc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjpr -l3RjM71oGDHweI12v/yejl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoI -VDaGezq1BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEB -BQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT929hkTI7gQCvlYpNRh -cL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3WgxjkzSswF07r51XgdIGn9w/xZchMB5 -hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsa -Y71k5h+3zvDyny67G7fyUIhzksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9H -RCwBXbsdtTLSR9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp ------END CERTIFICATE----- - Entrust Root Certification Authority ==================================== -----BEGIN CERTIFICATE----- @@ -110,30 +46,6 @@ W3iDVuycNsMm4hH2Z0kdkquM++v/eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0 tHuu2guQOHXvgR1m0vdXcDazv/wor3ElhVsT/h5/WrQ8 -----END CERTIFICATE----- -Comodo AAA Services root -======================== ------BEGIN CERTIFICATE----- -MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEbMBkGA1UECAwS -R3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRowGAYDVQQKDBFDb21vZG8gQ0Eg -TGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmljYXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAw -MFoXDTI4MTIzMTIzNTk1OVowezELMAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hl -c3RlcjEQMA4GA1UEBwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNV -BAMMGEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC -ggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQuaBtDFcCLNSS1UY8y2bmhG -C1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe3M/vg4aijJRPn2jymJBGhCfHdr/jzDUs -i14HZGWCwEiwqJH5YZ92IFCokcdmtet4YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszW -Y19zjNoFmag4qMsXeDZRrOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjH -Ypy+g8cmez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQUoBEK -Iz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wewYDVR0f -BHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNl -cy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29tb2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2Vz -LmNybDANBgkqhkiG9w0BAQUFAAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm -7l3sAg9g1o1QGE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz -Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2G9w84FoVxp7Z -8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsil2D4kF501KKaU73yqWjgom7C -12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg== ------END CERTIFICATE----- - QuoVadis Root CA 2 ================== -----BEGIN CERTIFICATE----- @@ -200,99 +112,6 @@ vGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeTmJlglFwjz1onl14LBQaTNx47aTbr qZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK4SVhM7JZG+Ju1zdXtg2pEto= -----END CERTIFICATE----- -Security Communication Root CA -============================== ------BEGIN CERTIFICATE----- -MIIDWjCCAkKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJKUDEYMBYGA1UEChMP -U0VDT00gVHJ1c3QubmV0MScwJQYDVQQLEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTEw -HhcNMDMwOTMwMDQyMDQ5WhcNMjMwOTMwMDQyMDQ5WjBQMQswCQYDVQQGEwJKUDEYMBYGA1UEChMP -U0VDT00gVHJ1c3QubmV0MScwJQYDVQQLEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTEw -ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCzs/5/022x7xZ8V6UMbXaKL0u/ZPtM7orw -8yl89f/uKuDp6bpbZCKamm8sOiZpUQWZJtzVHGpxxpp9Hp3dfGzGjGdnSj74cbAZJ6kJDKaVv0uM -DPpVmDvY6CKhS3E4eayXkmmziX7qIWgGmBSWh9JhNrxtJ1aeV+7AwFb9Ms+k2Y7CI9eNqPPYJayX -5HA49LY6tJ07lyZDo6G8SVlyTCMwhwFY9k6+HGhWZq/NQV3Is00qVUarH9oe4kA92819uZKAnDfd -DJZkndwi92SL32HeFZRSFaB9UslLqCHJxrHty8OVYNEP8Ktw+N/LTX7s1vqr2b1/VPKl6Xn62dZ2 -JChzAgMBAAGjPzA9MB0GA1UdDgQWBBSgc0mZaNyFW2XjmygvV5+9M7wHSDALBgNVHQ8EBAMCAQYw -DwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAaECpqLvkT115swW1F7NgE+vGkl3g -0dNq/vu+m22/xwVtWSDEHPC32oRYAmP6SBbvT6UL90qY8j+eG61Ha2POCEfrUj94nK9NrvjVT8+a -mCoQQTlSxN3Zmw7vkwGusi7KaEIkQmywszo+zenaSMQVy+n5Bw+SUEmK3TGXX8npN6o7WWWXlDLJ -s58+OmJYxUmtYg5xpTKqL8aJdkNAExNnPaJUJRDL8Try2frbSVa7pv6nQTXD4IhhyYjH3zYQIphZ -6rBK+1YWc26sTfcioU+tHXotRSflMMFe8toTyyVCUZVHA4xsIcx0Qu1T/zOLjw9XARYvz6buyXAi -FL39vmwLAw== ------END CERTIFICATE----- - -XRamp Global CA Root -==================== ------BEGIN CERTIFICATE----- -MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCBgjELMAkGA1UE -BhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2Vj -dXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB -dXRob3JpdHkwHhcNMDQxMTAxMTcxNDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMx -HjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkg -U2VydmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3Jp -dHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS638eMpSe2OAtp87ZOqCwu -IR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCPKZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMx -foArtYzAQDsRhtDLooY2YKTVMIJt2W7QDxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FE -zG+gSqmUsE3a56k0enI4qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqs -AxcZZPRaJSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNViPvry -xS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1Ud -EwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASsjVy16bYbMDYGA1UdHwQvMC0wK6Ap -oCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMC -AQEwDQYJKoZIhvcNAQEFBQADggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc -/Kh4ZzXxHfARvbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt -qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLaIR9NmXmd4c8n -nxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSyi6mx5O+aGtA9aZnuqCij4Tyz -8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQO+7ETPTsJ3xCwnR8gooJybQDJbw= ------END CERTIFICATE----- - -Go Daddy Class 2 CA -=================== ------BEGIN CERTIFICATE----- -MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMY -VGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRp -ZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkG -A1UEBhMCVVMxITAfBgNVBAoTGFRoZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28g -RGFkZHkgQ2xhc3MgMiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQAD -ggENADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCAPVYYYwhv -2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6wwdhFJ2+qN1j3hybX2C32 -qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXiEqITLdiOr18SPaAIBQi2XKVlOARFmR6j -YGB0xUGlcmIbYsUfb18aQr4CUWWoriMYavx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmY -vLEHZ6IVDd2gWMZEewo+YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0O -BBYEFNLEsNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h/t2o -atTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMu -MTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwG -A1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wim -PQoZ+YeAEW5p5JYXMP80kWNyOO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKt -I3lpjbi2Tc7PTMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ -HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mERdEr/VxqHD3VI -Ls9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5CufReYNnyicsbkqWletNw+vHX/b -vZ8= ------END CERTIFICATE----- - -Starfield Class 2 CA -==================== ------BEGIN CERTIFICATE----- -MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzElMCMGA1UEChMc -U3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZpZWxkIENsYXNzIDIg -Q2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQwNjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBo -MQswCQYDVQQGEwJVUzElMCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAG -A1UECxMpU3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqG -SIb3DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf8MOh2tTY -bitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN+lq2cwQlZut3f+dZxkqZ -JRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVm -epsZGD3/cVE8MC5fvj13c7JdBmzDI1aaK4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSN -F4Azbl5KXZnJHoe0nRrA1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HF -MIHCMB0GA1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fRzt0f -hvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0YXJmaWVsZCBUZWNo -bm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBDbGFzcyAyIENlcnRpZmljYXRpb24g -QXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGs -afPzWdqbAYcaT1epoXkJKtv3L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLM -PUxA2IGvd56Deruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl -xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynpVSJYACPq4xJD -KVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEYWQPJIrSPnNVeKtelttQKbfi3 -QBFGmh95DmK/D5fs4C8fF5Q= ------END CERTIFICATE----- - DigiCert Assured ID Root CA =========================== -----BEGIN CERTIFICATE----- @@ -390,37 +209,6 @@ NU0LbbqhPcCT4H8js1WtciVORvnSFu+wZMEBnunKoGqYDs/YYPIvSbjkQuE4NRb0yG5P94FW6Lqj viOvrv1vA+ACOzB2+httQc8Bsem4yWb02ybzOqR08kkkW8mw0FfB+j564ZfJ -----END CERTIFICATE----- -SwissSign Silver CA - G2 -======================== ------BEGIN CERTIFICATE----- -MIIFvTCCA6WgAwIBAgIITxvUL1S7L0swDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UEBhMCQ0gxFTAT -BgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMB4X -DTA2MTAyNTA4MzI0NloXDTM2MTAyNTA4MzI0NlowRzELMAkGA1UEBhMCQ0gxFTATBgNVBAoTDFN3 -aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMIICIjANBgkqhkiG -9w0BAQEFAAOCAg8AMIICCgKCAgEAxPGHf9N4Mfc4yfjDmUO8x/e8N+dOcbpLj6VzHVxumK4DV644 -N0MvFz0fyM5oEMF4rhkDKxD6LHmD9ui5aLlV8gREpzn5/ASLHvGiTSf5YXu6t+WiE7brYT7QbNHm -+/pe7R20nqA1W6GSy/BJkv6FCgU+5tkL4k+73JU3/JHpMjUi0R86TieFnbAVlDLaYQ1HTWBCrpJH -6INaUFjpiou5XaHc3ZlKHzZnu0jkg7Y360g6rw9njxcH6ATK72oxh9TAtvmUcXtnZLi2kUpCe2Uu -MGoM9ZDulebyzYLs2aFK7PayS+VFheZteJMELpyCbTapxDFkH4aDCyr0NQp4yVXPQbBH6TCfmb5h -qAaEuSh6XzjZG6k4sIN/c8HDO0gqgg8hm7jMqDXDhBuDsz6+pJVpATqJAHgE2cn0mRmrVn5bi4Y5 -FZGkECwJMoBgs5PAKrYYC51+jUnyEEp/+dVGLxmSo5mnJqy7jDzmDrxHB9xzUfFwZC8I+bRHHTBs -ROopN4WSaGa8gzj+ezku01DwH/teYLappvonQfGbGHLy9YR0SslnxFSuSGTfjNFusB3hB48IHpmc -celM2KX3RxIfdNFRnobzwqIjQAtz20um53MGjMGg6cFZrEb65i/4z3GcRm25xBWNOHkDRUjvxF3X -CO6HOSKGsg0PWEP3calILv3q1h8CAwEAAaOBrDCBqTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/ -BAUwAwEB/zAdBgNVHQ4EFgQUF6DNweRBtjpbO8tFnb0cwpj6hlgwHwYDVR0jBBgwFoAUF6DNweRB -tjpbO8tFnb0cwpj6hlgwRgYDVR0gBD8wPTA7BglghXQBWQEDAQEwLjAsBggrBgEFBQcCARYgaHR0 -cDovL3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIBAHPGgeAn0i0P -4JUw4ppBf1AsX19iYamGamkYDHRJ1l2E6kFSGG9YrVBWIGrGvShpWJHckRE1qTodvBqlYJ7YH39F -kWnZfrt4csEGDyrOj4VwYaygzQu4OSlWhDJOhrs9xCrZ1x9y7v5RoSJBsXECYxqCsGKrXlcSH9/L -3XWgwF15kIwb4FDm3jH+mHtwX6WQ2K34ArZv02DdQEsixT2tOnqfGhpHkXkzuoLcMmkDlm4fS/Bx -/uNncqCxv1yL5PqZIseEuRuNI5c/7SXgz2W79WEE790eslpBIlqhn10s6FvJbakMDHiqYMZWjwFa -DGi8aRl5xB9+lwW/xekkUV7U1UtT7dkjWjYDZaPBA61BMPNGG4WQr2W11bHkFlt4dR2Xem1ZqSqP -e97Dh4kQmUlzeMg9vVE1dCrV8X5pGyq7O70luJpaPXJhkGaH7gzWTdQRdAtq/gsD/KNVV4n+Ssuu -WxcFyPKNIzFTONItaj+CuY0IavdeQXRuwxF+B6wpYJE/OMpXEA29MC/HpeZBoNquBYeaoKRlbEwJ -DIm6uNO5wJOKMPqN5ZprFQFOZ6raYlY+hAhm0sQ2fac+EPyI4NSA5QC9qvNOBqN6avlicuMJT+ub -DgEj8Z+7fNzcbBGXJbLytGMU0gYqZ4yD9c7qB9iaah7s5Aq7KkzrCWA5zspi2C5u ------END CERTIFICATE----- - SecureTrust CA ============== -----BEGIN CERTIFICATE----- @@ -489,29 +277,6 @@ IGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5ddBA6+C4OmF4O5MBKgxTMVBbkN +8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IBZQ== -----END CERTIFICATE----- -Network Solutions Certificate Authority -======================================= ------BEGIN CERTIFICATE----- -MIID5jCCAs6gAwIBAgIQV8szb8JcFuZHFhfjkDFo4DANBgkqhkiG9w0BAQUFADBiMQswCQYDVQQG -EwJVUzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMuMTAwLgYDVQQDEydOZXR3b3Jr -IFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwHhcNMDYxMjAxMDAwMDAwWhcNMjkxMjMx -MjM1OTU5WjBiMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMu -MTAwLgYDVQQDEydOZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwggEiMA0G -CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkvH6SMG3G2I4rC7xGzuAnlt7e+foS0zwzc7MEL7xx -jOWftiJgPl9dzgn/ggwbmlFQGiaJ3dVhXRncEg8tCqJDXRfQNJIg6nPPOCwGJgl6cvf6UDL4wpPT -aaIjzkGxzOTVHzbRijr4jGPiFFlp7Q3Tf2vouAPlT2rlmGNpSAW+Lv8ztumXWWn4Zxmuk2GWRBXT -crA/vGp97Eh/jcOrqnErU2lBUzS1sLnFBgrEsEX1QV1uiUV7PTsmjHTC5dLRfbIR1PtYMiKagMnc -/Qzpf14Dl847ABSHJ3A4qY5usyd2mFHgBeMhqxrVhSI8KbWaFsWAqPS7azCPL0YCorEMIuDTAgMB -AAGjgZcwgZQwHQYDVR0OBBYEFCEwyfsA106Y2oeqKtCnLrFAMadMMA4GA1UdDwEB/wQEAwIBBjAP -BgNVHRMBAf8EBTADAQH/MFIGA1UdHwRLMEkwR6BFoEOGQWh0dHA6Ly9jcmwubmV0c29sc3NsLmNv -bS9OZXR3b3JrU29sdXRpb25zQ2VydGlmaWNhdGVBdXRob3JpdHkuY3JsMA0GCSqGSIb3DQEBBQUA -A4IBAQC7rkvnt1frf6ott3NHhWrB5KUd5Oc86fRZZXe1eltajSU24HqXLjjAV2CDmAaDn7l2em5Q -4LqILPxFzBiwmZVRDuwduIj/h1AcgsLj4DKAv6ALR8jDMe+ZZzKATxcheQxpXN5eNK4CtSbqUN9/ -GGUsyfJj4akH/nxxH2szJGoeBfcFaMBqEssuXmHLrijTfsK0ZpEmXzwuJF/LWA/rKOyvEZbz3Htv -wKeI8lN3s2Berq4o2jUsbzRF0ybh3uxbTydrFny9RAQYgrOJeRcQcT16ohZO9QHNpGxlaKFJdlxD -ydi8NmdspZS11My5vWo1ViHe2MPr+8ukYEywVaCge1ey ------END CERTIFICATE----- - COMODO ECC Certification Authority ================================== -----BEGIN CERTIFICATE----- @@ -626,47 +391,6 @@ NwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2XjG4Kvte9nHfRCaexOYNkbQu dZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E= -----END CERTIFICATE----- -Hongkong Post Root CA 1 -======================= ------BEGIN CERTIFICATE----- -MIIDMDCCAhigAwIBAgICA+gwDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UEBhMCSEsxFjAUBgNVBAoT -DUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdrb25nIFBvc3QgUm9vdCBDQSAxMB4XDTAzMDUx -NTA1MTMxNFoXDTIzMDUxNTA0NTIyOVowRzELMAkGA1UEBhMCSEsxFjAUBgNVBAoTDUhvbmdrb25n -IFBvc3QxIDAeBgNVBAMTF0hvbmdrb25nIFBvc3QgUm9vdCBDQSAxMIIBIjANBgkqhkiG9w0BAQEF -AAOCAQ8AMIIBCgKCAQEArP84tulmAknjorThkPlAj3n54r15/gK97iSSHSL22oVyaf7XPwnU3ZG1 -ApzQjVrhVcNQhrkpJsLj2aDxaQMoIIBFIi1WpztUlVYiWR8o3x8gPW2iNr4joLFutbEnPzlTCeqr -auh0ssJlXI6/fMN4hM2eFvz1Lk8gKgifd/PFHsSaUmYeSF7jEAaPIpjhZY4bXSNmO7ilMlHIhqqh -qZ5/dpTCpmy3QfDVyAY45tQM4vM7TG1QjMSDJ8EThFk9nnV0ttgCXjqQesBCNnLsak3c78QA3xMY -V18meMjWCnl3v/evt3a5pQuEF10Q6m/hq5URX208o1xNg1vysxmKgIsLhwIDAQABoyYwJDASBgNV -HRMBAf8ECDAGAQH/AgEDMA4GA1UdDwEB/wQEAwIBxjANBgkqhkiG9w0BAQUFAAOCAQEADkbVPK7i -h9legYsCmEEIjEy82tvuJxuC52pF7BaLT4Wg87JwvVqWuspube5Gi27nKi6Wsxkz67SfqLI37pio -l7Yutmcn1KZJ/RyTZXaeQi/cImyaT/JaFTmxcdcrUehtHJjA2Sr0oYJ71clBoiMBdDhViw+5Lmei -IAQ32pwL0xch4I+XeTRvhEgCIDMb5jREn5Fw9IBehEPCKdJsEhTkYY2sEJCehFC78JZvRZ+K88ps -T/oROhUVRsPNH4NbLUES7VBnQRM9IauUiqpOfMGx+6fWtScvl6tu4B3i0RwsH0Ti/L6RoZz71ilT -c4afU9hDDl3WY4JxHYB0yvbiAmvZWg== ------END CERTIFICATE----- - -SecureSign RootCA11 -=================== ------BEGIN CERTIFICATE----- -MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDErMCkGA1UEChMi -SmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoGA1UEAxMTU2VjdXJlU2lnbiBS -b290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSsw -KQYDVQQKEyJKYXBhbiBDZXJ0aWZpY2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1 -cmVTaWduIFJvb3RDQTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvL -TJszi1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8h9uuywGO -wvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOVMdrAG/LuYpmGYz+/3ZMq -g6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rP -O7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitA -bpSACW22s293bzUIUPsCh8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZX -t94wDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEBAKCh -OBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xmKbabfSVSSUOrTC4r -bnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQX5Ucv+2rIrVls4W6ng+4reV6G4pQ -Oh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWrQbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01 -y8hSyn+B/tlr0/cR7SXf+Of5pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061 -lgeLKBObjBmNQSdJQO7e5iNEOdyhIta6A/I= ------END CERTIFICATE----- - Microsec e-Szigno Root CA 2009 ============================== -----BEGIN CERTIFICATE----- @@ -712,39 +436,6 @@ YIvDQVETI53O9zJrlAGomecsMx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7r kpeDMdmztcpHWD9f -----END CERTIFICATE----- -Autoridad de Certificacion Firmaprofesional CIF A62634068 -========================================================= ------BEGIN CERTIFICATE----- -MIIGFDCCA/ygAwIBAgIIU+w77vuySF8wDQYJKoZIhvcNAQEFBQAwUTELMAkGA1UEBhMCRVMxQjBA -BgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1hcHJvZmVzaW9uYWwgQ0lGIEE2 -MjYzNDA2ODAeFw0wOTA1MjAwODM4MTVaFw0zMDEyMzEwODM4MTVaMFExCzAJBgNVBAYTAkVTMUIw -QAYDVQQDDDlBdXRvcmlkYWQgZGUgQ2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBB -NjI2MzQwNjgwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDD -Utd9thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQMcas9UX4P -B99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefGL9ItWY16Ck6WaVICqjaY -7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15iNA9wBj4gGFrO93IbJWyTdBSTo3OxDqqH -ECNZXyAFGUftaI6SEspd/NYrspI8IM/hX68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyI -plD9amML9ZMWGxmPsu2bm8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctX -MbScyJCyZ/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirjaEbsX -LZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/TKI8xWVvTyQKmtFLK -bpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF6NkBiDkal4ZkQdU7hwxu+g/GvUgU -vzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVhOSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMBIGA1Ud -EwEB/wQIMAYBAf8CAQEwDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRlzeurNR4APn7VdMActHNH -DhpkLzCBpgYDVR0gBIGeMIGbMIGYBgRVHSAAMIGPMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmZp -cm1hcHJvZmVzaW9uYWwuY29tL2NwczBcBggrBgEFBQcCAjBQHk4AUABhAHMAZQBvACAAZABlACAA -bABhACAAQgBvAG4AYQBuAG8AdgBhACAANAA3ACAAQgBhAHIAYwBlAGwAbwBuAGEAIAAwADgAMAAx -ADcwDQYJKoZIhvcNAQEFBQADggIBABd9oPm03cXF661LJLWhAqvdpYhKsg9VSytXjDvlMd3+xDLx -51tkljYyGOylMnfX40S2wBEqgLk9am58m9Ot/MPWo+ZkKXzR4Tgegiv/J2Wv+xYVxC5xhOW1//qk -R71kMrv2JYSiJ0L1ILDCExARzRAVukKQKtJE4ZYm6zFIEv0q2skGz3QeqUvVhyj5eTSSPi5E6PaP -T481PyWzOdxjKpBrIF/EUhJOlywqrJ2X3kjyo2bbwtKDlaZmp54lD+kLM5FlClrD2VQS3a/DTg4f -Jl4N3LON7NWBcN7STyQF82xO9UxJZo3R/9ILJUFI/lGExkKvgATP0H5kSeTy36LssUzAKh3ntLFl -osS88Zj0qnAHY7S42jtM+kAiMFsRpvAFDsYCA0irhpuF3dvd6qJ2gHN99ZwExEWN57kci57q13XR -crHedUTnQn3iV2t93Jm8PYMo6oCTjcVMZcFwgbg4/EMxsvYDNEeyrPsiBsse3RdHHF9mudMaotoR -saS8I8nkvof/uZS2+F0gStRf571oe2XyFR7SOqkt6dhrJKyXWERHrVkY8SFlcN7ONGCoQPHzPKTD -KCOM/iczQ0CgFzzr6juwcqajuUpLXhZI9LK8yIySxZ2frHI2vDSANGupi5LAuBft7HZT9SQBjLMi -6Et8Vcad+qMUu2WFbm5PEn4KPJ2V ------END CERTIFICATE----- - Izenpe.com ========== -----BEGIN CERTIFICATE----- @@ -993,30 +684,6 @@ tnRGEmyR7jTV7JqR50S+kDFy1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29 mvVXIwAHIRc/SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03 -----END CERTIFICATE----- -Hellenic Academic and Research Institutions RootCA 2011 -======================================================= ------BEGIN CERTIFICATE----- -MIIEMTCCAxmgAwIBAgIBADANBgkqhkiG9w0BAQUFADCBlTELMAkGA1UEBhMCR1IxRDBCBgNVBAoT -O0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9y -aXR5MUAwPgYDVQQDEzdIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25z -IFJvb3RDQSAyMDExMB4XDTExMTIwNjEzNDk1MloXDTMxMTIwMTEzNDk1MlowgZUxCzAJBgNVBAYT -AkdSMUQwQgYDVQQKEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25z -IENlcnQuIEF1dGhvcml0eTFAMD4GA1UEAxM3SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJlc2VhcmNo -IEluc3RpdHV0aW9ucyBSb290Q0EgMjAxMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB -AKlTAOMupvaO+mDYLZU++CwqVE7NuYRhlFhPjz2L5EPzdYmNUeTDN9KKiE15HrcS3UN4SoqS5tdI -1Q+kOilENbgH9mgdVc04UfCMJDGFr4PJfel3r+0ae50X+bOdOFAPplp5kYCvN66m0zH7tSYJnTxa -71HFK9+WXesyHgLacEnsbgzImjeN9/E2YEsmLIKe0HjzDQ9jpFEw4fkrJxIH2Oq9GGKYsFk3fb7u -8yBRQlqD75O6aRXxYp2fmTmCobd0LovUxQt7L/DICto9eQqakxylKHJzkUOap9FNhYS5qXSPFEDH -3N6sQWRstBmbAmNtJGSPRLIl6s5ddAxjMlyNh+UCAwEAAaOBiTCBhjAPBgNVHRMBAf8EBTADAQH/ -MAsGA1UdDwQEAwIBBjAdBgNVHQ4EFgQUppFC/RNhSiOeCKQp5dgTBCPuQSUwRwYDVR0eBEAwPqA8 -MAWCAy5ncjAFggMuZXUwBoIELmVkdTAGggQub3JnMAWBAy5ncjAFgQMuZXUwBoEELmVkdTAGgQQu -b3JnMA0GCSqGSIb3DQEBBQUAA4IBAQAf73lB4XtuP7KMhjdCSk4cNx6NZrokgclPEg8hwAOXhiVt -XdMiKahsog2p6z0GW5k6x8zDmjR/qw7IThzh+uTczQ2+vyT+bOdrwg3IBp5OjWEopmr95fZi6hg8 -TqBTnbI6nOulnJEWtk2C4AwFSKls9cz4y51JtPACpf1wA+2KIaWuE4ZJwzNzvoc7dIsXRSZMFpGD -/md9zU1jZ/rzAxKWeAaNsWftjj++n08C9bMJL/NMh98qy5V8AcysNnq/onN694/BtZqhFLKPM58N -7yLcZnuEvUUXBj08yrl3NI/K6s8/MT7jiOOASSXIl7WdmplNsDz4SgCbZN2fOUvRJ9e4 ------END CERTIFICATE----- - Actalis Authentication Root CA ============================== -----BEGIN CERTIFICATE----- @@ -1308,40 +975,6 @@ Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVxSK236thZiNSQvxaz2ems WWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY= -----END CERTIFICATE----- -E-Tugra Certification Authority -=============================== ------BEGIN CERTIFICATE----- -MIIGSzCCBDOgAwIBAgIIamg+nFGby1MwDQYJKoZIhvcNAQELBQAwgbIxCzAJBgNVBAYTAlRSMQ8w -DQYDVQQHDAZBbmthcmExQDA+BgNVBAoMN0UtVHXEn3JhIEVCRyBCaWxpxZ9pbSBUZWtub2xvamls -ZXJpIHZlIEhpem1ldGxlcmkgQS7Fni4xJjAkBgNVBAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBN -ZXJrZXppMSgwJgYDVQQDDB9FLVR1Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTEzMDMw -NTEyMDk0OFoXDTIzMDMwMzEyMDk0OFowgbIxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHDAZBbmthcmEx -QDA+BgNVBAoMN0UtVHXEn3JhIEVCRyBCaWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhpem1ldGxl -cmkgQS7Fni4xJjAkBgNVBAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBNZXJrZXppMSgwJgYDVQQD -DB9FLVR1Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEFAAOCAg8A -MIICCgKCAgEA4vU/kwVRHoViVF56C/UYB4Oufq9899SKa6VjQzm5S/fDxmSJPZQuVIBSOTkHS0vd -hQd2h8y/L5VMzH2nPbxHD5hw+IyFHnSOkm0bQNGZDbt1bsipa5rAhDGvykPL6ys06I+XawGb1Q5K -CKpbknSFQ9OArqGIW66z6l7LFpp3RMih9lRozt6Plyu6W0ACDGQXwLWTzeHxE2bODHnv0ZEoq1+g -ElIwcxmOj+GMB6LDu0rw6h8VqO4lzKRG+Bsi77MOQ7osJLjFLFzUHPhdZL3Dk14opz8n8Y4e0ypQ -BaNV2cvnOVPAmJ6MVGKLJrD3fY185MaeZkJVgkfnsliNZvcHfC425lAcP9tDJMW/hkd5s3kc91r0 -E+xs+D/iWR+V7kI+ua2oMoVJl0b+SzGPWsutdEcf6ZG33ygEIqDUD13ieU/qbIWGvaimzuT6w+Gz -rt48Ue7LE3wBf4QOXVGUnhMMti6lTPk5cDZvlsouDERVxcr6XQKj39ZkjFqzAQqptQpHF//vkUAq -jqFGOjGY5RH8zLtJVor8udBhmm9lbObDyz51Sf6Pp+KJxWfXnUYTTjF2OySznhFlhqt/7x3U+Lzn -rFpct1pHXFXOVbQicVtbC/DP3KBhZOqp12gKY6fgDT+gr9Oq0n7vUaDmUStVkhUXU8u3Zg5mTPj5 -dUyQ5xJwx0UCAwEAAaNjMGEwHQYDVR0OBBYEFC7j27JJ0JxUeVz6Jyr+zE7S6E5UMA8GA1UdEwEB -/wQFMAMBAf8wHwYDVR0jBBgwFoAULuPbsknQnFR5XPonKv7MTtLoTlQwDgYDVR0PAQH/BAQDAgEG -MA0GCSqGSIb3DQEBCwUAA4ICAQAFNzr0TbdF4kV1JI+2d1LoHNgQk2Xz8lkGpD4eKexd0dCrfOAK -kEh47U6YA5n+KGCRHTAduGN8qOY1tfrTYXbm1gdLymmasoR6d5NFFxWfJNCYExL/u6Au/U5Mh/jO -XKqYGwXgAEZKgoClM4so3O0409/lPun++1ndYYRP0lSWE2ETPo+Aab6TR7U1Q9Jauz1c77NCR807 -VRMGsAnb/WP2OogKmW9+4c4bU2pEZiNRCHu8W1Ki/QY3OEBhj0qWuJA3+GbHeJAAFS6LrVE1Uweo -a2iu+U48BybNCAVwzDk/dr2l02cmAYamU9JgO3xDf1WKvJUawSg5TB9D0pH0clmKuVb8P7Sd2nCc -dlqMQ1DujjByTd//SffGqWfZbawCEeI6FiWnWAjLb1NBnEg4R2gz0dfHj9R0IdTDBZB6/86WiLEV -KV0jq9BgoRJP3vQXzTLlyb/IQ639Lo7xr+L0mPoSHyDYwKcMhcWQ9DstliaxLL5Mq+ux0orJ23gT -Dx4JnW2PAJ8C2sH6H3p6CcRK5ogql5+Ji/03X186zjhZhkuvcQu02PJwT58yE+Owp1fl2tpDy4Q0 -8ijE6m30Ku/Ba3ba+367hTzSU8JNvnHhRdH9I2cNE3X7z2VnIp2usAnRCf8dNL/+I5c30jn6PQ0G -C7TbO6Orb1wdtn7os4I07QZcJA== ------END CERTIFICATE----- - T-TeleSec GlobalRoot Class 2 ============================ -----BEGIN CERTIFICATE----- @@ -1678,36 +1311,6 @@ uglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7 yFz9SO8NdCKoCOJuxUnOxwy8p2Fp8fc74SrL+SvzZpA3 -----END CERTIFICATE----- -Staat der Nederlanden EV Root CA -================================ ------BEGIN CERTIFICATE----- -MIIFcDCCA1igAwIBAgIEAJiWjTANBgkqhkiG9w0BAQsFADBYMQswCQYDVQQGEwJOTDEeMBwGA1UE -CgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSkwJwYDVQQDDCBTdGFhdCBkZXIgTmVkZXJsYW5kZW4g -RVYgUm9vdCBDQTAeFw0xMDEyMDgxMTE5MjlaFw0yMjEyMDgxMTEwMjhaMFgxCzAJBgNVBAYTAk5M -MR4wHAYDVQQKDBVTdGFhdCBkZXIgTmVkZXJsYW5kZW4xKTAnBgNVBAMMIFN0YWF0IGRlciBOZWRl -cmxhbmRlbiBFViBSb290IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA48d+ifkk -SzrSM4M1LGns3Amk41GoJSt5uAg94JG6hIXGhaTK5skuU6TJJB79VWZxXSzFYGgEt9nCUiY4iKTW -O0Cmws0/zZiTs1QUWJZV1VD+hq2kY39ch/aO5ieSZxeSAgMs3NZmdO3dZ//BYY1jTw+bbRcwJu+r -0h8QoPnFfxZpgQNH7R5ojXKhTbImxrpsX23Wr9GxE46prfNeaXUmGD5BKyF/7otdBwadQ8QpCiv8 -Kj6GyzyDOvnJDdrFmeK8eEEzduG/L13lpJhQDBXd4Pqcfzho0LKmeqfRMb1+ilgnQ7O6M5HTp5gV -XJrm0w912fxBmJc+qiXbj5IusHsMX/FjqTf5m3VpTCgmJdrV8hJwRVXj33NeN/UhbJCONVrJ0yPr -08C+eKxCKFhmpUZtcALXEPlLVPxdhkqHz3/KRawRWrUgUY0viEeXOcDPusBCAUCZSCELa6fS/ZbV -0b5GnUngC6agIk440ME8MLxwjyx1zNDFjFE7PZQIZCZhfbnDZY8UnCHQqv0XcgOPvZuM5l5Tnrmd -74K74bzickFbIZTTRTeU0d8JOV3nI6qaHcptqAqGhYqCvkIH1vI4gnPah1vlPNOePqc7nvQDs/nx -fRN0Av+7oeX6AHkcpmZBiFxgV6YuCcS6/ZrPpx9Aw7vMWgpVSzs4dlG4Y4uElBbmVvMCAwEAAaNC -MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFP6rAJCYniT8qcwa -ivsnuL8wbqg7MA0GCSqGSIb3DQEBCwUAA4ICAQDPdyxuVr5Os7aEAJSrR8kN0nbHhp8dB9O2tLsI -eK9p0gtJ3jPFrK3CiAJ9Brc1AsFgyb/E6JTe1NOpEyVa/m6irn0F3H3zbPB+po3u2dfOWBfoqSmu -c0iH55vKbimhZF8ZE/euBhD/UcabTVUlT5OZEAFTdfETzsemQUHSv4ilf0X8rLiltTMMgsT7B/Zq -5SWEXwbKwYY5EdtYzXc7LMJMD16a4/CrPmEbUCTCwPTxGfARKbalGAKb12NMcIxHowNDXLldRqAN -b/9Zjr7dn3LDWyvfjFvO5QxGbJKyCqNMVEIYFRIYvdr8unRu/8G2oGTYqV9Vrp9canaW2HNnh/tN -f1zuacpzEPuKqf2evTY4SUmH9A4U8OmHuD+nT3pajnnUk+S7aFKErGzp85hwVXIy+TSrK0m1zSBi -5Dp6Z2Orltxtrpfs/J92VoguZs9btsmksNcFuuEnL5O7Jiqik7Ab846+HUCjuTaPPoIaGl6I6lD4 -WeKDRikL40Rc4ZW2aZCaFG+XroHPaO+Zmr615+F/+PoTRxZMzG0IQOeLeG9QgkRQP2YGiqtDhFZK -DyAthg710tvSeopLzaXoTvFeJiUBWSOgftL2fiFX1ye8FVdMpEbB4IMeDExNH08GGeL5qPQ6gqGy -eUN51q1veieQA6TqJIc/2b3Z6fJfUEkc7uzXLg== ------END CERTIFICATE----- - IdenTrust Commercial Root CA 1 ============================== -----BEGIN CERTIFICATE----- @@ -2159,87 +1762,6 @@ F8Io2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV09tL7ECQ aaApJUqlyyvdimYHFngVV3Eb7PVHhPOeMTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g== -----END CERTIFICATE----- -TrustCor RootCert CA-1 -====================== ------BEGIN CERTIFICATE----- -MIIEMDCCAxigAwIBAgIJANqb7HHzA7AZMA0GCSqGSIb3DQEBCwUAMIGkMQswCQYDVQQGEwJQQTEP -MA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEkMCIGA1UECgwbVHJ1c3RDb3Ig -U3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5UcnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3Jp -dHkxHzAdBgNVBAMMFlRydXN0Q29yIFJvb3RDZXJ0IENBLTEwHhcNMTYwMjA0MTIzMjE2WhcNMjkx -MjMxMTcyMzE2WjCBpDELMAkGA1UEBhMCUEExDzANBgNVBAgMBlBhbmFtYTEUMBIGA1UEBwwLUGFu -YW1hIENpdHkxJDAiBgNVBAoMG1RydXN0Q29yIFN5c3RlbXMgUy4gZGUgUi5MLjEnMCUGA1UECwwe -VHJ1c3RDb3IgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MR8wHQYDVQQDDBZUcnVzdENvciBSb290Q2Vy -dCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv463leLCJhJrMxnHQFgKq1mq -jQCj/IDHUHuO1CAmujIS2CNUSSUQIpidRtLByZ5OGy4sDjjzGiVoHKZaBeYei0i/mJZ0PmnK6bV4 -pQa81QBeCQryJ3pS/C3Vseq0iWEk8xoT26nPUu0MJLq5nux+AHT6k61sKZKuUbS701e/s/OojZz0 -JEsq1pme9J7+wH5COucLlVPat2gOkEz7cD+PSiyU8ybdY2mplNgQTsVHCJCZGxdNuWxu72CVEY4h -gLW9oHPY0LJ3xEXqWib7ZnZ2+AYfYW0PVcWDtxBWcgYHpfOxGgMFZA6dWorWhnAbJN7+KIor0Gqw -/Hqi3LJ5DotlDwIDAQABo2MwYTAdBgNVHQ4EFgQU7mtJPHo/DeOxCbeKyKsZn3MzUOcwHwYDVR0j -BBgwFoAU7mtJPHo/DeOxCbeKyKsZn3MzUOcwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC -AYYwDQYJKoZIhvcNAQELBQADggEBACUY1JGPE+6PHh0RU9otRCkZoB5rMZ5NDp6tPVxBb5UrJKF5 -mDo4Nvu7Zp5I/5CQ7z3UuJu0h3U/IJvOcs+hVcFNZKIZBqEHMwwLKeXx6quj7LUKdJDHfXLy11yf -ke+Ri7fc7Waiz45mO7yfOgLgJ90WmMCV1Aqk5IGadZQ1nJBfiDcGrVmVCrDRZ9MZyonnMlo2HD6C -qFqTvsbQZJG2z9m2GM/bftJlo6bEjhcxwft+dtvTheNYsnd6djtsL1Ac59v2Z3kf9YKVmgenFK+P -3CghZwnS1k1aHBkcjndcw5QkPTJrS37UeJSDvjdNzl/HHk484IkzlQsPpTLWPFp5LBk= ------END CERTIFICATE----- - -TrustCor RootCert CA-2 -====================== ------BEGIN CERTIFICATE----- -MIIGLzCCBBegAwIBAgIIJaHfyjPLWQIwDQYJKoZIhvcNAQELBQAwgaQxCzAJBgNVBAYTAlBBMQ8w -DQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQwIgYDVQQKDBtUcnVzdENvciBT -eXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRydXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0 -eTEfMB0GA1UEAwwWVHJ1c3RDb3IgUm9vdENlcnQgQ0EtMjAeFw0xNjAyMDQxMjMyMjNaFw0zNDEy -MzExNzI2MzlaMIGkMQswCQYDVQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5h -bWEgQ2l0eTEkMCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U -cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRydXN0Q29yIFJvb3RDZXJ0 -IENBLTIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCnIG7CKqJiJJWQdsg4foDSq8Gb -ZQWU9MEKENUCrO2fk8eHyLAnK0IMPQo+QVqedd2NyuCb7GgypGmSaIwLgQ5WoD4a3SwlFIIvl9Nk -RvRUqdw6VC0xK5mC8tkq1+9xALgxpL56JAfDQiDyitSSBBtlVkxs1Pu2YVpHI7TYabS3OtB0PAx1 -oYxOdqHp2yqlO/rOsP9+aij9JxzIsekp8VduZLTQwRVtDr4uDkbIXvRR/u8OYzo7cbrPb1nKDOOb -XUm4TOJXsZiKQlecdu/vvdFoqNL0Cbt3Nb4lggjEFixEIFapRBF37120Hapeaz6LMvYHL1cEksr1 -/p3C6eizjkxLAjHZ5DxIgif3GIJ2SDpxsROhOdUuxTTCHWKF3wP+TfSvPd9cW436cOGlfifHhi5q -jxLGhF5DUVCcGZt45vz27Ud+ez1m7xMTiF88oWP7+ayHNZ/zgp6kPwqcMWmLmaSISo5uZk3vFsQP -eSghYA2FFn3XVDjxklb9tTNMg9zXEJ9L/cb4Qr26fHMC4P99zVvh1Kxhe1fVSntb1IVYJ12/+Ctg -rKAmrhQhJ8Z3mjOAPF5GP/fDsaOGM8boXg25NSyqRsGFAnWAoOsk+xWq5Gd/bnc/9ASKL3x74xdh -8N0JqSDIvgmk0H5Ew7IwSjiqqewYmgeCK9u4nBit2uBGF6zPXQIDAQABo2MwYTAdBgNVHQ4EFgQU -2f4hQG6UnrybPZx9mCAZ5YwwYrIwHwYDVR0jBBgwFoAU2f4hQG6UnrybPZx9mCAZ5YwwYrIwDwYD -VR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQADggIBAJ5Fngw7tu/h -Osh80QA9z+LqBrWyOrsGS2h60COXdKcs8AjYeVrXWoSK2BKaG9l9XE1wxaX5q+WjiYndAfrs3fnp -kpfbsEZC89NiqpX+MWcUaViQCqoL7jcjx1BRtPV+nuN79+TMQjItSQzL/0kMmx40/W5ulop5A7Zv -2wnL/V9lFDfhOPXzYRZY5LVtDQsEGz9QLX+zx3oaFoBg+Iof6Rsqxvm6ARppv9JYx1RXCI/hOWB3 -S6xZhBqI8d3LT3jX5+EzLfzuQfogsL7L9ziUwOHQhQ+77Sxzq+3+knYaZH9bDTMJBzN7Bj8RpFxw -PIXAz+OQqIN3+tvmxYxoZxBnpVIt8MSZj3+/0WvitUfW2dCFmU2Umw9Lje4AWkcdEQOsQRivh7dv -DDqPys/cA8GiCcjl/YBeyGBCARsaU1q7N6a3vLqE6R5sGtRk2tRD/pOLS/IseRYQ1JMLiI+h2IYU -RpFHmygk71dSTlxCnKr3Sewn6EAes6aJInKc9Q0ztFijMDvd1GpUk74aTfOTlPf8hAs/hCBcNANE -xdqtvArBAs8e5ZTZ845b2EzwnexhF7sUMlQMAimTHpKG9n/v55IFDlndmQguLvqcAFLTxWYp5KeX -RKQOKIETNcX2b2TmQcTVL8w0RSXPQQCWPUouwpaYT05KnJe32x+SMsj/D1Fu1uwJ ------END CERTIFICATE----- - -TrustCor ECA-1 -============== ------BEGIN CERTIFICATE----- -MIIEIDCCAwigAwIBAgIJAISCLF8cYtBAMA0GCSqGSIb3DQEBCwUAMIGcMQswCQYDVQQGEwJQQTEP -MA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEkMCIGA1UECgwbVHJ1c3RDb3Ig -U3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5UcnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3Jp -dHkxFzAVBgNVBAMMDlRydXN0Q29yIEVDQS0xMB4XDTE2MDIwNDEyMzIzM1oXDTI5MTIzMTE3Mjgw -N1owgZwxCzAJBgNVBAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5 -MSQwIgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRydXN0Q29y -IENlcnRpZmljYXRlIEF1dGhvcml0eTEXMBUGA1UEAwwOVHJ1c3RDb3IgRUNBLTEwggEiMA0GCSqG -SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDPj+ARtZ+odnbb3w9U73NjKYKtR8aja+3+XzP4Q1HpGjOR -MRegdMTUpwHmspI+ap3tDvl0mEDTPwOABoJA6LHip1GnHYMma6ve+heRK9jGrB6xnhkB1Zem6g23 -xFUfJ3zSCNV2HykVh0A53ThFEXXQmqc04L/NyFIduUd+Dbi7xgz2c1cWWn5DkR9VOsZtRASqnKmc -p0yJF4OuowReUoCLHhIlERnXDH19MURB6tuvsBzvgdAsxZohmz3tQjtQJvLsznFhBmIhVE5/wZ0+ -fyCMgMsq2JdiyIMzkX2woloPV+g7zPIlstR8L+xNxqE6FXrntl019fZISjZFZtS6mFjBAgMBAAGj -YzBhMB0GA1UdDgQWBBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAfBgNVHSMEGDAWgBREnkj1zG1I1KBL -f/5ZJC+Dl5mahjAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsF -AAOCAQEABT41XBVwm8nHc2FvcivUwo/yQ10CzsSUuZQRg2dd4mdsdXa/uwyqNsatR5Nj3B5+1t4u -/ukZMjgDfxT2AHMsWbEhBuH7rBiVDKP/mZb3Kyeb1STMHd3BOuCYRLDE5D53sXOpZCz2HAF8P11F -hcCF5yWPldwX8zyfGm6wyuMdKulMY/okYWLW2n62HGz1Ah3UKt1VkOsqEUc8Ll50soIipX1TH0Xs -J5F95yIW6MBoNtjG8U+ARDL54dHRHareqKucBK+tIA5kmE2la8BIWJZpTdwHjFGTot+fDz2LYLSC -jaoITmJF4PkL0uDgPFveXHEnJcLmA4GLEFPjx1WitJ/X5g== ------END CERTIFICATE----- - SSL.com Root Certification Authority RSA ======================================== -----BEGIN CERTIFICATE----- @@ -2583,40 +2105,6 @@ hcErulWuBurQB7Lcq9CClnXO0lD+mefPL5/ndtFhKvshuzHQqp9HpLIiyhY6UFfEW0NnxWViA0kB dBb9HxEGmpv0 -----END CERTIFICATE----- -Entrust Root Certification Authority - G4 -========================================= ------BEGIN CERTIFICATE----- -MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAwgb4xCzAJBgNV -BAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3Qu -bmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1 -dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1 -dGhvcml0eSAtIEc0MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYT -AlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0 -L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhv -cml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhv -cml0eSAtIEc0MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3D -umSXbcr3DbVZwbPLqGgZ2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV -3imz/f3ET+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j5pds -8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAMC1rlLAHGVK/XqsEQ -e9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73TDtTUXm6Hnmo9RR3RXRv06QqsYJn7 -ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNXwbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5X -xNMhIWNlUpEbsZmOeX7m640A2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV -7rtNOzK+mndmnqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8 -dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwlN4y6mACXi0mW -Hv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNjc0kCAwEAAaNCMEAwDwYDVR0T -AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9n -MA0GCSqGSIb3DQEBCwUAA4ICAQAS5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4Q -jbRaZIxowLByQzTSGwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht -7LGrhFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/B7NTeLUK -YvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uIAeV8KEsD+UmDfLJ/fOPt -jqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbwH5Lk6rWS02FREAutp9lfx1/cH6NcjKF+ -m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKW -RGhXxNUzzxkvFMSUHHuk2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjA -JOgc47OlIQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk5F6G -+TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuYn/PIjhs4ViFqUZPT -kcpG2om3PVODLAgfi49T3f+sHw== ------END CERTIFICATE----- - Microsoft ECC Root Certificate Authority 2017 ============================================= -----BEGIN CERTIFICATE----- @@ -3345,3 +2833,679 @@ PUQtVHJ1c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjOPQQD AwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CAy/m0sRtW9XLS/BnR AjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJbgfM0agPnIjhQW+0ZT0MW -----END CERTIFICATE----- + +DigiCert TLS ECC P384 Root G5 +============================= +-----BEGIN CERTIFICATE----- +MIICGTCCAZ+gAwIBAgIQCeCTZaz32ci5PhwLBCou8zAKBggqhkjOPQQDAzBOMQswCQYDVQQGEwJV +UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJjAkBgNVBAMTHURpZ2lDZXJ0IFRMUyBFQ0MgUDM4 +NCBSb290IEc1MB4XDTIxMDExNTAwMDAwMFoXDTQ2MDExNDIzNTk1OVowTjELMAkGA1UEBhMCVVMx +FzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMSYwJAYDVQQDEx1EaWdpQ2VydCBUTFMgRUNDIFAzODQg +Um9vdCBHNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABMFEoc8Rl1Ca3iOCNQfN0MsYndLxf3c1Tzvd +lHJS7cI7+Oz6e2tYIOyZrsn8aLN1udsJ7MgT9U7GCh1mMEy7H0cKPGEQQil8pQgO4CLp0zVozptj +n4S1mU1YoI71VOeVyaNCMEAwHQYDVR0OBBYEFMFRRVBZqz7nLFr6ICISB4CIfBFqMA4GA1UdDwEB +/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQCJao1H5+z8blUD2Wds +Jk6Dxv3J+ysTvLd6jLRl0mlpYxNjOyZQLgGheQaRnUi/wr4CMEfDFXuxoJGZSZOoPHzoRgaLLPIx +AJSdYsiJvRmEFOml+wG4DXZDjC5Ty3zfDBeWUA== +-----END CERTIFICATE----- + +DigiCert TLS RSA4096 Root G5 +============================ +-----BEGIN CERTIFICATE----- +MIIFZjCCA06gAwIBAgIQCPm0eKj6ftpqMzeJ3nzPijANBgkqhkiG9w0BAQwFADBNMQswCQYDVQQG +EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0 +MDk2IFJvb3QgRzUwHhcNMjEwMTE1MDAwMDAwWhcNNDYwMTE0MjM1OTU5WjBNMQswCQYDVQQGEwJV +UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0MDk2 +IFJvb3QgRzUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz0PTJeRGd/fxmgefM1eS8 +7IE+ajWOLrfn3q/5B03PMJ3qCQuZvWxX2hhKuHisOjmopkisLnLlvevxGs3npAOpPxG02C+JFvuU +AT27L/gTBaF4HI4o4EXgg/RZG5Wzrn4DReW+wkL+7vI8toUTmDKdFqgpwgscONyfMXdcvyej/Ces +tyu9dJsXLfKB2l2w4SMXPohKEiPQ6s+d3gMXsUJKoBZMpG2T6T867jp8nVid9E6P/DsjyG244gXa +zOvswzH016cpVIDPRFtMbzCe88zdH5RDnU1/cHAN1DrRN/BsnZvAFJNY781BOHW8EwOVfH/jXOnV +DdXifBBiqmvwPXbzP6PosMH976pXTayGpxi0KcEsDr9kvimM2AItzVwv8n/vFfQMFawKsPHTDU9q +TXeXAaDxZre3zu/O7Oyldcqs4+Fj97ihBMi8ez9dLRYiVu1ISf6nL3kwJZu6ay0/nTvEF+cdLvvy +z6b84xQslpghjLSR6Rlgg/IwKwZzUNWYOwbpx4oMYIwo+FKbbuH2TbsGJJvXKyY//SovcfXWJL5/ +MZ4PbeiPT02jP/816t9JXkGPhvnxd3lLG7SjXi/7RgLQZhNeXoVPzthwiHvOAbWWl9fNff2C+MIk +wcoBOU+NosEUQB+cZtUMCUbW8tDRSHZWOkPLtgoRObqME2wGtZ7P6wIDAQABo0IwQDAdBgNVHQ4E +FgQUUTMc7TZArxfTJc1paPKvTiM+s0EwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8w +DQYJKoZIhvcNAQEMBQADggIBAGCmr1tfV9qJ20tQqcQjNSH/0GEwhJG3PxDPJY7Jv0Y02cEhJhxw +GXIeo8mH/qlDZJY6yFMECrZBu8RHANmfGBg7sg7zNOok992vIGCukihfNudd5N7HPNtQOa27PShN +lnx2xlv0wdsUpasZYgcYQF+Xkdycx6u1UQ3maVNVzDl92sURVXLFO4uJ+DQtpBflF+aZfTCIITfN +MBc9uPK8qHWgQ9w+iUuQrm0D4ByjoJYJu32jtyoQREtGBzRj7TG5BO6jm5qu5jF49OokYTurWGT/ +u4cnYiWB39yhL/btp/96j1EuMPikAdKFOV8BmZZvWltwGUb+hmA+rYAQCd05JS9Yf7vSdPD3Rh9G +OUrYU9DzLjtxpdRv/PNn5AeP3SYZ4Y1b+qOTEZvpyDrDVWiakuFSdjjo4bq9+0/V77PnSIMx8IIh +47a+p6tv75/fTM8BuGJqIz3nCU2AG3swpMPdB380vqQmsvZB6Akd4yCYqjdP//fx4ilwMUc/dNAU +FvohigLVigmUdy7yWSiLfFCSCmZ4OIN1xLVaqBHG5cGdZlXPU8Sv13WFqUITVuwhd4GTWgzqltlJ +yqEI8pc7bZsEGCREjnwB8twl2F6GmrE52/WRMmrRpnCKovfepEWFJqgejF0pW8hL2JpqA15w8oVP +bEtoL8pU9ozaMv7Da4M/OMZ+ +-----END CERTIFICATE----- + +Certainly Root R1 +================= +-----BEGIN CERTIFICATE----- +MIIFRzCCAy+gAwIBAgIRAI4P+UuQcWhlM1T01EQ5t+AwDQYJKoZIhvcNAQELBQAwPTELMAkGA1UE +BhMCVVMxEjAQBgNVBAoTCUNlcnRhaW5seTEaMBgGA1UEAxMRQ2VydGFpbmx5IFJvb3QgUjEwHhcN +MjEwNDAxMDAwMDAwWhcNNDYwNDAxMDAwMDAwWjA9MQswCQYDVQQGEwJVUzESMBAGA1UEChMJQ2Vy +dGFpbmx5MRowGAYDVQQDExFDZXJ0YWlubHkgUm9vdCBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIP +ADCCAgoCggIBANA21B/q3avk0bbm+yLA3RMNansiExyXPGhjZjKcA7WNpIGD2ngwEc/csiu+kr+O +5MQTvqRoTNoCaBZ0vrLdBORrKt03H2As2/X3oXyVtwxwhi7xOu9S98zTm/mLvg7fMbedaFySpvXl +8wo0tf97ouSHocavFwDvA5HtqRxOcT3Si2yJ9HiG5mpJoM610rCrm/b01C7jcvk2xusVtyWMOvwl +DbMicyF0yEqWYZL1LwsYpfSt4u5BvQF5+paMjRcCMLT5r3gajLQ2EBAHBXDQ9DGQilHFhiZ5shGI +XsXwClTNSaa/ApzSRKft43jvRl5tcdF5cBxGX1HpyTfcX35pe0HfNEXgO4T0oYoKNp43zGJS4YkN +KPl6I7ENPT2a/Z2B7yyQwHtETrtJ4A5KVpK8y7XdeReJkd5hiXSSqOMyhb5OhaRLWcsrxXiOcVTQ +AjeZjOVJ6uBUcqQRBi8LjMFbvrWhsFNunLhgkR9Za/kt9JQKl7XsxXYDVBtlUrpMklZRNaBA2Cnb +rlJ2Oy0wQJuK0EJWtLeIAaSHO1OWzaMWj/Nmqhexx2DgwUMFDO6bW2BvBlyHWyf5QBGenDPBt+U1 +VwV/J84XIIwc/PH72jEpSe31C4SnT8H2TsIonPru4K8H+zMReiFPCyEQtkA6qyI6BJyLm4SGcprS +p6XEtHWRqSsjAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud +DgQWBBTgqj8ljZ9EXME66C6ud0yEPmcM9DANBgkqhkiG9w0BAQsFAAOCAgEAuVevuBLaV4OPaAsz +HQNTVfSVcOQrPbA56/qJYv331hgELyE03fFo8NWWWt7CgKPBjcZq91l3rhVkz1t5BXdm6ozTaw3d +8VkswTOlMIAVRQdFGjEitpIAq5lNOo93r6kiyi9jyhXWx8bwPWz8HA2YEGGeEaIi1wrykXprOQ4v +MMM2SZ/g6Q8CRFA3lFV96p/2O7qUpUzpvD5RtOjKkjZUbVwlKNrdrRT90+7iIgXr0PK3aBLXWopB +GsaSpVo7Y0VPv+E6dyIvXL9G+VoDhRNCX8reU9ditaY1BMJH/5n9hN9czulegChB8n3nHpDYT3Y+ +gjwN/KUD+nsa2UUeYNrEjvn8K8l7lcUq/6qJ34IxD3L/DCfXCh5WAFAeDJDBlrXYFIW7pw0WwfgH +JBu6haEaBQmAupVjyTrsJZ9/nbqkRxWbRHDxakvWOF5D8xh+UG7pWijmZeZ3Gzr9Hb4DJqPb1OG7 +fpYnKx3upPvaJVQTA945xsMfTZDsjxtK0hzthZU4UHlG1sGQUDGpXJpuHfUzVounmdLyyCwzk5Iw +x06MZTMQZBf9JBeW0Y3COmor6xOLRPIh80oat3df1+2IpHLlOR+Vnb5nwXARPbv0+Em34yaXOp/S +X3z7wJl8OSngex2/DaeP0ik0biQVy96QXr8axGbqwua6OV+KmalBWQewLK8= +-----END CERTIFICATE----- + +Certainly Root E1 +================= +-----BEGIN CERTIFICATE----- +MIIB9zCCAX2gAwIBAgIQBiUzsUcDMydc+Y2aub/M+DAKBggqhkjOPQQDAzA9MQswCQYDVQQGEwJV +UzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0YWlubHkgUm9vdCBFMTAeFw0yMTA0 +MDEwMDAwMDBaFw00NjA0MDEwMDAwMDBaMD0xCzAJBgNVBAYTAlVTMRIwEAYDVQQKEwlDZXJ0YWlu +bHkxGjAYBgNVBAMTEUNlcnRhaW5seSBSb290IEUxMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE3m/4 +fxzf7flHh4axpMCK+IKXgOqPyEpeKn2IaKcBYhSRJHpcnqMXfYqGITQYUBsQ3tA3SybHGWCA6TS9 +YBk2QNYphwk8kXr2vBMj3VlOBF7PyAIcGFPBMdjaIOlEjeR2o0IwQDAOBgNVHQ8BAf8EBAMCAQYw +DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ygYy2R17ikq6+2uI1g4hevIIgcwCgYIKoZIzj0E +AwMDaAAwZQIxALGOWiDDshliTd6wT99u0nCK8Z9+aozmut6Dacpps6kFtZaSF4fC0urQe87YQVt8 +rgIwRt7qy12a7DLCZRawTDBcMPPaTnOGBtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR +-----END CERTIFICATE----- + +Security Communication ECC RootCA1 +================================== +-----BEGIN CERTIFICATE----- +MIICODCCAb6gAwIBAgIJANZdm7N4gS7rMAoGCCqGSM49BAMDMGExCzAJBgNVBAYTAkpQMSUwIwYD +VQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMSswKQYDVQQDEyJTZWN1cml0eSBDb21t +dW5pY2F0aW9uIEVDQyBSb290Q0ExMB4XDTE2MDYxNjA1MTUyOFoXDTM4MDExODA1MTUyOFowYTEL +MAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xKzApBgNV +BAMTIlNlY3VyaXR5IENvbW11bmljYXRpb24gRUNDIFJvb3RDQTEwdjAQBgcqhkjOPQIBBgUrgQQA +IgNiAASkpW9gAwPDvTH00xecK4R1rOX9PVdu12O/5gSJko6BnOPpR27KkBLIE+CnnfdldB9sELLo +5OnvbYUymUSxXv3MdhDYW72ixvnWQuRXdtyQwjWpS4g8EkdtXP9JTxpKULGjQjBAMB0GA1UdDgQW +BBSGHOf+LaVKiwj+KBH6vqNm+GBZLzAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAK +BggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3L +snNdo4gIxwwCMQDAqy0Obe0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70e +N9k= +-----END CERTIFICATE----- + +BJCA Global Root CA1 +==================== +-----BEGIN CERTIFICATE----- +MIIFdDCCA1ygAwIBAgIQVW9l47TZkGobCdFsPsBsIDANBgkqhkiG9w0BAQsFADBUMQswCQYDVQQG +EwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJVFkxHTAbBgNVBAMMFEJK +Q0EgR2xvYmFsIFJvb3QgQ0ExMB4XDTE5MTIxOTAzMTYxN1oXDTQ0MTIxMjAzMTYxN1owVDELMAkG +A1UEBhMCQ04xJjAkBgNVBAoMHUJFSUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQD +DBRCSkNBIEdsb2JhbCBSb290IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPFm +CL3ZxRVhy4QEQaVpN3cdwbB7+sN3SJATcmTRuHyQNZ0YeYjjlwE8R4HyDqKYDZ4/N+AZspDyRhyS +sTphzvq3Rp4Dhtczbu33RYx2N95ulpH3134rhxfVizXuhJFyV9xgw8O558dnJCNPYwpj9mZ9S1Wn +P3hkSWkSl+BMDdMJoDIwOvqfwPKcxRIqLhy1BDPapDgRat7GGPZHOiJBhyL8xIkoVNiMpTAK+BcW +yqw3/XmnkRd4OJmtWO2y3syJfQOcs4ll5+M7sSKGjwZteAf9kRJ/sGsciQ35uMt0WwfCyPQ10WRj +eulumijWML3mG90Vr4TqnMfK9Q7q8l0ph49pczm+LiRvRSGsxdRpJQaDrXpIhRMsDQa4bHlW/KNn +MoH1V6XKV0Jp6VwkYe/iMBhORJhVb3rCk9gZtt58R4oRTklH2yiUAguUSiz5EtBP6DF+bHq/pj+b +OT0CFqMYs2esWz8sgytnOYFcuX6U1WTdno9uruh8W7TXakdI136z1C2OVnZOz2nxbkRs1CTqjSSh +GL+9V/6pmTW12xB3uD1IutbB5/EjPtffhZ0nPNRAvQoMvfXnjSXWgXSHRtQpdaJCbPdzied9v3pK +H9MiyRVVz99vfFXQpIsHETdfg6YmV6YBW37+WGgHqel62bno/1Afq8K0wM7o6v0PvY1NuLxxAgMB +AAGjQjBAMB0GA1UdDgQWBBTF7+3M2I0hxkjk49cULqcWk+WYATAPBgNVHRMBAf8EBTADAQH/MA4G +A1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAUoKsITQfI/Ki2Pm4rzc2IInRNwPWaZ+4 +YRC6ojGYWUfo0Q0lHhVBDOAqVdVXUsv45Mdpox1NcQJeXyFFYEhcCY5JEMEE3KliawLwQ8hOnThJ +dMkycFRtwUf8jrQ2ntScvd0g1lPJGKm1Vrl2i5VnZu69mP6u775u+2D2/VnGKhs/I0qUJDAnyIm8 +60Qkmss9vk/Ves6OF8tiwdneHg56/0OGNFK8YT88X7vZdrRTvJez/opMEi4r89fO4aL/3Xtw+zuh +TaRjAv04l5U/BXCga99igUOLtFkNSoxUnMW7gZ/NfaXvCyUeOiDbHPwfmGcCCtRzRBPbUYQaVQNW +4AB+dAb/OMRyHdOoP2gxXdMJxy6MW2Pg6Nwe0uxhHvLe5e/2mXZgLR6UcnHGCyoyx5JO1UbXHfmp +GQrI+pXObSOYqgs4rZpWDW+N8TEAiMEXnM0ZNjX+VVOg4DwzX5Ze4jLp3zO7Bkqp2IRzznfSxqxx +4VyjHQy7Ct9f4qNx2No3WqB4K/TUfet27fJhcKVlmtOJNBir+3I+17Q9eVzYH6Eze9mCUAyTF6ps +3MKCuwJXNq+YJyo5UOGwifUll35HaBC07HPKs5fRJNz2YqAo07WjuGS3iGJCz51TzZm+ZGiPTx4S +SPfSKcOYKMryMguTjClPPGAyzQWWYezyr/6zcCwupvI= +-----END CERTIFICATE----- + +BJCA Global Root CA2 +==================== +-----BEGIN CERTIFICATE----- +MIICJTCCAaugAwIBAgIQLBcIfWQqwP6FGFkGz7RK6zAKBggqhkjOPQQDAzBUMQswCQYDVQQGEwJD +TjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJVFkxHTAbBgNVBAMMFEJKQ0Eg +R2xvYmFsIFJvb3QgQ0EyMB4XDTE5MTIxOTAzMTgyMVoXDTQ0MTIxMjAzMTgyMVowVDELMAkGA1UE +BhMCQ04xJjAkBgNVBAoMHUJFSUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRC +SkNBIEdsb2JhbCBSb290IENBMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABJ3LgJGNU2e1uVCxA/jl +SR9BIgmwUVJY1is0j8USRhTFiy8shP8sbqjV8QnjAyEUxEM9fMEsxEtqSs3ph+B99iK++kpRuDCK +/eHeGBIK9ke35xe/J4rUQUyWPGCWwf0VHKNCMEAwHQYDVR0OBBYEFNJKsVF/BvDRgh9Obl+rg/xI +1LCRMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2gAMGUCMBq8 +W9f+qdJUDkpd0m2xQNz0Q9XSSpkZElaA94M04TVOSG0ED1cxMDAtsaqdAzjbBgIxAMvMh1PLet8g +UXOQwKhbYdDFUDn9hf7B43j4ptZLvZuHjw/l1lOWqzzIQNph91Oj9w== +-----END CERTIFICATE----- + +Sectigo Public Server Authentication Root E46 +============================================= +-----BEGIN CERTIFICATE----- +MIICOjCCAcGgAwIBAgIQQvLM2htpN0RfFf51KBC49DAKBggqhkjOPQQDAzBfMQswCQYDVQQGEwJH +QjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBTZXJ2 +ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwHhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5 +WjBfMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0 +aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUr +gQQAIgNiAAR2+pmpbiDt+dd34wc7qNs9Xzjoq1WmVk/WSOrsfy2qw7LFeeyZYX8QeccCWvkEN/U0 +NSt3zn8gj1KjAIns1aeibVvjS5KToID1AZTc8GgHHs3u/iVStSBDHBv+6xnOQ6OjQjBAMB0GA1Ud +DgQWBBTRItpMWfFLXyY4qp3W7usNw/upYTAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB +/zAKBggqhkjOPQQDAwNnADBkAjAn7qRaqCG76UeXlImldCBteU/IvZNeWBj7LRoAasm4PdCkT0RH +lAFWovgzJQxC36oCMB3q4S6ILuH5px0CMk7yn2xVdOOurvulGu7t0vzCAxHrRVxgED1cf5kDW21U +SAGKcw== +-----END CERTIFICATE----- + +Sectigo Public Server Authentication Root R46 +============================================= +-----BEGIN CERTIFICATE----- +MIIFijCCA3KgAwIBAgIQdY39i658BwD6qSWn4cetFDANBgkqhkiG9w0BAQwFADBfMQswCQYDVQQG +EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBT +ZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwHhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1 +OTU5WjBfMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1T +ZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwggIiMA0GCSqGSIb3 +DQEBAQUAA4ICDwAwggIKAoICAQCTvtU2UnXYASOgHEdCSe5jtrch/cSV1UgrJnwUUxDaef0rty2k +1Cz66jLdScK5vQ9IPXtamFSvnl0xdE8H/FAh3aTPaE8bEmNtJZlMKpnzSDBh+oF8HqcIStw+Kxwf +GExxqjWMrfhu6DtK2eWUAtaJhBOqbchPM8xQljeSM9xfiOefVNlI8JhD1mb9nxc4Q8UBUQvX4yMP +FF1bFOdLvt30yNoDN9HWOaEhUTCDsG3XME6WW5HwcCSrv0WBZEMNvSE6Lzzpng3LILVCJ8zab5vu +ZDCQOc2TZYEhMbUjUDM3IuM47fgxMMxF/mL50V0yeUKH32rMVhlATc6qu/m1dkmU8Sf4kaWD5Qaz +Yw6A3OASVYCmO2a0OYctyPDQ0RTp5A1NDvZdV3LFOxxHVp3i1fuBYYzMTYCQNFu31xR13NgESJ/A +wSiItOkcyqex8Va3e0lMWeUgFaiEAin6OJRpmkkGj80feRQXEgyDet4fsZfu+Zd4KKTIRJLpfSYF +plhym3kT2BFfrsU4YjRosoYwjviQYZ4ybPUHNs2iTG7sijbt8uaZFURww3y8nDnAtOFr94MlI1fZ +EoDlSfB1D++N6xybVCi0ITz8fAr/73trdf+LHaAZBav6+CuBQug4urv7qv094PPK306Xlynt8xhW +6aWWrL3DkJiy4Pmi1KZHQ3xtzwIDAQABo0IwQDAdBgNVHQ4EFgQUVnNYZJX5khqwEioEYnmhQBWI +IUkwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAC9c +mTz8Bl6MlC5w6tIyMY208FHVvArzZJ8HXtXBc2hkeqK5Duj5XYUtqDdFqij0lgVQYKlJfp/imTYp +E0RHap1VIDzYm/EDMrraQKFz6oOht0SmDpkBm+S8f74TlH7Kph52gDY9hAaLMyZlbcp+nv4fjFg4 +exqDsQ+8FxG75gbMY/qB8oFM2gsQa6H61SilzwZAFv97fRheORKkU55+MkIQpiGRqRxOF3yEvJ+M +0ejf5lG5Nkc/kLnHvALcWxxPDkjBJYOcCj+esQMzEhonrPcibCTRAUH4WAP+JWgiH5paPHxsnnVI +84HxZmduTILA7rpXDhjvLpr3Etiga+kFpaHpaPi8TD8SHkXoUsCjvxInebnMMTzD9joiFgOgyY9m +pFuiTdaBJQbpdqQACj7LzTWb4OE4y2BThihCQRxEV+ioratF4yUQvNs+ZUH7G6aXD+u5dHn5Hrwd +Vw1Hr8Mvn4dGp+smWg9WY7ViYG4A++MnESLn/pmPNPW56MORcr3Ywx65LvKRRFHQV80MNNVIIb/b +E/FmJUNS0nAiNs2fxBx1IK1jcmMGDw4nztJqDby1ORrp0XZ60Vzk50lJLVU3aPAaOpg+VBeHVOmm +J1CJeyAvP/+/oYtKR5j/K3tJPsMpRmAYQqszKbrAKbkTidOIijlBO8n9pu0f9GBj39ItVQGL +-----END CERTIFICATE----- + +SSL.com TLS RSA Root CA 2022 +============================ +-----BEGIN CERTIFICATE----- +MIIFiTCCA3GgAwIBAgIQb77arXO9CEDii02+1PdbkTANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQG +EwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxTU0wuY29tIFRMUyBSU0Eg +Um9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzQyMloXDTQ2MDgxOTE2MzQyMVowTjELMAkGA1UEBhMC +VVMxGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgUlNBIFJv +b3QgQ0EgMjAyMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANCkCXJPQIgSYT41I57u +9nTPL3tYPc48DRAokC+X94xI2KDYJbFMsBFMF3NQ0CJKY7uB0ylu1bUJPiYYf7ISf5OYt6/wNr/y +7hienDtSxUcZXXTzZGbVXcdotL8bHAajvI9AI7YexoS9UcQbOcGV0insS657Lb85/bRi3pZ7Qcac +oOAGcvvwB5cJOYF0r/c0WRFXCsJbwST0MXMwgsadugL3PnxEX4MN8/HdIGkWCVDi1FW24IBydm5M +R7d1VVm0U3TZlMZBrViKMWYPHqIbKUBOL9975hYsLfy/7PO0+r4Y9ptJ1O4Fbtk085zx7AGL0SDG +D6C1vBdOSHtRwvzpXGk3R2azaPgVKPC506QVzFpPulJwoxJF3ca6TvvC0PeoUidtbnm1jPx7jMEW +TO6Af77wdr5BUxIzrlo4QqvXDz5BjXYHMtWrifZOZ9mxQnUjbvPNQrL8VfVThxc7wDNY8VLS+YCk +8OjwO4s4zKTGkH8PnP2L0aPP2oOnaclQNtVcBdIKQXTbYxE3waWglksejBYSd66UNHsef8JmAOSq +g+qKkK3ONkRN0VHpvB/zagX9wHQfJRlAUW7qglFA35u5CCoGAtUjHBPW6dvbxrB6y3snm/vg1UYk +7RBLY0ulBY+6uB0rpvqR4pJSvezrZ5dtmi2fgTIFZzL7SAg/2SW4BCUvAgMBAAGjYzBhMA8GA1Ud +EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU+y437uOEeicuzRk1sTN8/9REQrkwHQYDVR0OBBYEFPsu +N+7jhHonLs0ZNbEzfP/UREK5MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAjYlt +hEUY8U+zoO9opMAdrDC8Z2awms22qyIZZtM7QbUQnRC6cm4pJCAcAZli05bg4vsMQtfhWsSWTVTN +j8pDU/0quOr4ZcoBwq1gaAafORpR2eCNJvkLTqVTJXojpBzOCBvfR4iyrT7gJ4eLSYwfqUdYe5by +iB0YrrPRpgqU+tvT5TgKa3kSM/tKWTcWQA673vWJDPFs0/dRa1419dvAJuoSc06pkZCmF8NsLzjU +o3KUQyxi4U5cMj29TH0ZR6LDSeeWP4+a0zvkEdiLA9z2tmBVGKaBUfPhqBVq6+AL8BQx1rmMRTqo +ENjwuSfr98t67wVylrXEj5ZzxOhWc5y8aVFjvO9nHEMaX3cZHxj4HCUp+UmZKbaSPaKDN7Egkaib +MOlqbLQjk2UEqxHzDh1TJElTHaE/nUiSEeJ9DU/1172iWD54nR4fK/4huxoTtrEoZP2wAgDHbICi +vRZQIA9ygV/MlP+7mea6kMvq+cYMwq7FGc4zoWtcu358NFcXrfA/rs3qr5nsLFR+jM4uElZI7xc7 +P0peYNLcdDa8pUNjyw9bowJWCZ4kLOGGgYz+qxcs+sjiMho6/4UIyYOf8kpIEFR3N+2ivEC+5BB0 +9+Rbu7nzifmPQdjH5FCQNYA+HLhNkNPU98OwoX6EyneSMSy4kLGCenROmxMmtNVQZlR4rmA= +-----END CERTIFICATE----- + +SSL.com TLS ECC Root CA 2022 +============================ +-----BEGIN CERTIFICATE----- +MIICOjCCAcCgAwIBAgIQFAP1q/s3ixdAW+JDsqXRxDAKBggqhkjOPQQDAzBOMQswCQYDVQQGEwJV +UzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxTU0wuY29tIFRMUyBFQ0MgUm9v +dCBDQSAyMDIyMB4XDTIyMDgyNTE2MzM0OFoXDTQ2MDgxOTE2MzM0N1owTjELMAkGA1UEBhMCVVMx +GDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgRUNDIFJvb3Qg +Q0EgMjAyMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABEUpNXP6wrgjzhR9qLFNoFs27iosU8NgCTWy +JGYmacCzldZdkkAZDsalE3D07xJRKF3nzL35PIXBz5SQySvOkkJYWWf9lCcQZIxPBLFNSeR7T5v1 +5wj4A4j3p8OSSxlUgaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSJjy+j6CugFFR7 +81a4Jl9nOAuc0DAdBgNVHQ4EFgQUiY8vo+groBRUe/NWuCZfZzgLnNAwDgYDVR0PAQH/BAQDAgGG +MAoGCCqGSM49BAMDA2gAMGUCMFXjIlbp15IkWE8elDIPDAI2wv2sdDJO4fscgIijzPvX6yv/N33w +7deedWo1dlJF4AIxAMeNb0Igj762TVntd00pxCAgRWSGOlDGxK0tk/UYfXLtqc/ErFc2KAhl3zx5 +Zn6g6g== +-----END CERTIFICATE----- + +Atos TrustedRoot Root CA ECC TLS 2021 +===================================== +-----BEGIN CERTIFICATE----- +MIICFTCCAZugAwIBAgIQPZg7pmY9kGP3fiZXOATvADAKBggqhkjOPQQDAzBMMS4wLAYDVQQDDCVB +dG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgRUNDIFRMUyAyMDIxMQ0wCwYDVQQKDARBdG9zMQswCQYD +VQQGEwJERTAeFw0yMTA0MjIwOTI2MjNaFw00MTA0MTcwOTI2MjJaMEwxLjAsBgNVBAMMJUF0b3Mg +VHJ1c3RlZFJvb3QgUm9vdCBDQSBFQ0MgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYT +AkRFMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEloZYKDcKZ9Cg3iQZGeHkBQcfl+3oZIK59sRxUM6K +DP/XtXa7oWyTbIOiaG6l2b4siJVBzV3dscqDY4PMwL502eCdpO5KTlbgmClBk1IQ1SQ4AjJn8ZQS +b+/Xxd4u/RmAo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR2KCXWfeBmmnoJsmo7jjPX +NtNPojAOBgNVHQ8BAf8EBAMCAYYwCgYIKoZIzj0EAwMDaAAwZQIwW5kp85wxtolrbNa9d+F851F+ +uDrNozZffPc8dz7kUK2o59JZDCaOMDtuCCrCp1rIAjEAmeMM56PDr9NJLkaCI2ZdyQAUEv049OGY +a3cpetskz2VAv9LcjBHo9H1/IISpQuQo +-----END CERTIFICATE----- + +Atos TrustedRoot Root CA RSA TLS 2021 +===================================== +-----BEGIN CERTIFICATE----- +MIIFZDCCA0ygAwIBAgIQU9XP5hmTC/srBRLYwiqipDANBgkqhkiG9w0BAQwFADBMMS4wLAYDVQQD +DCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgUlNBIFRMUyAyMDIxMQ0wCwYDVQQKDARBdG9zMQsw +CQYDVQQGEwJERTAeFw0yMTA0MjIwOTIxMTBaFw00MTA0MTcwOTIxMDlaMEwxLjAsBgNVBAMMJUF0 +b3MgVHJ1c3RlZFJvb3QgUm9vdCBDQSBSU0EgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNV +BAYTAkRFMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtoAOxHm9BYx9sKOdTSJNy/BB +l01Z4NH+VoyX8te9j2y3I49f1cTYQcvyAh5x5en2XssIKl4w8i1mx4QbZFc4nXUtVsYvYe+W/CBG +vevUez8/fEc4BKkbqlLfEzfTFRVOvV98r61jx3ncCHvVoOX3W3WsgFWZkmGbzSoXfduP9LVq6hdK +ZChmFSlsAvFr1bqjM9xaZ6cF4r9lthawEO3NUDPJcFDsGY6wx/J0W2tExn2WuZgIWWbeKQGb9Cpt +0xU6kGpn8bRrZtkh68rZYnxGEFzedUlnnkL5/nWpo63/dgpnQOPF943HhZpZnmKaau1Fh5hnstVK +PNe0OwANwI8f4UDErmwh3El+fsqyjW22v5MvoVw+j8rtgI5Y4dtXz4U2OLJxpAmMkokIiEjxQGMY +sluMWuPD0xeqqxmjLBvk1cbiZnrXghmmOxYsL3GHX0WelXOTwkKBIROW1527k2gV+p2kHYzygeBY +Br3JtuP2iV2J+axEoctr+hbxx1A9JNr3w+SH1VbxT5Aw+kUJWdo0zuATHAR8ANSbhqRAvNncTFd+ +rrcztl524WWLZt+NyteYr842mIycg5kDcPOvdO3GDjbnvezBc6eUWsuSZIKmAMFwoW4sKeFYV+xa +fJlrJaSQOoD0IJ2azsct+bJLKZWD6TWNp0lIpw9MGZHQ9b8Q4HECAwEAAaNCMEAwDwYDVR0TAQH/ +BAUwAwEB/zAdBgNVHQ4EFgQUdEmZ0f+0emhFdcN+tNzMzjkz2ggwDgYDVR0PAQH/BAQDAgGGMA0G +CSqGSIb3DQEBDAUAA4ICAQAjQ1MkYlxt/T7Cz1UAbMVWiLkO3TriJQ2VSpfKgInuKs1l+NsW4AmS +4BjHeJi78+xCUvuppILXTdiK/ORO/auQxDh1MoSf/7OwKwIzNsAQkG8dnK/haZPso0UvFJ/1TCpl +Q3IM98P4lYsU84UgYt1UU90s3BiVaU+DR3BAM1h3Egyi61IxHkzJqM7F78PRreBrAwA0JrRUITWX +AdxfG/F851X6LWh3e9NpzNMOa7pNdkTWwhWaJuywxfW70Xp0wmzNxbVe9kzmWy2B27O3Opee7c9G +slA9hGCZcbUztVdF5kJHdWoOsAgMrr3e97sPWD2PAzHoPYJQyi9eDF20l74gNAf0xBLh7tew2Vkt +afcxBPTy+av5EzH4AXcOPUIjJsyacmdRIXrMPIWo6iFqO9taPKU0nprALN+AnCng33eU0aKAQv9q +TFsR0PXNor6uzFFcw9VUewyu1rkGd4Di7wcaaMxZUa1+XGdrudviB0JbuAEFWDlN5LuYo7Ey7Nmj +1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5dDTedk+SKlOxJTnbPP/l +PqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcEoji2jbDwN/zIIX8/syQbPYtuzE2wFg2W +HYMfRsCbvUOZ58SWLs5fyQ== +-----END CERTIFICATE----- + +TrustAsia Global Root CA G3 +=========================== +-----BEGIN CERTIFICATE----- +MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEMBQAwWjELMAkG +A1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xJDAiBgNVBAMM +G1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAeFw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEw +MTlaMFoxCzAJBgNVBAYTAkNOMSUwIwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMu +MSQwIgYDVQQDDBtUcnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUA +A4ICDwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNST1QY4Sxz +lZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqKAtCWHwDNBSHvBm3dIZwZ +Q0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/V +P68czH5GX6zfZBCK70bwkPAPLfSIC7Epqq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1Ag +dB4SQXMeJNnKziyhWTXAyB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm +9WAPzJMshH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gXzhqc +D0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAvkV34PmVACxmZySYg +WmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msTf9FkPz2ccEblooV7WIQn3MSAPmea +mseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jAuPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCF +TIcQcf+eQxuulXUtgQIDAQABo2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj +7zjKsK5Xf/IhMBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E +BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4wM8zAQLpw6o1 +D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2XFNFV1pF1AWZLy4jVe5jaN/T +G3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNj +duMNhXJEIlU/HHzp/LgV6FL6qj6jITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstl +cHboCoWASzY9M/eVVHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys ++TIxxHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1onAX1daBli +2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d7XB4tmBZrOFdRWOPyN9y +aFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2NtjjgKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsAS +ZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV+Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFR +JQJ6+N1rZdVtTTDIZbpoFGWsJwt0ivKH +-----END CERTIFICATE----- + +TrustAsia Global Root CA G4 +=========================== +-----BEGIN CERTIFICATE----- +MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMwWjELMAkGA1UE +BhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xJDAiBgNVBAMMG1Ry +dXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0yMTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJa +MFoxCzAJBgNVBAYTAkNOMSUwIwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQw +IgYDVQQDDBtUcnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNi +AATxs8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbwLxYI+hW8 +m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJijYzBhMA8GA1UdEwEB/wQF +MAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mDpm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/ +pDHel4NZg6ZvccveMA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AA +bbd+NvBNEU/zy4k6LHiRUKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xk +dUfFVZDj/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA== +-----END CERTIFICATE----- + +Telekom Security TLS ECC Root 2020 +================================== +-----BEGIN CERTIFICATE----- +MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQswCQYDVQQGEwJE +RTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBHbWJIMSswKQYDVQQDDCJUZWxl +a29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIwMB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIz +NTk1OVowYzELMAkGA1UEBhMCREUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkg +R21iSDErMCkGA1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqG +SM49AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/OtdKPD/M1 +2kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDPf8iAC8GXs7s1J8nCG6NC +MEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6fMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0P +AQH/BAQDAgEGMAoGCCqGSM49BAMDA2cAMGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZ +Mo7k+5Dck2TOrbRBR2Diz6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdU +ga/sf+Rn27iQ7t0l +-----END CERTIFICATE----- + +Telekom Security TLS RSA Root 2023 +================================== +-----BEGIN CERTIFICATE----- +MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBjMQswCQYDVQQG +EwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBHbWJIMSswKQYDVQQDDCJU +ZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAyMDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMy +NzIzNTk1OVowYzELMAkGA1UEBhMCREUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJp +dHkgR21iSDErMCkGA1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIw +DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9cUD/h3VC +KSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHVcp6R+SPWcHu79ZvB7JPP +GeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMAU6DksquDOFczJZSfvkgdmOGjup5czQRx +UX11eKvzWarE4GC+j4NSuHUaQTXtvPM6Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWo +l8hHD/BeEIvnHRz+sTugBTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9 +FIS3R/qy8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73Jco4v +zLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg8qKrBC7m8kwOFjQg +rIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8rFEz0ciD0cmfHdRHNCk+y7AO+oML +KFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7S +WWO/gLCMk3PLNaaZlSJhZQNg+y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNV +HQ4EFgQUtqeXgj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2 +p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQpGv7qHBFfLp+ +sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm9S3ul0A8Yute1hTWjOKWi0Fp +kzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErwM807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy +/SKE8YXJN3nptT+/XOR0so8RYgDdGGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4 +mZqTuXNnQkYRIer+CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtz +aL1txKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+w6jv/naa +oqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aKL4x35bcF7DvB7L6Gs4a8 +wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+ljX273CXE2whJdV/LItM3z7gLfEdxquVeE +HVlNjM7IDiPCtyaaEBRx/pOyiriA8A4QntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0 +o82bNSQ3+pCTE4FCxpgmdTdmQRCsu/WU48IxK63nI1bMNSWSs1A= +-----END CERTIFICATE----- + +FIRMAPROFESIONAL CA ROOT-A WEB +============================== +-----BEGIN CERTIFICATE----- +MIICejCCAgCgAwIBAgIQMZch7a+JQn81QYehZ1ZMbTAKBggqhkjOPQQDAzBuMQswCQYDVQQGEwJF +UzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UEYQwPVkFURVMtQTYyNjM0MDY4 +MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENBIFJPT1QtQSBXRUIwHhcNMjIwNDA2MDkwMTM2 +WhcNNDcwMzMxMDkwMTM2WjBuMQswCQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25h +bCBTQTEYMBYGA1UEYQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFM +IENBIFJPT1QtQSBXRUIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARHU+osEaR3xyrq89Zfe9MEkVz6 +iMYiuYMQYneEMy3pA4jU4DP37XcsSmDq5G+tbbT4TIqk5B/K6k84Si6CcyvHZpsKjECcfIr28jlg +st7L7Ljkb+qbXbdTkBgyVcUgt5SjYzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUk+FD +Y1w8ndYn81LsF7Kpryz3dvgwHQYDVR0OBBYEFJPhQ2NcPJ3WJ/NS7Beyqa8s93b4MA4GA1UdDwEB +/wQEAwIBBjAKBggqhkjOPQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgL +cFBTApFwhVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dGXSaQ +pYXFuXqUPoeovQA= +-----END CERTIFICATE----- + +TWCA CYBER Root CA +================== +-----BEGIN CERTIFICATE----- +MIIFjTCCA3WgAwIBAgIQQAE0jMIAAAAAAAAAATzyxjANBgkqhkiG9w0BAQwFADBQMQswCQYDVQQG +EwJUVzESMBAGA1UEChMJVEFJV0FOLUNBMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJUV0NB +IENZQkVSIFJvb3QgQ0EwHhcNMjIxMTIyMDY1NDI5WhcNNDcxMTIyMTU1OTU5WjBQMQswCQYDVQQG +EwJUVzESMBAGA1UEChMJVEFJV0FOLUNBMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJUV0NB +IENZQkVSIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDG+Moe2Qkgfh1s +Ts6P40czRJzHyWmqOlt47nDSkvgEs1JSHWdyKKHfi12VCv7qze33Kc7wb3+szT3vsxxFavcokPFh +V8UMxKNQXd7UtcsZyoC5dc4pztKFIuwCY8xEMCDa6pFbVuYdHNWdZsc/34bKS1PE2Y2yHer43CdT +o0fhYcx9tbD47nORxc5zb87uEB8aBs/pJ2DFTxnk684iJkXXYJndzk834H/nY62wuFm40AZoNWDT +Nq5xQwTxaWV4fPMf88oon1oglWa0zbfuj3ikRRjpJi+NmykosaS3Om251Bw4ckVYsV7r8Cibt4LK +/c/WMw+f+5eesRycnupfXtuq3VTpMCEobY5583WSjCb+3MX2w7DfRFlDo7YDKPYIMKoNM+HvnKkH +IuNZW0CP2oi3aQiotyMuRAlZN1vH4xfyIutuOVLF3lSnmMlLIJXcRolftBL5hSmO68gnFSDAS9TM +fAxsNAwmmyYxpjyn9tnQS6Jk/zuZQXLB4HCX8SS7K8R0IrGsayIyJNN4KsDAoS/xUgXJP+92ZuJF +2A09rZXIx4kmyA+upwMu+8Ff+iDhcK2wZSA3M2Cw1a/XDBzCkHDXShi8fgGwsOsVHkQGzaRP6AzR +wyAQ4VRlnrZR0Bp2a0JaWHY06rc3Ga4udfmW5cFZ95RXKSWNOkyrTZpB0F8mAwIDAQABo2MwYTAO +BgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSdhWEUfMFib5do5E83 +QOGt4A1WNzAdBgNVHQ4EFgQUnYVhFHzBYm+XaORPN0DhreANVjcwDQYJKoZIhvcNAQEMBQADggIB +AGSPesRiDrWIzLjHhg6hShbNcAu3p4ULs3a2D6f/CIsLJc+o1IN1KriWiLb73y0ttGlTITVX1olN +c79pj3CjYcya2x6a4CD4bLubIp1dhDGaLIrdaqHXKGnK/nZVekZn68xDiBaiA9a5F/gZbG0jAn/x +X9AKKSM70aoK7akXJlQKTcKlTfjF/biBzysseKNnTKkHmvPfXvt89YnNdJdhEGoHK4Fa0o635yDR +IG4kqIQnoVesqlVYL9zZyvpoBJ7tRCT5dEA7IzOrg1oYJkK2bVS1FmAwbLGg+LhBoF1JSdJlBTrq +/p1hvIbZv97Tujqxf36SNI7JAG7cmL3c7IAFrQI932XtCwP39xaEBDG6k5TY8hL4iuO/Qq+n1M0R +FxbIQh0UqEL20kCGoE8jypZFVmAGzbdVAaYBlGX+bgUJurSkquLvWL69J1bY73NxW0Qz8ppy6rBe +Pm6pUlvscG21h483XjyMnM7k8M4MZ0HMzvaAq07MTFb1wWFZk7Q+ptq4NxKfKjLji7gh7MMrZQzv +It6IKTtM1/r+t+FHvpw+PoP7UV31aPcuIYXcv/Fa4nzXxeSDwWrruoBa3lwtcHb4yOWHh8qgnaHl +IhInD0Q9HWzq1MKLL295q39QpsQZp6F6t5b5wR9iWqJDB0BeJsas7a5wFsWqynKKTbDPAYsDP27X +-----END CERTIFICATE----- + +SecureSign Root CA12 +==================== +-----BEGIN CERTIFICATE----- +MIIDcjCCAlqgAwIBAgIUZvnHwa/swlG07VOX5uaCwysckBYwDQYJKoZIhvcNAQELBQAwUTELMAkG +A1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBMdGQuMR0wGwYDVQQDExRT +ZWN1cmVTaWduIFJvb3QgQ0ExMjAeFw0yMDA0MDgwNTM2NDZaFw00MDA0MDgwNTM2NDZaMFExCzAJ +BgNVBAYTAkpQMSMwIQYDVQQKExpDeWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMU +U2VjdXJlU2lnbiBSb290IENBMTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6OcE3 +emhFKxS06+QT61d1I02PJC0W6K6OyX2kVzsqdiUzg2zqMoqUm048luT9Ub+ZyZN+v/mtp7JIKwcc +J/VMvHASd6SFVLX9kHrko+RRWAPNEHl57muTH2SOa2SroxPjcf59q5zdJ1M3s6oYwlkm7Fsf0uZl +fO+TvdhYXAvA42VvPMfKWeP+bl+sg779XSVOKik71gurFzJ4pOE+lEa+Ym6b3kaosRbnhW70CEBF +EaCeVESE99g2zvVQR9wsMJvuwPWW0v4JhscGWa5Pro4RmHvzC1KqYiaqId+OJTN5lxZJjfU+1Uef +NzFJM3IFTQy2VYzxV4+Kh9GtxRESOaCtAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0P +AQH/BAQDAgEGMB0GA1UdDgQWBBRXNPN0zwRL1SXm8UC2LEzZLemgrTANBgkqhkiG9w0BAQsFAAOC +AQEAPrvbFxbS8hQBICw4g0utvsqFepq2m2um4fylOqyttCg6r9cBg0krY6LdmmQOmFxv3Y67ilQi +LUoT865AQ9tPkbeGGuwAtEGBpE/6aouIs3YIcipJQMPTw4WJmBClnW8Zt7vPemVV2zfrPIpyMpce +mik+rY3moxtt9XUa5rBouVui7mlHJzWhhpmA8zNL4WukJsPvdFlseqJkth5Ew1DgDzk9qTPxpfPS +vWKErI4cqc1avTc7bgoitPQV55FYxTpE05Uo2cBl6XLK0A+9H7MV2anjpEcJnuDLN/v9vZfVvhga +aaI5gdka9at/yOPiZwud9AzqVN/Ssq+xIvEg37xEHA== +-----END CERTIFICATE----- + +SecureSign Root CA14 +==================== +-----BEGIN CERTIFICATE----- +MIIFcjCCA1qgAwIBAgIUZNtaDCBO6Ncpd8hQJ6JaJ90t8sswDQYJKoZIhvcNAQEMBQAwUTELMAkG +A1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBMdGQuMR0wGwYDVQQDExRT +ZWN1cmVTaWduIFJvb3QgQ0ExNDAeFw0yMDA0MDgwNzA2MTlaFw00NTA0MDgwNzA2MTlaMFExCzAJ +BgNVBAYTAkpQMSMwIQYDVQQKExpDeWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMU +U2VjdXJlU2lnbiBSb290IENBMTQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDF0nqh +1oq/FjHQmNE6lPxauG4iwWL3pwon71D2LrGeaBLwbCRjOfHw3xDG3rdSINVSW0KZnvOgvlIfX8xn +bacuUKLBl422+JX1sLrcneC+y9/3OPJH9aaakpUqYllQC6KxNedlsmGy6pJxaeQp8E+BgQQ8sqVb +1MWoWWd7VRxJq3qdwudzTe/NCcLEVxLbAQ4jeQkHO6Lo/IrPj8BGJJw4J+CDnRugv3gVEOuGTgpa +/d/aLIJ+7sr2KeH6caH3iGicnPCNvg9JkdjqOvn90Ghx2+m1K06Ckm9mH+Dw3EzsytHqunQG+bOE +kJTRX45zGRBdAuVwpcAQ0BB8b8VYSbSwbprafZX1zNoCr7gsfXmPvkPx+SgojQlD+Ajda8iLLCSx +jVIHvXiby8posqTdDEx5YMaZ0ZPxMBoH064iwurO8YQJzOAUbn8/ftKChazcqRZOhaBgy/ac18iz +ju3Gm5h1DVXoX+WViwKkrkMpKBGk5hIwAUt1ax5mnXkvpXYvHUC0bcl9eQjs0Wq2XSqypWa9a4X0 +dFbD9ed1Uigspf9mR6XU/v6eVL9lfgHWMI+lNpyiUBzuOIABSMbHdPTGrMNASRZhdCyvjG817XsY +AFs2PJxQDcqSMxDxJklt33UkN4Ii1+iW/RVLApY+B3KVfqs9TC7XyvDf4Fg/LS8EmjijAQIDAQAB +o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUBpOjCl4oaTeq +YR3r6/wtbyPk86AwDQYJKoZIhvcNAQEMBQADggIBAJaAcgkGfpzMkwQWu6A6jZJOtxEaCnFxEM0E +rX+lRVAQZk5KQaID2RFPeje5S+LGjzJmdSX7684/AykmjbgWHfYfM25I5uj4V7Ibed87hwriZLoA +ymzvftAj63iP/2SbNDefNWWipAA9EiOWWF3KY4fGoweITedpdopTzfFP7ELyk+OZpDc8h7hi2/Ds +Hzc/N19DzFGdtfCXwreFamgLRB7lUe6TzktuhsHSDCRZNhqfLJGP4xjblJUK7ZGqDpncllPjYYPG +FrojutzdfhrGe0K22VoF3Jpf1d+42kd92jjbrDnVHmtsKheMYc2xbXIBw8MgAGJoFjHVdqqGuw6q +nsb58Nn4DSEC5MUoFlkRudlpcyqSeLiSV5sI8jrlL5WwWLdrIBRtFO8KvH7YVdiI2i/6GaX7i+B/ +OfVyK4XELKzvGUWSTLNhB9xNH27SgRNcmvMSZ4PPmz+Ln52kuaiWA3rF7iDeM9ovnhp6dB7h7sxa +OgTdsxoEqBRjrLdHEoOabPXm6RUVkRqEGQ6UROcSjiVbgGcZ3GOTEAtlLor6CZpO2oYofaphNdgO +pygau1LgePhsumywbrmHXumZNTfxPWQrqaA0k89jL9WB365jJ6UeTo3cKXhZ+PmhIIynJkBugnLN +eLLIjzwec+fBH7/PzqUqm9tEZDKgu39cJRNItX+S +-----END CERTIFICATE----- + +SecureSign Root CA15 +==================== +-----BEGIN CERTIFICATE----- +MIICIzCCAamgAwIBAgIUFhXHw9hJp75pDIqI7fBw+d23PocwCgYIKoZIzj0EAwMwUTELMAkGA1UE +BhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBMdGQuMR0wGwYDVQQDExRTZWN1 +cmVTaWduIFJvb3QgQ0ExNTAeFw0yMDA0MDgwODMyNTZaFw00NTA0MDgwODMyNTZaMFExCzAJBgNV +BAYTAkpQMSMwIQYDVQQKExpDeWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2Vj +dXJlU2lnbiBSb290IENBMTUwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQLUHSNZDKZmbPSYAi4Io5G +dCx4wCtELW1fHcmuS1Iggz24FG1Th2CeX2yF2wYUleDHKP+dX+Sq8bOLbe1PL0vJSpSRZHX+AezB +2Ot6lHhWGENfa4HL9rzatAy2KZMIaY+jQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD +AgEGMB0GA1UdDgQWBBTrQciu/NWeUUj1vYv0hyCTQSvT9DAKBggqhkjOPQQDAwNoADBlAjEA2S6J +fl5OpBEHvVnCB96rMjhTKkZEBhd6zlHp4P9mLQlO4E/0BdGF9jVg3PVys0Z9AjBEmEYagoUeYWmJ +SwdLZrWeqrqgHkHZAXQ6bkU6iYAZezKYVWOr62Nuk22rGwlgMU4= +-----END CERTIFICATE----- + +D-TRUST BR Root CA 2 2023 +========================= +-----BEGIN CERTIFICATE----- +MIIFqTCCA5GgAwIBAgIQczswBEhb2U14LnNLyaHcZjANBgkqhkiG9w0BAQ0FADBIMQswCQYDVQQG +EwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEJSIFJvb3QgQ0Eg +MiAyMDIzMB4XDTIzMDUwOTA4NTYzMVoXDTM4MDUwOTA4NTYzMFowSDELMAkGA1UEBhMCREUxFTAT +BgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDIgMjAyMzCC +AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK7/CVmRgApKaOYkP7in5Mg6CjoWzckjYaCT +cfKri3OPoGdlYNJUa2NRb0kz4HIHE304zQaSBylSa053bATTlfrdTIzZXcFhfUvnKLNEgXtRr90z +sWh81k5M/itoucpmacTsXld/9w3HnDY25QdgrMBM6ghs7wZ8T1soegj8k12b9py0i4a6Ibn08OhZ +WiihNIQaJZG2tY/vsvmA+vk9PBFy2OMvhnbFeSzBqZCTRphny4NqoFAjpzv2gTng7fC5v2Xx2Mt6 +++9zA84A9H3X4F07ZrjcjrqDy4d2A/wl2ecjbwb9Z/Pg/4S8R7+1FhhGaRTMBffb00msa8yr5LUL +QyReS2tNZ9/WtT5PeB+UcSTq3nD88ZP+npNa5JRal1QMNXtfbO4AHyTsA7oC9Xb0n9Sa7YUsOCIv +x9gvdhFP/Wxc6PWOJ4d/GUohR5AdeY0cW/jPSoXk7bNbjb7EZChdQcRurDhaTyN0dKkSw/bSuREV +MweR2Ds3OmMwBtHFIjYoYiMQ4EbMl6zWK11kJNXuHA7e+whadSr2Y23OC0K+0bpwHJwh5Q8xaRfX +/Aq03u2AnMuStIv13lmiWAmlY0cL4UEyNEHZmrHZqLAbWt4NDfTisl01gLmB1IRpkQLLddCNxbU9 +CZEJjxShFHR5PtbJFR2kWVki3PaKRT08EtY+XTIvAgMBAAGjgY4wgYswDwYDVR0TAQH/BAUwAwEB +/zAdBgNVHQ4EFgQUZ5Dw1t61GNVGKX5cq/ieCLxklRAwDgYDVR0PAQH/BAQDAgEGMEkGA1UdHwRC +MEAwPqA8oDqGOGh0dHA6Ly9jcmwuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3RfYnJfcm9vdF9jYV8y +XzIwMjMuY3JsMA0GCSqGSIb3DQEBDQUAA4ICAQA097N3U9swFrktpSHxQCF16+tIFoE9c+CeJyrr +d6kTpGoKWloUMz1oH4Guaf2Mn2VsNELZLdB/eBaxOqwjMa1ef67nriv6uvw8l5VAk1/DLQOj7aRv +U9f6QA4w9QAgLABMjDu0ox+2v5Eyq6+SmNMW5tTRVFxDWy6u71cqqLRvpO8NVhTaIasgdp4D/Ca4 +nj8+AybmTNudX0KEPUUDAxxZiMrcLmEkWqTqJwtzEr5SswrPMhfiHocaFpVIbVrg0M8JkiZmkdij +YQ6qgYF/6FKC0ULn4B0Y+qSFNueG4A3rvNTJ1jxD8V1Jbn6Bm2m1iWKPiFLY1/4nwSPFyysCu7Ff +/vtDhQNGvl3GyiEm/9cCnnRK3PgTFbGBVzbLZVzRHTF36SXDw7IyN9XxmAnkbWOACKsGkoHU6XCP +pz+y7YaMgmo1yEJagtFSGkUPFaUA8JR7ZSdXOUPPfH/mvTWze/EZTN46ls/pdu4D58JDUjxqgejB +WoC9EV2Ta/vH5mQ/u2kc6d0li690yVRAysuTEwrt+2aSEcr1wPrYg1UDfNPFIkZ1cGt5SAYqgpq/ +5usWDiJFAbzdNpQ0qTUmiteXue4Icr80knCDgKs4qllo3UCkGJCy89UDyibK79XH4I9TjvAA46jt +n/mtd+ArY0+ew+43u3gJhJ65bvspmZDogNOfJA== +-----END CERTIFICATE----- + +TrustAsia TLS ECC Root CA +========================= +-----BEGIN CERTIFICATE----- +MIICMTCCAbegAwIBAgIUNnThTXxlE8msg1UloD5Sfi9QaMcwCgYIKoZIzj0EAwMwWDELMAkGA1UE +BhMCQ04xJTAjBgNVBAoTHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xIjAgBgNVBAMTGVRy +dXN0QXNpYSBUTFMgRUNDIFJvb3QgQ0EwHhcNMjQwNTE1MDU0MTU2WhcNNDQwNTE1MDU0MTU1WjBY +MQswCQYDVQQGEwJDTjElMCMGA1UEChMcVHJ1c3RBc2lhIFRlY2hub2xvZ2llcywgSW5jLjEiMCAG +A1UEAxMZVHJ1c3RBc2lhIFRMUyBFQ0MgUm9vdCBDQTB2MBAGByqGSM49AgEGBSuBBAAiA2IABLh/ +pVs/AT598IhtrimY4ZtcU5nb9wj/1WrgjstEpvDBjL1P1M7UiFPoXlfXTr4sP/MSpwDpguMqWzJ8 +S5sUKZ74LYO1644xST0mYekdcouJtgq7nDM1D9rs3qlKH8kzsaNCMEAwDwYDVR0TAQH/BAUwAwEB +/zAdBgNVHQ4EFgQULIVTu7FDzTLqnqOH/qKYqKaT6RAwDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49 +BAMDA2gAMGUCMFRH18MtYYZI9HlaVQ01L18N9mdsd0AaRuf4aFtOJx24mH1/k78ITcTaRTChD15K +eAIxAKORh/IRM4PDwYqROkwrULG9IpRdNYlzg8WbGf60oenUoWa2AaU2+dhoYSi3dOGiMQ== +-----END CERTIFICATE----- + +TrustAsia TLS RSA Root CA +========================= +-----BEGIN CERTIFICATE----- +MIIFgDCCA2igAwIBAgIUHBjYz+VTPyI1RlNUJDxsR9FcSpwwDQYJKoZIhvcNAQEMBQAwWDELMAkG +A1UEBhMCQ04xJTAjBgNVBAoTHFRydXN0QXNpYSBUZWNobm9sb2dpZXMsIEluYy4xIjAgBgNVBAMT +GVRydXN0QXNpYSBUTFMgUlNBIFJvb3QgQ0EwHhcNMjQwNTE1MDU0MTU3WhcNNDQwNTE1MDU0MTU2 +WjBYMQswCQYDVQQGEwJDTjElMCMGA1UEChMcVHJ1c3RBc2lhIFRlY2hub2xvZ2llcywgSW5jLjEi +MCAGA1UEAxMZVHJ1c3RBc2lhIFRMUyBSU0EgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIP +ADCCAgoCggIBAMMWuBtqpERz5dZO9LnPWwvB0ZqB9WOwj0PBuwhaGnrhB3YmH49pVr7+NmDQDIPN +lOrnxS1cLwUWAp4KqC/lYCZUlviYQB2srp10Zy9U+5RjmOMmSoPGlbYJQ1DNDX3eRA5gEk9bNb2/ +mThtfWza4mhzH/kxpRkQcwUqwzIZheo0qt1CHjCNP561HmHVb70AcnKtEj+qpklz8oYVlQwQX1Fk +zv93uMltrOXVmPGZLmzjyUT5tUMnCE32ft5EebuyjBza00tsLtbDeLdM1aTk2tyKjg7/D8OmYCYo +zza/+lcK7Fs/6TAWe8TbxNRkoDD75f0dcZLdKY9BWN4ArTr9PXwaqLEX8E40eFgl1oUh63kd0Nyr +z2I8sMeXi9bQn9P+PN7F4/w6g3CEIR0JwqH8uyghZVNgepBtljhb//HXeltt08lwSUq6HTrQUNoy +IBnkiz/r1RYmNzz7dZ6wB3C4FGB33PYPXFIKvF1tjVEK2sUYyJtt3LCDs3+jTnhMmCWr8n4uIF6C +FabW2I+s5c0yhsj55NqJ4js+k8UTav/H9xj8Z7XvGCxUq0DTbE3txci3OE9kxJRMT6DNrqXGJyV1 +J23G2pyOsAWZ1SgRxSHUuPzHlqtKZFlhaxP8S8ySpg+kUb8OWJDZgoM5pl+z+m6Ss80zDoWo8SnT +q1mt1tve1CuBAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFLgHkXlcBvRG/XtZ +ylomkadFK/hTMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQwFAAOCAgEAIZtqBSBdGBanEqT3 +Rz/NyjuujsCCztxIJXgXbODgcMTWltnZ9r96nBO7U5WS/8+S4PPFJzVXqDuiGev4iqME3mmL5Dw8 +veWv0BIb5Ylrc5tvJQJLkIKvQMKtuppgJFqBTQUYo+IzeXoLH5Pt7DlK9RME7I10nYEKqG/odv6L +TytpEoYKNDbdgptvT+Bz3Ul/KD7JO6NXBNiT2Twp2xIQaOHEibgGIOcberyxk2GaGUARtWqFVwHx +tlotJnMnlvm5P1vQiJ3koP26TpUJg3933FEFlJ0gcXax7PqJtZwuhfG5WyRasQmr2soaB82G39tp +27RIGAAtvKLEiUUjpQ7hRGU+isFqMB3iYPg6qocJQrmBktwliJiJ8Xw18WLK7nn4GS/+X/jbh87q +qA8MpugLoDzga5SYnH+tBuYc6kIQX+ImFTw3OffXvO645e8D7r0i+yiGNFjEWn9hongPXvPKnbwb +PKfILfanIhHKA9jnZwqKDss1jjQ52MjqjZ9k4DewbNfFj8GQYSbbJIweSsCI3zWQzj8C9GRh3sfI +B5XeMhg6j6JCQCTl1jNdfK7vsU1P1FeQNWrcrgSXSYk0ly4wBOeY99sLAZDBHwo/+ML+TvrbmnNz +FrwFuHnYWa8G5z9nODmxfKuU4CkUpijy323imttUQ/hHWKNddBWcwauwxzQ= +-----END CERTIFICATE----- + +D-TRUST EV Root CA 2 2023 +========================= +-----BEGIN CERTIFICATE----- +MIIFqTCCA5GgAwIBAgIQaSYJfoBLTKCnjHhiU19abzANBgkqhkiG9w0BAQ0FADBIMQswCQYDVQQG +EwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRSVVNUIEVWIFJvb3QgQ0Eg +MiAyMDIzMB4XDTIzMDUwOTA5MTAzM1oXDTM4MDUwOTA5MTAzMlowSDELMAkGA1UEBhMCREUxFTAT +BgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAGA1UEAxMZRC1UUlVTVCBFViBSb290IENBIDIgMjAyMzCC +AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANiOo4mAC7JXUtypU0w3uX9jFxPvp1sjW2l1 +sJkKF8GLxNuo4MwxusLyzV3pt/gdr2rElYfXR8mV2IIEUD2BCP/kPbOx1sWy/YgJ25yE7CUXFId/ +MHibaljJtnMoPDT3mfd/06b4HEV8rSyMlD/YZxBTfiLNTiVR8CUkNRFeEMbsh2aJgWi6zCudR3Mf +vc2RpHJqnKIbGKBv7FD0fUDCqDDPvXPIEysQEx6Lmqg6lHPTGGkKSv/BAQP/eX+1SH977ugpbzZM +lWGG2Pmic4ruri+W7mjNPU0oQvlFKzIbRlUWaqZLKfm7lVa/Rh3sHZMdwGWyH6FDrlaeoLGPaxK3 +YG14C8qKXO0elg6DpkiVjTujIcSuWMYAsoS0I6SWhjW42J7YrDRJmGOVxcttSEfi8i4YHtAxq910 +7PncjLgcjmgjutDzUNzPZY9zOjLHfP7KgiJPvo5iR2blzYfi6NUPGJ/lBHJLRjwQ8kTCZFZxTnXo +nMkmdMV9WdEKWw9t/p51HBjGGjp82A0EzM23RWV6sY+4roRIPrN6TagD4uJ+ARZZaBhDM7DS3LAa +QzXupdqpRlyuhoFBAUp0JuyfBr/CBTdkdXgpaP3F9ev+R/nkhbDhezGdpn9yo7nELC7MmVcOIQxF +AZRl62UJxmMiCzNJkkg8/M3OsD6Onov4/knFNXJHAgMBAAGjgY4wgYswDwYDVR0TAQH/BAUwAwEB +/zAdBgNVHQ4EFgQUqvyREBuHkV8Wub9PS5FeAByxMoAwDgYDVR0PAQH/BAQDAgEGMEkGA1UdHwRC +MEAwPqA8oDqGOGh0dHA6Ly9jcmwuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3RfZXZfcm9vdF9jYV8y +XzIwMjMuY3JsMA0GCSqGSIb3DQEBDQUAA4ICAQCTy6UfmRHsmg1fLBWTxj++EI14QvBukEdHjqOS +Mo1wj/Zbjb6JzkcBahsgIIlbyIIQbODnmaprxiqgYzWRaoUlrRc4pZt+UPJ26oUFKidBK7GB0aL2 +QHWpDsvxVUjY7NHss+jOFKE17MJeNRqrphYBBo7q3C+jisosketSjl8MmxfPy3MHGcRqwnNU73xD +UmPBEcrCRbH0O1P1aa4846XerOhUt7KR/aypH/KH5BfGSah82ApB9PI+53c0BFLd6IHyTS9URZ0V +4U/M5d40VxDJI3IXcI1QcB9WbMy5/zpaT2N6w25lBx2Eof+pDGOJbbJAiDnXH3dotfyc1dZnaVuo +dNv8ifYbMvekJKZ2t0dT741Jj6m2g1qllpBFYfXeA08mD6iL8AOWsKwV0HFaanuU5nCT2vFp4LJi +TZ6P/4mdm13NRemUAiKN4DV/6PEEeXFsVIP4M7kFMhtYVRFP0OUnR3Hs7dpn1mKmS00PaaLJvOwi +S5THaJQXfuKOKD62xur1NGyfN4gHONuGcfrNlUhDbqNPgofXNJhuS5N5YHVpD/Aa1VP6IQzCP+k/ +HxiMkl14p3ZnGbuy6n/pcAlWVqOwDAstNl7F6cTVg8uGF5csbBNvh1qvSaYd2804BC5f4ko1Di1L ++KIkBI3Y4WNeApI02phhXBxvWHZks/wCuPWdCg== +-----END CERTIFICATE----- + +SwissSign RSA TLS Root CA 2022 - 1 +================================== +-----BEGIN CERTIFICATE----- +MIIFkzCCA3ugAwIBAgIUQ/oMX04bgBhE79G0TzUfRPSA7cswDQYJKoZIhvcNAQELBQAwUTELMAkG +A1UEBhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzErMCkGA1UEAxMiU3dpc3NTaWduIFJTQSBU +TFMgUm9vdCBDQSAyMDIyIC0gMTAeFw0yMjA2MDgxMTA4MjJaFw00NzA2MDgxMTA4MjJaMFExCzAJ +BgNVBAYTAkNIMRUwEwYDVQQKEwxTd2lzc1NpZ24gQUcxKzApBgNVBAMTIlN3aXNzU2lnbiBSU0Eg +VExTIFJvb3QgQ0EgMjAyMiAtIDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDLKmji +C8NXvDVjvHClO/OMPE5Xlm7DTjak9gLKHqquuN6orx122ro10JFwB9+zBvKK8i5VUXu7LCTLf5Im +gKO0lPaCoaTo+nUdWfMHamFk4saMla+ju45vVs9xzF6BYQ1t8qsCLqSX5XH8irCRIFucdFJtrhUn +WXjyCcplDn/L9Ovn3KlMd/YrFgSVrpxxpT8q2kFC5zyEEPThPYxr4iuRR1VPuFa+Rd4iUU1OKNlf +GUEGjw5NBuBwQCMBauTLE5tzrE0USJIt/m2n+IdreXXhvhCxqohAWVTXz8TQm0SzOGlkjIHRI36q +OTw7D59Ke4LKa2/KIj4x0LDQKhySio/YGZxH5D4MucLNvkEM+KRHBdvBFzA4OmnczcNpI/2aDwLO +EGrOyvi5KaM2iYauC8BPY7kGWUleDsFpswrzd34unYyzJ5jSmY0lpx+Gs6ZUcDj8fV3oT4MM0ZPl +EuRU2j7yrTrePjxF8CgPBrnh25d7mUWe3f6VWQQvdT/TromZhqwUtKiE+shdOxtYk8EXlFXIC+OC +eYSf8wCENO7cMdWP8vpPlkwGqnj73mSiI80fPsWMvDdUDrtaclXvyFu1cvh43zcgTFeRc5JzrBh3 +Q4IgaezprClG5QtO+DdziZaKHG29777YtvTKwP1H8K4LWCDFyB02rpeNUIMmJCn3nTsPBQIDAQAB +o2MwYTAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBRvjmKLk0Ow +4UD2p8P98Q+4DxU4pTAdBgNVHQ4EFgQUb45ii5NDsOFA9qfD/fEPuA8VOKUwDQYJKoZIhvcNAQEL +BQADggIBAKwsKUF9+lz1GpUYvyypiqkkVHX1uECry6gkUSsYP2OprphWKwVDIqO310aewCoSPY6W +lkDfDDOLazeROpW7OSltwAJsipQLBwJNGD77+3v1dj2b9l4wBlgzHqp41eZUBDqyggmNzhYzWUUo +8aWjlw5DI/0LIICQ/+Mmz7hkkeUFjxOgdg3XNwwQiJb0Pr6VvfHDffCjw3lHC1ySFWPtUnWK50Zp +y1FVCypM9fJkT6lc/2cyjlUtMoIcgC9qkfjLvH4YoiaoLqNTKIftV+Vlek4ASltOU8liNr3Cjlvr +zG4ngRhZi0Rjn9UMZfQpZX+RLOV/fuiJz48gy20HQhFRJjKKLjpHE7iNvUcNCfAWpO2Whi4Z2L6M +OuhFLhG6rlrnub+xzI/goP+4s9GFe3lmozm1O2bYQL7Pt2eLSMkZJVX8vY3PXtpOpvJpzv1/THfQ +wUY1mFwjmwJFQ5Ra3bxHrSL+ul4vkSkphnsh3m5kt8sNjzdbowhq6/TdAo9QAwKxuDdollDruF/U +KIqlIgyKhPBZLtU30WHlQnNYKoH3dtvi4k0NX/a3vgW0rk4N3hY9A4GzJl5LuEsAz/+MF7psYC0n +hzck5npgL7XTgwSqT0N1osGDsieYK7EOgLrAhV5Cud+xYJHT6xh+cHiudoO+cVrQkOPKwRYlZ0rw +tnu64ZzZ +-----END CERTIFICATE----- + +OISTE Server Root ECC G1 +======================== +-----BEGIN CERTIFICATE----- +MIICNTCCAbqgAwIBAgIQI/nD1jWvjyhLH/BU6n6XnTAKBggqhkjOPQQDAzBLMQswCQYDVQQGEwJD +SDEZMBcGA1UECgwQT0lTVEUgRm91bmRhdGlvbjEhMB8GA1UEAwwYT0lTVEUgU2VydmVyIFJvb3Qg +RUNDIEcxMB4XDTIzMDUzMTE0NDIyOFoXDTQ4MDUyNDE0NDIyN1owSzELMAkGA1UEBhMCQ0gxGTAX +BgNVBAoMEE9JU1RFIEZvdW5kYXRpb24xITAfBgNVBAMMGE9JU1RFIFNlcnZlciBSb290IEVDQyBH +MTB2MBAGByqGSM49AgEGBSuBBAAiA2IABBcv+hK8rBjzCvRE1nZCnrPoH7d5qVi2+GXROiFPqOuj +vqQycvO2Ackr/XeFblPdreqqLiWStukhEaivtUwL85Zgmjvn6hp4LrQ95SjeHIC6XG4N2xml4z+c +KrhAS93mT6NjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBQ3TYhlz/w9itWj8UnATgwQ +b0K0nDAdBgNVHQ4EFgQUN02IZc/8PYrVo/FJwE4MEG9CtJwwDgYDVR0PAQH/BAQDAgGGMAoGCCqG +SM49BAMDA2kAMGYCMQCpKjAd0MKfkFFRQD6VVCHNFmb3U2wIFjnQEnx/Yxvf4zgAOdktUyBFCxxg +ZzFDJe0CMQCSia7pXGKDYmH5LVerVrkR3SW+ak5KGoJr3M/TvEqzPNcum9v4KGm8ay3sMaE641c= +-----END CERTIFICATE----- + + OISTE Server Root RSA G1 +========================= +-----BEGIN CERTIFICATE----- +MIIFgzCCA2ugAwIBAgIQVaXZZ5Qoxu0M+ifdWwFNGDANBgkqhkiG9w0BAQwFADBLMQswCQYDVQQG +EwJDSDEZMBcGA1UECgwQT0lTVEUgRm91bmRhdGlvbjEhMB8GA1UEAwwYT0lTVEUgU2VydmVyIFJv +b3QgUlNBIEcxMB4XDTIzMDUzMTE0MzcxNloXDTQ4MDUyNDE0MzcxNVowSzELMAkGA1UEBhMCQ0gx +GTAXBgNVBAoMEE9JU1RFIEZvdW5kYXRpb24xITAfBgNVBAMMGE9JU1RFIFNlcnZlciBSb290IFJT +QSBHMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKqu9KuCz/vlNwvn1ZatkOhLKdxV +YOPMvLO8LZK55KN68YG0nnJyQ98/qwsmtO57Gmn7KNByXEptaZnwYx4M0rH/1ow00O7brEi56rAU +jtgHqSSY3ekJvqgiG1k50SeH3BzN+Puz6+mTeO0Pzjd8JnduodgsIUzkik/HEzxux9UTl7Ko2yRp +g1bTacuCErudG/L4NPKYKyqOBGf244ehHa1uzjZ0Dl4zO8vbUZeUapU8zhhabkvG/AePLhq5Svdk +NCncpo1Q4Y2LS+VIG24ugBA/5J8bZT8RtOpXaZ+0AOuFJJkk9SGdl6r7NH8CaxWQrbueWhl/pIzY ++m0o/DjH40ytas7ZTpOSjswMZ78LS5bOZmdTaMsXEY5Z96ycG7mOaES3GK/m5Q9l3JUJsJMStR8+ +lKXHiHUhsd4JJCpM4rzsTGdHwimIuQq6+cF0zowYJmXa92/GjHtoXAvuY8BeS/FOzJ8vD+HomnqT +8eDI278n5mUpezbgMxVz8p1rhAhoKzYHKyfMeNhqhw5HdPSqoBNdZH702xSu+zrkL8Fl47l6QGzw +Brd7KJvX4V84c5Ss2XCTLdyEr0YconosP4EmQufU2MVshGYRi3drVByjtdgQ8K4p92cIiBdcuJd5 +z+orKu5YM+Vt6SmqZQENghPsJQtdLEByFSnTkCz3GkPVavBpAgMBAAGjYzBhMA8GA1UdEwEB/wQF +MAMBAf8wHwYDVR0jBBgwFoAU8snBDw1jALvsRQ5KH7WxszbNDo0wHQYDVR0OBBYEFPLJwQ8NYwC7 +7EUOSh+1sbM2zQ6NMA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQwFAAOCAgEANGd5sjrG5T33 +I3K5Ce+SrScfoE4KsvXaFwyihdJ+klH9FWXXXGtkFu6KRcoMQzZENdl//nk6HOjG5D1rd9QhEOP2 +8yBOqb6J8xycqd+8MDoX0TJD0KqKchxRKEzdNsjkLWd9kYccnbz8qyiWXmFcuCIzGEgWUOrKL+ml +Sdx/PKQZvDatkuK59EvV6wit53j+F8Bdh3foZ3dPAGav9LEDOr4SfEE15fSmG0eLy3n31r8Xbk5l +8PjaV8GUgeV6Vg27Rn9vkf195hfkgSe7BYhW3SCl95gtkRlpMV+bMPKZrXJAlszYd2abtNUOshD+ +FKrDgHGdPY3ofRRsYWSGRqbXVMW215AWRqWFyp464+YTFrYVI8ypKVL9AMb2kI5Wj4kI3Zaq5tNq +qYY19tVFeEJKRvwDyF7YZvZFZSS0vod7VSCd9521Kvy5YhnLbDuv0204bKt7ph6N/Ome/msVuduC +msuY33OhkKCgxeDoAaijFJzIwZqsFVAzje18KotzlUBDJvyBpCpfOZC3J8tRd/iWkx7P8nd9H0aT +olkelUTFLXVksNb54Dxp6gS1HAviRkRNQzuXSXERvSS2wq1yVAb+axj5d9spLFKebXd7Yv0PTY6Y +MjAwcRLWJTXjn/hvnLXrahut6hDTlhZyBiElxky8j3C7DOReIoMt0r7+hVu05L0= +-----END CERTIFICATE----- diff --git a/stripe/entitlements/_active_entitlement.py b/stripe/entitlements/_active_entitlement.py index 9e95b282d..b9b6c4ead 100644 --- a/stripe/entitlements/_active_entitlement.py +++ b/stripe/entitlements/_active_entitlement.py @@ -26,7 +26,7 @@ class ActiveEntitlement(ListableAPIResource["ActiveEntitlement"]): ) feature: ExpandableField["Feature"] """ - The [Feature](https://stripe.com/docs/api/entitlements/feature) that the customer is entitled to. + The [Feature](https://docs.stripe.com/api/entitlements/feature) that the customer is entitled to. """ id: str """ diff --git a/stripe/events/__init__.py b/stripe/events/__init__.py index 304496a6b..97b92f368 100644 --- a/stripe/events/__init__.py +++ b/stripe/events/__init__.py @@ -193,6 +193,10 @@ V2MoneyManagementOutboundTransferUpdatedEvent as V2MoneyManagementOutboundTransferUpdatedEvent, V2MoneyManagementOutboundTransferUpdatedEventNotification as V2MoneyManagementOutboundTransferUpdatedEventNotification, ) + from stripe.events._v2_money_management_payout_method_created_event import ( + V2MoneyManagementPayoutMethodCreatedEvent as V2MoneyManagementPayoutMethodCreatedEvent, + V2MoneyManagementPayoutMethodCreatedEventNotification as V2MoneyManagementPayoutMethodCreatedEventNotification, + ) from stripe.events._v2_money_management_payout_method_updated_event import ( V2MoneyManagementPayoutMethodUpdatedEvent as V2MoneyManagementPayoutMethodUpdatedEvent, V2MoneyManagementPayoutMethodUpdatedEventNotification as V2MoneyManagementPayoutMethodUpdatedEventNotification, @@ -605,6 +609,14 @@ "stripe.events._v2_money_management_outbound_transfer_updated_event", False, ), + "V2MoneyManagementPayoutMethodCreatedEvent": ( + "stripe.events._v2_money_management_payout_method_created_event", + False, + ), + "V2MoneyManagementPayoutMethodCreatedEventNotification": ( + "stripe.events._v2_money_management_payout_method_created_event", + False, + ), "V2MoneyManagementPayoutMethodUpdatedEvent": ( "stripe.events._v2_money_management_payout_method_updated_event", False, diff --git a/stripe/events/_event_classes.py b/stripe/events/_event_classes.py index a8728a4da..481aed7bb 100644 --- a/stripe/events/_event_classes.py +++ b/stripe/events/_event_classes.py @@ -142,6 +142,9 @@ from stripe.events._v2_money_management_outbound_transfer_updated_event import ( V2MoneyManagementOutboundTransferUpdatedEventNotification, ) + from stripe.events._v2_money_management_payout_method_created_event import ( + V2MoneyManagementPayoutMethodCreatedEventNotification, + ) from stripe.events._v2_money_management_payout_method_updated_event import ( V2MoneyManagementPayoutMethodUpdatedEventNotification, ) @@ -361,6 +364,10 @@ "stripe.events._v2_money_management_outbound_transfer_updated_event", "V2MoneyManagementOutboundTransferUpdatedEvent", ), + "v2.money_management.payout_method.created": ( + "stripe.events._v2_money_management_payout_method_created_event", + "V2MoneyManagementPayoutMethodCreatedEvent", + ), "v2.money_management.payout_method.updated": ( "stripe.events._v2_money_management_payout_method_updated_event", "V2MoneyManagementPayoutMethodUpdatedEvent", @@ -604,6 +611,10 @@ def get_v2_event_class(type_: str): "stripe.events._v2_money_management_outbound_transfer_updated_event", "V2MoneyManagementOutboundTransferUpdatedEventNotification", ), + "v2.money_management.payout_method.created": ( + "stripe.events._v2_money_management_payout_method_created_event", + "V2MoneyManagementPayoutMethodCreatedEventNotification", + ), "v2.money_management.payout_method.updated": ( "stripe.events._v2_money_management_payout_method_updated_event", "V2MoneyManagementPayoutMethodUpdatedEventNotification", @@ -712,6 +723,7 @@ def get_v2_event_notification_class(type_: str): "V2MoneyManagementOutboundTransferPostedEventNotification", "V2MoneyManagementOutboundTransferReturnedEventNotification", "V2MoneyManagementOutboundTransferUpdatedEventNotification", + "V2MoneyManagementPayoutMethodCreatedEventNotification", "V2MoneyManagementPayoutMethodUpdatedEventNotification", "V2MoneyManagementReceivedCreditAvailableEventNotification", "V2MoneyManagementReceivedCreditFailedEventNotification", diff --git a/stripe/events/_v2_money_management_payout_method_created_event.py b/stripe/events/_v2_money_management_payout_method_created_event.py new file mode 100644 index 000000000..3e5123c10 --- /dev/null +++ b/stripe/events/_v2_money_management_payout_method_created_event.py @@ -0,0 +1,110 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._stripe_object import StripeObject +from stripe._util import get_api_mode +from stripe.v2.core._event import Event, EventNotification, RelatedObject +from typing import Any, Dict, cast +from typing_extensions import Literal, TYPE_CHECKING, override + +if TYPE_CHECKING: + from stripe._stripe_client import StripeClient + from stripe.v2.money_management._payout_method import PayoutMethod + + +class V2MoneyManagementPayoutMethodCreatedEventNotification(EventNotification): + LOOKUP_TYPE = "v2.money_management.payout_method.created" + type: Literal["v2.money_management.payout_method.created"] + related_object: RelatedObject + + def __init__( + self, parsed_body: Dict[str, Any], client: "StripeClient" + ) -> None: + super().__init__( + parsed_body, + client, + ) + self.related_object = RelatedObject(parsed_body["related_object"]) + + @override + def fetch_event(self) -> "V2MoneyManagementPayoutMethodCreatedEvent": + return cast( + "V2MoneyManagementPayoutMethodCreatedEvent", + super().fetch_event(), + ) + + def fetch_related_object(self) -> "PayoutMethod": + response = self._client.raw_request( + "get", + self.related_object.url, + stripe_context=self.context, + usage=["fetch_related_object"], + ) + return cast( + "PayoutMethod", + self._client.deserialize( + response, + api_mode=get_api_mode(self.related_object.url), + ), + ) + + @override + async def fetch_event_async( + self, + ) -> "V2MoneyManagementPayoutMethodCreatedEvent": + return cast( + "V2MoneyManagementPayoutMethodCreatedEvent", + await super().fetch_event_async(), + ) + + async def fetch_related_object_async(self) -> "PayoutMethod": + response = await self._client.raw_request_async( + "get", + self.related_object.url, + stripe_context=self.context, + usage=["fetch_related_object"], + ) + return cast( + "PayoutMethod", + self._client.deserialize( + response, + api_mode=get_api_mode(self.related_object.url), + ), + ) + + +class V2MoneyManagementPayoutMethodCreatedEvent(Event): + LOOKUP_TYPE = "v2.money_management.payout_method.created" + type: Literal["v2.money_management.payout_method.created"] + + class RelatedObject(StripeObject): + id: str + """ + Unique identifier for the object relevant to the event. + """ + type: str + """ + Type of the object relevant to the event. + """ + url: str + """ + URL to retrieve the resource. + """ + + related_object: RelatedObject + """ + Object containing the reference to API resource relevant to the event + """ + + def fetch_related_object(self) -> "PayoutMethod": + """ + Retrieves the related object from the API. Makes an API request on every call. + """ + return cast( + "PayoutMethod", + self._requestor.request( + "get", + self.related_object.url, + base_address="api", + options={"stripe_context": self.context}, + ), + ) diff --git a/stripe/financial_connections/_account.py b/stripe/financial_connections/_account.py index d8f88e603..d94098d80 100644 --- a/stripe/financial_connections/_account.py +++ b/stripe/financial_connections/_account.py @@ -59,11 +59,11 @@ class Account(ListableAPIResource["Account"]): class AccountHolder(StripeObject): account: Optional[ExpandableField["AccountResource"]] """ - The ID of the Stripe account this account belongs to. Should only be present if `account_holder.type` is `account`. + The ID of the Stripe account that this account belongs to. Only available when `account_holder.type` is `account`. """ customer: Optional[ExpandableField["Customer"]] """ - ID of the Stripe customer this account belongs to. Present if and only if `account_holder.type` is `customer`. + The ID for an Account representing a customer that this account belongs to. Only available when `account_holder.type` is `customer`. """ customer_account: Optional[str] type: Literal["account", "customer"] @@ -298,7 +298,7 @@ class TransactionRefresh(StripeObject): """ supported_payment_method_types: List[Literal["link", "us_bank_account"]] """ - The [PaymentMethod type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account. + The [PaymentMethod type](https://docs.stripe.com/api/payment_methods/object#payment_method_object-type)(s) that can be created from this account. """ transaction_refresh: Optional[TransactionRefresh] """ diff --git a/stripe/financial_connections/_session.py b/stripe/financial_connections/_session.py index 2dd6bc7d6..e95b7f07c 100644 --- a/stripe/financial_connections/_session.py +++ b/stripe/financial_connections/_session.py @@ -33,11 +33,11 @@ class Session(CreateableAPIResource["Session"]): class AccountHolder(StripeObject): account: Optional[ExpandableField["AccountResource"]] """ - The ID of the Stripe account this account belongs to. Should only be present if `account_holder.type` is `account`. + The ID of the Stripe account that this account belongs to. Only available when `account_holder.type` is `account`. """ customer: Optional[ExpandableField["Customer"]] """ - ID of the Stripe customer this account belongs to. Present if and only if `account_holder.type` is `customer`. + The ID for an Account representing a customer that this account belongs to. Only available when `account_holder.type` is `customer`. """ customer_account: Optional[str] type: Literal["account", "customer"] diff --git a/stripe/forwarding/_request.py b/stripe/forwarding/_request.py index cd1bd7016..2c6f23971 100644 --- a/stripe/forwarding/_request.py +++ b/stripe/forwarding/_request.py @@ -115,7 +115,7 @@ class Header(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["forwarding.request"] """ diff --git a/stripe/identity/_verification_report.py b/stripe/identity/_verification_report.py index 335851502..df53ce6fb 100644 --- a/stripe/identity/_verification_report.py +++ b/stripe/identity/_verification_report.py @@ -23,11 +23,11 @@ class VerificationReport(ListableAPIResource["VerificationReport"]): appropriate sub-resource: `document`, `id_number`, `selfie`. Each VerificationReport contains a copy of any data collected by the user as well as - reference IDs which can be used to access collected images through the [FileUpload](https://stripe.com/docs/api/files) + reference IDs which can be used to access collected images through the [FileUpload](https://docs.stripe.com/api/files) API. To configure and create VerificationReports, use the - [VerificationSession](https://stripe.com/docs/api/identity/verification_sessions) API. + [VerificationSession](https://docs.stripe.com/api/identity/verification_sessions) API. - Related guide: [Accessing verification results](https://stripe.com/docs/identity/verification-sessions#results). + Related guide: [Accessing verification results](https://docs.stripe.com/identity/verification-sessions#results). """ OBJECT_NAME: ClassVar[Literal["identity.verification_report"]] = ( @@ -58,7 +58,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class Dob(StripeObject): @@ -137,7 +137,7 @@ class IssuedDate(StripeObject): """ files: Optional[List[str]] """ - Array of [File](https://stripe.com/docs/api/files) ids containing images for this document. + Array of [File](https://docs.stripe.com/api/files) ids containing images for this document. """ first_name: Optional[str] """ @@ -287,7 +287,7 @@ class Document(StripeObject): """ require_id_number: Optional[bool] """ - Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. + Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. """ require_live_capture: Optional[bool] """ @@ -295,7 +295,7 @@ class Document(StripeObject): """ require_matching_selfie: Optional[bool] """ - Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie). + Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie). """ class IdNumber(StripeObject): @@ -354,7 +354,7 @@ class Error(StripeObject): document: Optional[str] """ - ID of the [File](https://stripe.com/docs/api/files) holding the image of the identity document used in this check. + ID of the [File](https://docs.stripe.com/api/files) holding the image of the identity document used in this check. """ error: Optional[Error] """ @@ -362,7 +362,7 @@ class Error(StripeObject): """ selfie: Optional[str] """ - ID of the [File](https://stripe.com/docs/api/files) holding the image of the selfie used in this check. + ID of the [File](https://docs.stripe.com/api/files) holding the image of the selfie used in this check. """ status: Literal["unverified", "verified"] """ diff --git a/stripe/identity/_verification_session.py b/stripe/identity/_verification_session.py index 02e248f9b..374f3d5bd 100644 --- a/stripe/identity/_verification_session.py +++ b/stripe/identity/_verification_session.py @@ -48,7 +48,7 @@ class VerificationSession( the verification flow. The VerificationSession contains the user's verified data after verification checks are complete. - Related guide: [The Verification Sessions API](https://stripe.com/docs/identity/verification-sessions) + Related guide: [The Verification Sessions API](https://docs.stripe.com/identity/verification-sessions) """ OBJECT_NAME: ClassVar[Literal["identity.verification_session"]] = ( @@ -97,7 +97,7 @@ class Document(StripeObject): """ require_id_number: Optional[bool] """ - Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. + Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. """ require_live_capture: Optional[bool] """ @@ -105,7 +105,7 @@ class Document(StripeObject): """ require_matching_selfie: Optional[bool] """ - Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie). + Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie). """ class Email(StripeObject): @@ -196,7 +196,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class Dob(StripeObject): @@ -265,7 +265,7 @@ class Dob(StripeObject): """ client_secret: Optional[str] """ - The short-lived client secret used by Stripe.js to [show a verification modal](https://stripe.com/docs/js/identity/modal) inside your app. This client secret expires after 24 hours and can only be used once. Don't store it, log it, embed it in a URL, or expose it to anyone other than the user. Make sure that you have TLS enabled on any page that includes the client secret. Refer to our docs on [passing the client secret to the frontend](https://stripe.com/docs/identity/verification-sessions#client-secret) to learn more. + The short-lived client secret used by Stripe.js to [show a verification modal](https://docs.stripe.com/js/identity/modal) inside your app. This client secret expires after 24 hours and can only be used once. Don't store it, log it, embed it in a URL, or expose it to anyone other than the user. Make sure that you have TLS enabled on any page that includes the client secret. Refer to our docs on [passing the client secret to the frontend](https://docs.stripe.com/identity/verification-sessions#client-secret) to learn more. """ created: int """ @@ -281,7 +281,7 @@ class Dob(StripeObject): """ last_verification_report: Optional[ExpandableField["VerificationReport"]] """ - ID of the most recent VerificationReport. [Learn more about accessing detailed verification results.](https://stripe.com/docs/identity/verification-sessions#results) + ID of the most recent VerificationReport. [Learn more about accessing detailed verification results.](https://docs.stripe.com/identity/verification-sessions#results) """ livemode: bool """ @@ -289,7 +289,7 @@ class Dob(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["identity.verification_session"] """ @@ -313,20 +313,20 @@ class Dob(StripeObject): """ related_customer_account: Optional[str] """ - Token referencing a Customer Account resource. + The ID of the Account representing a customer. """ related_person: Optional[RelatedPerson] status: Literal["canceled", "processing", "requires_input", "verified"] """ - Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work). + Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://docs.stripe.com/identity/how-sessions-work). """ type: Literal["document", "id_number", "verification_flow"] """ - The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. + The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed. """ url: Optional[str] """ - The short-lived URL that you use to redirect a user to Stripe to submit their identity information. This URL expires after 48 hours and can only be used once. Don't store it, log it, send it in emails or expose it to anyone other than the user. Refer to our docs on [verifying identity documents](https://stripe.com/docs/identity/verify-identity-documents?platform=web&type=redirect) to learn how to redirect users to Stripe. + The short-lived URL that you use to redirect a user to Stripe to submit their identity information. This URL expires after 48 hours and can only be used once. Don't store it, log it, send it in emails or expose it to anyone other than the user. Refer to our docs on [verifying identity documents](https://docs.stripe.com/identity/verify-identity-documents?platform=web&type=redirect) to learn how to redirect users to Stripe. """ verification_flow: Optional[str] """ diff --git a/stripe/issuing/_authorization.py b/stripe/issuing/_authorization.py index 60e775d02..55dbb593d 100644 --- a/stripe/issuing/_authorization.py +++ b/stripe/issuing/_authorization.py @@ -59,11 +59,11 @@ class Authorization( UpdateableAPIResource["Authorization"], ): """ - When an [issued card](https://stripe.com/docs/issuing) is used to make a purchase, an Issuing `Authorization` - object is created. [Authorizations](https://stripe.com/docs/issuing/purchases/authorizations) must be approved for the + When an [issued card](https://docs.stripe.com/issuing) is used to make a purchase, an Issuing `Authorization` + object is created. [Authorizations](https://docs.stripe.com/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://docs.stripe.com/issuing/purchases/authorizations) """ OBJECT_NAME: ClassVar[Literal["issuing.authorization"]] = ( @@ -239,7 +239,7 @@ class Fuel(StripeObject): class MerchantData(StripeObject): category: str """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ category_code: str """ @@ -309,11 +309,11 @@ class AmountDetails(StripeObject): amount: int """ - The additional amount Stripe will hold if the authorization is approved, in the card's [currency](https://stripe.com/docs/api#issuing_authorization_object-pending-request-currency) and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The additional amount Stripe will hold if the authorization is approved, in the card's [currency](https://docs.stripe.com/api#issuing_authorization_object-pending-request-currency) and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ amount_details: Optional[AmountDetails] """ - Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ currency: str """ @@ -321,11 +321,11 @@ class AmountDetails(StripeObject): """ is_amount_controllable: bool """ - If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. + If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. """ merchant_amount: int """ - The amount the merchant is requesting to be authorized in the `merchant_currency`. The amount is in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount the merchant is requesting to be authorized in the `merchant_currency`. The amount is in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ merchant_currency: str """ @@ -350,11 +350,11 @@ class AmountDetails(StripeObject): amount: int """ - The `pending_request.amount` at the time of the request, presented in your card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Stripe held this amount from your account to fund the authorization if the request was approved. + The `pending_request.amount` at the time of the request, presented in your card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Stripe held this amount from your account to fund the authorization if the request was approved. """ amount_details: Optional[AmountDetails] """ - Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ approved: bool """ @@ -374,7 +374,7 @@ class AmountDetails(StripeObject): """ merchant_amount: int """ - The `pending_request.merchant_amount` at the time of the request, presented in the `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The `pending_request.merchant_amount` at the time of the request, presented in the `merchant_currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ merchant_currency: str """ @@ -422,15 +422,15 @@ class AmountDetails(StripeObject): class Treasury(StripeObject): received_credits: List[str] """ - The array of [ReceivedCredits](https://stripe.com/docs/api/treasury/received_credits) associated with this authorization + The array of [ReceivedCredits](https://docs.stripe.com/api/treasury/received_credits) associated with this authorization """ received_debits: List[str] """ - The array of [ReceivedDebits](https://stripe.com/docs/api/treasury/received_debits) associated with this authorization + The array of [ReceivedDebits](https://docs.stripe.com/api/treasury/received_debits) associated with this authorization """ transaction: Optional[str] """ - The Treasury [Transaction](https://stripe.com/docs/api/treasury/transactions) associated with this authorization + The Treasury [Transaction](https://docs.stripe.com/api/treasury/transactions) associated with this authorization """ class VerificationData(StripeObject): @@ -493,7 +493,7 @@ class ThreeDSecure(StripeObject): """ amount_details: Optional[AmountDetails] """ - Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ approved: bool """ @@ -511,7 +511,7 @@ class ThreeDSecure(StripeObject): """ card: "Card" """ - You can [create physical or virtual cards](https://stripe.com/docs/issuing) that are issued to cardholders. + You can [create physical or virtual cards](https://docs.stripe.com/issuing) that are issued to cardholders. """ cardholder: Optional[ExpandableField["Cardholder"]] """ @@ -556,7 +556,7 @@ class ThreeDSecure(StripeObject): merchant_data: MerchantData metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ network_data: Optional[NetworkData] """ @@ -580,15 +580,15 @@ class ThreeDSecure(StripeObject): """ token: Optional[ExpandableField["Token"]] """ - [Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this authorization. If a network token was not used for this authorization, this field will be null. + [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this authorization. If a network token was not used for this authorization, this field will be null. """ transactions: List["Transaction"] """ - List of [transactions](https://stripe.com/docs/api/issuing/transactions) associated with this authorization. + List of [transactions](https://docs.stripe.com/api/issuing/transactions) associated with this authorization. """ treasury: Optional[Treasury] """ - [Treasury](https://stripe.com/docs/api/treasury) details related to this authorization if it was created on a [FinancialAccount](https://stripe.com/docs/api/treasury/financial_accounts). + [Treasury](https://docs.stripe.com/api/treasury) details related to this authorization if it was created on a [FinancialAccount](https://docs.stripe.com/api/treasury/financial_accounts). """ verification_data: VerificationData verified_by_fraud_challenge: Optional[bool] diff --git a/stripe/issuing/_card.py b/stripe/issuing/_card.py index bd805f845..c45204df3 100644 --- a/stripe/issuing/_card.py +++ b/stripe/issuing/_card.py @@ -37,7 +37,7 @@ class Card( UpdateableAPIResource["Card"], ): """ - You can [create physical or virtual cards](https://stripe.com/docs/issuing) that are issued to cardholders. + You can [create physical or virtual cards](https://docs.stripe.com/issuing) that are issued to cardholders. """ OBJECT_NAME: ClassVar[Literal["issuing.card"]] = "issuing.card" @@ -83,7 +83,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class AddressValidation(StripeObject): @@ -110,7 +110,7 @@ class NormalizedAddress(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ mode: Literal[ @@ -212,7 +212,7 @@ class SpendingControls(StripeObject): class SpendingLimit(StripeObject): amount: int """ - Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ categories: Optional[ List[ @@ -516,7 +516,7 @@ class SpendingLimit(StripeObject): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", @@ -832,7 +832,7 @@ class SpendingLimit(StripeObject): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: Optional[List[str]] """ @@ -1140,7 +1140,7 @@ class SpendingLimit(StripeObject): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: Optional[List[str]] """ @@ -1207,9 +1207,9 @@ class GooglePay(StripeObject): """ cardholder: "Cardholder" """ - An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards. + An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://docs.stripe.com/issuing) cards. - Related guide: [How to create a cardholder](https://stripe.com/docs/issuing/cards/virtual/issue-cards#create-cardholder) + Related guide: [How to create a cardholder](https://docs.stripe.com/issuing/cards/virtual/issue-cards#create-cardholder) """ created: int """ @@ -1221,7 +1221,7 @@ class GooglePay(StripeObject): """ cvc: Optional[str] """ - The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. + The card's CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://docs.stripe.com/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. """ exp_month: int """ @@ -1253,11 +1253,11 @@ class GooglePay(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ number: Optional[str] """ - The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://stripe.com/docs/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://stripe.com/docs/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. + The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with [the `expand` parameter](https://docs.stripe.com/api/expanding_objects). Additionally, it's only available via the ["Retrieve a card" endpoint](https://docs.stripe.com/api/issuing/cards/retrieve), not via "List all cards" or any other endpoint. """ object: Literal["issuing.card"] """ diff --git a/stripe/issuing/_cardholder.py b/stripe/issuing/_cardholder.py index 673668b82..15aecebe0 100644 --- a/stripe/issuing/_cardholder.py +++ b/stripe/issuing/_cardholder.py @@ -32,9 +32,9 @@ class Cardholder( UpdateableAPIResource["Cardholder"], ): """ - An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards. + An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://docs.stripe.com/issuing) cards. - Related guide: [How to create a cardholder](https://stripe.com/docs/issuing/cards/virtual/issue-cards#create-cardholder) + Related guide: [How to create a cardholder](https://docs.stripe.com/issuing/cards/virtual/issue-cards#create-cardholder) """ OBJECT_NAME: ClassVar[Literal["issuing.cardholder"]] = "issuing.cardholder" @@ -63,7 +63,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -115,11 +115,11 @@ class Verification(StripeObject): class Document(StripeObject): back: Optional[ExpandableField["File"]] """ - The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ front: Optional[ExpandableField["File"]] """ - The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ document: Optional[Document] @@ -189,7 +189,7 @@ class SpendingControls(StripeObject): class SpendingLimit(StripeObject): amount: int """ - Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ categories: Optional[ List[ @@ -493,7 +493,7 @@ class SpendingLimit(StripeObject): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", @@ -809,7 +809,7 @@ class SpendingLimit(StripeObject): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: Optional[List[str]] """ @@ -1117,7 +1117,7 @@ class SpendingLimit(StripeObject): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: Optional[List[str]] """ @@ -1160,7 +1160,7 @@ class SpendingLimit(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: str """ @@ -1172,17 +1172,17 @@ class SpendingLimit(StripeObject): """ phone_number: Optional[str] """ - The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure#when-is-3d-secure-applied) for more details. + The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://docs.stripe.com/issuing/3d-secure#when-is-3d-secure-applied) for more details. """ preferred_locales: Optional[List[Literal["de", "en", "es", "fr", "it"]]] """ The cardholder's preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`. - This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder. + This changes the language of the [3D Secure flow](https://docs.stripe.com/issuing/3d-secure) and one-time password messages sent to the cardholder. """ requirements: Requirements spending_controls: Optional[SpendingControls] """ - Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. + Rules that control spending across this cardholder's cards. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details. """ status: Literal["active", "blocked", "inactive"] """ @@ -1190,7 +1190,7 @@ class SpendingLimit(StripeObject): """ type: Literal["company", "individual"] """ - One of `individual` or `company`. See [Choose a cardholder type](https://stripe.com/docs/issuing/other/choose-cardholder) for more details. + One of `individual` or `company`. See [Choose a cardholder type](https://docs.stripe.com/issuing/other/choose-cardholder) for more details. """ @classmethod diff --git a/stripe/issuing/_credit_underwriting_record.py b/stripe/issuing/_credit_underwriting_record.py index 96bd7fb63..1801bfbce 100644 --- a/stripe/issuing/_credit_underwriting_record.py +++ b/stripe/issuing/_credit_underwriting_record.py @@ -34,7 +34,7 @@ class CreditUnderwritingRecord( """ Every time an applicant submits an application for a Charge Card product your platform offers, or every time your platform takes a proactive credit decision on an existing account, you must record the decision by creating a new `CreditUnderwritingRecord` object on a connected account. - [Follow the guide](https://stripe.com/docs/issuing/credit/report-credit-decisions-and-manage-aans) to learn about your requirements as a platform. + [Follow the guide](https://docs.stripe.com/issuing/credit/report-credit-decisions-and-manage-aans) to learn about your requirements as a platform. """ OBJECT_NAME: ClassVar[Literal["issuing.credit_underwriting_record"]] = ( @@ -145,7 +145,7 @@ class ApplicationRejected(StripeObject): class CreditLimitApproved(StripeObject): amount: int """ - Credit amount approved. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy). + Credit amount approved. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://docs.stripe.com/api/issuing/credit_policy). """ currency: str """ @@ -155,7 +155,7 @@ class CreditLimitApproved(StripeObject): class CreditLimitDecreased(StripeObject): amount: int """ - Credit amount approved after decrease. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy). + Credit amount approved after decrease. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://docs.stripe.com/api/issuing/credit_policy). """ currency: str """ @@ -416,7 +416,7 @@ class UnderwritingException(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["issuing.credit_underwriting_record"] """ @@ -424,7 +424,7 @@ class UnderwritingException(StripeObject): """ regulatory_reporting_file: Optional[str] """ - File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://stripe.com/docs/issuing/credit/report-required-regulatory-data-for-credit-decisions). + File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://docs.stripe.com/issuing/credit/report-required-regulatory-data-for-credit-decisions). """ underwriting_exception: Optional[UnderwritingException] """ diff --git a/stripe/issuing/_dispute.py b/stripe/issuing/_dispute.py index 2be6f914d..b9a4a9fd3 100644 --- a/stripe/issuing/_dispute.py +++ b/stripe/issuing/_dispute.py @@ -35,9 +35,9 @@ class Dispute( UpdateableAPIResource["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. + As a [card issuer](https://docs.stripe.com/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with. - Related guide: [Issuing disputes](https://stripe.com/docs/issuing/purchases/disputes) + Related guide: [Issuing disputes](https://docs.stripe.com/issuing/purchases/disputes) """ OBJECT_NAME: ClassVar[Literal["issuing.dispute"]] = "issuing.dispute" @@ -254,16 +254,16 @@ class ServiceNotAsDescribed(StripeObject): class Treasury(StripeObject): debit_reversal: Optional[str] """ - The Treasury [DebitReversal](https://stripe.com/docs/api/treasury/debit_reversals) representing this Issuing dispute + The Treasury [DebitReversal](https://docs.stripe.com/api/treasury/debit_reversals) representing this Issuing dispute """ received_debit: str """ - The Treasury [ReceivedDebit](https://stripe.com/docs/api/treasury/received_debits) that is being disputed. + The Treasury [ReceivedDebit](https://docs.stripe.com/api/treasury/received_debits) that is being disputed. """ amount: int """ - Disputed amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation). + Disputed amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation). """ balance_transactions: Optional[List["BalanceTransaction"]] """ @@ -315,7 +315,7 @@ class Treasury(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["issuing.dispute"] """ @@ -331,7 +331,7 @@ class Treasury(StripeObject): """ treasury: Optional[Treasury] """ - [Treasury](https://stripe.com/docs/api/treasury) details related to this dispute if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts + [Treasury](https://docs.stripe.com/api/treasury) details related to this dispute if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts """ @classmethod diff --git a/stripe/issuing/_fraud_liability_debit.py b/stripe/issuing/_fraud_liability_debit.py index 9efb04448..8e9f8387a 100644 --- a/stripe/issuing/_fraud_liability_debit.py +++ b/stripe/issuing/_fraud_liability_debit.py @@ -30,7 +30,7 @@ class FraudLiabilityDebit(ListableAPIResource["FraudLiabilityDebit"]): """ balance_transaction: Optional[ExpandableField["BalanceTransaction"]] """ - ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this debit. + ID of the [balance transaction](https://docs.stripe.com/api/balance_transactions) associated with this debit. """ created: int """ diff --git a/stripe/issuing/_personalization_design.py b/stripe/issuing/_personalization_design.py index fd65ab0ac..fcdcc5e96 100644 --- a/stripe/issuing/_personalization_design.py +++ b/stripe/issuing/_personalization_design.py @@ -139,7 +139,7 @@ class RejectionReasons(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: Optional[str] """ diff --git a/stripe/issuing/_settlement.py b/stripe/issuing/_settlement.py index 5818a9a89..f04f49639 100644 --- a/stripe/issuing/_settlement.py +++ b/stripe/issuing/_settlement.py @@ -7,7 +7,7 @@ class Settlement(StripeObject): """ - When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object. + When a non-stripe BIN is used, any use of an [issued card](https://docs.stripe.com/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object. """ OBJECT_NAME: ClassVar[Literal["issuing.settlement"]] = "issuing.settlement" @@ -41,7 +41,7 @@ class Settlement(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ net_total_amount: int """ diff --git a/stripe/issuing/_token.py b/stripe/issuing/_token.py index 85434e3ea..1a76ce121 100644 --- a/stripe/issuing/_token.py +++ b/stripe/issuing/_token.py @@ -20,7 +20,7 @@ class Token(ListableAPIResource["Token"], UpdateableAPIResource["Token"]): """ - An issuing token object is created when an issued card is added to a digital wallet. As a [card issuer](https://stripe.com/docs/issuing), you can [view and manage these tokens](https://stripe.com/docs/issuing/controls/token-management) through Stripe. + An issuing token object is created when an issued card is added to a digital wallet. As a [card issuer](https://docs.stripe.com/issuing), you can [view and manage these tokens](https://docs.stripe.com/issuing/controls/token-management) through Stripe. """ OBJECT_NAME: ClassVar[Literal["issuing.token"]] = "issuing.token" diff --git a/stripe/issuing/_transaction.py b/stripe/issuing/_transaction.py index fa97fd598..429f7e24b 100644 --- a/stripe/issuing/_transaction.py +++ b/stripe/issuing/_transaction.py @@ -43,11 +43,11 @@ class Transaction( UpdateableAPIResource["Transaction"], ): """ - Any use of an [issued card](https://stripe.com/docs/issuing) that results in funds entering or leaving + Any use of an [issued card](https://docs.stripe.com/issuing) that results in funds entering or leaving 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://docs.stripe.com/issuing/purchases/transactions) """ OBJECT_NAME: ClassVar[Literal["issuing.transaction"]] = ( @@ -67,7 +67,7 @@ class AmountDetails(StripeObject): class MerchantData(StripeObject): category: str """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ category_code: str """ @@ -344,20 +344,20 @@ class Receipt(StripeObject): class Treasury(StripeObject): received_credit: Optional[str] """ - The Treasury [ReceivedCredit](https://stripe.com/docs/api/treasury/received_credits) representing this Issuing transaction if it is a refund + The Treasury [ReceivedCredit](https://docs.stripe.com/api/treasury/received_credits) representing this Issuing transaction if it is a refund """ received_debit: Optional[str] """ - The Treasury [ReceivedDebit](https://stripe.com/docs/api/treasury/received_debits) representing this Issuing transaction if it is a capture + The Treasury [ReceivedDebit](https://docs.stripe.com/api/treasury/received_debits) representing this Issuing transaction if it is a capture """ amount: int """ - The transaction amount, which will be reflected in your balance. This amount is in your currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The transaction amount, which will be reflected in your balance. This amount is in your currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ amount_details: Optional[AmountDetails] """ - Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ authorization: Optional[ExpandableField["Authorization"]] """ @@ -365,7 +365,7 @@ class Treasury(StripeObject): """ balance_transaction: Optional[ExpandableField["BalanceTransaction"]] """ - ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this transaction. + ID of the [balance transaction](https://docs.stripe.com/api/balance_transactions) associated with this transaction. """ card: ExpandableField["Card"] """ @@ -397,7 +397,7 @@ class Treasury(StripeObject): """ merchant_amount: int """ - The amount that the merchant will receive, denominated in `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). It will be different from `amount` if the merchant is taking payment in a different currency. + The amount that the merchant will receive, denominated in `merchant_currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). It will be different from `amount` if the merchant is taking payment in a different currency. """ merchant_currency: str """ @@ -406,7 +406,7 @@ class Treasury(StripeObject): merchant_data: MerchantData metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ network_data: Optional[NetworkData] """ @@ -422,15 +422,15 @@ class Treasury(StripeObject): """ settlement: Optional[ExpandableField["Settlement"]] """ - The ID of the [settlement](https://stripe.com/docs/api/issuing/settlements) to which this transaction belongs. + The ID of the [settlement](https://docs.stripe.com/api/issuing/settlements) to which this transaction belongs. """ token: Optional[ExpandableField["Token"]] """ - [Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null. + [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null. """ treasury: Optional[Treasury] """ - [Treasury](https://stripe.com/docs/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts + [Treasury](https://docs.stripe.com/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts """ type: Literal["capture", "refund"] """ diff --git a/stripe/params/__init__.py b/stripe/params/__init__.py index f72aae913..5fbab3865 100644 --- a/stripe/params/__init__.py +++ b/stripe/params/__init__.py @@ -19,6 +19,7 @@ privacy as privacy, radar as radar, reporting as reporting, + reserve as reserve, sigma as sigma, tax as tax, terminal as terminal, @@ -152,7 +153,9 @@ AccountCreateParamsDocumentsCompanyTaxIdVerification as AccountCreateParamsDocumentsCompanyTaxIdVerification, AccountCreateParamsDocumentsProofOfAddress as AccountCreateParamsDocumentsProofOfAddress, AccountCreateParamsDocumentsProofOfRegistration as AccountCreateParamsDocumentsProofOfRegistration, + AccountCreateParamsDocumentsProofOfRegistrationSigner as AccountCreateParamsDocumentsProofOfRegistrationSigner, AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnership as AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnership, + AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner as AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner, AccountCreateParamsGroups as AccountCreateParamsGroups, AccountCreateParamsIndividual as AccountCreateParamsIndividual, AccountCreateParamsIndividualAddress as AccountCreateParamsIndividualAddress, @@ -543,7 +546,9 @@ AccountUpdateParamsDocumentsCompanyTaxIdVerification as AccountUpdateParamsDocumentsCompanyTaxIdVerification, AccountUpdateParamsDocumentsProofOfAddress as AccountUpdateParamsDocumentsProofOfAddress, AccountUpdateParamsDocumentsProofOfRegistration as AccountUpdateParamsDocumentsProofOfRegistration, + AccountUpdateParamsDocumentsProofOfRegistrationSigner as AccountUpdateParamsDocumentsProofOfRegistrationSigner, AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnership as AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnership, + AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner as AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner, AccountUpdateParamsGroups as AccountUpdateParamsGroups, AccountUpdateParamsIndividual as AccountUpdateParamsIndividual, AccountUpdateParamsIndividualAddress as AccountUpdateParamsIndividualAddress, @@ -1418,6 +1423,8 @@ InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer, InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsKonbini as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsKonbini, + InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPayto as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPayto, + InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions, InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPix as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPix, InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsSepaDebit as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsSepaDebit, InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsUpi as InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsUpi, @@ -1632,6 +1639,8 @@ InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer, InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsKonbini as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsKonbini, + InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPayto as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPayto, + InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions, InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPix as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPix, InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsSepaDebit as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsSepaDebit, InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsUpi as InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsUpi, @@ -1724,6 +1733,8 @@ InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer, InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsKonbini as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsKonbini, + InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPayto as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPayto, + InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions, InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPix as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPix, InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsSepaDebit as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsSepaDebit, InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsUpi as InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsUpi, @@ -4982,6 +4993,8 @@ SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer, SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsKonbini as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsKonbini, + SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPayto as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPayto, + SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions, SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPix as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPix, SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPixMandateOptions as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPixMandateOptions, SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsSepaDebit as SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsSepaDebit, @@ -5091,6 +5104,8 @@ SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer, SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsKonbini as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsKonbini, + SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPayto as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPayto, + SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions, SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPix as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPix, SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPixMandateOptions as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPixMandateOptions, SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsSepaDebit as SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsSepaDebit, @@ -5337,6 +5352,8 @@ SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsCustomerBalanceBankTransferEuBankTransfer, SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsIdBankTransfer, SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsKonbini as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsKonbini, + SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPayto as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPayto, + SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions, SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPix as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPix, SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPixMandateOptions as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPixMandateOptions, SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsSepaDebit as SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsSepaDebit, @@ -5533,6 +5550,7 @@ "privacy": ("stripe.params.privacy", True), "radar": ("stripe.params.radar", True), "reporting": ("stripe.params.reporting", True), + "reserve": ("stripe.params.reserve", True), "sigma": ("stripe.params.sigma", True), "tax": ("stripe.params.tax", True), "terminal": ("stripe.params.terminal", True), @@ -5996,10 +6014,18 @@ "stripe.params._account_create_params", False, ), + "AccountCreateParamsDocumentsProofOfRegistrationSigner": ( + "stripe.params._account_create_params", + False, + ), "AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnership": ( "stripe.params._account_create_params", False, ), + "AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner": ( + "stripe.params._account_create_params", + False, + ), "AccountCreateParamsGroups": ( "stripe.params._account_create_params", False, @@ -7248,10 +7274,18 @@ "stripe.params._account_update_params", False, ), + "AccountUpdateParamsDocumentsProofOfRegistrationSigner": ( + "stripe.params._account_update_params", + False, + ), "AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnership": ( "stripe.params._account_update_params", False, ), + "AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner": ( + "stripe.params._account_update_params", + False, + ), "AccountUpdateParamsGroups": ( "stripe.params._account_update_params", False, @@ -9541,6 +9575,14 @@ "stripe.params._invoice_create_params", False, ), + "InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPayto": ( + "stripe.params._invoice_create_params", + False, + ), + "InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions": ( + "stripe.params._invoice_create_params", + False, + ), "InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPix": ( "stripe.params._invoice_create_params", False, @@ -10262,6 +10304,14 @@ "stripe.params._invoice_modify_params", False, ), + "InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPayto": ( + "stripe.params._invoice_modify_params", + False, + ), + "InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions": ( + "stripe.params._invoice_modify_params", + False, + ), "InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPix": ( "stripe.params._invoice_modify_params", False, @@ -10514,6 +10564,14 @@ "stripe.params._invoice_update_params", False, ), + "InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPayto": ( + "stripe.params._invoice_update_params", + False, + ), + "InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions": ( + "stripe.params._invoice_update_params", + False, + ), "InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPix": ( "stripe.params._invoice_update_params", False, @@ -21915,6 +21973,14 @@ "stripe.params._subscription_create_params", False, ), + "SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPayto": ( + "stripe.params._subscription_create_params", + False, + ), + "SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions": ( + "stripe.params._subscription_create_params", + False, + ), "SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPix": ( "stripe.params._subscription_create_params", False, @@ -22271,6 +22337,14 @@ "stripe.params._subscription_modify_params", False, ), + "SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPayto": ( + "stripe.params._subscription_modify_params", + False, + ), + "SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions": ( + "stripe.params._subscription_modify_params", + False, + ), "SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPix": ( "stripe.params._subscription_modify_params", False, @@ -23159,6 +23233,14 @@ "stripe.params._subscription_update_params", False, ), + "SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPayto": ( + "stripe.params._subscription_update_params", + False, + ), + "SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions": ( + "stripe.params._subscription_update_params", + False, + ), "SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPix": ( "stripe.params._subscription_update_params", False, diff --git a/stripe/params/_account_create_external_account_params.py b/stripe/params/_account_create_external_account_params.py index 82ccbfb58..0bc9334b0 100644 --- a/stripe/params/_account_create_external_account_params.py +++ b/stripe/params/_account_create_external_account_params.py @@ -21,11 +21,11 @@ class AccountCreateExternalAccountParams(RequestOptions): "AccountCreateExternalAccountParamsCardToken", ] """ - A token, like the ones returned by [Stripe.js](https://stripe.com/docs/js) or a dictionary containing a user's external account details (with the options shown below). Please refer to full [documentation](https://stripe.com/docs/api/external_accounts) instead. + A token, like the ones returned by [Stripe.js](https://docs.stripe.com/js) or a dictionary containing a user's external account details (with the options shown below). Please refer to full [documentation](https://stripe.com/docs/api/external_accounts) instead. """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_account_create_params.py b/stripe/params/_account_create_params.py index 75aec104b..85eddfb74 100644 --- a/stripe/params/_account_create_params.py +++ b/stripe/params/_account_create_params.py @@ -8,7 +8,7 @@ class AccountCreateParams(RequestOptions): account_token: NotRequired[str] """ - An [account token](https://stripe.com/docs/api#create_account_token), used to securely provide details to the account. + An [account token](https://api.stripe.com#create_account_token), used to securely provide details to the account. """ business_profile: NotRequired["AccountCreateParamsBusinessProfile"] """ @@ -77,7 +77,7 @@ class AccountCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ risk_controls: NotRequired["AccountCreateParamsRiskControls"] """ @@ -217,7 +217,7 @@ class AccountCreateParamsBusinessProfileSupportAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1274,7 +1274,7 @@ class AccountCreateParamsCompanyAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1410,11 +1410,11 @@ class AccountCreateParamsCompanyVerification(TypedDict): class AccountCreateParamsCompanyVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ @@ -1450,7 +1450,7 @@ class AccountCreateParamsController(TypedDict): class AccountCreateParamsControllerApplication(TypedDict): loss_liable: bool """ - Whether the controller is liable for losses on this account. For details, see [Understanding Connect Account Balances](https://stripe.com/docs/connect/account-balances). + Whether the controller is liable for losses on this account. For details, see [Understanding Connect Account Balances](https://docs.stripe.com/connect/account-balances). """ onboarding_owner: NotRequired[bool] """ @@ -1546,56 +1546,69 @@ class AccountCreateParamsDocuments(TypedDict): class AccountCreateParamsDocumentsBankAccountOwnershipVerification(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreateParamsDocumentsCompanyLicense(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreateParamsDocumentsCompanyMemorandumOfAssociation(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreateParamsDocumentsCompanyMinisterialDecree(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreateParamsDocumentsCompanyRegistrationVerification(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreateParamsDocumentsCompanyTaxIdVerification(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreateParamsDocumentsProofOfAddress(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreateParamsDocumentsProofOfRegistration(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. + """ + signer: NotRequired[ + "AccountCreateParamsDocumentsProofOfRegistrationSigner" + ] + """ + Information regarding the person signing the document if applicable. + """ + + +class AccountCreateParamsDocumentsProofOfRegistrationSigner(TypedDict): + person: NotRequired[str] + """ + The token of the person signing the document, if applicable. """ @@ -1604,7 +1617,22 @@ class AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnership( ): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. + """ + signer: NotRequired[ + "AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner" + ] + """ + Information regarding the person signing the document if applicable. + """ + + +class AccountCreateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner( + TypedDict, +): + person: NotRequired[str] + """ + The token of the person signing the document, if applicable. """ @@ -1666,7 +1694,7 @@ class AccountCreateParamsCardToken(TypedDict): class AccountCreateParamsGroups(TypedDict): payments_pricing: NotRequired["Literal['']|str"] """ - The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://stripe.com/docs/connect/platform-pricing-tools) for details. + The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://docs.stripe.com/connect/platform-pricing-tools) for details. """ @@ -1737,7 +1765,7 @@ class AccountCreateParamsIndividual(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone: NotRequired[str] """ @@ -1790,7 +1818,7 @@ class AccountCreateParamsIndividualAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1894,7 +1922,7 @@ class AccountCreateParamsIndividualRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1937,33 +1965,33 @@ class AccountCreateParamsIndividualVerification(TypedDict): class AccountCreateParamsIndividualVerificationAdditionalDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountCreateParamsIndividualVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountCreateParamsRiskControls(TypedDict): charges: NotRequired["AccountCreateParamsRiskControlsCharges"] """ - Represents the risk control status of charges. Please see [this page for more details](https://stripe.com/docs/connect/pausing-payments-or-payouts-on-connected-accounts). + Represents the risk control status of charges. Please see [this page for more details](https://docs.stripe.com/connect/pausing-payments-or-payouts-on-connected-accounts). """ payouts: NotRequired["AccountCreateParamsRiskControlsPayouts"] """ - Represents the risk control status of payouts. Please see [this page for more details](https://stripe.com/docs/connect/pausing-payments-or-payouts-on-connected-accounts). + Represents the risk control status of payouts. Please see [this page for more details](https://docs.stripe.com/connect/pausing-payments-or-payouts-on-connected-accounts). """ diff --git a/stripe/params/_account_create_person_params.py b/stripe/params/_account_create_person_params.py index d52502b95..7e4eef2f6 100644 --- a/stripe/params/_account_create_person_params.py +++ b/stripe/params/_account_create_person_params.py @@ -86,7 +86,7 @@ class AccountCreatePersonParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nationality: NotRequired[str] """ @@ -175,7 +175,7 @@ class AccountCreatePersonParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -276,21 +276,21 @@ class AccountCreatePersonParamsDocuments(TypedDict): class AccountCreatePersonParamsDocumentsCompanyAuthorization(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreatePersonParamsDocumentsPassport(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountCreatePersonParamsDocumentsVisa(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ @@ -317,7 +317,7 @@ class AccountCreatePersonParamsRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -452,20 +452,20 @@ class AccountCreatePersonParamsVerification(TypedDict): class AccountCreatePersonParamsVerificationAdditionalDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountCreatePersonParamsVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ diff --git a/stripe/params/_account_external_account_create_params.py b/stripe/params/_account_external_account_create_params.py index 144d75853..c780935fc 100644 --- a/stripe/params/_account_external_account_create_params.py +++ b/stripe/params/_account_external_account_create_params.py @@ -20,11 +20,11 @@ class AccountExternalAccountCreateParams(TypedDict): "AccountExternalAccountCreateParamsCardToken", ] """ - A token, like the ones returned by [Stripe.js](https://stripe.com/docs/js) or a dictionary containing a user's external account details (with the options shown below). Please refer to full [documentation](https://stripe.com/docs/api/external_accounts) instead. + A token, like the ones returned by [Stripe.js](https://docs.stripe.com/js) or a dictionary containing a user's external account details (with the options shown below). Please refer to full [documentation](https://stripe.com/docs/api/external_accounts) instead. """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_account_external_account_update_params.py b/stripe/params/_account_external_account_update_params.py index 04642cd79..6b1d5d29f 100644 --- a/stripe/params/_account_external_account_update_params.py +++ b/stripe/params/_account_external_account_update_params.py @@ -65,7 +65,7 @@ class AccountExternalAccountUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -87,5 +87,5 @@ class AccountExternalAccountUpdateParamsDocumentsBankAccountOwnershipVerificatio ): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ diff --git a/stripe/params/_account_modify_external_account_params.py b/stripe/params/_account_modify_external_account_params.py index 682ec49ed..0a83d10f6 100644 --- a/stripe/params/_account_modify_external_account_params.py +++ b/stripe/params/_account_modify_external_account_params.py @@ -66,7 +66,7 @@ class AccountModifyExternalAccountParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -88,5 +88,5 @@ class AccountModifyExternalAccountParamsDocumentsBankAccountOwnershipVerificatio ): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ diff --git a/stripe/params/_account_modify_person_params.py b/stripe/params/_account_modify_person_params.py index 08a3455a9..5ab1aac5f 100644 --- a/stripe/params/_account_modify_person_params.py +++ b/stripe/params/_account_modify_person_params.py @@ -86,7 +86,7 @@ class AccountModifyPersonParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nationality: NotRequired[str] """ @@ -175,7 +175,7 @@ class AccountModifyPersonParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -276,21 +276,21 @@ class AccountModifyPersonParamsDocuments(TypedDict): class AccountModifyPersonParamsDocumentsCompanyAuthorization(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountModifyPersonParamsDocumentsPassport(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountModifyPersonParamsDocumentsVisa(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ @@ -317,7 +317,7 @@ class AccountModifyPersonParamsRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -452,20 +452,20 @@ class AccountModifyPersonParamsVerification(TypedDict): class AccountModifyPersonParamsVerificationAdditionalDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountModifyPersonParamsVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ diff --git a/stripe/params/_account_notice_modify_params.py b/stripe/params/_account_notice_modify_params.py index 3fb0f3304..3f2f29849 100644 --- a/stripe/params/_account_notice_modify_params.py +++ b/stripe/params/_account_notice_modify_params.py @@ -16,7 +16,7 @@ class AccountNoticeModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ sent_at: int """ diff --git a/stripe/params/_account_notice_update_params.py b/stripe/params/_account_notice_update_params.py index 9bc697cc4..f4e359772 100644 --- a/stripe/params/_account_notice_update_params.py +++ b/stripe/params/_account_notice_update_params.py @@ -15,7 +15,7 @@ class AccountNoticeUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ sent_at: int """ diff --git a/stripe/params/_account_person_create_params.py b/stripe/params/_account_person_create_params.py index bf5abaf4c..749d0a3fe 100644 --- a/stripe/params/_account_person_create_params.py +++ b/stripe/params/_account_person_create_params.py @@ -85,7 +85,7 @@ class AccountPersonCreateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nationality: NotRequired[str] """ @@ -174,7 +174,7 @@ class AccountPersonCreateParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -275,21 +275,21 @@ class AccountPersonCreateParamsDocuments(TypedDict): class AccountPersonCreateParamsDocumentsCompanyAuthorization(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountPersonCreateParamsDocumentsPassport(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountPersonCreateParamsDocumentsVisa(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ @@ -316,7 +316,7 @@ class AccountPersonCreateParamsRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -451,20 +451,20 @@ class AccountPersonCreateParamsVerification(TypedDict): class AccountPersonCreateParamsVerificationAdditionalDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountPersonCreateParamsVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ diff --git a/stripe/params/_account_person_update_params.py b/stripe/params/_account_person_update_params.py index c15713705..0b8854917 100644 --- a/stripe/params/_account_person_update_params.py +++ b/stripe/params/_account_person_update_params.py @@ -85,7 +85,7 @@ class AccountPersonUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nationality: NotRequired[str] """ @@ -174,7 +174,7 @@ class AccountPersonUpdateParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -275,21 +275,21 @@ class AccountPersonUpdateParamsDocuments(TypedDict): class AccountPersonUpdateParamsDocumentsCompanyAuthorization(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountPersonUpdateParamsDocumentsPassport(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountPersonUpdateParamsDocumentsVisa(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ @@ -316,7 +316,7 @@ class AccountPersonUpdateParamsRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -451,20 +451,20 @@ class AccountPersonUpdateParamsVerification(TypedDict): class AccountPersonUpdateParamsVerificationAdditionalDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountPersonUpdateParamsVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ diff --git a/stripe/params/_account_update_params.py b/stripe/params/_account_update_params.py index 7120e5204..ba4a5ff48 100644 --- a/stripe/params/_account_update_params.py +++ b/stripe/params/_account_update_params.py @@ -7,7 +7,7 @@ class AccountUpdateParams(TypedDict): account_token: NotRequired[str] """ - An [account token](https://stripe.com/docs/api#create_account_token), used to securely provide details to the account. + An [account token](https://api.stripe.com#create_account_token), used to securely provide details to the account. """ business_profile: NotRequired["AccountUpdateParamsBusinessProfile"] """ @@ -68,7 +68,7 @@ class AccountUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ risk_controls: NotRequired["AccountUpdateParamsRiskControls"] """ @@ -204,7 +204,7 @@ class AccountUpdateParamsBusinessProfileSupportAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1258,7 +1258,7 @@ class AccountUpdateParamsCompanyAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1394,11 +1394,11 @@ class AccountUpdateParamsCompanyVerification(TypedDict): class AccountUpdateParamsCompanyVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ @@ -1458,56 +1458,69 @@ class AccountUpdateParamsDocuments(TypedDict): class AccountUpdateParamsDocumentsBankAccountOwnershipVerification(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountUpdateParamsDocumentsCompanyLicense(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountUpdateParamsDocumentsCompanyMemorandumOfAssociation(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountUpdateParamsDocumentsCompanyMinisterialDecree(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountUpdateParamsDocumentsCompanyRegistrationVerification(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountUpdateParamsDocumentsCompanyTaxIdVerification(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountUpdateParamsDocumentsProofOfAddress(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class AccountUpdateParamsDocumentsProofOfRegistration(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. + """ + signer: NotRequired[ + "AccountUpdateParamsDocumentsProofOfRegistrationSigner" + ] + """ + Information regarding the person signing the document if applicable. + """ + + +class AccountUpdateParamsDocumentsProofOfRegistrationSigner(TypedDict): + person: NotRequired[str] + """ + The token of the person signing the document, if applicable. """ @@ -1516,7 +1529,22 @@ class AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnership( ): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. + """ + signer: NotRequired[ + "AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner" + ] + """ + Information regarding the person signing the document if applicable. + """ + + +class AccountUpdateParamsDocumentsProofOfUltimateBeneficialOwnershipSigner( + TypedDict, +): + person: NotRequired[str] + """ + The token of the person signing the document, if applicable. """ @@ -1578,7 +1606,7 @@ class AccountUpdateParamsCardToken(TypedDict): class AccountUpdateParamsGroups(TypedDict): payments_pricing: NotRequired["Literal['']|str"] """ - The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://stripe.com/docs/connect/platform-pricing-tools) for details. + The group the account is in to determine their payments pricing, and null if the account is on customized pricing. [See the Platform pricing tool documentation](https://docs.stripe.com/connect/platform-pricing-tools) for details. """ @@ -1649,7 +1677,7 @@ class AccountUpdateParamsIndividual(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone: NotRequired[str] """ @@ -1702,7 +1730,7 @@ class AccountUpdateParamsIndividualAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1806,7 +1834,7 @@ class AccountUpdateParamsIndividualRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1849,33 +1877,33 @@ class AccountUpdateParamsIndividualVerification(TypedDict): class AccountUpdateParamsIndividualVerificationAdditionalDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountUpdateParamsIndividualVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class AccountUpdateParamsRiskControls(TypedDict): charges: NotRequired["AccountUpdateParamsRiskControlsCharges"] """ - Represents the risk control status of charges. Please see [this page for more details](https://stripe.com/docs/connect/pausing-payments-or-payouts-on-connected-accounts). + Represents the risk control status of charges. Please see [this page for more details](https://docs.stripe.com/connect/pausing-payments-or-payouts-on-connected-accounts). """ payouts: NotRequired["AccountUpdateParamsRiskControlsPayouts"] """ - Represents the risk control status of payouts. Please see [this page for more details](https://stripe.com/docs/connect/pausing-payments-or-payouts-on-connected-accounts). + Represents the risk control status of payouts. Please see [this page for more details](https://docs.stripe.com/connect/pausing-payments-or-payouts-on-connected-accounts). """ diff --git a/stripe/params/_application_fee_create_refund_params.py b/stripe/params/_application_fee_create_refund_params.py index 4d209e6a4..d6c0f11af 100644 --- a/stripe/params/_application_fee_create_refund_params.py +++ b/stripe/params/_application_fee_create_refund_params.py @@ -16,5 +16,5 @@ class ApplicationFeeCreateRefundParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_application_fee_modify_refund_params.py b/stripe/params/_application_fee_modify_refund_params.py index a0b49b616..d2382e52e 100644 --- a/stripe/params/_application_fee_modify_refund_params.py +++ b/stripe/params/_application_fee_modify_refund_params.py @@ -12,5 +12,5 @@ class ApplicationFeeModifyRefundParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_application_fee_refund_create_params.py b/stripe/params/_application_fee_refund_create_params.py index 6f7a75697..ecb1bbcea 100644 --- a/stripe/params/_application_fee_refund_create_params.py +++ b/stripe/params/_application_fee_refund_create_params.py @@ -15,5 +15,5 @@ class ApplicationFeeRefundCreateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_application_fee_refund_params.py b/stripe/params/_application_fee_refund_params.py index 66e53b611..a6cbc410a 100644 --- a/stripe/params/_application_fee_refund_params.py +++ b/stripe/params/_application_fee_refund_params.py @@ -16,5 +16,5 @@ class ApplicationFeeRefundParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_application_fee_refund_update_params.py b/stripe/params/_application_fee_refund_update_params.py index 9d2a63eb6..cbfcb830c 100644 --- a/stripe/params/_application_fee_refund_update_params.py +++ b/stripe/params/_application_fee_refund_update_params.py @@ -11,5 +11,5 @@ class ApplicationFeeRefundUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_charge_capture_params.py b/stripe/params/_charge_capture_params.py index 1f2b2829e..b3eb9f6fb 100644 --- a/stripe/params/_charge_capture_params.py +++ b/stripe/params/_charge_capture_params.py @@ -42,11 +42,11 @@ class ChargeCaptureParams(RequestOptions): """ transfer_data: NotRequired["ChargeCaptureParamsTransferData"] """ - An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://stripe.com/docs/connect/destination-charges) for details. + An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://docs.stripe.com/connect/destination-charges) for details. """ transfer_group: NotRequired[str] """ - A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details. + A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details. """ @@ -306,7 +306,7 @@ class ChargeCaptureParamsPaymentDetailsCarRentalPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -333,7 +333,7 @@ class ChargeCaptureParamsPaymentDetailsCarRentalReturnAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -504,7 +504,7 @@ class ChargeCaptureParamsPaymentDetailsCarRentalDatumDropOffAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -572,7 +572,7 @@ class ChargeCaptureParamsPaymentDetailsCarRentalDatumPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -814,7 +814,7 @@ class ChargeCaptureParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1376,7 +1376,7 @@ class ChargeCaptureParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1611,7 +1611,7 @@ class ChargeCaptureParamsPaymentDetailsLodgingDatumHostAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_charge_create_params.py b/stripe/params/_charge_create_params.py index a305b0f81..d746556dd 100644 --- a/stripe/params/_charge_create_params.py +++ b/stripe/params/_charge_create_params.py @@ -8,16 +8,16 @@ class ChargeCreateParams(RequestOptions): amount: NotRequired[int] """ - Amount intended to be collected by this payment. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). + Amount intended to be collected by this payment. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). """ application_fee: NotRequired[int] application_fee_amount: NotRequired[int] """ - A fee in cents (or local equivalent) that will be applied to the charge 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](https://stripe.com/docs/connect/direct-charges#collect-fees). + A fee in cents (or local equivalent) that will be applied to the charge 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](https://docs.stripe.com/connect/direct-charges#collect-fees). """ capture: NotRequired[bool] """ - Whether to immediately capture the charge. Defaults to `true`. When `false`, the charge issues an authorization (or pre-authorization), and will need to be [captured](https://stripe.com/docs/api#capture_charge) later. Uncaptured charges expire after a set number of days (7 by default). For more information, see the [authorizing charges and settling later](https://stripe.com/docs/charges/placing-a-hold) documentation. + Whether to immediately capture the charge. Defaults to `true`. When `false`, the charge issues an authorization (or pre-authorization), and will need to be [captured](https://api.stripe.com#capture_charge) later. Uncaptured charges expire after a set number of days (7 by default). For more information, see the [authorizing charges and settling later](https://docs.stripe.com/charges/placing-a-hold) documentation. """ currency: NotRequired[str] """ @@ -38,19 +38,19 @@ class ChargeCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired[str] """ - The Stripe account ID for which these funds are intended. Automatically set if you use the `destination` parameter. For details, see [Creating Separate Charges and Transfers](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant). + The Stripe account ID for which these funds are intended. You can specify the business of record as the connected account using the `on_behalf_of` attribute on the charge. For details, see [Creating Separate Charges and Transfers](https://docs.stripe.com/connect/separate-charges-and-transfers#settlement-merchant). """ radar_options: NotRequired["ChargeCreateParamsRadarOptions"] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ receipt_email: NotRequired[str] """ - The email address to which this charge's [receipt](https://stripe.com/docs/dashboard/receipts) will be sent. The receipt will not be sent until the charge is paid, and no receipts will be sent for test mode charges. If this charge is for a [Customer](https://stripe.com/docs/api/customers/object), the email address specified here will override the customer's email address. If `receipt_email` is specified for a charge in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails). + The email address to which this charge's [receipt](https://docs.stripe.com/dashboard/receipts) will be sent. The receipt will not be sent until the charge is paid, and no receipts will be sent for test mode charges. If this charge is for a [Customer](https://docs.stripe.com/api/customers/object), the email address specified here will override the customer's email address. If `receipt_email` is specified for a charge in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails). """ shipping: NotRequired["ChargeCreateParamsShipping"] """ @@ -58,7 +58,7 @@ class ChargeCreateParams(RequestOptions): """ source: NotRequired[str] """ - A payment source to be charged. This can be the ID of a [card](https://stripe.com/docs/api#cards) (i.e., credit or debit card), a [bank account](https://stripe.com/docs/api#bank_accounts), a [source](https://stripe.com/docs/api#sources), a [token](https://stripe.com/docs/api#tokens), or a [connected account](https://stripe.com/docs/connect/account-debits#charging-a-connected-account). For certain sources---namely, [cards](https://stripe.com/docs/api#cards), [bank accounts](https://stripe.com/docs/api#bank_accounts), and attached [sources](https://stripe.com/docs/api#sources)---you must also pass the ID of the associated customer. + A payment source to be charged. This can be the ID of a [card](https://docs.stripe.com/api#cards) (i.e., credit or debit card), a [bank account](https://docs.stripe.com/api#bank_accounts), a [source](https://docs.stripe.com/api#sources), a [token](https://docs.stripe.com/api#tokens), or a [connected account](https://docs.stripe.com/connect/account-debits#charging-a-connected-account). For certain sources---namely, [cards](https://docs.stripe.com/api#cards), [bank accounts](https://docs.stripe.com/api#bank_accounts), and attached [sources](https://docs.stripe.com/api#sources)---you must also pass the ID of the associated customer. """ statement_descriptor: NotRequired[str] """ @@ -72,11 +72,11 @@ class ChargeCreateParams(RequestOptions): """ transfer_data: NotRequired["ChargeCreateParamsTransferData"] """ - An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://stripe.com/docs/connect/destination-charges) for details. + An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://docs.stripe.com/connect/destination-charges) for details. """ transfer_group: NotRequired[str] """ - A string that identifies this transaction as part of a group. For details, see [Grouping transactions](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options). + A string that identifies this transaction as part of a group. For details, see [Grouping transactions](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options). """ @@ -94,7 +94,7 @@ class ChargeCreateParamsDestination(TypedDict): class ChargeCreateParamsRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -144,7 +144,7 @@ class ChargeCreateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_charge_modify_params.py b/stripe/params/_charge_modify_params.py index ad8d744a4..9ce3701f6 100644 --- a/stripe/params/_charge_modify_params.py +++ b/stripe/params/_charge_modify_params.py @@ -24,7 +24,7 @@ class ChargeModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_details: NotRequired["ChargeModifyParamsPaymentDetails"] """ @@ -40,7 +40,7 @@ class ChargeModifyParams(RequestOptions): """ transfer_group: NotRequired[str] """ - A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details. + A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details. """ @@ -307,7 +307,7 @@ class ChargeModifyParamsPaymentDetailsCarRentalPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -334,7 +334,7 @@ class ChargeModifyParamsPaymentDetailsCarRentalReturnAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -505,7 +505,7 @@ class ChargeModifyParamsPaymentDetailsCarRentalDatumDropOffAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -573,7 +573,7 @@ class ChargeModifyParamsPaymentDetailsCarRentalDatumPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -813,7 +813,7 @@ class ChargeModifyParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1373,7 +1373,7 @@ class ChargeModifyParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1608,7 +1608,7 @@ class ChargeModifyParamsPaymentDetailsLodgingDatumHostAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1817,5 +1817,5 @@ class ChargeModifyParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_charge_search_params.py b/stripe/params/_charge_search_params.py index a936ec939..129829849 100644 --- a/stripe/params/_charge_search_params.py +++ b/stripe/params/_charge_search_params.py @@ -20,5 +20,5 @@ class ChargeSearchParams(RequestOptions): """ query: str """ - The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for charges](https://stripe.com/docs/search#query-fields-for-charges). + The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for charges](https://docs.stripe.com/search#query-fields-for-charges). """ diff --git a/stripe/params/_charge_update_params.py b/stripe/params/_charge_update_params.py index 8e8b27a41..a1bd52671 100644 --- a/stripe/params/_charge_update_params.py +++ b/stripe/params/_charge_update_params.py @@ -23,7 +23,7 @@ class ChargeUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_details: NotRequired["ChargeUpdateParamsPaymentDetails"] """ @@ -39,7 +39,7 @@ class ChargeUpdateParams(TypedDict): """ transfer_group: NotRequired[str] """ - A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details. + A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details. """ @@ -306,7 +306,7 @@ class ChargeUpdateParamsPaymentDetailsCarRentalPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -333,7 +333,7 @@ class ChargeUpdateParamsPaymentDetailsCarRentalReturnAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -504,7 +504,7 @@ class ChargeUpdateParamsPaymentDetailsCarRentalDatumDropOffAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -572,7 +572,7 @@ class ChargeUpdateParamsPaymentDetailsCarRentalDatumPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -812,7 +812,7 @@ class ChargeUpdateParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1372,7 +1372,7 @@ class ChargeUpdateParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1607,7 +1607,7 @@ class ChargeUpdateParamsPaymentDetailsLodgingDatumHostAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1816,5 +1816,5 @@ class ChargeUpdateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_confirmation_token_create_params.py b/stripe/params/_confirmation_token_create_params.py index 01aeb5c6f..ef4157cae 100644 --- a/stripe/params/_confirmation_token_create_params.py +++ b/stripe/params/_confirmation_token_create_params.py @@ -34,7 +34,7 @@ class ConfirmationTokenCreateParams(RequestOptions): """ Indicates that you intend to make future payments with this ConfirmationToken's payment method. - The presence of this property will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. + The presence of this property will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. """ shipping: NotRequired["ConfirmationTokenCreateParamsShipping"] """ @@ -201,7 +201,7 @@ class ConfirmationTokenCreateParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired[ "ConfirmationTokenCreateParamsPaymentMethodDataMobilepay" @@ -279,7 +279,7 @@ class ConfirmationTokenCreateParamsPaymentMethodData(TypedDict): "ConfirmationTokenCreateParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired[ "ConfirmationTokenCreateParamsPaymentMethodDataRechnung" @@ -531,7 +531,7 @@ class ConfirmationTokenCreateParamsPaymentMethodDataBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -660,6 +660,7 @@ class ConfirmationTokenCreateParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -852,7 +853,7 @@ class ConfirmationTokenCreateParamsPaymentMethodDataQris(TypedDict): class ConfirmationTokenCreateParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -1042,5 +1043,5 @@ class ConfirmationTokenCreateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_coupon_create_params.py b/stripe/params/_coupon_create_params.py index 143d5ca61..f148a46a1 100644 --- a/stripe/params/_coupon_create_params.py +++ b/stripe/params/_coupon_create_params.py @@ -46,7 +46,7 @@ class CouponCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/_coupon_modify_params.py b/stripe/params/_coupon_modify_params.py index 3a40e77aa..10a6fbaf5 100644 --- a/stripe/params/_coupon_modify_params.py +++ b/stripe/params/_coupon_modify_params.py @@ -18,7 +18,7 @@ class CouponModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/_coupon_update_params.py b/stripe/params/_coupon_update_params.py index bbd7d067b..82ad710a5 100644 --- a/stripe/params/_coupon_update_params.py +++ b/stripe/params/_coupon_update_params.py @@ -17,7 +17,7 @@ class CouponUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/_credit_note_create_params.py b/stripe/params/_credit_note_create_params.py index 349d1d6f0..6fe871bad 100644 --- a/stripe/params/_credit_note_create_params.py +++ b/stripe/params/_credit_note_create_params.py @@ -40,7 +40,7 @@ class CreditNoteCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ out_of_band_amount: NotRequired[int] """ diff --git a/stripe/params/_credit_note_list_params.py b/stripe/params/_credit_note_list_params.py index 35ac6e801..49e66c686 100644 --- a/stripe/params/_credit_note_list_params.py +++ b/stripe/params/_credit_note_list_params.py @@ -16,7 +16,7 @@ class CreditNoteListParams(RequestOptions): """ customer_account: NotRequired[str] """ - Only return credit notes for the account specified by this account ID. + Only return credit notes for the account representing the customer specified by this account ID. """ ending_before: NotRequired[str] """ diff --git a/stripe/params/_credit_note_modify_params.py b/stripe/params/_credit_note_modify_params.py index 7b53aa673..fe69c0423 100644 --- a/stripe/params/_credit_note_modify_params.py +++ b/stripe/params/_credit_note_modify_params.py @@ -16,5 +16,5 @@ class CreditNoteModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_credit_note_preview_lines_list_params.py b/stripe/params/_credit_note_preview_lines_list_params.py index 337f7e9d3..a62d86ebf 100644 --- a/stripe/params/_credit_note_preview_lines_list_params.py +++ b/stripe/params/_credit_note_preview_lines_list_params.py @@ -47,7 +47,7 @@ class CreditNotePreviewLinesListParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ out_of_band_amount: NotRequired[int] """ diff --git a/stripe/params/_credit_note_preview_lines_params.py b/stripe/params/_credit_note_preview_lines_params.py index c1a761dc3..111011f14 100644 --- a/stripe/params/_credit_note_preview_lines_params.py +++ b/stripe/params/_credit_note_preview_lines_params.py @@ -48,7 +48,7 @@ class CreditNotePreviewLinesParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ out_of_band_amount: NotRequired[int] """ diff --git a/stripe/params/_credit_note_preview_params.py b/stripe/params/_credit_note_preview_params.py index 9626dba96..aa978ab53 100644 --- a/stripe/params/_credit_note_preview_params.py +++ b/stripe/params/_credit_note_preview_params.py @@ -40,7 +40,7 @@ class CreditNotePreviewParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ out_of_band_amount: NotRequired[int] """ diff --git a/stripe/params/_credit_note_update_params.py b/stripe/params/_credit_note_update_params.py index 240ca2645..f3a374c86 100644 --- a/stripe/params/_credit_note_update_params.py +++ b/stripe/params/_credit_note_update_params.py @@ -15,5 +15,5 @@ class CreditNoteUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_customer_balance_transaction_create_params.py b/stripe/params/_customer_balance_transaction_create_params.py index 4795d1b73..bee7dd142 100644 --- a/stripe/params/_customer_balance_transaction_create_params.py +++ b/stripe/params/_customer_balance_transaction_create_params.py @@ -11,7 +11,7 @@ class CustomerBalanceTransactionCreateParams(TypedDict): """ currency: str """ - Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Specifies the [`invoice_credit_balance`](https://stripe.com/docs/api/customers/object#customer_object-invoice_credit_balance) that this transaction will apply to. If the customer's `currency` is not set, it will be updated to this value. + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Specifies the [`invoice_credit_balance`](https://docs.stripe.com/api/customers/object#customer_object-invoice_credit_balance) that this transaction will apply to. If the customer's `currency` is not set, it will be updated to this value. """ description: NotRequired[str] """ @@ -23,5 +23,5 @@ class CustomerBalanceTransactionCreateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_customer_balance_transaction_list_params.py b/stripe/params/_customer_balance_transaction_list_params.py index 826403276..a90aa1a15 100644 --- a/stripe/params/_customer_balance_transaction_list_params.py +++ b/stripe/params/_customer_balance_transaction_list_params.py @@ -17,6 +17,10 @@ class CustomerBalanceTransactionListParams(TypedDict): """ Specifies which fields in the response should be expanded. """ + invoice: NotRequired[str] + """ + Only return transactions that are related to the specified invoice. + """ limit: NotRequired[int] """ A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. diff --git a/stripe/params/_customer_balance_transaction_update_params.py b/stripe/params/_customer_balance_transaction_update_params.py index d4766b557..5e792783a 100644 --- a/stripe/params/_customer_balance_transaction_update_params.py +++ b/stripe/params/_customer_balance_transaction_update_params.py @@ -15,5 +15,5 @@ class CustomerBalanceTransactionUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_customer_cash_balance_update_params.py b/stripe/params/_customer_cash_balance_update_params.py index 2f1bd2ced..47b4e048d 100644 --- a/stripe/params/_customer_cash_balance_update_params.py +++ b/stripe/params/_customer_cash_balance_update_params.py @@ -20,5 +20,5 @@ class CustomerCashBalanceUpdateParamsSettings(TypedDict): Literal["automatic", "manual", "merchant_default"] ] """ - Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation). + Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation). """ diff --git a/stripe/params/_customer_create_balance_transaction_params.py b/stripe/params/_customer_create_balance_transaction_params.py index 7d979c0a6..c20c785a7 100644 --- a/stripe/params/_customer_create_balance_transaction_params.py +++ b/stripe/params/_customer_create_balance_transaction_params.py @@ -12,7 +12,7 @@ class CustomerCreateBalanceTransactionParams(RequestOptions): """ currency: str """ - Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Specifies the [`invoice_credit_balance`](https://stripe.com/docs/api/customers/object#customer_object-invoice_credit_balance) that this transaction will apply to. If the customer's `currency` is not set, it will be updated to this value. + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Specifies the [`invoice_credit_balance`](https://docs.stripe.com/api/customers/object#customer_object-invoice_credit_balance) that this transaction will apply to. If the customer's `currency` is not set, it will be updated to this value. """ description: NotRequired[str] """ @@ -24,5 +24,5 @@ class CustomerCreateBalanceTransactionParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_customer_create_params.py b/stripe/params/_customer_create_params.py index 3d7ae3df9..d930a2617 100644 --- a/stripe/params/_customer_create_params.py +++ b/stripe/params/_customer_create_params.py @@ -8,7 +8,7 @@ class CustomerCreateParams(RequestOptions): address: NotRequired["Literal['']|CustomerCreateParamsAddress"] """ - The customer's address. + The customer's address. Learn about [country-specific requirements for calculating tax](https://docs.stripe.com/invoicing/taxes?dashboard-or-api=dashboard#set-up-customer). """ balance: NotRequired[int] """ @@ -48,7 +48,7 @@ class CustomerCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -114,7 +114,7 @@ class CustomerCreateParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -131,7 +131,7 @@ class CustomerCreateParamsCashBalanceSettings(TypedDict): Literal["automatic", "manual", "merchant_default"] ] """ - Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation). + Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation). """ @@ -220,7 +220,7 @@ class CustomerCreateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_customer_create_source_params.py b/stripe/params/_customer_create_source_params.py index 80318b03a..d58379e59 100644 --- a/stripe/params/_customer_create_source_params.py +++ b/stripe/params/_customer_create_source_params.py @@ -12,10 +12,10 @@ class CustomerCreateSourceParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ source: str """ - Please refer to full [documentation](https://stripe.com/docs/api) instead. + Please refer to full [documentation](https://api.stripe.com) instead. """ validate: NotRequired[bool] diff --git a/stripe/params/_customer_fund_cash_balance_params.py b/stripe/params/_customer_fund_cash_balance_params.py index 50645a32f..ee3294982 100644 --- a/stripe/params/_customer_fund_cash_balance_params.py +++ b/stripe/params/_customer_fund_cash_balance_params.py @@ -8,7 +8,7 @@ class CustomerFundCashBalanceParams(RequestOptions): amount: int """ - Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency). + Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency). """ currency: str """ @@ -20,5 +20,5 @@ class CustomerFundCashBalanceParams(RequestOptions): """ reference: NotRequired[str] """ - A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://stripe.com/docs/payments/customer-balance/reconciliation) applies to different user inputs. + A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://docs.stripe.com/payments/customer-balance/reconciliation) applies to different user inputs. """ diff --git a/stripe/params/_customer_list_balance_transactions_params.py b/stripe/params/_customer_list_balance_transactions_params.py index 9175024be..c5f62dc9e 100644 --- a/stripe/params/_customer_list_balance_transactions_params.py +++ b/stripe/params/_customer_list_balance_transactions_params.py @@ -18,6 +18,10 @@ class CustomerListBalanceTransactionsParams(RequestOptions): """ Specifies which fields in the response should be expanded. """ + invoice: NotRequired[str] + """ + Only return transactions that are related to the specified invoice. + """ limit: NotRequired[int] """ A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. diff --git a/stripe/params/_customer_modify_balance_transaction_params.py b/stripe/params/_customer_modify_balance_transaction_params.py index 9201b6263..ba32df38b 100644 --- a/stripe/params/_customer_modify_balance_transaction_params.py +++ b/stripe/params/_customer_modify_balance_transaction_params.py @@ -16,5 +16,5 @@ class CustomerModifyBalanceTransactionParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_customer_modify_cash_balance_params.py b/stripe/params/_customer_modify_cash_balance_params.py index 825733e11..d3b2ce817 100644 --- a/stripe/params/_customer_modify_cash_balance_params.py +++ b/stripe/params/_customer_modify_cash_balance_params.py @@ -21,5 +21,5 @@ class CustomerModifyCashBalanceParamsSettings(TypedDict): Literal["automatic", "manual", "merchant_default"] ] """ - Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation). + Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation). """ diff --git a/stripe/params/_customer_modify_params.py b/stripe/params/_customer_modify_params.py index 4e1f5e8be..d0eaa699a 100644 --- a/stripe/params/_customer_modify_params.py +++ b/stripe/params/_customer_modify_params.py @@ -8,7 +8,7 @@ class CustomerModifyParams(RequestOptions): address: NotRequired["Literal['']|CustomerModifyParamsAddress"] """ - The customer's address. + The customer's address. Learn about [country-specific requirements for calculating tax](https://docs.stripe.com/invoicing/taxes?dashboard-or-api=dashboard#set-up-customer). """ balance: NotRequired[int] """ @@ -24,11 +24,11 @@ class CustomerModifyParams(RequestOptions): """ default_source: NotRequired[str] """ - If you are using payment methods created via the PaymentMethods API, see the [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method) parameter. + If you are using payment methods created via the PaymentMethods API, see the [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/update#update_customer-invoice_settings-default_payment_method) parameter. Provide the ID of a payment source already attached to this customer to make it this customer's default payment source. - If you want to add a new payment source and make it the default, see the [source](https://stripe.com/docs/api/customers/update#update_customer-source) property. + If you want to add a new payment source and make it the default, see the [source](https://docs.stripe.com/api/customers/update#update_customer-source) property. """ description: NotRequired[str] """ @@ -56,7 +56,7 @@ class CustomerModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -113,7 +113,7 @@ class CustomerModifyParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -130,7 +130,7 @@ class CustomerModifyParamsCashBalanceSettings(TypedDict): Literal["automatic", "manual", "merchant_default"] ] """ - Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation). + Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation). """ @@ -219,7 +219,7 @@ class CustomerModifyParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_customer_modify_source_params.py b/stripe/params/_customer_modify_source_params.py index 844a6a70a..a3044e727 100644 --- a/stripe/params/_customer_modify_source_params.py +++ b/stripe/params/_customer_modify_source_params.py @@ -52,7 +52,7 @@ class CustomerModifySourceParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -103,5 +103,5 @@ class CustomerModifySourceParamsOwnerAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_customer_payment_source_create_params.py b/stripe/params/_customer_payment_source_create_params.py index 20c45c9f8..a44db1a90 100644 --- a/stripe/params/_customer_payment_source_create_params.py +++ b/stripe/params/_customer_payment_source_create_params.py @@ -11,10 +11,10 @@ class CustomerPaymentSourceCreateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ source: str """ - Please refer to full [documentation](https://stripe.com/docs/api) instead. + Please refer to full [documentation](https://api.stripe.com) instead. """ validate: NotRequired[bool] diff --git a/stripe/params/_customer_payment_source_update_params.py b/stripe/params/_customer_payment_source_update_params.py index 33e5b3520..258c1be3f 100644 --- a/stripe/params/_customer_payment_source_update_params.py +++ b/stripe/params/_customer_payment_source_update_params.py @@ -51,7 +51,7 @@ class CustomerPaymentSourceUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -102,5 +102,5 @@ class CustomerPaymentSourceUpdateParamsOwnerAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_customer_search_params.py b/stripe/params/_customer_search_params.py index 7cb556101..a67752be9 100644 --- a/stripe/params/_customer_search_params.py +++ b/stripe/params/_customer_search_params.py @@ -20,5 +20,5 @@ class CustomerSearchParams(RequestOptions): """ query: str """ - The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for customers](https://stripe.com/docs/search#query-fields-for-customers). + The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for customers](https://docs.stripe.com/search#query-fields-for-customers). """ diff --git a/stripe/params/_customer_update_params.py b/stripe/params/_customer_update_params.py index b325846dc..188f68eea 100644 --- a/stripe/params/_customer_update_params.py +++ b/stripe/params/_customer_update_params.py @@ -7,7 +7,7 @@ class CustomerUpdateParams(TypedDict): address: NotRequired["Literal['']|CustomerUpdateParamsAddress"] """ - The customer's address. + The customer's address. Learn about [country-specific requirements for calculating tax](https://docs.stripe.com/invoicing/taxes?dashboard-or-api=dashboard#set-up-customer). """ balance: NotRequired[int] """ @@ -23,11 +23,11 @@ class CustomerUpdateParams(TypedDict): """ default_source: NotRequired[str] """ - If you are using payment methods created via the PaymentMethods API, see the [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method) parameter. + If you are using payment methods created via the PaymentMethods API, see the [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/update#update_customer-invoice_settings-default_payment_method) parameter. Provide the ID of a payment source already attached to this customer to make it this customer's default payment source. - If you want to add a new payment source and make it the default, see the [source](https://stripe.com/docs/api/customers/update#update_customer-source) property. + If you want to add a new payment source and make it the default, see the [source](https://docs.stripe.com/api/customers/update#update_customer-source) property. """ description: NotRequired[str] """ @@ -55,7 +55,7 @@ class CustomerUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -112,7 +112,7 @@ class CustomerUpdateParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -129,7 +129,7 @@ class CustomerUpdateParamsCashBalanceSettings(TypedDict): Literal["automatic", "manual", "merchant_default"] ] """ - Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://stripe.com/docs/payments/customer-balance/reconciliation). + Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are `automatic`, `manual`, or `merchant_default`. For more information about these reconciliation modes, see [Reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation). """ @@ -218,7 +218,7 @@ class CustomerUpdateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_dispute_modify_params.py b/stripe/params/_dispute_modify_params.py index e8542c553..e3bf42051 100644 --- a/stripe/params/_dispute_modify_params.py +++ b/stripe/params/_dispute_modify_params.py @@ -27,7 +27,7 @@ class DisputeModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ submit: NotRequired[bool] """ @@ -250,7 +250,7 @@ class DisputeModifyParamsEvidenceEnhancedEvidenceVisaCompellingEvidence3Disputed """ state: NotRequired["Literal['']|str"] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -318,7 +318,7 @@ class DisputeModifyParamsEvidenceEnhancedEvidenceVisaCompellingEvidence3PriorUnd """ state: NotRequired["Literal['']|str"] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_dispute_update_params.py b/stripe/params/_dispute_update_params.py index ef8ec6e44..2472bb737 100644 --- a/stripe/params/_dispute_update_params.py +++ b/stripe/params/_dispute_update_params.py @@ -26,7 +26,7 @@ class DisputeUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ submit: NotRequired[bool] """ @@ -249,7 +249,7 @@ class DisputeUpdateParamsEvidenceEnhancedEvidenceVisaCompellingEvidence3Disputed """ state: NotRequired["Literal['']|str"] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -317,7 +317,7 @@ class DisputeUpdateParamsEvidenceEnhancedEvidenceVisaCompellingEvidence3PriorUnd """ state: NotRequired["Literal['']|str"] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_external_account_create_params.py b/stripe/params/_external_account_create_params.py index dd7cdd0d3..86f9cbb83 100644 --- a/stripe/params/_external_account_create_params.py +++ b/stripe/params/_external_account_create_params.py @@ -20,11 +20,11 @@ class ExternalAccountCreateParams(TypedDict): "ExternalAccountCreateParamsCardToken", ] """ - Either a token, like the ones returned by [Stripe.js](https://stripe.com/docs/js), or a dictionary containing a user's external account details (with the options shown below). + Either a token, like the ones returned by [Stripe.js](https://docs.stripe.com/js), or a dictionary containing a user's external account details (with the options shown below). """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_external_account_update_params.py b/stripe/params/_external_account_update_params.py index e16b66d1c..9579098f5 100644 --- a/stripe/params/_external_account_update_params.py +++ b/stripe/params/_external_account_update_params.py @@ -65,7 +65,7 @@ class ExternalAccountUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -87,5 +87,5 @@ class ExternalAccountUpdateParamsDocumentsBankAccountOwnershipVerification( ): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ diff --git a/stripe/params/_file_create_params.py b/stripe/params/_file_create_params.py index 00b5f427f..a65648464 100644 --- a/stripe/params/_file_create_params.py +++ b/stripe/params/_file_create_params.py @@ -16,7 +16,7 @@ class FileCreateParams(RequestOptions): """ file_link_data: NotRequired["FileCreateParamsFileLinkData"] """ - Optional parameters that automatically create a [file link](https://stripe.com/docs/api#file_links) for the newly created file. + Optional parameters that automatically create a [file link](https://api.stripe.com#file_links) for the newly created file. """ purpose: Literal[ "account_requirement", @@ -34,7 +34,7 @@ class FileCreateParams(RequestOptions): "terminal_reader_splashscreen", ] """ - The [purpose](https://stripe.com/docs/file-upload#uploading-a-file) of the uploaded file. + The [purpose](https://docs.stripe.com/file-upload#uploading-a-file) of the uploaded file. """ @@ -49,5 +49,5 @@ class FileCreateParamsFileLinkData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_file_link_create_params.py b/stripe/params/_file_link_create_params.py index 08c6e4489..75ea9de90 100644 --- a/stripe/params/_file_link_create_params.py +++ b/stripe/params/_file_link_create_params.py @@ -20,5 +20,5 @@ class FileLinkCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_file_link_modify_params.py b/stripe/params/_file_link_modify_params.py index 2dda56a17..62f80dedd 100644 --- a/stripe/params/_file_link_modify_params.py +++ b/stripe/params/_file_link_modify_params.py @@ -16,5 +16,5 @@ class FileLinkModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_file_link_update_params.py b/stripe/params/_file_link_update_params.py index 0c5ee8a36..34cd70f86 100644 --- a/stripe/params/_file_link_update_params.py +++ b/stripe/params/_file_link_update_params.py @@ -15,5 +15,5 @@ class FileLinkUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_invoice_add_lines_params.py b/stripe/params/_invoice_add_lines_params.py index 8d9005192..0eada73fd 100644 --- a/stripe/params/_invoice_add_lines_params.py +++ b/stripe/params/_invoice_add_lines_params.py @@ -12,7 +12,7 @@ class InvoiceAddLinesParams(RequestOptions): """ invoice_metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ lines: List["InvoiceAddLinesParamsLine"] """ @@ -49,15 +49,15 @@ class InvoiceAddLinesParamsLine(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["InvoiceAddLinesParamsLinePeriod"] """ - The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details. + The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details. """ price_data: NotRequired["InvoiceAddLinesParamsLinePriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ pricing: NotRequired["InvoiceAddLinesParamsLinePricing"] """ @@ -71,7 +71,7 @@ class InvoiceAddLinesParamsLine(TypedDict): "Literal['']|List[InvoiceAddLinesParamsLineTaxAmount]" ] """ - A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://stripe.com/docs/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://stripe.com/docs/tax/invoicing). Pass an empty string to remove previously defined tax amounts. + A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://docs.stripe.com/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://docs.stripe.com/tax/invoicing). Pass an empty string to remove previously defined tax amounts. """ tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -152,7 +152,7 @@ class InvoiceAddLinesParamsLinePriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -175,7 +175,7 @@ class InvoiceAddLinesParamsLinePriceDataProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -183,7 +183,7 @@ class InvoiceAddLinesParamsLinePriceDataProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ diff --git a/stripe/params/_invoice_attach_payment_params.py b/stripe/params/_invoice_attach_payment_params.py index 8481bb77d..939c7ba9f 100644 --- a/stripe/params/_invoice_attach_payment_params.py +++ b/stripe/params/_invoice_attach_payment_params.py @@ -41,7 +41,7 @@ class InvoiceAttachPaymentParamsPaymentRecordData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ money_movement_type: str """ diff --git a/stripe/params/_invoice_create_params.py b/stripe/params/_invoice_create_params.py index 683986bb9..738a3da8c 100644 --- a/stripe/params/_invoice_create_params.py +++ b/stripe/params/_invoice_create_params.py @@ -16,11 +16,11 @@ class InvoiceCreateParams(RequestOptions): """ application_fee_amount: NotRequired[int] """ - 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](https://stripe.com/docs/billing/invoices/connect#collecting-fees). + 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](https://docs.stripe.com/billing/invoices/connect#collecting-fees). """ auto_advance: NotRequired[bool] """ - Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. Defaults to false. + Controls whether Stripe performs [automatic collection](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. Defaults to false. """ automatic_tax: NotRequired["InvoiceCreateParamsAutomaticTax"] """ @@ -48,11 +48,11 @@ class InvoiceCreateParams(RequestOptions): """ customer: NotRequired[str] """ - The ID of the customer who will be billed. + The ID of the customer to bill. """ customer_account: NotRequired[str] """ - The ID of the account who will be billed. + The ID of the account to bill. """ days_until_due: NotRequired[int] """ @@ -100,7 +100,7 @@ class InvoiceCreateParams(RequestOptions): """ from_invoice: NotRequired["InvoiceCreateParamsFromInvoice"] """ - Revise an existing invoice. The new invoice will be created in `status=draft`. See the [revision documentation](https://stripe.com/docs/invoicing/invoice-revisions) for more details. + Revise an existing invoice. The new invoice will be created in `status=draft`. See the [revision documentation](https://docs.stripe.com/invoicing/invoice-revisions) for more details. """ issuer: NotRequired["InvoiceCreateParamsIssuer"] """ @@ -108,7 +108,7 @@ class InvoiceCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ number: NotRequired[str] """ @@ -116,7 +116,7 @@ class InvoiceCreateParams(RequestOptions): """ on_behalf_of: NotRequired[str] """ - 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](https://stripe.com/docs/billing/invoices/connect) documentation for details. + 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](https://docs.stripe.com/billing/invoices/connect) documentation for details. """ payment_settings: NotRequired["InvoiceCreateParamsPaymentSettings"] """ @@ -174,7 +174,7 @@ class InvoiceCreateParamsAmountsDue(TypedDict): class InvoiceCreateParamsAutomaticTax(TypedDict): enabled: bool """ - Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. + Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. """ liability: NotRequired["InvoiceCreateParamsAutomaticTaxLiability"] """ @@ -283,7 +283,7 @@ class InvoiceCreateParamsPaymentSettings(TypedDict): Payment-method-specific configuration to provide to the invoice's PaymentIntent. """ payment_method_types: NotRequired[ - "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" + "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'payto', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" ] """ 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](https://dashboard.stripe.com/settings/billing/invoice). @@ -327,6 +327,12 @@ class InvoiceCreateParamsPaymentSettingsPaymentMethodOptions(TypedDict): """ If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: NotRequired[ + "Literal['']|InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPayto" + ] + """ + If paying by `payto`, this sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: NotRequired[ "Literal['']|InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPix" ] @@ -395,13 +401,13 @@ class InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsCard(TypedDict): """ Installment configuration for payments attempted on this invoice. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ request_three_d_secure: NotRequired[ Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ @@ -488,6 +494,42 @@ class InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsKonbini(TypedDict): pass +class InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPayto(TypedDict): + mandate_options: NotRequired[ + "InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions" + ] + """ + Additional fields for Mandate creation. + """ + + +class InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions( + TypedDict, +): + amount: NotRequired[int] + """ + The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit. + """ + purpose: NotRequired[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + class InvoiceCreateParamsPaymentSettingsPaymentMethodOptionsPix(TypedDict): amount_includes_iof: NotRequired[Literal["always", "never"]] """ @@ -652,7 +694,7 @@ class InvoiceCreateParamsShippingCostShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -660,7 +702,7 @@ class InvoiceCreateParamsShippingCostShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ @@ -782,7 +824,7 @@ class InvoiceCreateParamsShippingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_invoice_create_preview_params.py b/stripe/params/_invoice_create_preview_params.py index af2ef90ab..f520f9f9d 100644 --- a/stripe/params/_invoice_create_preview_params.py +++ b/stripe/params/_invoice_create_preview_params.py @@ -12,7 +12,7 @@ class InvoiceCreatePreviewParams(RequestOptions): """ billing_cadence: NotRequired[str] """ - The identifier of the billing cadence for which you'd like to retrieve the upcoming invoice.Cannot be provided when `subscription`, `schedule`, `subscription_details` or `schedule_details` are provided. + The identifier of the billing cadence for which you'd like to retrieve the upcoming invoice. Cannot be provided when `subscription`, `schedule`, `subscription_details` or `schedule_details` are provided. """ currency: NotRequired[str] """ @@ -20,11 +20,11 @@ class InvoiceCreatePreviewParams(RequestOptions): """ customer: NotRequired[str] """ - The identifier of the customer whose upcoming invoice you'd like to retrieve. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set. + The identifier of the customer whose upcoming invoice you're retrieving. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set. """ customer_account: NotRequired[str] """ - The identifier of the account whose upcoming invoice you'd like to retrieve. If `automatic_tax` is enabled then one of `customer`, `customer_account`, `customer_details`, `subscription`, or `schedule` must be set. + The identifier of the account representing the customer whose upcoming invoice you're retrieving. If `automatic_tax` is enabled then one of `customer`, `customer_account`, `customer_details`, `subscription`, or `schedule` must be set. """ customer_details: NotRequired["InvoiceCreatePreviewParamsCustomerDetails"] """ @@ -50,7 +50,7 @@ class InvoiceCreatePreviewParams(RequestOptions): """ on_behalf_of: NotRequired["Literal['']|str"] """ - 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](https://stripe.com/docs/billing/invoices/connect) documentation for details. + 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](https://docs.stripe.com/billing/invoices/connect) documentation for details. """ preview_mode: NotRequired[Literal["next", "recurring"]] """ @@ -79,7 +79,7 @@ class InvoiceCreatePreviewParams(RequestOptions): class InvoiceCreatePreviewParamsAutomaticTax(TypedDict): enabled: bool """ - Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. + Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. """ liability: NotRequired["InvoiceCreatePreviewParamsAutomaticTaxLiability"] """ @@ -103,7 +103,7 @@ class InvoiceCreatePreviewParamsCustomerDetails(TypedDict): "Literal['']|InvoiceCreatePreviewParamsCustomerDetailsAddress" ] """ - The customer's address. + The customer's address. Learn about [country-specific requirements for calculating tax](https://docs.stripe.com/invoicing/taxes?dashboard-or-api=dashboard#set-up-customer). """ shipping: NotRequired[ "Literal['']|InvoiceCreatePreviewParamsCustomerDetailsShipping" @@ -150,7 +150,7 @@ class InvoiceCreatePreviewParamsCustomerDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -192,7 +192,7 @@ class InvoiceCreatePreviewParamsCustomerDetailsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -401,11 +401,11 @@ class InvoiceCreatePreviewParamsInvoiceItem(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["InvoiceCreatePreviewParamsInvoiceItemPeriod"] """ - The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details. + The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details. """ price: NotRequired[str] """ @@ -413,7 +413,7 @@ class InvoiceCreatePreviewParamsInvoiceItem(TypedDict): """ price_data: NotRequired["InvoiceCreatePreviewParamsInvoiceItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -421,11 +421,11 @@ class InvoiceCreatePreviewParamsInvoiceItem(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -514,7 +514,7 @@ class InvoiceCreatePreviewParamsInvoiceItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -883,7 +883,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsAmendmentItemActionAdd( """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: str """ @@ -1189,7 +1189,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhase(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["automatic", "phase_start"]] """ - Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: NotRequired[ "Literal['']|InvoiceCreatePreviewParamsScheduleDetailsPhaseBillingThresholds" @@ -1213,7 +1213,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhase(TypedDict): """ default_tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://stripe.com/docs/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://docs.stripe.com/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. """ description: NotRequired["Literal['']|str"] """ @@ -1233,7 +1233,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhase(TypedDict): """ end_date: NotRequired["int|Literal['now']"] """ - The date at which this phase of the subscription schedule ends. If set, `iterations` must not be set. + The date at which this phase of the subscription schedule ends. If set, `duration` must not be set. """ invoice_settings: NotRequired[ "InvoiceCreatePreviewParamsScheduleDetailsPhaseInvoiceSettings" @@ -1247,7 +1247,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhase(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. """ on_behalf_of: NotRequired[str] """ @@ -1257,13 +1257,13 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhase(TypedDict): "InvoiceCreatePreviewParamsScheduleDetailsPhasePauseCollection" ] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ proration_behavior: NotRequired[ Literal["always_invoice", "create_prorations", "none"] ] """ - Controls whether the subscription schedule should create [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://stripe.com/docs/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. + Controls whether the subscription schedule should create [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://docs.stripe.com/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. """ start_date: NotRequired["int|Literal['now']"] """ @@ -1306,7 +1306,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseAddInvoiceItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired[ "InvoiceCreatePreviewParamsScheduleDetailsPhaseAddInvoiceItemPeriod" @@ -1322,7 +1322,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseAddInvoiceItem(TypedDict): "InvoiceCreatePreviewParamsScheduleDetailsPhaseAddInvoiceItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -1443,7 +1443,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseAddInvoiceItemPriceData( """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -1603,7 +1603,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. """ plan: NotRequired[str] """ @@ -1617,7 +1617,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseItem(TypedDict): "InvoiceCreatePreviewParamsScheduleDetailsPhaseItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ quantity: NotRequired[int] """ @@ -1625,7 +1625,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ trial: NotRequired[ "InvoiceCreatePreviewParamsScheduleDetailsPhaseItemTrial" @@ -1640,7 +1640,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseItemBillingThresholds( ): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -1714,7 +1714,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPhaseItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -1847,7 +1847,7 @@ class InvoiceCreatePreviewParamsScheduleDetailsPrebillingBillUntilDuration( class InvoiceCreatePreviewParamsSubscriptionDetails(TypedDict): billing_cycle_anchor: NotRequired["Literal['now', 'unchanged']|int"] """ - For new subscriptions, a future timestamp to anchor the subscription's [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle). This is used to determine the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to `now` or `unchanged`. + For new subscriptions, a future timestamp to anchor the subscription's [billing cycle](https://docs.stripe.com/subscriptions/billing-cycle). This is used to determine the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to `now` or `unchanged`. """ billing_mode: NotRequired[ "InvoiceCreatePreviewParamsSubscriptionDetailsBillingMode" @@ -1895,7 +1895,7 @@ class InvoiceCreatePreviewParamsSubscriptionDetails(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. """ proration_date: NotRequired[int] """ @@ -2030,7 +2030,7 @@ class InvoiceCreatePreviewParamsSubscriptionDetailsItem(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ plan: NotRequired[str] """ @@ -2044,7 +2044,7 @@ class InvoiceCreatePreviewParamsSubscriptionDetailsItem(TypedDict): "InvoiceCreatePreviewParamsSubscriptionDetailsItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -2052,7 +2052,7 @@ class InvoiceCreatePreviewParamsSubscriptionDetailsItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ @@ -2061,7 +2061,7 @@ class InvoiceCreatePreviewParamsSubscriptionDetailsItemBillingThresholds( ): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -2135,7 +2135,7 @@ class InvoiceCreatePreviewParamsSubscriptionDetailsItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_invoice_finalize_invoice_params.py b/stripe/params/_invoice_finalize_invoice_params.py index 14613f6eb..95d5c92bc 100644 --- a/stripe/params/_invoice_finalize_invoice_params.py +++ b/stripe/params/_invoice_finalize_invoice_params.py @@ -8,7 +8,7 @@ class InvoiceFinalizeInvoiceParams(RequestOptions): auto_advance: NotRequired[bool] """ - Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. + Controls whether Stripe performs [automatic collection](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection) of the invoice. If `false`, the invoice's state doesn't automatically advance without an explicit action. """ expand: NotRequired[List[str]] """ diff --git a/stripe/params/_invoice_item_create_params.py b/stripe/params/_invoice_item_create_params.py index 4dd9acdb1..8973bd53a 100644 --- a/stripe/params/_invoice_item_create_params.py +++ b/stripe/params/_invoice_item_create_params.py @@ -16,11 +16,11 @@ class InvoiceItemCreateParams(RequestOptions): """ customer: NotRequired[str] """ - The ID of the customer who will be billed when this invoice item is billed. + The ID of the customer to bill for this invoice item. """ customer_account: NotRequired[str] """ - The ID of the account who will be billed when this invoice item is billed. + The ID of the account representing the customer to bill for this invoice item. """ description: NotRequired[str] """ @@ -48,15 +48,15 @@ class InvoiceItemCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["InvoiceItemCreateParamsPeriod"] """ - The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details. + The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details. """ price_data: NotRequired["InvoiceItemCreateParamsPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ pricing: NotRequired["InvoiceItemCreateParamsPricing"] """ @@ -72,11 +72,11 @@ class InvoiceItemCreateParams(RequestOptions): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ tax_rates: NotRequired[List[str]] """ @@ -155,7 +155,7 @@ class InvoiceItemCreateParamsPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_invoice_item_list_params.py b/stripe/params/_invoice_item_list_params.py index 2febdaaec..20df34a7b 100644 --- a/stripe/params/_invoice_item_list_params.py +++ b/stripe/params/_invoice_item_list_params.py @@ -12,11 +12,11 @@ class InvoiceItemListParams(RequestOptions): """ customer: NotRequired[str] """ - The identifier of the customer whose invoice items to return. If none is provided, all invoice items will be returned. + The identifier of the customer whose invoice items to return. If none is provided, returns all invoice items. """ customer_account: NotRequired[str] """ - The identifier of the account whose invoice items to return. If none is provided, all invoice items will be returned. + The identifier of the account representing the customer whose invoice items to return. If none is provided, returns all invoice items. """ ending_before: NotRequired[str] """ diff --git a/stripe/params/_invoice_item_modify_params.py b/stripe/params/_invoice_item_modify_params.py index e8eb0d87c..6a6623db4 100644 --- a/stripe/params/_invoice_item_modify_params.py +++ b/stripe/params/_invoice_item_modify_params.py @@ -32,15 +32,15 @@ class InvoiceItemModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["InvoiceItemModifyParamsPeriod"] """ - The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details. + The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details. """ price_data: NotRequired["InvoiceItemModifyParamsPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ pricing: NotRequired["InvoiceItemModifyParamsPricing"] """ @@ -52,11 +52,11 @@ class InvoiceItemModifyParams(RequestOptions): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -135,7 +135,7 @@ class InvoiceItemModifyParamsPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_invoice_item_update_params.py b/stripe/params/_invoice_item_update_params.py index 8d6baabbf..f10d2bef8 100644 --- a/stripe/params/_invoice_item_update_params.py +++ b/stripe/params/_invoice_item_update_params.py @@ -31,15 +31,15 @@ class InvoiceItemUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["InvoiceItemUpdateParamsPeriod"] """ - The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details. + The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details. """ price_data: NotRequired["InvoiceItemUpdateParamsPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ pricing: NotRequired["InvoiceItemUpdateParamsPricing"] """ @@ -51,11 +51,11 @@ class InvoiceItemUpdateParams(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -134,7 +134,7 @@ class InvoiceItemUpdateParamsPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_invoice_line_item_update_params.py b/stripe/params/_invoice_line_item_update_params.py index 96fd03d7c..31fc52d74 100644 --- a/stripe/params/_invoice_line_item_update_params.py +++ b/stripe/params/_invoice_line_item_update_params.py @@ -33,15 +33,15 @@ class InvoiceLineItemUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For [type=subscription](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For [type=subscription](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data. """ period: NotRequired["InvoiceLineItemUpdateParamsPeriod"] """ - The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details. + The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details. """ price_data: NotRequired["InvoiceLineItemUpdateParamsPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ pricing: NotRequired["InvoiceLineItemUpdateParamsPricing"] """ @@ -55,7 +55,7 @@ class InvoiceLineItemUpdateParams(TypedDict): "Literal['']|List[InvoiceLineItemUpdateParamsTaxAmount]" ] """ - A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://stripe.com/docs/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://stripe.com/docs/tax/invoicing). Pass an empty string to remove previously defined tax amounts. + A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://docs.stripe.com/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://docs.stripe.com/tax/invoicing). Pass an empty string to remove previously defined tax amounts. """ tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -138,7 +138,7 @@ class InvoiceLineItemUpdateParamsPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -161,7 +161,7 @@ class InvoiceLineItemUpdateParamsPriceDataProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -169,7 +169,7 @@ class InvoiceLineItemUpdateParamsPriceDataProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ diff --git a/stripe/params/_invoice_list_params.py b/stripe/params/_invoice_list_params.py index 5329db5d1..6e7a934b3 100644 --- a/stripe/params/_invoice_list_params.py +++ b/stripe/params/_invoice_list_params.py @@ -22,7 +22,7 @@ class InvoiceListParams(RequestOptions): """ customer_account: NotRequired[str] """ - Only return invoices for the account specified by this account ID. + Only return invoices for the account representing the customer specified by this account ID. """ due_date: NotRequired["InvoiceListParamsDueDate|int"] ending_before: NotRequired[str] @@ -45,7 +45,7 @@ class InvoiceListParams(RequestOptions): Literal["draft", "open", "paid", "uncollectible", "void"] ] """ - The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://stripe.com/docs/billing/invoices/workflow#workflow-overview) + The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://docs.stripe.com/billing/invoices/workflow#workflow-overview) """ subscription: NotRequired[str] """ diff --git a/stripe/params/_invoice_modify_params.py b/stripe/params/_invoice_modify_params.py index c6e4d8622..f4cfc7275 100644 --- a/stripe/params/_invoice_modify_params.py +++ b/stripe/params/_invoice_modify_params.py @@ -16,11 +16,11 @@ class InvoiceModifyParams(RequestOptions): """ application_fee_amount: NotRequired[int] """ - 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](https://stripe.com/docs/billing/invoices/connect#collecting-fees). + 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](https://docs.stripe.com/billing/invoices/connect#collecting-fees). """ auto_advance: NotRequired[bool] """ - Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. + Controls whether Stripe performs [automatic collection](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection) of the invoice. """ automatic_tax: NotRequired["InvoiceModifyParamsAutomaticTax"] """ @@ -92,7 +92,7 @@ class InvoiceModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ number: NotRequired["Literal['']|str"] """ @@ -100,7 +100,7 @@ class InvoiceModifyParams(RequestOptions): """ on_behalf_of: NotRequired["Literal['']|str"] """ - 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](https://stripe.com/docs/billing/invoices/connect) documentation for details. + 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](https://docs.stripe.com/billing/invoices/connect) documentation for details. """ payment_settings: NotRequired["InvoiceModifyParamsPaymentSettings"] """ @@ -152,7 +152,7 @@ class InvoiceModifyParamsAmountsDue(TypedDict): class InvoiceModifyParamsAutomaticTax(TypedDict): enabled: bool """ - Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. + Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. """ liability: NotRequired["InvoiceModifyParamsAutomaticTaxLiability"] """ @@ -250,7 +250,7 @@ class InvoiceModifyParamsPaymentSettings(TypedDict): Payment-method-specific configuration to provide to the invoice's PaymentIntent. """ payment_method_types: NotRequired[ - "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" + "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'payto', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" ] """ 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](https://dashboard.stripe.com/settings/billing/invoice). @@ -294,6 +294,12 @@ class InvoiceModifyParamsPaymentSettingsPaymentMethodOptions(TypedDict): """ If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: NotRequired[ + "Literal['']|InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPayto" + ] + """ + If paying by `payto`, this sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: NotRequired[ "Literal['']|InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPix" ] @@ -362,13 +368,13 @@ class InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsCard(TypedDict): """ Installment configuration for payments attempted on this invoice. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ request_three_d_secure: NotRequired[ Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ @@ -455,6 +461,42 @@ class InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsKonbini(TypedDict): pass +class InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPayto(TypedDict): + mandate_options: NotRequired[ + "InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions" + ] + """ + Additional fields for Mandate creation. + """ + + +class InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions( + TypedDict, +): + amount: NotRequired[int] + """ + The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit. + """ + purpose: NotRequired[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + class InvoiceModifyParamsPaymentSettingsPaymentMethodOptionsPix(TypedDict): amount_includes_iof: NotRequired[Literal["always", "never"]] """ @@ -619,7 +661,7 @@ class InvoiceModifyParamsShippingCostShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -627,7 +669,7 @@ class InvoiceModifyParamsShippingCostShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ @@ -749,7 +791,7 @@ class InvoiceModifyParamsShippingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_invoice_remove_lines_params.py b/stripe/params/_invoice_remove_lines_params.py index b6796164e..b89b8b543 100644 --- a/stripe/params/_invoice_remove_lines_params.py +++ b/stripe/params/_invoice_remove_lines_params.py @@ -12,7 +12,7 @@ class InvoiceRemoveLinesParams(RequestOptions): """ invoice_metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ lines: List["InvoiceRemoveLinesParamsLine"] """ diff --git a/stripe/params/_invoice_search_params.py b/stripe/params/_invoice_search_params.py index 1ee516f8f..f43214b34 100644 --- a/stripe/params/_invoice_search_params.py +++ b/stripe/params/_invoice_search_params.py @@ -20,5 +20,5 @@ class InvoiceSearchParams(RequestOptions): """ query: str """ - The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for invoices](https://stripe.com/docs/search#query-fields-for-invoices). + The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for invoices](https://docs.stripe.com/search#query-fields-for-invoices). """ diff --git a/stripe/params/_invoice_update_lines_params.py b/stripe/params/_invoice_update_lines_params.py index 2c9ce811c..c8ebf3e53 100644 --- a/stripe/params/_invoice_update_lines_params.py +++ b/stripe/params/_invoice_update_lines_params.py @@ -12,7 +12,7 @@ class InvoiceUpdateLinesParams(RequestOptions): """ invoice_metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For [type=subscription](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For [type=subscription](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data. """ lines: List["InvoiceUpdateLinesParamsLine"] """ @@ -49,15 +49,15 @@ class InvoiceUpdateLinesParamsLine(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For [type=subscription](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. For [type=subscription](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-type) line items, the incoming metadata specified on the request is directly used to set this value, in contrast to [type=invoiceitem](api/invoices/line_item#invoice_line_item_object-type) line items, where any existing metadata on the invoice line is merged with the incoming data. """ period: NotRequired["InvoiceUpdateLinesParamsLinePeriod"] """ - The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details. + The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details. """ price_data: NotRequired["InvoiceUpdateLinesParamsLinePriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ pricing: NotRequired["InvoiceUpdateLinesParamsLinePricing"] """ @@ -71,7 +71,7 @@ class InvoiceUpdateLinesParamsLine(TypedDict): "Literal['']|List[InvoiceUpdateLinesParamsLineTaxAmount]" ] """ - A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://stripe.com/docs/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://stripe.com/docs/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://stripe.com/docs/tax/invoicing). Pass an empty string to remove previously defined tax amounts. + A list of up to 10 tax amounts for this line item. This can be useful if you calculate taxes on your own or use a third-party to calculate them. You cannot set tax amounts if any line item has [tax_rates](https://docs.stripe.com/api/invoices/line_item#invoice_line_item_object-tax_rates) or if the invoice has [default_tax_rates](https://docs.stripe.com/api/invoices/object#invoice_object-default_tax_rates) or uses [automatic tax](https://docs.stripe.com/tax/invoicing). Pass an empty string to remove previously defined tax amounts. """ tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -156,7 +156,7 @@ class InvoiceUpdateLinesParamsLinePriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -179,7 +179,7 @@ class InvoiceUpdateLinesParamsLinePriceDataProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -187,7 +187,7 @@ class InvoiceUpdateLinesParamsLinePriceDataProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ diff --git a/stripe/params/_invoice_update_params.py b/stripe/params/_invoice_update_params.py index 961d72f89..c80d7e771 100644 --- a/stripe/params/_invoice_update_params.py +++ b/stripe/params/_invoice_update_params.py @@ -15,11 +15,11 @@ class InvoiceUpdateParams(TypedDict): """ application_fee_amount: NotRequired[int] """ - 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](https://stripe.com/docs/billing/invoices/connect#collecting-fees). + 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](https://docs.stripe.com/billing/invoices/connect#collecting-fees). """ auto_advance: NotRequired[bool] """ - Controls whether Stripe performs [automatic collection](https://stripe.com/docs/invoicing/integration/automatic-advancement-collection) of the invoice. + Controls whether Stripe performs [automatic collection](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection) of the invoice. """ automatic_tax: NotRequired["InvoiceUpdateParamsAutomaticTax"] """ @@ -91,7 +91,7 @@ class InvoiceUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ number: NotRequired["Literal['']|str"] """ @@ -99,7 +99,7 @@ class InvoiceUpdateParams(TypedDict): """ on_behalf_of: NotRequired["Literal['']|str"] """ - 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](https://stripe.com/docs/billing/invoices/connect) documentation for details. + 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](https://docs.stripe.com/billing/invoices/connect) documentation for details. """ payment_settings: NotRequired["InvoiceUpdateParamsPaymentSettings"] """ @@ -151,7 +151,7 @@ class InvoiceUpdateParamsAmountsDue(TypedDict): class InvoiceUpdateParamsAutomaticTax(TypedDict): enabled: bool """ - Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. + Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices. """ liability: NotRequired["InvoiceUpdateParamsAutomaticTaxLiability"] """ @@ -249,7 +249,7 @@ class InvoiceUpdateParamsPaymentSettings(TypedDict): Payment-method-specific configuration to provide to the invoice's PaymentIntent. """ payment_method_types: NotRequired[ - "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" + "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'payto', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" ] """ 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](https://dashboard.stripe.com/settings/billing/invoice). @@ -293,6 +293,12 @@ class InvoiceUpdateParamsPaymentSettingsPaymentMethodOptions(TypedDict): """ If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: NotRequired[ + "Literal['']|InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPayto" + ] + """ + If paying by `payto`, this sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: NotRequired[ "Literal['']|InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPix" ] @@ -361,13 +367,13 @@ class InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsCard(TypedDict): """ Installment configuration for payments attempted on this invoice. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ request_three_d_secure: NotRequired[ Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ @@ -454,6 +460,42 @@ class InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsKonbini(TypedDict): pass +class InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPayto(TypedDict): + mandate_options: NotRequired[ + "InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions" + ] + """ + Additional fields for Mandate creation. + """ + + +class InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions( + TypedDict, +): + amount: NotRequired[int] + """ + The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit. + """ + purpose: NotRequired[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + class InvoiceUpdateParamsPaymentSettingsPaymentMethodOptionsPix(TypedDict): amount_includes_iof: NotRequired[Literal["always", "never"]] """ @@ -618,7 +660,7 @@ class InvoiceUpdateParamsShippingCostShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -626,7 +668,7 @@ class InvoiceUpdateParamsShippingCostShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ @@ -748,7 +790,7 @@ class InvoiceUpdateParamsShippingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_mandate_list_params.py b/stripe/params/_mandate_list_params.py index f92b5ab4d..69bc69f1a 100644 --- a/stripe/params/_mandate_list_params.py +++ b/stripe/params/_mandate_list_params.py @@ -20,7 +20,7 @@ class MandateListParams(RequestOptions): """ on_behalf_of: NotRequired[str] """ - The Stripe account ID that the mandates are intended for. Learn more about the [use case for connected accounts payments](https://stripe.com/docs/payments/connected-accounts). + The Stripe account ID that the mandates are intended for. Learn more about the [use case for connected accounts payments](https://docs.stripe.com/payments/connected-accounts). """ payment_method: str starting_after: NotRequired[str] diff --git a/stripe/params/_margin_create_params.py b/stripe/params/_margin_create_params.py index 2869defba..457d9f5ca 100644 --- a/stripe/params/_margin_create_params.py +++ b/stripe/params/_margin_create_params.py @@ -16,7 +16,7 @@ class MarginCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/_margin_modify_params.py b/stripe/params/_margin_modify_params.py index 3c24d2a19..d0bc27a56 100644 --- a/stripe/params/_margin_modify_params.py +++ b/stripe/params/_margin_modify_params.py @@ -16,7 +16,7 @@ class MarginModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/_margin_update_params.py b/stripe/params/_margin_update_params.py index e1594e34d..ff9827747 100644 --- a/stripe/params/_margin_update_params.py +++ b/stripe/params/_margin_update_params.py @@ -15,7 +15,7 @@ class MarginUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/_order_create_params.py b/stripe/params/_order_create_params.py index c4175e43f..607e35e6d 100644 --- a/stripe/params/_order_create_params.py +++ b/stripe/params/_order_create_params.py @@ -44,7 +44,7 @@ class OrderCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment: NotRequired["OrderCreateParamsPayment"] """ @@ -207,7 +207,7 @@ class OrderCreateParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -236,7 +236,7 @@ class OrderCreateParamsLineItemProductData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -254,7 +254,7 @@ class OrderCreateParamsLineItemProductData(TypedDict): """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ url: NotRequired["Literal['']|str"] """ @@ -327,7 +327,7 @@ class OrderCreateParamsPaymentSettings(TypedDict): ] ] """ - The list of [payment method types](https://stripe.com/docs/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). + The list of [payment method types](https://docs.stripe.com/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). """ return_url: NotRequired[str] """ @@ -515,9 +515,9 @@ class OrderCreateParamsPaymentSettingsPaymentMethodOptionsAfterpayClearpay( """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -576,9 +576,9 @@ class OrderCreateParamsPaymentSettingsPaymentMethodOptionsCard(TypedDict): """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -2019,7 +2019,7 @@ class OrderCreateParamsPaymentSettingsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -2232,7 +2232,7 @@ class OrderCreateParamsShippingCostShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -2240,7 +2240,7 @@ class OrderCreateParamsShippingCostShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ diff --git a/stripe/params/_order_modify_params.py b/stripe/params/_order_modify_params.py index cf01e7df3..d7b3ab823 100644 --- a/stripe/params/_order_modify_params.py +++ b/stripe/params/_order_modify_params.py @@ -44,7 +44,7 @@ class OrderModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment: NotRequired["OrderModifyParamsPayment"] """ @@ -211,7 +211,7 @@ class OrderModifyParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -240,7 +240,7 @@ class OrderModifyParamsLineItemProductData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -258,7 +258,7 @@ class OrderModifyParamsLineItemProductData(TypedDict): """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ url: NotRequired["Literal['']|str"] """ @@ -331,7 +331,7 @@ class OrderModifyParamsPaymentSettings(TypedDict): ] ] """ - The list of [payment method types](https://stripe.com/docs/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). + The list of [payment method types](https://docs.stripe.com/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). """ return_url: NotRequired["Literal['']|str"] """ @@ -523,9 +523,9 @@ class OrderModifyParamsPaymentSettingsPaymentMethodOptionsAfterpayClearpay( """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -584,9 +584,9 @@ class OrderModifyParamsPaymentSettingsPaymentMethodOptionsCard(TypedDict): """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -2027,7 +2027,7 @@ class OrderModifyParamsPaymentSettingsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -2240,7 +2240,7 @@ class OrderModifyParamsShippingCostShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -2248,7 +2248,7 @@ class OrderModifyParamsShippingCostShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ diff --git a/stripe/params/_order_update_params.py b/stripe/params/_order_update_params.py index 5f0d32b71..d376ae0ac 100644 --- a/stripe/params/_order_update_params.py +++ b/stripe/params/_order_update_params.py @@ -43,7 +43,7 @@ class OrderUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment: NotRequired["OrderUpdateParamsPayment"] """ @@ -210,7 +210,7 @@ class OrderUpdateParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -239,7 +239,7 @@ class OrderUpdateParamsLineItemProductData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -257,7 +257,7 @@ class OrderUpdateParamsLineItemProductData(TypedDict): """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ url: NotRequired["Literal['']|str"] """ @@ -330,7 +330,7 @@ class OrderUpdateParamsPaymentSettings(TypedDict): ] ] """ - The list of [payment method types](https://stripe.com/docs/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). + The list of [payment method types](https://docs.stripe.com/payments/payment-methods/overview) to provide to the order's PaymentIntent. Do not include this attribute if you prefer to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). """ return_url: NotRequired["Literal['']|str"] """ @@ -522,9 +522,9 @@ class OrderUpdateParamsPaymentSettingsPaymentMethodOptionsAfterpayClearpay( """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -583,9 +583,9 @@ class OrderUpdateParamsPaymentSettingsPaymentMethodOptionsCard(TypedDict): """ Indicates that you intend to make future payments with the payment method. - Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes. + Providing this parameter will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the order's Customer, if present, after the order's PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://docs.stripe.com/api/payment_methods/attach) to a Customer after the transaction completes. - When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication). + When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication). If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`. """ @@ -2026,7 +2026,7 @@ class OrderUpdateParamsPaymentSettingsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -2239,7 +2239,7 @@ class OrderUpdateParamsShippingCostShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -2247,7 +2247,7 @@ class OrderUpdateParamsShippingCostShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ diff --git a/stripe/params/_payment_intent_apply_customer_balance_params.py b/stripe/params/_payment_intent_apply_customer_balance_params.py index f3f3b05cc..ec70e53ca 100644 --- a/stripe/params/_payment_intent_apply_customer_balance_params.py +++ b/stripe/params/_payment_intent_apply_customer_balance_params.py @@ -10,7 +10,7 @@ class PaymentIntentApplyCustomerBalanceParams(RequestOptions): """ Amount that you intend to apply to this PaymentIntent from the customer's cash balance. If the PaymentIntent was created by an Invoice, the full amount of the PaymentIntent is applied regardless of this parameter. - A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (for example, 100 cents to charge 1 USD or 100 to charge 100 JPY, a zero-decimal currency). The maximum amount is the amount of the PaymentIntent. + A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (for example, 100 cents to charge 1 USD or 100 to charge 100 JPY, a zero-decimal currency). The maximum amount is the amount of the PaymentIntent. When you omit the amount, it defaults to the remaining amount requested on the PaymentIntent. """ diff --git a/stripe/params/_payment_intent_capture_params.py b/stripe/params/_payment_intent_capture_params.py index 2f1b43afb..0996155e8 100644 --- a/stripe/params/_payment_intent_capture_params.py +++ b/stripe/params/_payment_intent_capture_params.py @@ -16,7 +16,7 @@ class PaymentIntentCaptureParams(RequestOptions): """ application_fee_amount: NotRequired[int] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ expand: NotRequired[List[str]] """ @@ -24,7 +24,7 @@ class PaymentIntentCaptureParams(RequestOptions): """ final_capture: NotRequired[bool] """ - Defaults to `true`. When capturing a PaymentIntent, setting `final_capture` to `false` notifies Stripe to not release the remaining uncaptured funds to make sure that they're captured in future requests. You can only use this setting when [multicapture](https://stripe.com/docs/payments/multicapture) is available for PaymentIntents. + Defaults to `true`. When capturing a PaymentIntent, setting `final_capture` to `false` notifies Stripe to not release the remaining uncaptured funds to make sure that they're captured in future requests. You can only use this setting when [multicapture](https://docs.stripe.com/payments/multicapture) is available for PaymentIntents. """ hooks: NotRequired["PaymentIntentCaptureParamsHooks"] """ @@ -32,7 +32,7 @@ class PaymentIntentCaptureParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_details: NotRequired[ "Literal['']|PaymentIntentCaptureParamsPaymentDetails" @@ -53,14 +53,14 @@ class PaymentIntentCaptureParams(RequestOptions): transfer_data: NotRequired["PaymentIntentCaptureParamsTransferData"] """ The parameters that you can use to automatically create a transfer after the payment - is captured. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + is captured. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ class PaymentIntentCaptureParamsAmountDetails(TypedDict): discount_amount: NotRequired["Literal['']|int"] """ - The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field. """ @@ -68,7 +68,7 @@ class PaymentIntentCaptureParamsAmountDetails(TypedDict): "Literal['']|List[PaymentIntentCaptureParamsAmountDetailsLineItem]" ] """ - A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items. + A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items. """ shipping: NotRequired[ "Literal['']|PaymentIntentCaptureParamsAmountDetailsShipping" @@ -85,7 +85,7 @@ class PaymentIntentCaptureParamsAmountDetails(TypedDict): class PaymentIntentCaptureParamsAmountDetailsLineItem(TypedDict): discount_amount: NotRequired[int] """ - The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The discount applied on this line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[discount_amount]` field. """ @@ -115,7 +115,7 @@ class PaymentIntentCaptureParamsAmountDetailsLineItem(TypedDict): """ unit_cost: int """ - The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. """ unit_of_measure: NotRequired[str] """ @@ -213,7 +213,7 @@ class PaymentIntentCaptureParamsAmountDetailsLineItemPaymentMethodOptionsPaypal( class PaymentIntentCaptureParamsAmountDetailsLineItemTax(TypedDict): total_tax_amount: int """ - The total amount of tax on a single line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The total amount of tax on a single line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[tax][total_tax_amount]` field. """ @@ -222,7 +222,7 @@ class PaymentIntentCaptureParamsAmountDetailsLineItemTax(TypedDict): class PaymentIntentCaptureParamsAmountDetailsShipping(TypedDict): amount: NotRequired["Literal['']|int"] """ - If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0. + If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0. """ from_postal_code: NotRequired["Literal['']|str"] """ @@ -237,7 +237,7 @@ class PaymentIntentCaptureParamsAmountDetailsShipping(TypedDict): class PaymentIntentCaptureParamsAmountDetailsTax(TypedDict): total_tax_amount: int """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ @@ -260,7 +260,7 @@ class PaymentIntentCaptureParamsHooksInputs(TypedDict): class PaymentIntentCaptureParamsHooksInputsTax(TypedDict): calculation: Union[Literal[""], str] """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ @@ -534,7 +534,7 @@ class PaymentIntentCaptureParamsPaymentDetailsCarRentalPickupAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -563,7 +563,7 @@ class PaymentIntentCaptureParamsPaymentDetailsCarRentalReturnAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -742,7 +742,7 @@ class PaymentIntentCaptureParamsPaymentDetailsCarRentalDatumDropOffAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -816,7 +816,7 @@ class PaymentIntentCaptureParamsPaymentDetailsCarRentalDatumPickupAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1070,7 +1070,7 @@ class PaymentIntentCaptureParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1664,7 +1664,7 @@ class PaymentIntentCaptureParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1907,7 +1907,7 @@ class PaymentIntentCaptureParamsPaymentDetailsLodgingDatumHostAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_intent_confirm_params.py b/stripe/params/_payment_intent_confirm_params.py index ff8607df0..b95dbd21a 100644 --- a/stripe/params/_payment_intent_confirm_params.py +++ b/stripe/params/_payment_intent_confirm_params.py @@ -14,7 +14,7 @@ class PaymentIntentConfirmParams(RequestOptions): """ application_fee_amount: NotRequired["Literal['']|int"] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ capture_method: NotRequired[ Literal["automatic", "automatic_async", "manual"] @@ -30,7 +30,7 @@ class PaymentIntentConfirmParams(RequestOptions): """ error_on_requires_action: NotRequired[bool] """ - Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. This parameter is intended for simpler integrations that do not handle customer actions, like [saving cards without authentication](https://stripe.com/docs/payments/save-card-without-authentication). + Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. This parameter is intended for simpler integrations that do not handle customer actions, like [saving cards without authentication](https://docs.stripe.com/payments/save-card-without-authentication). """ excluded_payment_method_types: NotRequired[ "Literal['']|List[Literal['acss_debit', 'affirm', 'afterpay_clearpay', 'alipay', 'alma', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'billie', 'blik', 'boleto', 'card', 'cashapp', 'crypto', 'customer_balance', 'eps', 'fpx', 'giropay', 'gopay', 'grabpay', 'id_bank_transfer', 'ideal', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'mb_way', 'mobilepay', 'multibanco', 'naver_pay', 'nz_bank_account', 'oxxo', 'p24', 'pay_by_bank', 'payco', 'paynow', 'paypal', 'paypay', 'payto', 'pix', 'promptpay', 'qris', 'rechnung', 'revolut_pay', 'samsung_pay', 'satispay', 'sepa_debit', 'shopeepay', 'sofort', 'stripe_balance', 'swish', 'twint', 'us_bank_account', 'wechat_pay', 'zip']]" @@ -59,7 +59,7 @@ class PaymentIntentConfirmParams(RequestOptions): ] off_session: NotRequired["bool|Literal['one_off', 'recurring']"] """ - Set to `true` to indicate that the customer isn't in your checkout flow during this payment attempt and can't authenticate. Use this parameter in scenarios where you collect card details and [charge them later](https://stripe.com/docs/payments/cards/charging-saved-cards). + Set to `true` to indicate that the customer isn't in your checkout flow during this payment attempt and can't authenticate. Use this parameter in scenarios where you collect card details and [charge them later](https://docs.stripe.com/payments/cards/charging-saved-cards). """ payment_details: NotRequired[ "Literal['']|PaymentIntentConfirmParamsPaymentDetails" @@ -69,15 +69,15 @@ class PaymentIntentConfirmParams(RequestOptions): """ payment_method: NotRequired[str] """ - ID of the payment method (a PaymentMethod, Card, or [compatible Source](https://stripe.com/docs/payments/payment-methods/transitioning#compatibility) object) to attach to this PaymentIntent. - If the payment method is attached to a Customer, it must match the [customer](https://stripe.com/docs/api#create_payment_intent-customer) that is set on this PaymentIntent. + ID of the payment method (a PaymentMethod, Card, or [compatible Source](https://docs.stripe.com/payments/payment-methods/transitioning#compatibility) object) to attach to this PaymentIntent. + If the payment method is attached to a Customer, it must match the [customer](https://api.stripe.com#create_payment_intent-customer) that is set on this PaymentIntent. """ payment_method_data: NotRequired[ "PaymentIntentConfirmParamsPaymentMethodData" ] """ If provided, this hash will be used to create a PaymentMethod. The new PaymentMethod will appear - in the [payment_method](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method) + in the [payment_method](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-payment_method) property on the PaymentIntent. """ payment_method_options: NotRequired[ @@ -92,7 +92,7 @@ class PaymentIntentConfirmParams(RequestOptions): """ radar_options: NotRequired["PaymentIntentConfirmParamsRadarOptions"] """ - Options to configure Radar. Learn more about [Radar Sessions](https://stripe.com/docs/radar/radar-session). + Options to configure Radar. Learn more about [Radar Sessions](https://docs.stripe.com/radar/radar-session). """ receipt_email: NotRequired["Literal['']|str"] """ @@ -131,7 +131,7 @@ class PaymentIntentConfirmParams(RequestOptions): class PaymentIntentConfirmParamsAmountDetails(TypedDict): discount_amount: NotRequired["Literal['']|int"] """ - The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field. """ @@ -139,7 +139,7 @@ class PaymentIntentConfirmParamsAmountDetails(TypedDict): "Literal['']|List[PaymentIntentConfirmParamsAmountDetailsLineItem]" ] """ - A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items. + A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items. """ shipping: NotRequired[ "Literal['']|PaymentIntentConfirmParamsAmountDetailsShipping" @@ -156,7 +156,7 @@ class PaymentIntentConfirmParamsAmountDetails(TypedDict): class PaymentIntentConfirmParamsAmountDetailsLineItem(TypedDict): discount_amount: NotRequired[int] """ - The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The discount applied on this line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[discount_amount]` field. """ @@ -186,7 +186,7 @@ class PaymentIntentConfirmParamsAmountDetailsLineItem(TypedDict): """ unit_cost: int """ - The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. """ unit_of_measure: NotRequired[str] """ @@ -284,7 +284,7 @@ class PaymentIntentConfirmParamsAmountDetailsLineItemPaymentMethodOptionsPaypal( class PaymentIntentConfirmParamsAmountDetailsLineItemTax(TypedDict): total_tax_amount: int """ - The total amount of tax on a single line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The total amount of tax on a single line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[tax][total_tax_amount]` field. """ @@ -293,7 +293,7 @@ class PaymentIntentConfirmParamsAmountDetailsLineItemTax(TypedDict): class PaymentIntentConfirmParamsAmountDetailsShipping(TypedDict): amount: NotRequired["Literal['']|int"] """ - If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0. + If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0. """ from_postal_code: NotRequired["Literal['']|str"] """ @@ -308,7 +308,7 @@ class PaymentIntentConfirmParamsAmountDetailsShipping(TypedDict): class PaymentIntentConfirmParamsAmountDetailsTax(TypedDict): total_tax_amount: int """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ @@ -331,7 +331,7 @@ class PaymentIntentConfirmParamsHooksInputs(TypedDict): class PaymentIntentConfirmParamsHooksInputsTax(TypedDict): calculation: Union[Literal[""], str] """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ @@ -654,7 +654,7 @@ class PaymentIntentConfirmParamsPaymentDetailsCarRentalPickupAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -683,7 +683,7 @@ class PaymentIntentConfirmParamsPaymentDetailsCarRentalReturnAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -862,7 +862,7 @@ class PaymentIntentConfirmParamsPaymentDetailsCarRentalDatumDropOffAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -936,7 +936,7 @@ class PaymentIntentConfirmParamsPaymentDetailsCarRentalDatumPickupAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1190,7 +1190,7 @@ class PaymentIntentConfirmParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1784,7 +1784,7 @@ class PaymentIntentConfirmParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2027,7 +2027,7 @@ class PaymentIntentConfirmParamsPaymentDetailsLodgingDatumHostAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2351,7 +2351,7 @@ class PaymentIntentConfirmParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired[ "PaymentIntentConfirmParamsPaymentMethodDataMobilepay" @@ -2429,7 +2429,7 @@ class PaymentIntentConfirmParamsPaymentMethodData(TypedDict): "PaymentIntentConfirmParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired[ "PaymentIntentConfirmParamsPaymentMethodDataRechnung" @@ -2679,7 +2679,7 @@ class PaymentIntentConfirmParamsPaymentMethodDataBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2808,6 +2808,7 @@ class PaymentIntentConfirmParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -3000,7 +3001,7 @@ class PaymentIntentConfirmParamsPaymentMethodDataQris(TypedDict): class PaymentIntentConfirmParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -3775,7 +3776,7 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsCard(TypedDict): """ Installment configuration for payments attempted on this PaymentIntent. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ mandate_options: NotRequired[ "PaymentIntentConfirmParamsPaymentMethodOptionsCardMandateOptions" @@ -3813,27 +3814,27 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsCard(TypedDict): Literal["if_available", "never"] ] """ - Request ability to [decrement the authorization](https://stripe.com/docs/payments/decremental-authorization) for this PaymentIntent. + Request ability to [decrement the authorization](https://docs.stripe.com/payments/decremental-authorization) for this PaymentIntent. """ request_extended_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [capture beyond the standard authorization validity window](https://stripe.com/docs/payments/extended-authorization) for this PaymentIntent. + Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this PaymentIntent. """ request_incremental_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [increment the authorization](https://stripe.com/docs/payments/incremental-authorization) for this PaymentIntent. + Request ability to [increment the authorization](https://docs.stripe.com/payments/incremental-authorization) for this PaymentIntent. """ request_multicapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to make [multiple captures](https://stripe.com/docs/payments/multicapture) for this PaymentIntent. + Request ability to make [multiple captures](https://docs.stripe.com/payments/multicapture) for this PaymentIntent. """ request_overcapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to [overcapture](https://stripe.com/docs/payments/overcapture) for this PaymentIntent. + Request ability to [overcapture](https://docs.stripe.com/payments/overcapture) for this PaymentIntent. """ request_partial_authorization: NotRequired[ Literal["if_available", "never"] @@ -3845,7 +3846,7 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ require_cvc_recollection: NotRequired[bool] """ @@ -4005,7 +4006,7 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsCardStatementDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -4103,11 +4104,11 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsCardPresent(TypedDict): """ request_extended_authorization: NotRequired[bool] """ - Request ability to capture this payment beyond the standard [authorization validity window](https://stripe.com/docs/terminal/features/extended-authorizations#authorization-validity) + Request ability to capture this payment beyond the standard [authorization validity window](https://docs.stripe.com/terminal/features/extended-authorizations#authorization-validity) """ request_incremental_authorization_support: NotRequired[bool] """ - Request ability to [increment](https://stripe.com/docs/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://stripe.com/docs/api/payment_intents/confirm) response to verify support. + Request ability to [increment](https://docs.stripe.com/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://docs.stripe.com/api/payment_intents/confirm) response to verify support. """ routing: NotRequired[ "PaymentIntentConfirmParamsPaymentMethodOptionsCardPresentRouting" @@ -5901,7 +5902,7 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -6024,51 +6025,30 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsPayto(TypedDict): class PaymentIntentConfirmParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict, ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. @@ -6522,7 +6502,7 @@ class PaymentIntentConfirmParamsPaymentMethodOptionsZip(TypedDict): class PaymentIntentConfirmParamsRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -6572,5 +6552,5 @@ class PaymentIntentConfirmParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_intent_create_params.py b/stripe/params/_payment_intent_create_params.py index 30eddb044..bd15253a6 100644 --- a/stripe/params/_payment_intent_create_params.py +++ b/stripe/params/_payment_intent_create_params.py @@ -8,7 +8,7 @@ class PaymentIntentCreateParams(RequestOptions): amount: int """ - Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). + Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). """ amount_details: NotRequired["PaymentIntentCreateParamsAmountDetails"] """ @@ -16,7 +16,7 @@ class PaymentIntentCreateParams(RequestOptions): """ application_fee_amount: NotRequired[int] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ automatic_payment_methods: NotRequired[ "PaymentIntentCreateParamsAutomaticPaymentMethods" @@ -32,7 +32,7 @@ class PaymentIntentCreateParams(RequestOptions): """ confirm: NotRequired[bool] """ - Set to `true` to attempt to [confirm this PaymentIntent](https://stripe.com/docs/api/payment_intents/confirm) immediately. This parameter defaults to `false`. When creating and confirming a PaymentIntent at the same time, you can also provide the parameters available in the [Confirm API](https://stripe.com/docs/api/payment_intents/confirm). + Set to `true` to attempt to [confirm this PaymentIntent](https://docs.stripe.com/api/payment_intents/confirm) immediately. This parameter defaults to `false`. When creating and confirming a PaymentIntent at the same time, you can also provide the parameters available in the [Confirm API](https://docs.stripe.com/api/payment_intents/confirm). """ confirmation_method: NotRequired[Literal["automatic", "manual"]] """ @@ -54,15 +54,15 @@ class PaymentIntentCreateParams(RequestOptions): Payment methods attached to other Customers cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. """ customer_account: NotRequired[str] """ - ID of the Account this PaymentIntent belongs to, if one exists. + ID of the Account representing the customer that this PaymentIntent belongs to, if one exists. Payment methods attached to other Accounts cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. """ description: NotRequired[str] """ @@ -70,7 +70,7 @@ class PaymentIntentCreateParams(RequestOptions): """ error_on_requires_action: NotRequired[bool] """ - Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. Use this parameter for simpler integrations that don't handle customer actions, such as [saving cards without authentication](https://stripe.com/docs/payments/save-card-without-authentication). This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-confirm). + Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. Use this parameter for simpler integrations that don't handle customer actions, such as [saving cards without authentication](https://docs.stripe.com/payments/save-card-without-authentication). This parameter can only be used with [`confirm=true`](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-confirm). """ excluded_payment_method_types: NotRequired[ List[ @@ -151,25 +151,25 @@ class PaymentIntentCreateParams(RequestOptions): """ mandate: NotRequired[str] """ - ID of the mandate that's used for this payment. This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-confirm). + ID of the mandate that's used for this payment. This parameter can only be used with [`confirm=true`](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-confirm). """ mandate_data: NotRequired[ "Literal['']|PaymentIntentCreateParamsMandateData" ] """ - This hash contains details about the Mandate to create. This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-confirm). + This hash contains details about the Mandate to create. This parameter can only be used with [`confirm=true`](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-confirm). """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ off_session: NotRequired["bool|Literal['one_off', 'recurring']"] """ - Set to `true` to indicate that the customer isn't in your checkout flow during this payment attempt and can't authenticate. Use this parameter in scenarios where you collect card details and [charge them later](https://stripe.com/docs/payments/cards/charging-saved-cards). This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-confirm). + Set to `true` to indicate that the customer isn't in your checkout flow during this payment attempt and can't authenticate. Use this parameter in scenarios where you collect card details and [charge them later](https://docs.stripe.com/payments/cards/charging-saved-cards). This parameter can only be used with [`confirm=true`](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-confirm). """ on_behalf_of: NotRequired[str] """ - The Stripe account ID that these funds are intended for. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The Stripe account ID that these funds are intended for. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ payment_details: NotRequired["PaymentIntentCreateParamsPaymentDetails"] """ @@ -177,22 +177,22 @@ class PaymentIntentCreateParams(RequestOptions): """ payment_method: NotRequired[str] """ - ID of the payment method (a PaymentMethod, Card, or [compatible Source](https://stripe.com/docs/payments/payment-methods#compatibility) object) to attach to this PaymentIntent. + ID of the payment method (a PaymentMethod, Card, or [compatible Source](https://docs.stripe.com/payments/payment-methods#compatibility) object) to attach to this PaymentIntent. If you don't provide the `payment_method` parameter or the `source` parameter with `confirm=true`, `source` automatically populates with `customer.default_source` to improve migration for users of the Charges API. We recommend that you explicitly provide the `payment_method` moving forward. - If the payment method is attached to a Customer, you must also provide the ID of that Customer as the [customer](https://stripe.com/docs/api#create_payment_intent-customer) parameter of this PaymentIntent. + If the payment method is attached to a Customer, you must also provide the ID of that Customer as the [customer](https://api.stripe.com#create_payment_intent-customer) parameter of this PaymentIntent. end """ payment_method_configuration: NotRequired[str] """ - The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this PaymentIntent. + The ID of the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) to use with this PaymentIntent. """ payment_method_data: NotRequired[ "PaymentIntentCreateParamsPaymentMethodData" ] """ If provided, this hash will be used to create a PaymentMethod. The new PaymentMethod will appear - in the [payment_method](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method) + in the [payment_method](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-payment_method) property on the PaymentIntent. """ payment_method_options: NotRequired[ @@ -207,7 +207,7 @@ class PaymentIntentCreateParams(RequestOptions): """ radar_options: NotRequired["PaymentIntentCreateParamsRadarOptions"] """ - Options to configure Radar. Learn more about [Radar Sessions](https://stripe.com/docs/radar/radar-session). + Options to configure Radar. Learn more about [Radar Sessions](https://docs.stripe.com/radar/radar-session). """ receipt_email: NotRequired[str] """ @@ -215,7 +215,7 @@ class PaymentIntentCreateParams(RequestOptions): """ return_url: NotRequired[str] """ - The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site. If you'd prefer to redirect to a mobile application, you can alternatively supply an application URI scheme. This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-confirm). + The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site. If you'd prefer to redirect to a mobile application, you can alternatively supply an application URI scheme. This parameter can only be used with [`confirm=true`](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-confirm). """ secret_key_confirmation: NotRequired[Literal["optional", "required"]] """ @@ -248,11 +248,11 @@ class PaymentIntentCreateParams(RequestOptions): transfer_data: NotRequired["PaymentIntentCreateParamsTransferData"] """ The parameters that you can use to automatically create a Transfer. - Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ transfer_group: NotRequired[str] """ - A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers). + A string that identifies the resulting payment as part of a group. Learn more about the [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers). """ use_stripe_sdk: NotRequired[bool] """ @@ -263,7 +263,7 @@ class PaymentIntentCreateParams(RequestOptions): class PaymentIntentCreateParamsAmountDetails(TypedDict): discount_amount: NotRequired["Literal['']|int"] """ - The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field. """ @@ -271,7 +271,7 @@ class PaymentIntentCreateParamsAmountDetails(TypedDict): "Literal['']|List[PaymentIntentCreateParamsAmountDetailsLineItem]" ] """ - A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items. + A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items. """ shipping: NotRequired[ "Literal['']|PaymentIntentCreateParamsAmountDetailsShipping" @@ -288,7 +288,7 @@ class PaymentIntentCreateParamsAmountDetails(TypedDict): class PaymentIntentCreateParamsAmountDetailsLineItem(TypedDict): discount_amount: NotRequired[int] """ - The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The discount applied on this line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[discount_amount]` field. """ @@ -318,7 +318,7 @@ class PaymentIntentCreateParamsAmountDetailsLineItem(TypedDict): """ unit_cost: int """ - The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. """ unit_of_measure: NotRequired[str] """ @@ -416,7 +416,7 @@ class PaymentIntentCreateParamsAmountDetailsLineItemPaymentMethodOptionsPaypal( class PaymentIntentCreateParamsAmountDetailsLineItemTax(TypedDict): total_tax_amount: int """ - The total amount of tax on a single line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The total amount of tax on a single line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[tax][total_tax_amount]` field. """ @@ -425,7 +425,7 @@ class PaymentIntentCreateParamsAmountDetailsLineItemTax(TypedDict): class PaymentIntentCreateParamsAmountDetailsShipping(TypedDict): amount: NotRequired["Literal['']|int"] """ - If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0. + If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0. """ from_postal_code: NotRequired["Literal['']|str"] """ @@ -440,7 +440,7 @@ class PaymentIntentCreateParamsAmountDetailsShipping(TypedDict): class PaymentIntentCreateParamsAmountDetailsTax(TypedDict): total_tax_amount: int """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ @@ -451,7 +451,7 @@ class PaymentIntentCreateParamsAutomaticPaymentMethods(TypedDict): """ Controls whether this PaymentIntent will accept redirect-based payment methods. - Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://stripe.com/docs/api/payment_intents/confirm) this PaymentIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the payment. + Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://docs.stripe.com/api/payment_intents/confirm) this PaymentIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the payment. """ enabled: bool """ @@ -476,7 +476,7 @@ class PaymentIntentCreateParamsHooksInputs(TypedDict): class PaymentIntentCreateParamsHooksInputsTax(TypedDict): calculation: Union[Literal[""], str] """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ @@ -793,7 +793,7 @@ class PaymentIntentCreateParamsPaymentDetailsCarRentalPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -820,7 +820,7 @@ class PaymentIntentCreateParamsPaymentDetailsCarRentalReturnAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -997,7 +997,7 @@ class PaymentIntentCreateParamsPaymentDetailsCarRentalDatumDropOffAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1071,7 +1071,7 @@ class PaymentIntentCreateParamsPaymentDetailsCarRentalDatumPickupAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1323,7 +1323,7 @@ class PaymentIntentCreateParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1911,7 +1911,7 @@ class PaymentIntentCreateParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2154,7 +2154,7 @@ class PaymentIntentCreateParamsPaymentDetailsLodgingDatumHostAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2478,7 +2478,7 @@ class PaymentIntentCreateParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired[ "PaymentIntentCreateParamsPaymentMethodDataMobilepay" @@ -2556,7 +2556,7 @@ class PaymentIntentCreateParamsPaymentMethodData(TypedDict): "PaymentIntentCreateParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["PaymentIntentCreateParamsPaymentMethodDataRechnung"] """ @@ -2802,7 +2802,7 @@ class PaymentIntentCreateParamsPaymentMethodDataBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2931,6 +2931,7 @@ class PaymentIntentCreateParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -3123,7 +3124,7 @@ class PaymentIntentCreateParamsPaymentMethodDataQris(TypedDict): class PaymentIntentCreateParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -3896,7 +3897,7 @@ class PaymentIntentCreateParamsPaymentMethodOptionsCard(TypedDict): """ Installment configuration for payments attempted on this PaymentIntent. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ mandate_options: NotRequired[ "PaymentIntentCreateParamsPaymentMethodOptionsCardMandateOptions" @@ -3934,27 +3935,27 @@ class PaymentIntentCreateParamsPaymentMethodOptionsCard(TypedDict): Literal["if_available", "never"] ] """ - Request ability to [decrement the authorization](https://stripe.com/docs/payments/decremental-authorization) for this PaymentIntent. + Request ability to [decrement the authorization](https://docs.stripe.com/payments/decremental-authorization) for this PaymentIntent. """ request_extended_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [capture beyond the standard authorization validity window](https://stripe.com/docs/payments/extended-authorization) for this PaymentIntent. + Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this PaymentIntent. """ request_incremental_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [increment the authorization](https://stripe.com/docs/payments/incremental-authorization) for this PaymentIntent. + Request ability to [increment the authorization](https://docs.stripe.com/payments/incremental-authorization) for this PaymentIntent. """ request_multicapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to make [multiple captures](https://stripe.com/docs/payments/multicapture) for this PaymentIntent. + Request ability to make [multiple captures](https://docs.stripe.com/payments/multicapture) for this PaymentIntent. """ request_overcapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to [overcapture](https://stripe.com/docs/payments/overcapture) for this PaymentIntent. + Request ability to [overcapture](https://docs.stripe.com/payments/overcapture) for this PaymentIntent. """ request_partial_authorization: NotRequired[ Literal["if_available", "never"] @@ -3966,7 +3967,7 @@ class PaymentIntentCreateParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ require_cvc_recollection: NotRequired[bool] """ @@ -4124,7 +4125,7 @@ class PaymentIntentCreateParamsPaymentMethodOptionsCardStatementDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -4220,11 +4221,11 @@ class PaymentIntentCreateParamsPaymentMethodOptionsCardPresent(TypedDict): """ request_extended_authorization: NotRequired[bool] """ - Request ability to capture this payment beyond the standard [authorization validity window](https://stripe.com/docs/terminal/features/extended-authorizations#authorization-validity) + Request ability to capture this payment beyond the standard [authorization validity window](https://docs.stripe.com/terminal/features/extended-authorizations#authorization-validity) """ request_incremental_authorization_support: NotRequired[bool] """ - Request ability to [increment](https://stripe.com/docs/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://stripe.com/docs/api/payment_intents/confirm) response to verify support. + Request ability to [increment](https://docs.stripe.com/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://docs.stripe.com/api/payment_intents/confirm) response to verify support. """ routing: NotRequired[ "PaymentIntentCreateParamsPaymentMethodOptionsCardPresentRouting" @@ -6018,7 +6019,7 @@ class PaymentIntentCreateParamsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -6141,51 +6142,30 @@ class PaymentIntentCreateParamsPaymentMethodOptionsPayto(TypedDict): class PaymentIntentCreateParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict, ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. @@ -6639,7 +6619,7 @@ class PaymentIntentCreateParamsPaymentMethodOptionsZip(TypedDict): class PaymentIntentCreateParamsRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -6689,7 +6669,7 @@ class PaymentIntentCreateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -6701,7 +6681,7 @@ class PaymentIntentCreateParamsTransferData(TypedDict): the full amount is transferred. If you intend to collect a fee and you need a more robust reporting experience, using - [application_fee_amount](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-application_fee_amount) + [application_fee_amount](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-application_fee_amount) might be a better fit for your integration. """ destination: str diff --git a/stripe/params/_payment_intent_decrement_authorization_params.py b/stripe/params/_payment_intent_decrement_authorization_params.py index 529f0c812..ea2187c7e 100644 --- a/stripe/params/_payment_intent_decrement_authorization_params.py +++ b/stripe/params/_payment_intent_decrement_authorization_params.py @@ -12,7 +12,7 @@ class PaymentIntentDecrementAuthorizationParams(RequestOptions): """ application_fee_amount: NotRequired[int] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ description: NotRequired[str] """ @@ -28,14 +28,14 @@ class PaymentIntentDecrementAuthorizationParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ transfer_data: NotRequired[ "PaymentIntentDecrementAuthorizationParamsTransferData" ] """ The parameters used to automatically create a transfer after the payment is captured. - Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ @@ -56,7 +56,7 @@ class PaymentIntentDecrementAuthorizationParamsHooksInputs(TypedDict): class PaymentIntentDecrementAuthorizationParamsHooksInputsTax(TypedDict): calculation: Union[Literal[""], str] """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ diff --git a/stripe/params/_payment_intent_increment_authorization_params.py b/stripe/params/_payment_intent_increment_authorization_params.py index b3ea5bca7..a8fbb7b9a 100644 --- a/stripe/params/_payment_intent_increment_authorization_params.py +++ b/stripe/params/_payment_intent_increment_authorization_params.py @@ -18,7 +18,7 @@ class PaymentIntentIncrementAuthorizationParams(RequestOptions): """ application_fee_amount: NotRequired[int] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ description: NotRequired[str] """ @@ -34,7 +34,7 @@ class PaymentIntentIncrementAuthorizationParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_details: NotRequired[ "PaymentIntentIncrementAuthorizationParamsPaymentDetails" @@ -57,14 +57,14 @@ class PaymentIntentIncrementAuthorizationParams(RequestOptions): ] """ The parameters used to automatically create a transfer after the payment is captured. - Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ class PaymentIntentIncrementAuthorizationParamsAmountDetails(TypedDict): discount_amount: NotRequired["Literal['']|int"] """ - The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field. """ @@ -72,7 +72,7 @@ class PaymentIntentIncrementAuthorizationParamsAmountDetails(TypedDict): "Literal['']|List[PaymentIntentIncrementAuthorizationParamsAmountDetailsLineItem]" ] """ - A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items. + A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items. """ shipping: NotRequired[ "Literal['']|PaymentIntentIncrementAuthorizationParamsAmountDetailsShipping" @@ -93,7 +93,7 @@ class PaymentIntentIncrementAuthorizationParamsAmountDetailsLineItem( ): discount_amount: NotRequired[int] """ - The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The discount applied on this line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[discount_amount]` field. """ @@ -125,7 +125,7 @@ class PaymentIntentIncrementAuthorizationParamsAmountDetailsLineItem( """ unit_cost: int """ - The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. """ unit_of_measure: NotRequired[str] """ @@ -225,7 +225,7 @@ class PaymentIntentIncrementAuthorizationParamsAmountDetailsLineItemTax( ): total_tax_amount: int """ - The total amount of tax on a single line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The total amount of tax on a single line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[tax][total_tax_amount]` field. """ @@ -236,7 +236,7 @@ class PaymentIntentIncrementAuthorizationParamsAmountDetailsShipping( ): amount: NotRequired["Literal['']|int"] """ - If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0. + If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0. """ from_postal_code: NotRequired["Literal['']|str"] """ @@ -251,7 +251,7 @@ class PaymentIntentIncrementAuthorizationParamsAmountDetailsShipping( class PaymentIntentIncrementAuthorizationParamsAmountDetailsTax(TypedDict): total_tax_amount: int """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ @@ -274,7 +274,7 @@ class PaymentIntentIncrementAuthorizationParamsHooksInputs(TypedDict): class PaymentIntentIncrementAuthorizationParamsHooksInputsTax(TypedDict): calculation: Union[Literal[""], str] """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ diff --git a/stripe/params/_payment_intent_list_params.py b/stripe/params/_payment_intent_list_params.py index ed635ab53..10ec58a94 100644 --- a/stripe/params/_payment_intent_list_params.py +++ b/stripe/params/_payment_intent_list_params.py @@ -16,7 +16,7 @@ class PaymentIntentListParams(RequestOptions): """ customer_account: NotRequired[str] """ - Only return PaymentIntents for the account that this ID specifies. + Only return PaymentIntents for the account representing the customer that this ID specifies. """ ending_before: NotRequired[str] """ diff --git a/stripe/params/_payment_intent_modify_params.py b/stripe/params/_payment_intent_modify_params.py index d255fd695..17f176288 100644 --- a/stripe/params/_payment_intent_modify_params.py +++ b/stripe/params/_payment_intent_modify_params.py @@ -8,7 +8,7 @@ class PaymentIntentModifyParams(RequestOptions): amount: NotRequired[int] """ - Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). + Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). """ amount_details: NotRequired[ "Literal['']|PaymentIntentModifyParamsAmountDetails" @@ -18,7 +18,7 @@ class PaymentIntentModifyParams(RequestOptions): """ application_fee_amount: NotRequired["Literal['']|int"] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ capture_method: NotRequired[ Literal["automatic", "automatic_async", "manual"] @@ -36,15 +36,15 @@ class PaymentIntentModifyParams(RequestOptions): Payment methods attached to other Customers cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. """ customer_account: NotRequired[str] """ - ID of the Account this PaymentIntent belongs to, if one exists. + ID of the Account representing the customer that this PaymentIntent belongs to, if one exists. Payment methods attached to other Accounts cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. """ description: NotRequired[str] """ @@ -74,7 +74,7 @@ class PaymentIntentModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_details: NotRequired[ "Literal['']|PaymentIntentModifyParamsPaymentDetails" @@ -85,14 +85,14 @@ class PaymentIntentModifyParams(RequestOptions): payment_method: NotRequired[str] payment_method_configuration: NotRequired[str] """ - The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this PaymentIntent. + The ID of the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) to use with this PaymentIntent. """ payment_method_data: NotRequired[ "PaymentIntentModifyParamsPaymentMethodData" ] """ If provided, this hash will be used to create a PaymentMethod. The new PaymentMethod will appear - in the [payment_method](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method) + in the [payment_method](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-payment_method) property on the PaymentIntent. """ payment_method_options: NotRequired[ @@ -139,18 +139,18 @@ class PaymentIntentModifyParams(RequestOptions): """ transfer_data: NotRequired["PaymentIntentModifyParamsTransferData"] """ - Use this parameter to automatically create a Transfer when the payment succeeds. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + Use this parameter to automatically create a Transfer when the payment succeeds. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ transfer_group: NotRequired[str] """ - A string that identifies the resulting payment as part of a group. You can only provide `transfer_group` if it hasn't been set. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + A string that identifies the resulting payment as part of a group. You can only provide `transfer_group` if it hasn't been set. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ class PaymentIntentModifyParamsAmountDetails(TypedDict): discount_amount: NotRequired["Literal['']|int"] """ - The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field. """ @@ -158,7 +158,7 @@ class PaymentIntentModifyParamsAmountDetails(TypedDict): "Literal['']|List[PaymentIntentModifyParamsAmountDetailsLineItem]" ] """ - A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items. + A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items. """ shipping: NotRequired[ "Literal['']|PaymentIntentModifyParamsAmountDetailsShipping" @@ -175,7 +175,7 @@ class PaymentIntentModifyParamsAmountDetails(TypedDict): class PaymentIntentModifyParamsAmountDetailsLineItem(TypedDict): discount_amount: NotRequired[int] """ - The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The discount applied on this line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[discount_amount]` field. """ @@ -205,7 +205,7 @@ class PaymentIntentModifyParamsAmountDetailsLineItem(TypedDict): """ unit_cost: int """ - The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. """ unit_of_measure: NotRequired[str] """ @@ -303,7 +303,7 @@ class PaymentIntentModifyParamsAmountDetailsLineItemPaymentMethodOptionsPaypal( class PaymentIntentModifyParamsAmountDetailsLineItemTax(TypedDict): total_tax_amount: int """ - The total amount of tax on a single line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The total amount of tax on a single line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[tax][total_tax_amount]` field. """ @@ -312,7 +312,7 @@ class PaymentIntentModifyParamsAmountDetailsLineItemTax(TypedDict): class PaymentIntentModifyParamsAmountDetailsShipping(TypedDict): amount: NotRequired["Literal['']|int"] """ - If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0. + If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0. """ from_postal_code: NotRequired["Literal['']|str"] """ @@ -327,7 +327,7 @@ class PaymentIntentModifyParamsAmountDetailsShipping(TypedDict): class PaymentIntentModifyParamsAmountDetailsTax(TypedDict): total_tax_amount: int """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ @@ -350,7 +350,7 @@ class PaymentIntentModifyParamsHooksInputs(TypedDict): class PaymentIntentModifyParamsHooksInputsTax(TypedDict): calculation: Union[Literal[""], str] """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ @@ -651,7 +651,7 @@ class PaymentIntentModifyParamsPaymentDetailsCarRentalPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -678,7 +678,7 @@ class PaymentIntentModifyParamsPaymentDetailsCarRentalReturnAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -855,7 +855,7 @@ class PaymentIntentModifyParamsPaymentDetailsCarRentalDatumDropOffAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -929,7 +929,7 @@ class PaymentIntentModifyParamsPaymentDetailsCarRentalDatumPickupAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1181,7 +1181,7 @@ class PaymentIntentModifyParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1769,7 +1769,7 @@ class PaymentIntentModifyParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2012,7 +2012,7 @@ class PaymentIntentModifyParamsPaymentDetailsLodgingDatumHostAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2336,7 +2336,7 @@ class PaymentIntentModifyParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired[ "PaymentIntentModifyParamsPaymentMethodDataMobilepay" @@ -2414,7 +2414,7 @@ class PaymentIntentModifyParamsPaymentMethodData(TypedDict): "PaymentIntentModifyParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["PaymentIntentModifyParamsPaymentMethodDataRechnung"] """ @@ -2660,7 +2660,7 @@ class PaymentIntentModifyParamsPaymentMethodDataBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2789,6 +2789,7 @@ class PaymentIntentModifyParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -2981,7 +2982,7 @@ class PaymentIntentModifyParamsPaymentMethodDataQris(TypedDict): class PaymentIntentModifyParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -3754,7 +3755,7 @@ class PaymentIntentModifyParamsPaymentMethodOptionsCard(TypedDict): """ Installment configuration for payments attempted on this PaymentIntent. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ mandate_options: NotRequired[ "PaymentIntentModifyParamsPaymentMethodOptionsCardMandateOptions" @@ -3792,27 +3793,27 @@ class PaymentIntentModifyParamsPaymentMethodOptionsCard(TypedDict): Literal["if_available", "never"] ] """ - Request ability to [decrement the authorization](https://stripe.com/docs/payments/decremental-authorization) for this PaymentIntent. + Request ability to [decrement the authorization](https://docs.stripe.com/payments/decremental-authorization) for this PaymentIntent. """ request_extended_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [capture beyond the standard authorization validity window](https://stripe.com/docs/payments/extended-authorization) for this PaymentIntent. + Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this PaymentIntent. """ request_incremental_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [increment the authorization](https://stripe.com/docs/payments/incremental-authorization) for this PaymentIntent. + Request ability to [increment the authorization](https://docs.stripe.com/payments/incremental-authorization) for this PaymentIntent. """ request_multicapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to make [multiple captures](https://stripe.com/docs/payments/multicapture) for this PaymentIntent. + Request ability to make [multiple captures](https://docs.stripe.com/payments/multicapture) for this PaymentIntent. """ request_overcapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to [overcapture](https://stripe.com/docs/payments/overcapture) for this PaymentIntent. + Request ability to [overcapture](https://docs.stripe.com/payments/overcapture) for this PaymentIntent. """ request_partial_authorization: NotRequired[ Literal["if_available", "never"] @@ -3824,7 +3825,7 @@ class PaymentIntentModifyParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ require_cvc_recollection: NotRequired[bool] """ @@ -3982,7 +3983,7 @@ class PaymentIntentModifyParamsPaymentMethodOptionsCardStatementDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -4078,11 +4079,11 @@ class PaymentIntentModifyParamsPaymentMethodOptionsCardPresent(TypedDict): """ request_extended_authorization: NotRequired[bool] """ - Request ability to capture this payment beyond the standard [authorization validity window](https://stripe.com/docs/terminal/features/extended-authorizations#authorization-validity) + Request ability to capture this payment beyond the standard [authorization validity window](https://docs.stripe.com/terminal/features/extended-authorizations#authorization-validity) """ request_incremental_authorization_support: NotRequired[bool] """ - Request ability to [increment](https://stripe.com/docs/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://stripe.com/docs/api/payment_intents/confirm) response to verify support. + Request ability to [increment](https://docs.stripe.com/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://docs.stripe.com/api/payment_intents/confirm) response to verify support. """ routing: NotRequired[ "PaymentIntentModifyParamsPaymentMethodOptionsCardPresentRouting" @@ -5876,7 +5877,7 @@ class PaymentIntentModifyParamsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -5999,51 +6000,30 @@ class PaymentIntentModifyParamsPaymentMethodOptionsPayto(TypedDict): class PaymentIntentModifyParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict, ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. @@ -6540,7 +6520,7 @@ class PaymentIntentModifyParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_intent_search_params.py b/stripe/params/_payment_intent_search_params.py index 53c3cc376..516352aec 100644 --- a/stripe/params/_payment_intent_search_params.py +++ b/stripe/params/_payment_intent_search_params.py @@ -20,5 +20,5 @@ class PaymentIntentSearchParams(RequestOptions): """ query: str """ - The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for payment intents](https://stripe.com/docs/search#query-fields-for-payment-intents). + The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for payment intents](https://docs.stripe.com/search#query-fields-for-payment-intents). """ diff --git a/stripe/params/_payment_intent_update_params.py b/stripe/params/_payment_intent_update_params.py index e14561510..ab45039ee 100644 --- a/stripe/params/_payment_intent_update_params.py +++ b/stripe/params/_payment_intent_update_params.py @@ -7,7 +7,7 @@ class PaymentIntentUpdateParams(TypedDict): amount: NotRequired[int] """ - Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). + Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). """ amount_details: NotRequired[ "Literal['']|PaymentIntentUpdateParamsAmountDetails" @@ -17,7 +17,7 @@ class PaymentIntentUpdateParams(TypedDict): """ application_fee_amount: NotRequired["Literal['']|int"] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ capture_method: NotRequired[ Literal["automatic", "automatic_async", "manual"] @@ -35,15 +35,15 @@ class PaymentIntentUpdateParams(TypedDict): Payment methods attached to other Customers cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Customer instead. """ customer_account: NotRequired[str] """ - ID of the Account this PaymentIntent belongs to, if one exists. + ID of the Account representing the customer that this PaymentIntent belongs to, if one exists. Payment methods attached to other Accounts cannot be used with this PaymentIntent. - If [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. + If [setup_future_usage](https://api.stripe.com#payment_intent_object-setup_future_usage) is set and this PaymentIntent's payment method is not `card_present`, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method is `card_present` and isn't a digital wallet, then a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card is created and attached to the Account instead. """ description: NotRequired[str] """ @@ -73,7 +73,7 @@ class PaymentIntentUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_details: NotRequired[ "Literal['']|PaymentIntentUpdateParamsPaymentDetails" @@ -84,14 +84,14 @@ class PaymentIntentUpdateParams(TypedDict): payment_method: NotRequired[str] payment_method_configuration: NotRequired[str] """ - The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this PaymentIntent. + The ID of the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) to use with this PaymentIntent. """ payment_method_data: NotRequired[ "PaymentIntentUpdateParamsPaymentMethodData" ] """ If provided, this hash will be used to create a PaymentMethod. The new PaymentMethod will appear - in the [payment_method](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method) + in the [payment_method](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-payment_method) property on the PaymentIntent. """ payment_method_options: NotRequired[ @@ -138,18 +138,18 @@ class PaymentIntentUpdateParams(TypedDict): """ transfer_data: NotRequired["PaymentIntentUpdateParamsTransferData"] """ - Use this parameter to automatically create a Transfer when the payment succeeds. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + Use this parameter to automatically create a Transfer when the payment succeeds. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ transfer_group: NotRequired[str] """ - A string that identifies the resulting payment as part of a group. You can only provide `transfer_group` if it hasn't been set. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + A string that identifies the resulting payment as part of a group. You can only provide `transfer_group` if it hasn't been set. Learn more about the [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ class PaymentIntentUpdateParamsAmountDetails(TypedDict): discount_amount: NotRequired["Literal['']|int"] """ - The total discount applied on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[line_items][#][discount_amount]` field. """ @@ -157,7 +157,7 @@ class PaymentIntentUpdateParamsAmountDetails(TypedDict): "Literal['']|List[PaymentIntentUpdateParamsAmountDetailsLineItem]" ] """ - A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 100 line items. + A list of line items, each containing information about a product in the PaymentIntent. There is a maximum of 200 line items. """ shipping: NotRequired[ "Literal['']|PaymentIntentUpdateParamsAmountDetailsShipping" @@ -174,7 +174,7 @@ class PaymentIntentUpdateParamsAmountDetails(TypedDict): class PaymentIntentUpdateParamsAmountDetailsLineItem(TypedDict): discount_amount: NotRequired[int] """ - The discount applied on this line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than 0. + The discount applied on this line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0. This field is mutually exclusive with the `amount_details[discount_amount]` field. """ @@ -204,7 +204,7 @@ class PaymentIntentUpdateParamsAmountDetailsLineItem(TypedDict): """ unit_cost: int """ - The unit cost of the line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The unit cost of the line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. """ unit_of_measure: NotRequired[str] """ @@ -302,7 +302,7 @@ class PaymentIntentUpdateParamsAmountDetailsLineItemPaymentMethodOptionsPaypal( class PaymentIntentUpdateParamsAmountDetailsLineItemTax(TypedDict): total_tax_amount: int """ - The total amount of tax on a single line item represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. + The total amount of tax on a single line item represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L3 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[tax][total_tax_amount]` field. """ @@ -311,7 +311,7 @@ class PaymentIntentUpdateParamsAmountDetailsLineItemTax(TypedDict): class PaymentIntentUpdateParamsAmountDetailsShipping(TypedDict): amount: NotRequired["Literal['']|int"] """ - If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). An integer greater than or equal to 0. + If a physical good is being shipped, the cost of shipping represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than or equal to 0. """ from_postal_code: NotRequired["Literal['']|str"] """ @@ -326,7 +326,7 @@ class PaymentIntentUpdateParamsAmountDetailsShipping(TypedDict): class PaymentIntentUpdateParamsAmountDetailsTax(TypedDict): total_tax_amount: int """ - The total amount of tax on the transaction represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. + The total amount of tax on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). Required for L2 rates. An integer greater than or equal to 0. This field is mutually exclusive with the `amount_details[line_items][#][tax][total_tax_amount]` field. """ @@ -349,7 +349,7 @@ class PaymentIntentUpdateParamsHooksInputs(TypedDict): class PaymentIntentUpdateParamsHooksInputsTax(TypedDict): calculation: Union[Literal[""], str] """ - The [TaxCalculation](https://stripe.com/docs/api/tax/calculations) id + The [TaxCalculation](https://docs.stripe.com/api/tax/calculations) id """ @@ -650,7 +650,7 @@ class PaymentIntentUpdateParamsPaymentDetailsCarRentalPickupAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -677,7 +677,7 @@ class PaymentIntentUpdateParamsPaymentDetailsCarRentalReturnAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -854,7 +854,7 @@ class PaymentIntentUpdateParamsPaymentDetailsCarRentalDatumDropOffAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -928,7 +928,7 @@ class PaymentIntentUpdateParamsPaymentDetailsCarRentalDatumPickupAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1180,7 +1180,7 @@ class PaymentIntentUpdateParamsPaymentDetailsEventDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1768,7 +1768,7 @@ class PaymentIntentUpdateParamsPaymentDetailsLodgingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2011,7 +2011,7 @@ class PaymentIntentUpdateParamsPaymentDetailsLodgingDatumHostAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2335,7 +2335,7 @@ class PaymentIntentUpdateParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired[ "PaymentIntentUpdateParamsPaymentMethodDataMobilepay" @@ -2413,7 +2413,7 @@ class PaymentIntentUpdateParamsPaymentMethodData(TypedDict): "PaymentIntentUpdateParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["PaymentIntentUpdateParamsPaymentMethodDataRechnung"] """ @@ -2659,7 +2659,7 @@ class PaymentIntentUpdateParamsPaymentMethodDataBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -2788,6 +2788,7 @@ class PaymentIntentUpdateParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -2980,7 +2981,7 @@ class PaymentIntentUpdateParamsPaymentMethodDataQris(TypedDict): class PaymentIntentUpdateParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -3753,7 +3754,7 @@ class PaymentIntentUpdateParamsPaymentMethodOptionsCard(TypedDict): """ Installment configuration for payments attempted on this PaymentIntent. - For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments). + For more information, see the [installments integration guide](https://docs.stripe.com/payments/installments). """ mandate_options: NotRequired[ "PaymentIntentUpdateParamsPaymentMethodOptionsCardMandateOptions" @@ -3791,27 +3792,27 @@ class PaymentIntentUpdateParamsPaymentMethodOptionsCard(TypedDict): Literal["if_available", "never"] ] """ - Request ability to [decrement the authorization](https://stripe.com/docs/payments/decremental-authorization) for this PaymentIntent. + Request ability to [decrement the authorization](https://docs.stripe.com/payments/decremental-authorization) for this PaymentIntent. """ request_extended_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [capture beyond the standard authorization validity window](https://stripe.com/docs/payments/extended-authorization) for this PaymentIntent. + Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this PaymentIntent. """ request_incremental_authorization: NotRequired[ Literal["if_available", "never"] ] """ - Request ability to [increment the authorization](https://stripe.com/docs/payments/incremental-authorization) for this PaymentIntent. + Request ability to [increment the authorization](https://docs.stripe.com/payments/incremental-authorization) for this PaymentIntent. """ request_multicapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to make [multiple captures](https://stripe.com/docs/payments/multicapture) for this PaymentIntent. + Request ability to make [multiple captures](https://docs.stripe.com/payments/multicapture) for this PaymentIntent. """ request_overcapture: NotRequired[Literal["if_available", "never"]] """ - Request ability to [overcapture](https://stripe.com/docs/payments/overcapture) for this PaymentIntent. + Request ability to [overcapture](https://docs.stripe.com/payments/overcapture) for this PaymentIntent. """ request_partial_authorization: NotRequired[ Literal["if_available", "never"] @@ -3823,7 +3824,7 @@ class PaymentIntentUpdateParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ require_cvc_recollection: NotRequired[bool] """ @@ -3981,7 +3982,7 @@ class PaymentIntentUpdateParamsPaymentMethodOptionsCardStatementDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -4077,11 +4078,11 @@ class PaymentIntentUpdateParamsPaymentMethodOptionsCardPresent(TypedDict): """ request_extended_authorization: NotRequired[bool] """ - Request ability to capture this payment beyond the standard [authorization validity window](https://stripe.com/docs/terminal/features/extended-authorizations#authorization-validity) + Request ability to capture this payment beyond the standard [authorization validity window](https://docs.stripe.com/terminal/features/extended-authorizations#authorization-validity) """ request_incremental_authorization_support: NotRequired[bool] """ - Request ability to [increment](https://stripe.com/docs/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://stripe.com/docs/api/payment_intents/confirm) response to verify support. + Request ability to [increment](https://docs.stripe.com/terminal/features/incremental-authorizations) this PaymentIntent if the combination of MCC and card brand is eligible. Check [incremental_authorization_supported](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-incremental_authorization_supported) in the [Confirm](https://docs.stripe.com/api/payment_intents/confirm) response to verify support. """ routing: NotRequired[ "PaymentIntentUpdateParamsPaymentMethodOptionsCardPresentRouting" @@ -5875,7 +5876,7 @@ class PaymentIntentUpdateParamsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -5998,51 +5999,30 @@ class PaymentIntentUpdateParamsPaymentMethodOptionsPayto(TypedDict): class PaymentIntentUpdateParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict, ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. @@ -6539,7 +6519,7 @@ class PaymentIntentUpdateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_link_create_params.py b/stripe/params/_payment_link_create_params.py index f579fdbdb..3dde2fc56 100644 --- a/stripe/params/_payment_link_create_params.py +++ b/stripe/params/_payment_link_create_params.py @@ -48,7 +48,7 @@ class PaymentLinkCreateParams(RequestOptions): """ customer_creation: NotRequired[Literal["always", "if_required"]] """ - Configures whether [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link create a [Customer](https://stripe.com/docs/api/customers). + Configures whether [checkout sessions](https://docs.stripe.com/api/checkout/sessions) created by this payment link create a [Customer](https://docs.stripe.com/api/customers). """ expand: NotRequired[List[str]] """ @@ -68,7 +68,7 @@ class PaymentLinkCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. Metadata associated with this Payment Link will automatically be copied to [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. Metadata associated with this Payment Link will automatically be copied to [checkout sessions](https://docs.stripe.com/api/checkout/sessions) created by this payment link. """ name_collection: NotRequired["PaymentLinkCreateParamsNameCollection"] """ @@ -80,7 +80,7 @@ class PaymentLinkCreateParams(RequestOptions): """ optional_items: NotRequired[List["PaymentLinkCreateParamsOptionalItem"]] """ - A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices). + A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://docs.stripe.com/api/prices). There is a maximum of 10 optional items allowed on a payment link, and the existing limits on the number of line items allowed on a payment link apply to the combined number of line items and optional items. There is a maximum of 20 combined line items and optional items. """ @@ -96,7 +96,7 @@ class PaymentLinkCreateParams(RequestOptions): Can only be set in `subscription` mode. Defaults to `always`. - If you'd like information on how to collect a payment method outside of Checkout, read the guide on [configuring subscriptions with a free trial](https://stripe.com/docs/payments/checkout/free-trials). + If you'd like information on how to collect a payment method outside of Checkout, read the guide on [configuring subscriptions with a free trial](https://docs.stripe.com/payments/checkout/free-trials). """ payment_method_types: NotRequired[ List[ @@ -149,7 +149,7 @@ class PaymentLinkCreateParams(RequestOptions): ] ] """ - The list of payment method types that customers can use. If no value is passed, Stripe will dynamically show relevant payment methods from your [payment method settings](https://dashboard.stripe.com/settings/payment_methods) (20+ payment methods [supported](https://stripe.com/docs/payments/payment-methods/integration-options#payment-method-product-support)). + The list of payment method types that customers can use. If no value is passed, Stripe will dynamically show relevant payment methods from your [payment method settings](https://dashboard.stripe.com/settings/payment_methods) (20+ payment methods [supported](https://docs.stripe.com/payments/payment-methods/integration-options#payment-method-product-support)). """ phone_number_collection: NotRequired[ "PaymentLinkCreateParamsPhoneNumberCollection" @@ -173,13 +173,13 @@ class PaymentLinkCreateParams(RequestOptions): List["PaymentLinkCreateParamsShippingOption"] ] """ - The shipping rate options to apply to [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link. + The shipping rate options to apply to [checkout sessions](https://docs.stripe.com/api/checkout/sessions) created by this payment link. """ submit_type: NotRequired[ Literal["auto", "book", "donate", "pay", "subscribe"] ] """ - Describes the type of transaction being performed in order to customize relevant text on the page, such as the submit button. Changing this value will also affect the hostname in the [url](https://stripe.com/docs/api/payment_links/payment_links/object#url) property (example: `donate.stripe.com`). + Describes the type of transaction being performed in order to customize relevant text on the page, such as the submit button. Changing this value will also affect the hostname in the [url](https://docs.stripe.com/api/payment_links/payment_links/object#url) property (example: `donate.stripe.com`). """ subscription_data: NotRequired["PaymentLinkCreateParamsSubscriptionData"] """ @@ -222,7 +222,7 @@ class PaymentLinkCreateParamsAfterCompletionHostedConfirmation(TypedDict): class PaymentLinkCreateParamsAfterCompletionRedirect(TypedDict): url: str """ - The URL the customer will be redirected to after the purchase is complete. You can embed `{CHECKOUT_SESSION_ID}` into the URL to have the `id` of the completed [checkout session](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-id) included. + The URL the customer will be redirected to after the purchase is complete. You can embed `{CHECKOUT_SESSION_ID}` into the URL to have the `id` of the completed [checkout session](https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-id) included. """ @@ -467,7 +467,7 @@ class PaymentLinkCreateParamsInvoiceCreationInvoiceData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ rendering_options: NotRequired[ "Literal['']|PaymentLinkCreateParamsInvoiceCreationInvoiceDataRenderingOptions" @@ -523,11 +523,11 @@ class PaymentLinkCreateParamsLineItem(TypedDict): """ price: NotRequired[str] """ - The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. One of `price` or `price_data` is required. + The ID of the [Price](https://docs.stripe.com/api/prices) or [Plan](https://docs.stripe.com/api/plans) object. One of `price` or `price_data` is required. """ price_data: NotRequired["PaymentLinkCreateParamsLineItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: int """ @@ -571,7 +571,7 @@ class PaymentLinkCreateParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -594,7 +594,7 @@ class PaymentLinkCreateParamsLineItemPriceDataProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -602,7 +602,7 @@ class PaymentLinkCreateParamsLineItemPriceDataProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ @@ -663,7 +663,7 @@ class PaymentLinkCreateParamsOptionalItem(TypedDict): """ price: str """ - The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. + The ID of the [Price](https://docs.stripe.com/api/prices) or [Plan](https://docs.stripe.com/api/plans) object. """ quantity: int """ @@ -699,11 +699,11 @@ class PaymentLinkCreateParamsPaymentIntentData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will declaratively set metadata on [Payment Intents](https://stripe.com/docs/api/payment_intents) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will declaratively set metadata on [Payment Intents](https://docs.stripe.com/api/payment_intents) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ setup_future_usage: NotRequired[Literal["off_session", "on_session"]] """ - Indicates that you intend to [make future payments](https://stripe.com/docs/payments/payment-intents#future-usage) with the payment method collected by this Checkout Session. + Indicates that you intend to [make future payments](https://docs.stripe.com/payments/payment-intents#future-usage) with the payment method collected by this Checkout Session. When setting this to `on_session`, Checkout will show a notice to the customer that their payment details will be saved. @@ -727,7 +727,7 @@ class PaymentLinkCreateParamsPaymentIntentData(TypedDict): """ transfer_group: NotRequired[str] """ - A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details. + A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers) for details. """ @@ -1021,7 +1021,7 @@ class PaymentLinkCreateParamsSubscriptionData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will declaratively set metadata on [Subscriptions](https://stripe.com/docs/api/subscriptions) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will declaratively set metadata on [Subscriptions](https://docs.stripe.com/api/subscriptions) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ trial_period_days: NotRequired[int] """ diff --git a/stripe/params/_payment_link_modify_params.py b/stripe/params/_payment_link_modify_params.py index 03aa05bda..e0f86a1e1 100644 --- a/stripe/params/_payment_link_modify_params.py +++ b/stripe/params/_payment_link_modify_params.py @@ -38,7 +38,7 @@ class PaymentLinkModifyParams(RequestOptions): """ customer_creation: NotRequired[Literal["always", "if_required"]] """ - Configures whether [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link create a [Customer](https://stripe.com/docs/api/customers). + Configures whether [checkout sessions](https://docs.stripe.com/api/checkout/sessions) created by this payment link create a [Customer](https://docs.stripe.com/api/customers). """ expand: NotRequired[List[str]] """ @@ -58,7 +58,7 @@ class PaymentLinkModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. Metadata associated with this Payment Link will automatically be copied to [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. Metadata associated with this Payment Link will automatically be copied to [checkout sessions](https://docs.stripe.com/api/checkout/sessions) created by this payment link. """ name_collection: NotRequired[ "Literal['']|PaymentLinkModifyParamsNameCollection" @@ -78,7 +78,7 @@ class PaymentLinkModifyParams(RequestOptions): Can only be set in `subscription` mode. Defaults to `always`. - If you'd like information on how to collect a payment method outside of Checkout, read the guide on [configuring subscriptions with a free trial](https://stripe.com/docs/payments/checkout/free-trials). + If you'd like information on how to collect a payment method outside of Checkout, read the guide on [configuring subscriptions with a free trial](https://docs.stripe.com/payments/checkout/free-trials). """ payment_method_types: NotRequired[ "Literal['']|List[Literal['affirm', 'afterpay_clearpay', 'alipay', 'alma', 'au_becs_debit', 'bacs_debit', 'bancontact', 'billie', 'blik', 'boleto', 'card', 'cashapp', 'eps', 'fpx', 'giropay', 'gopay', 'grabpay', 'ideal', 'klarna', 'konbini', 'link', 'mb_way', 'mobilepay', 'multibanco', 'oxxo', 'p24', 'pay_by_bank', 'paynow', 'paypal', 'paypay', 'payto', 'pix', 'promptpay', 'qris', 'rechnung', 'satispay', 'sepa_debit', 'shopeepay', 'sofort', 'swish', 'twint', 'us_bank_account', 'wechat_pay', 'zip']]" @@ -110,7 +110,7 @@ class PaymentLinkModifyParams(RequestOptions): Literal["auto", "book", "donate", "pay", "subscribe"] ] """ - Describes the type of transaction being performed in order to customize relevant text on the page, such as the submit button. Changing this value will also affect the hostname in the [url](https://stripe.com/docs/api/payment_links/payment_links/object#url) property (example: `donate.stripe.com`). + Describes the type of transaction being performed in order to customize relevant text on the page, such as the submit button. Changing this value will also affect the hostname in the [url](https://docs.stripe.com/api/payment_links/payment_links/object#url) property (example: `donate.stripe.com`). """ subscription_data: NotRequired["PaymentLinkModifyParamsSubscriptionData"] """ @@ -149,7 +149,7 @@ class PaymentLinkModifyParamsAfterCompletionHostedConfirmation(TypedDict): class PaymentLinkModifyParamsAfterCompletionRedirect(TypedDict): url: str """ - The URL the customer will be redirected to after the purchase is complete. You can embed `{CHECKOUT_SESSION_ID}` into the URL to have the `id` of the completed [checkout session](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-id) included. + The URL the customer will be redirected to after the purchase is complete. You can embed `{CHECKOUT_SESSION_ID}` into the URL to have the `id` of the completed [checkout session](https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-id) included. """ @@ -364,7 +364,7 @@ class PaymentLinkModifyParamsInvoiceCreationInvoiceData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ rendering_options: NotRequired[ "Literal['']|PaymentLinkModifyParamsInvoiceCreationInvoiceDataRenderingOptions" @@ -483,7 +483,7 @@ class PaymentLinkModifyParamsPaymentIntentData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will declaratively set metadata on [Payment Intents](https://stripe.com/docs/api/payment_intents) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will declaratively set metadata on [Payment Intents](https://docs.stripe.com/api/payment_intents) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ statement_descriptor: NotRequired["Literal['']|str"] """ @@ -497,7 +497,7 @@ class PaymentLinkModifyParamsPaymentIntentData(TypedDict): """ transfer_group: NotRequired["Literal['']|str"] """ - A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details. + A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers) for details. """ @@ -780,7 +780,7 @@ class PaymentLinkModifyParamsSubscriptionData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will declaratively set metadata on [Subscriptions](https://stripe.com/docs/api/subscriptions) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will declaratively set metadata on [Subscriptions](https://docs.stripe.com/api/subscriptions) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ trial_period_days: NotRequired["Literal['']|int"] """ diff --git a/stripe/params/_payment_link_update_params.py b/stripe/params/_payment_link_update_params.py index 85f0949fd..7388ff734 100644 --- a/stripe/params/_payment_link_update_params.py +++ b/stripe/params/_payment_link_update_params.py @@ -37,7 +37,7 @@ class PaymentLinkUpdateParams(TypedDict): """ customer_creation: NotRequired[Literal["always", "if_required"]] """ - Configures whether [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link create a [Customer](https://stripe.com/docs/api/customers). + Configures whether [checkout sessions](https://docs.stripe.com/api/checkout/sessions) created by this payment link create a [Customer](https://docs.stripe.com/api/customers). """ expand: NotRequired[List[str]] """ @@ -57,7 +57,7 @@ class PaymentLinkUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. Metadata associated with this Payment Link will automatically be copied to [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. Metadata associated with this Payment Link will automatically be copied to [checkout sessions](https://docs.stripe.com/api/checkout/sessions) created by this payment link. """ name_collection: NotRequired[ "Literal['']|PaymentLinkUpdateParamsNameCollection" @@ -77,7 +77,7 @@ class PaymentLinkUpdateParams(TypedDict): Can only be set in `subscription` mode. Defaults to `always`. - If you'd like information on how to collect a payment method outside of Checkout, read the guide on [configuring subscriptions with a free trial](https://stripe.com/docs/payments/checkout/free-trials). + If you'd like information on how to collect a payment method outside of Checkout, read the guide on [configuring subscriptions with a free trial](https://docs.stripe.com/payments/checkout/free-trials). """ payment_method_types: NotRequired[ "Literal['']|List[Literal['affirm', 'afterpay_clearpay', 'alipay', 'alma', 'au_becs_debit', 'bacs_debit', 'bancontact', 'billie', 'blik', 'boleto', 'card', 'cashapp', 'eps', 'fpx', 'giropay', 'gopay', 'grabpay', 'ideal', 'klarna', 'konbini', 'link', 'mb_way', 'mobilepay', 'multibanco', 'oxxo', 'p24', 'pay_by_bank', 'paynow', 'paypal', 'paypay', 'payto', 'pix', 'promptpay', 'qris', 'rechnung', 'satispay', 'sepa_debit', 'shopeepay', 'sofort', 'swish', 'twint', 'us_bank_account', 'wechat_pay', 'zip']]" @@ -109,7 +109,7 @@ class PaymentLinkUpdateParams(TypedDict): Literal["auto", "book", "donate", "pay", "subscribe"] ] """ - Describes the type of transaction being performed in order to customize relevant text on the page, such as the submit button. Changing this value will also affect the hostname in the [url](https://stripe.com/docs/api/payment_links/payment_links/object#url) property (example: `donate.stripe.com`). + Describes the type of transaction being performed in order to customize relevant text on the page, such as the submit button. Changing this value will also affect the hostname in the [url](https://docs.stripe.com/api/payment_links/payment_links/object#url) property (example: `donate.stripe.com`). """ subscription_data: NotRequired["PaymentLinkUpdateParamsSubscriptionData"] """ @@ -148,7 +148,7 @@ class PaymentLinkUpdateParamsAfterCompletionHostedConfirmation(TypedDict): class PaymentLinkUpdateParamsAfterCompletionRedirect(TypedDict): url: str """ - The URL the customer will be redirected to after the purchase is complete. You can embed `{CHECKOUT_SESSION_ID}` into the URL to have the `id` of the completed [checkout session](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-id) included. + The URL the customer will be redirected to after the purchase is complete. You can embed `{CHECKOUT_SESSION_ID}` into the URL to have the `id` of the completed [checkout session](https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-id) included. """ @@ -363,7 +363,7 @@ class PaymentLinkUpdateParamsInvoiceCreationInvoiceData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ rendering_options: NotRequired[ "Literal['']|PaymentLinkUpdateParamsInvoiceCreationInvoiceDataRenderingOptions" @@ -482,7 +482,7 @@ class PaymentLinkUpdateParamsPaymentIntentData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will declaratively set metadata on [Payment Intents](https://stripe.com/docs/api/payment_intents) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will declaratively set metadata on [Payment Intents](https://docs.stripe.com/api/payment_intents) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ statement_descriptor: NotRequired["Literal['']|str"] """ @@ -496,7 +496,7 @@ class PaymentLinkUpdateParamsPaymentIntentData(TypedDict): """ transfer_group: NotRequired["Literal['']|str"] """ - A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details. + A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers) for details. """ @@ -779,7 +779,7 @@ class PaymentLinkUpdateParamsSubscriptionData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will declaratively set metadata on [Subscriptions](https://stripe.com/docs/api/subscriptions) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will declaratively set metadata on [Subscriptions](https://docs.stripe.com/api/subscriptions) generated from this payment link. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ trial_period_days: NotRequired["Literal['']|int"] """ diff --git a/stripe/params/_payment_method_attach_params.py b/stripe/params/_payment_method_attach_params.py index bde9583a3..95dcf6bbb 100644 --- a/stripe/params/_payment_method_attach_params.py +++ b/stripe/params/_payment_method_attach_params.py @@ -12,7 +12,7 @@ class PaymentMethodAttachParams(RequestOptions): """ customer_account: NotRequired[str] """ - The ID of the account to which to attach the PaymentMethod. + The ID of the Account representing the customer to which to attach the PaymentMethod. """ expand: NotRequired[List[str]] """ diff --git a/stripe/params/_payment_method_configuration_create_params.py b/stripe/params/_payment_method_configuration_create_params.py index 99e265abe..37c71f565 100644 --- a/stripe/params/_payment_method_configuration_create_params.py +++ b/stripe/params/_payment_method_configuration_create_params.py @@ -8,21 +8,21 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): acss_debit: NotRequired["PaymentMethodConfigurationCreateParamsAcssDebit"] """ - Canadian pre-authorized debit payments, check this [page](https://stripe.com/docs/payments/acss-debit) for more details like country availability. + Canadian pre-authorized debit payments, check this [page](https://docs.stripe.com/payments/acss-debit) for more details like country availability. """ affirm: NotRequired["PaymentMethodConfigurationCreateParamsAffirm"] """ - [Affirm](https://www.affirm.com/) gives your customers a way to split purchases over a series of payments. Depending on the purchase, they can pay with four interest-free payments (Split Pay) or pay over a longer term (Installments), which might include interest. Check this [page](https://stripe.com/docs/payments/affirm) for more details like country availability. + [Affirm](https://www.affirm.com/) gives your customers a way to split purchases over a series of payments. Depending on the purchase, they can pay with four interest-free payments (Split Pay) or pay over a longer term (Installments), which might include interest. Check this [page](https://docs.stripe.com/payments/affirm) for more details like country availability. """ afterpay_clearpay: NotRequired[ "PaymentMethodConfigurationCreateParamsAfterpayClearpay" ] """ - Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://stripe.com/docs/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products. + Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://docs.stripe.com/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products. """ alipay: NotRequired["PaymentMethodConfigurationCreateParamsAlipay"] """ - Alipay is a digital wallet in China that has more than a billion active users worldwide. Alipay users can pay on the web or on a mobile device using login credentials or their Alipay app. Alipay has a low dispute rate and reduces fraud by authenticating payments using the customer's login credentials. Check this [page](https://stripe.com/docs/payments/alipay) for more details. + Alipay is a digital wallet in China that has more than a billion active users worldwide. Alipay users can pay on the web or on a mobile device using login credentials or their Alipay app. Alipay has a low dispute rate and reduces fraud by authenticating payments using the customer's login credentials. Check this [page](https://docs.stripe.com/payments/alipay) for more details. """ alma: NotRequired["PaymentMethodConfigurationCreateParamsAlma"] """ @@ -34,7 +34,7 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ apple_pay: NotRequired["PaymentMethodConfigurationCreateParamsApplePay"] """ - Stripe users can accept [Apple Pay](https://stripe.com/payments/apple-pay) in iOS applications in iOS 9 and later, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments, and the [pricing](https://stripe.com/pricing) is the same as other card transactions. Check this [page](https://stripe.com/docs/apple-pay) for more details. + Stripe users can accept [Apple Pay](https://stripe.com/payments/apple-pay) in iOS applications in iOS 9 and later, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments, and the [pricing](https://stripe.com/pricing) is the same as other card transactions. Check this [page](https://docs.stripe.com/apple-pay) for more details. """ apple_pay_later: NotRequired[ "PaymentMethodConfigurationCreateParamsApplePayLater" @@ -46,15 +46,15 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): "PaymentMethodConfigurationCreateParamsAuBecsDebit" ] """ - Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this [page](https://stripe.com/docs/payments/au-becs-debit) for more details. + Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this [page](https://docs.stripe.com/payments/au-becs-debit) for more details. """ bacs_debit: NotRequired["PaymentMethodConfigurationCreateParamsBacsDebit"] """ - Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://stripe.com/docs/payments/payment-methods/bacs-debit) for more details. + Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://docs.stripe.com/payments/payment-methods/bacs-debit) for more details. """ bancontact: NotRequired["PaymentMethodConfigurationCreateParamsBancontact"] """ - Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://stripe.com/docs/api/customers) use a Bancontact card or mobile app linked to a Belgian bank account to make online payments that are secure, guaranteed, and confirmed immediately. Check this [page](https://stripe.com/docs/payments/bancontact) for more details. + Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://docs.stripe.com/api/customers) use a Bancontact card or mobile app linked to a Belgian bank account to make online payments that are secure, guaranteed, and confirmed immediately. Check this [page](https://docs.stripe.com/payments/bancontact) for more details. """ billie: NotRequired["PaymentMethodConfigurationCreateParamsBillie"] """ @@ -62,11 +62,11 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ blik: NotRequired["PaymentMethodConfigurationCreateParamsBlik"] """ - BLIK is a [single use](https://stripe.com/docs/payments/payment-methods#usage) payment method that requires customers to authenticate their payments. When customers want to pay online using BLIK, they request a six-digit code from their banking application and enter it into the payment collection form. Check this [page](https://stripe.com/docs/payments/blik) for more details. + BLIK is a [single use](https://docs.stripe.com/payments/payment-methods#usage) payment method that requires customers to authenticate their payments. When customers want to pay online using BLIK, they request a six-digit code from their banking application and enter it into the payment collection form. Check this [page](https://docs.stripe.com/payments/blik) for more details. """ boleto: NotRequired["PaymentMethodConfigurationCreateParamsBoleto"] """ - Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://stripe.com/docs/payments/boleto) for more details. + Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://docs.stripe.com/payments/boleto) for more details. """ card: NotRequired["PaymentMethodConfigurationCreateParamsCard"] """ @@ -76,25 +76,25 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): "PaymentMethodConfigurationCreateParamsCartesBancaires" ] """ - Cartes Bancaires is France's local card network. More than 95% of these cards are co-branded with either Visa or Mastercard, meaning you can process these cards over either Cartes Bancaires or the Visa or Mastercard networks. Check this [page](https://stripe.com/docs/payments/cartes-bancaires) for more details. + Cartes Bancaires is France's local card network. More than 95% of these cards are co-branded with either Visa or Mastercard, meaning you can process these cards over either Cartes Bancaires or the Visa or Mastercard networks. Check this [page](https://docs.stripe.com/payments/cartes-bancaires) for more details. """ cashapp: NotRequired["PaymentMethodConfigurationCreateParamsCashapp"] """ - Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet. Check this [page](https://stripe.com/docs/payments/cash-app-pay) for more details. + Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet. Check this [page](https://docs.stripe.com/payments/cash-app-pay) for more details. """ crypto: NotRequired["PaymentMethodConfigurationCreateParamsCrypto"] """ - [Stablecoin payments](https://stripe.com/docs/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask. + [Stablecoin payments](https://docs.stripe.com/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask. """ customer_balance: NotRequired[ "PaymentMethodConfigurationCreateParamsCustomerBalance" ] """ - Uses a customer's [cash balance](https://stripe.com/docs/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://stripe.com/docs/payments/bank-transfers) for more details. + Uses a customer's [cash balance](https://docs.stripe.com/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://docs.stripe.com/payments/bank-transfers) for more details. """ eps: NotRequired["PaymentMethodConfigurationCreateParamsEps"] """ - EPS is an Austria-based payment method that allows customers to complete transactions online using their bank credentials. EPS is supported by all Austrian banks and is accepted by over 80% of Austrian online retailers. Check this [page](https://stripe.com/docs/payments/eps) for more details. + EPS is an Austria-based payment method that allows customers to complete transactions online using their bank credentials. EPS is supported by all Austrian banks and is accepted by over 80% of Austrian online retailers. Check this [page](https://docs.stripe.com/payments/eps) for more details. """ expand: NotRequired[List[str]] """ @@ -102,29 +102,29 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ fpx: NotRequired["PaymentMethodConfigurationCreateParamsFpx"] """ - Financial Process Exchange (FPX) is a Malaysia-based payment method that allows customers to complete transactions online using their bank credentials. Bank Negara Malaysia (BNM), the Central Bank of Malaysia, and eleven other major Malaysian financial institutions are members of the PayNet Group, which owns and operates FPX. It is one of the most popular online payment methods in Malaysia, with nearly 90 million transactions in 2018 according to BNM. Check this [page](https://stripe.com/docs/payments/fpx) for more details. + Financial Process Exchange (FPX) is a Malaysia-based payment method that allows customers to complete transactions online using their bank credentials. Bank Negara Malaysia (BNM), the Central Bank of Malaysia, and eleven other major Malaysian financial institutions are members of the PayNet Group, which owns and operates FPX. It is one of the most popular online payment methods in Malaysia, with nearly 90 million transactions in 2018 according to BNM. Check this [page](https://docs.stripe.com/payments/fpx) for more details. """ fr_meal_voucher_conecs: NotRequired[ "PaymentMethodConfigurationCreateParamsFrMealVoucherConecs" ] """ - Meal vouchers in France, or “titres-restaurant”, is a local benefits program commonly offered by employers for their employees to purchase prepared food and beverages on working days. Check this [page](https://stripe.com/docs/payments/benefits/fr-meal-vouchers) for more details. + Meal vouchers in France, or “titres-restaurant”, is a local benefits program commonly offered by employers for their employees to purchase prepared food and beverages on working days. Check this [page](https://docs.stripe.com/payments/benefits/fr-meal-vouchers) for more details. """ giropay: NotRequired["PaymentMethodConfigurationCreateParamsGiropay"] """ - giropay is a German payment method based on online banking, introduced in 2006. It allows customers to complete transactions online using their online banking environment, with funds debited from their bank account. Depending on their bank, customers confirm payments on giropay using a second factor of authentication or a PIN. giropay accounts for 10% of online checkouts in Germany. Check this [page](https://stripe.com/docs/payments/giropay) for more details. + giropay is a German payment method based on online banking, introduced in 2006. It allows customers to complete transactions online using their online banking environment, with funds debited from their bank account. Depending on their bank, customers confirm payments on giropay using a second factor of authentication or a PIN. giropay accounts for 10% of online checkouts in Germany. Check this [page](https://docs.stripe.com/payments/giropay) for more details. """ google_pay: NotRequired["PaymentMethodConfigurationCreateParamsGooglePay"] """ - Google Pay allows customers to make payments in your app or website using any credit or debit card saved to their Google Account, including those from Google Play, YouTube, Chrome, or an Android device. Use the Google Pay API to request any credit or debit card stored in your customer's Google account. Check this [page](https://stripe.com/docs/google-pay) for more details. + Google Pay allows customers to make payments in your app or website using any credit or debit card saved to their Google Account, including those from Google Play, YouTube, Chrome, or an Android device. Use the Google Pay API to request any credit or debit card stored in your customer's Google account. Check this [page](https://docs.stripe.com/google-pay) for more details. """ gopay: NotRequired["PaymentMethodConfigurationCreateParamsGopay"] """ - GoPay is a [single use](https://stripe.com/docs/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Gojek app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Gojek app to confirm payment. + GoPay is a [single use](https://docs.stripe.com/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Gojek app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Gojek app to confirm payment. """ grabpay: NotRequired["PaymentMethodConfigurationCreateParamsGrabpay"] """ - GrabPay is a payment method developed by [Grab](https://www.grab.com/sg/consumer/finance/pay/). GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this [page](https://stripe.com/docs/payments/grabpay) for more details. + GrabPay is a payment method developed by [Grab](https://www.grab.com/sg/consumer/finance/pay/). GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this [page](https://docs.stripe.com/payments/grabpay) for more details. """ id_bank_transfer: NotRequired[ "PaymentMethodConfigurationCreateParamsIdBankTransfer" @@ -134,7 +134,7 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ ideal: NotRequired["PaymentMethodConfigurationCreateParamsIdeal"] """ - iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their bank credentials. All major Dutch banks are members of Currence, the scheme that operates iDEAL, making it the most popular online payment method in the Netherlands with a share of online transactions close to 55%. Check this [page](https://stripe.com/docs/payments/ideal) for more details. + iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their bank credentials. All major Dutch banks are members of Currence, the scheme that operates iDEAL, making it the most popular online payment method in the Netherlands with a share of online transactions close to 55%. Check this [page](https://docs.stripe.com/payments/ideal) for more details. """ jcb: NotRequired["PaymentMethodConfigurationCreateParamsJcb"] """ @@ -146,11 +146,11 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ klarna: NotRequired["PaymentMethodConfigurationCreateParamsKlarna"] """ - Klarna gives customers a range of [payment options](https://stripe.com/docs/payments/klarna#payment-options) during checkout. Available payment options vary depending on the customer's billing address and the transaction amount. These payment options make it convenient for customers to purchase items in all price ranges. Check this [page](https://stripe.com/docs/payments/klarna) for more details. + Klarna gives customers a range of [payment options](https://docs.stripe.com/payments/klarna#payment-options) during checkout. Available payment options vary depending on the customer's billing address and the transaction amount. These payment options make it convenient for customers to purchase items in all price ranges. Check this [page](https://docs.stripe.com/payments/klarna) for more details. """ konbini: NotRequired["PaymentMethodConfigurationCreateParamsKonbini"] """ - Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://stripe.com/docs/payments/konbini) for more details. + Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://docs.stripe.com/payments/konbini) for more details. """ kr_card: NotRequired["PaymentMethodConfigurationCreateParamsKrCard"] """ @@ -158,15 +158,15 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ link: NotRequired["PaymentMethodConfigurationCreateParamsLink"] """ - [Link](https://stripe.com/docs/payments/link) is a payment method network. With Link, users save their payment details once, then reuse that information to pay with one click for any business on the network. + [Link](https://docs.stripe.com/payments/link) is a payment method network. With Link, users save their payment details once, then reuse that information to pay with one click for any business on the network. """ mb_way: NotRequired["PaymentMethodConfigurationCreateParamsMbWay"] """ - MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://stripe.com/docs/payments/mb-way) for more details. + MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://docs.stripe.com/payments/mb-way) for more details. """ mobilepay: NotRequired["PaymentMethodConfigurationCreateParamsMobilepay"] """ - MobilePay is a [single-use](https://stripe.com/docs/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://stripe.com/docs/payments/mobilepay) for more details. + MobilePay is a [single-use](https://docs.stripe.com/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://docs.stripe.com/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://docs.stripe.com/payments/mobilepay) for more details. """ multibanco: NotRequired["PaymentMethodConfigurationCreateParamsMultibanco"] """ @@ -184,15 +184,15 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): "PaymentMethodConfigurationCreateParamsNzBankAccount" ] """ - Stripe users in New Zealand can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with a New Zeland bank account. Check this [page](https://stripe.com/docs/payments/nz-bank-account) for more details. + Stripe users in New Zealand can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with a New Zeland bank account. Check this [page](https://docs.stripe.com/payments/nz-bank-account) for more details. """ oxxo: NotRequired["PaymentMethodConfigurationCreateParamsOxxo"] """ - OXXO is a Mexican chain of convenience stores with thousands of locations across Latin America and represents nearly 20% of online transactions in Mexico. OXXO allows customers to pay bills and online purchases in-store with cash. Check this [page](https://stripe.com/docs/payments/oxxo) for more details. + OXXO is a Mexican chain of convenience stores with thousands of locations across Latin America and represents nearly 20% of online transactions in Mexico. OXXO allows customers to pay bills and online purchases in-store with cash. Check this [page](https://docs.stripe.com/payments/oxxo) for more details. """ p24: NotRequired["PaymentMethodConfigurationCreateParamsP24"] """ - Przelewy24 is a Poland-based payment method aggregator that allows customers to complete transactions online using bank transfers and other methods. Bank transfers account for 30% of online payments in Poland and Przelewy24 provides a way for customers to pay with over 165 banks. Check this [page](https://stripe.com/docs/payments/p24) for more details. + Przelewy24 is a Poland-based payment method aggregator that allows customers to complete transactions online using bank transfers and other methods. Bank transfers account for 30% of online payments in Poland and Przelewy24 provides a way for customers to pay with over 165 banks. Check this [page](https://docs.stripe.com/payments/p24) for more details. """ parent: NotRequired[str] """ @@ -208,11 +208,11 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ paynow: NotRequired["PaymentMethodConfigurationCreateParamsPaynow"] """ - PayNow is a Singapore-based payment method that allows customers to make a payment using their preferred app from participating banks and participating non-bank financial institutions. Check this [page](https://stripe.com/docs/payments/paynow) for more details. + PayNow is a Singapore-based payment method that allows customers to make a payment using their preferred app from participating banks and participating non-bank financial institutions. Check this [page](https://docs.stripe.com/payments/paynow) for more details. """ paypal: NotRequired["PaymentMethodConfigurationCreateParamsPaypal"] """ - PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this [page](https://stripe.com/docs/payments/paypal) for more details. + PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this [page](https://docs.stripe.com/payments/paypal) for more details. """ paypay: NotRequired["PaymentMethodConfigurationCreateParamsPaypay"] """ @@ -228,7 +228,7 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ promptpay: NotRequired["PaymentMethodConfigurationCreateParamsPromptpay"] """ - PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this [page](https://stripe.com/docs/payments/promptpay) for more details. + PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this [page](https://docs.stripe.com/payments/promptpay) for more details. """ qris: NotRequired["PaymentMethodConfigurationCreateParamsQris"] """ @@ -252,19 +252,19 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): """ sepa_debit: NotRequired["PaymentMethodConfigurationCreateParamsSepaDebit"] """ - The [Single Euro Payments Area (SEPA)](https://en.wikipedia.org/wiki/Single_Euro_Payments_Area) is an initiative of the European Union to simplify payments within and across member countries. SEPA established and enforced banking standards to allow for the direct debiting of every EUR-denominated bank account within the SEPA region, check this [page](https://stripe.com/docs/payments/sepa-debit) for more details. + The [Single Euro Payments Area (SEPA)](https://en.wikipedia.org/wiki/Single_Euro_Payments_Area) is an initiative of the European Union to simplify payments within and across member countries. SEPA established and enforced banking standards to allow for the direct debiting of every EUR-denominated bank account within the SEPA region, check this [page](https://docs.stripe.com/payments/sepa-debit) for more details. """ shopeepay: NotRequired["PaymentMethodConfigurationCreateParamsShopeepay"] """ - ShopeePay is a [single use](https://stripe.com/docs/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Shopee app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Shopee app to confirm payment. + ShopeePay is a [single use](https://docs.stripe.com/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Shopee app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Shopee app to confirm payment. """ sofort: NotRequired["PaymentMethodConfigurationCreateParamsSofort"] """ - Stripe users in Europe and the United States can use the [Payment Intents API](https://stripe.com/docs/payments/payment-intents)—a single integration path for creating payments using any supported method—to accept [Sofort](https://www.sofort.com/) payments from customers. Check this [page](https://stripe.com/docs/payments/sofort) for more details. + Stripe users in Europe and the United States can use the [Payment Intents API](https://stripe.com/docs/payments/payment-intents)—a single integration path for creating payments using any supported method—to accept [Sofort](https://www.sofort.com/) payments from customers. Check this [page](https://docs.stripe.com/payments/sofort) for more details. """ swish: NotRequired["PaymentMethodConfigurationCreateParamsSwish"] """ - Swish is a [real-time](https://stripe.com/docs/payments/real-time) payment method popular in Sweden. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the Swish mobile app and the Swedish BankID mobile app. Check this [page](https://stripe.com/docs/payments/swish) for more details. + Swish is a [real-time](https://docs.stripe.com/payments/real-time) payment method popular in Sweden. It allows customers to [authenticate and approve](https://docs.stripe.com/payments/payment-methods#customer-actions) payments using the Swish mobile app and the Swedish BankID mobile app. Check this [page](https://docs.stripe.com/payments/swish) for more details. """ twint: NotRequired["PaymentMethodConfigurationCreateParamsTwint"] """ @@ -274,15 +274,15 @@ class PaymentMethodConfigurationCreateParams(RequestOptions): "PaymentMethodConfigurationCreateParamsUsBankAccount" ] """ - Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://stripe.com/docs/payments/ach-direct-debit) for more details. + Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://docs.stripe.com/payments/ach-direct-debit) for more details. """ wechat_pay: NotRequired["PaymentMethodConfigurationCreateParamsWechatPay"] """ - WeChat, owned by Tencent, is China's leading mobile app with over 1 billion monthly active users. Chinese consumers can use WeChat Pay to pay for goods and services inside of businesses' apps and websites. WeChat Pay users buy most frequently in gaming, e-commerce, travel, online education, and food/nutrition. Check this [page](https://stripe.com/docs/payments/wechat-pay) for more details. + WeChat, owned by Tencent, is China's leading mobile app with over 1 billion monthly active users. Chinese consumers can use WeChat Pay to pay for goods and services inside of businesses' apps and websites. WeChat Pay users buy most frequently in gaming, e-commerce, travel, online education, and food/nutrition. Check this [page](https://docs.stripe.com/payments/wechat-pay) for more details. """ zip: NotRequired["PaymentMethodConfigurationCreateParamsZip"] """ - Zip gives your customers a way to split purchases over a series of payments. Check this [page](https://stripe.com/docs/payments/zip) for more details like country availability. + Zip gives your customers a way to split purchases over a series of payments. Check this [page](https://docs.stripe.com/payments/zip) for more details like country availability. """ diff --git a/stripe/params/_payment_method_configuration_modify_params.py b/stripe/params/_payment_method_configuration_modify_params.py index c95ea3d76..0a1de919b 100644 --- a/stripe/params/_payment_method_configuration_modify_params.py +++ b/stripe/params/_payment_method_configuration_modify_params.py @@ -8,7 +8,7 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): acss_debit: NotRequired["PaymentMethodConfigurationModifyParamsAcssDebit"] """ - Canadian pre-authorized debit payments, check this [page](https://stripe.com/docs/payments/acss-debit) for more details like country availability. + Canadian pre-authorized debit payments, check this [page](https://docs.stripe.com/payments/acss-debit) for more details like country availability. """ active: NotRequired[bool] """ @@ -16,17 +16,17 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ affirm: NotRequired["PaymentMethodConfigurationModifyParamsAffirm"] """ - [Affirm](https://www.affirm.com/) gives your customers a way to split purchases over a series of payments. Depending on the purchase, they can pay with four interest-free payments (Split Pay) or pay over a longer term (Installments), which might include interest. Check this [page](https://stripe.com/docs/payments/affirm) for more details like country availability. + [Affirm](https://www.affirm.com/) gives your customers a way to split purchases over a series of payments. Depending on the purchase, they can pay with four interest-free payments (Split Pay) or pay over a longer term (Installments), which might include interest. Check this [page](https://docs.stripe.com/payments/affirm) for more details like country availability. """ afterpay_clearpay: NotRequired[ "PaymentMethodConfigurationModifyParamsAfterpayClearpay" ] """ - Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://stripe.com/docs/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products. + Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://docs.stripe.com/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products. """ alipay: NotRequired["PaymentMethodConfigurationModifyParamsAlipay"] """ - Alipay is a digital wallet in China that has more than a billion active users worldwide. Alipay users can pay on the web or on a mobile device using login credentials or their Alipay app. Alipay has a low dispute rate and reduces fraud by authenticating payments using the customer's login credentials. Check this [page](https://stripe.com/docs/payments/alipay) for more details. + Alipay is a digital wallet in China that has more than a billion active users worldwide. Alipay users can pay on the web or on a mobile device using login credentials or their Alipay app. Alipay has a low dispute rate and reduces fraud by authenticating payments using the customer's login credentials. Check this [page](https://docs.stripe.com/payments/alipay) for more details. """ alma: NotRequired["PaymentMethodConfigurationModifyParamsAlma"] """ @@ -38,7 +38,7 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ apple_pay: NotRequired["PaymentMethodConfigurationModifyParamsApplePay"] """ - Stripe users can accept [Apple Pay](https://stripe.com/payments/apple-pay) in iOS applications in iOS 9 and later, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments, and the [pricing](https://stripe.com/pricing) is the same as other card transactions. Check this [page](https://stripe.com/docs/apple-pay) for more details. + Stripe users can accept [Apple Pay](https://stripe.com/payments/apple-pay) in iOS applications in iOS 9 and later, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments, and the [pricing](https://stripe.com/pricing) is the same as other card transactions. Check this [page](https://docs.stripe.com/apple-pay) for more details. """ apple_pay_later: NotRequired[ "PaymentMethodConfigurationModifyParamsApplePayLater" @@ -50,15 +50,15 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): "PaymentMethodConfigurationModifyParamsAuBecsDebit" ] """ - Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this [page](https://stripe.com/docs/payments/au-becs-debit) for more details. + Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this [page](https://docs.stripe.com/payments/au-becs-debit) for more details. """ bacs_debit: NotRequired["PaymentMethodConfigurationModifyParamsBacsDebit"] """ - Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://stripe.com/docs/payments/payment-methods/bacs-debit) for more details. + Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://docs.stripe.com/payments/payment-methods/bacs-debit) for more details. """ bancontact: NotRequired["PaymentMethodConfigurationModifyParamsBancontact"] """ - Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://stripe.com/docs/api/customers) use a Bancontact card or mobile app linked to a Belgian bank account to make online payments that are secure, guaranteed, and confirmed immediately. Check this [page](https://stripe.com/docs/payments/bancontact) for more details. + Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://docs.stripe.com/api/customers) use a Bancontact card or mobile app linked to a Belgian bank account to make online payments that are secure, guaranteed, and confirmed immediately. Check this [page](https://docs.stripe.com/payments/bancontact) for more details. """ billie: NotRequired["PaymentMethodConfigurationModifyParamsBillie"] """ @@ -66,11 +66,11 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ blik: NotRequired["PaymentMethodConfigurationModifyParamsBlik"] """ - BLIK is a [single use](https://stripe.com/docs/payments/payment-methods#usage) payment method that requires customers to authenticate their payments. When customers want to pay online using BLIK, they request a six-digit code from their banking application and enter it into the payment collection form. Check this [page](https://stripe.com/docs/payments/blik) for more details. + BLIK is a [single use](https://docs.stripe.com/payments/payment-methods#usage) payment method that requires customers to authenticate their payments. When customers want to pay online using BLIK, they request a six-digit code from their banking application and enter it into the payment collection form. Check this [page](https://docs.stripe.com/payments/blik) for more details. """ boleto: NotRequired["PaymentMethodConfigurationModifyParamsBoleto"] """ - Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://stripe.com/docs/payments/boleto) for more details. + Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://docs.stripe.com/payments/boleto) for more details. """ card: NotRequired["PaymentMethodConfigurationModifyParamsCard"] """ @@ -80,25 +80,25 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): "PaymentMethodConfigurationModifyParamsCartesBancaires" ] """ - Cartes Bancaires is France's local card network. More than 95% of these cards are co-branded with either Visa or Mastercard, meaning you can process these cards over either Cartes Bancaires or the Visa or Mastercard networks. Check this [page](https://stripe.com/docs/payments/cartes-bancaires) for more details. + Cartes Bancaires is France's local card network. More than 95% of these cards are co-branded with either Visa or Mastercard, meaning you can process these cards over either Cartes Bancaires or the Visa or Mastercard networks. Check this [page](https://docs.stripe.com/payments/cartes-bancaires) for more details. """ cashapp: NotRequired["PaymentMethodConfigurationModifyParamsCashapp"] """ - Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet. Check this [page](https://stripe.com/docs/payments/cash-app-pay) for more details. + Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet. Check this [page](https://docs.stripe.com/payments/cash-app-pay) for more details. """ crypto: NotRequired["PaymentMethodConfigurationModifyParamsCrypto"] """ - [Stablecoin payments](https://stripe.com/docs/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask. + [Stablecoin payments](https://docs.stripe.com/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask. """ customer_balance: NotRequired[ "PaymentMethodConfigurationModifyParamsCustomerBalance" ] """ - Uses a customer's [cash balance](https://stripe.com/docs/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://stripe.com/docs/payments/bank-transfers) for more details. + Uses a customer's [cash balance](https://docs.stripe.com/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://docs.stripe.com/payments/bank-transfers) for more details. """ eps: NotRequired["PaymentMethodConfigurationModifyParamsEps"] """ - EPS is an Austria-based payment method that allows customers to complete transactions online using their bank credentials. EPS is supported by all Austrian banks and is accepted by over 80% of Austrian online retailers. Check this [page](https://stripe.com/docs/payments/eps) for more details. + EPS is an Austria-based payment method that allows customers to complete transactions online using their bank credentials. EPS is supported by all Austrian banks and is accepted by over 80% of Austrian online retailers. Check this [page](https://docs.stripe.com/payments/eps) for more details. """ expand: NotRequired[List[str]] """ @@ -106,29 +106,29 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ fpx: NotRequired["PaymentMethodConfigurationModifyParamsFpx"] """ - Financial Process Exchange (FPX) is a Malaysia-based payment method that allows customers to complete transactions online using their bank credentials. Bank Negara Malaysia (BNM), the Central Bank of Malaysia, and eleven other major Malaysian financial institutions are members of the PayNet Group, which owns and operates FPX. It is one of the most popular online payment methods in Malaysia, with nearly 90 million transactions in 2018 according to BNM. Check this [page](https://stripe.com/docs/payments/fpx) for more details. + Financial Process Exchange (FPX) is a Malaysia-based payment method that allows customers to complete transactions online using their bank credentials. Bank Negara Malaysia (BNM), the Central Bank of Malaysia, and eleven other major Malaysian financial institutions are members of the PayNet Group, which owns and operates FPX. It is one of the most popular online payment methods in Malaysia, with nearly 90 million transactions in 2018 according to BNM. Check this [page](https://docs.stripe.com/payments/fpx) for more details. """ fr_meal_voucher_conecs: NotRequired[ "PaymentMethodConfigurationModifyParamsFrMealVoucherConecs" ] """ - Meal vouchers in France, or “titres-restaurant”, is a local benefits program commonly offered by employers for their employees to purchase prepared food and beverages on working days. Check this [page](https://stripe.com/docs/payments/benefits/fr-meal-vouchers) for more details. + Meal vouchers in France, or “titres-restaurant”, is a local benefits program commonly offered by employers for their employees to purchase prepared food and beverages on working days. Check this [page](https://docs.stripe.com/payments/benefits/fr-meal-vouchers) for more details. """ giropay: NotRequired["PaymentMethodConfigurationModifyParamsGiropay"] """ - giropay is a German payment method based on online banking, introduced in 2006. It allows customers to complete transactions online using their online banking environment, with funds debited from their bank account. Depending on their bank, customers confirm payments on giropay using a second factor of authentication or a PIN. giropay accounts for 10% of online checkouts in Germany. Check this [page](https://stripe.com/docs/payments/giropay) for more details. + giropay is a German payment method based on online banking, introduced in 2006. It allows customers to complete transactions online using their online banking environment, with funds debited from their bank account. Depending on their bank, customers confirm payments on giropay using a second factor of authentication or a PIN. giropay accounts for 10% of online checkouts in Germany. Check this [page](https://docs.stripe.com/payments/giropay) for more details. """ google_pay: NotRequired["PaymentMethodConfigurationModifyParamsGooglePay"] """ - Google Pay allows customers to make payments in your app or website using any credit or debit card saved to their Google Account, including those from Google Play, YouTube, Chrome, or an Android device. Use the Google Pay API to request any credit or debit card stored in your customer's Google account. Check this [page](https://stripe.com/docs/google-pay) for more details. + Google Pay allows customers to make payments in your app or website using any credit or debit card saved to their Google Account, including those from Google Play, YouTube, Chrome, or an Android device. Use the Google Pay API to request any credit or debit card stored in your customer's Google account. Check this [page](https://docs.stripe.com/google-pay) for more details. """ gopay: NotRequired["PaymentMethodConfigurationModifyParamsGopay"] """ - GoPay is a [single use](https://stripe.com/docs/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Gojek app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Gojek app to confirm payment. + GoPay is a [single use](https://docs.stripe.com/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Gojek app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Gojek app to confirm payment. """ grabpay: NotRequired["PaymentMethodConfigurationModifyParamsGrabpay"] """ - GrabPay is a payment method developed by [Grab](https://www.grab.com/sg/consumer/finance/pay/). GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this [page](https://stripe.com/docs/payments/grabpay) for more details. + GrabPay is a payment method developed by [Grab](https://www.grab.com/sg/consumer/finance/pay/). GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this [page](https://docs.stripe.com/payments/grabpay) for more details. """ id_bank_transfer: NotRequired[ "PaymentMethodConfigurationModifyParamsIdBankTransfer" @@ -138,7 +138,7 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ ideal: NotRequired["PaymentMethodConfigurationModifyParamsIdeal"] """ - iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their bank credentials. All major Dutch banks are members of Currence, the scheme that operates iDEAL, making it the most popular online payment method in the Netherlands with a share of online transactions close to 55%. Check this [page](https://stripe.com/docs/payments/ideal) for more details. + iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their bank credentials. All major Dutch banks are members of Currence, the scheme that operates iDEAL, making it the most popular online payment method in the Netherlands with a share of online transactions close to 55%. Check this [page](https://docs.stripe.com/payments/ideal) for more details. """ jcb: NotRequired["PaymentMethodConfigurationModifyParamsJcb"] """ @@ -150,11 +150,11 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ klarna: NotRequired["PaymentMethodConfigurationModifyParamsKlarna"] """ - Klarna gives customers a range of [payment options](https://stripe.com/docs/payments/klarna#payment-options) during checkout. Available payment options vary depending on the customer's billing address and the transaction amount. These payment options make it convenient for customers to purchase items in all price ranges. Check this [page](https://stripe.com/docs/payments/klarna) for more details. + Klarna gives customers a range of [payment options](https://docs.stripe.com/payments/klarna#payment-options) during checkout. Available payment options vary depending on the customer's billing address and the transaction amount. These payment options make it convenient for customers to purchase items in all price ranges. Check this [page](https://docs.stripe.com/payments/klarna) for more details. """ konbini: NotRequired["PaymentMethodConfigurationModifyParamsKonbini"] """ - Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://stripe.com/docs/payments/konbini) for more details. + Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://docs.stripe.com/payments/konbini) for more details. """ kr_card: NotRequired["PaymentMethodConfigurationModifyParamsKrCard"] """ @@ -162,15 +162,15 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ link: NotRequired["PaymentMethodConfigurationModifyParamsLink"] """ - [Link](https://stripe.com/docs/payments/link) is a payment method network. With Link, users save their payment details once, then reuse that information to pay with one click for any business on the network. + [Link](https://docs.stripe.com/payments/link) is a payment method network. With Link, users save their payment details once, then reuse that information to pay with one click for any business on the network. """ mb_way: NotRequired["PaymentMethodConfigurationModifyParamsMbWay"] """ - MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://stripe.com/docs/payments/mb-way) for more details. + MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://docs.stripe.com/payments/mb-way) for more details. """ mobilepay: NotRequired["PaymentMethodConfigurationModifyParamsMobilepay"] """ - MobilePay is a [single-use](https://stripe.com/docs/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://stripe.com/docs/payments/mobilepay) for more details. + MobilePay is a [single-use](https://docs.stripe.com/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://docs.stripe.com/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://docs.stripe.com/payments/mobilepay) for more details. """ multibanco: NotRequired["PaymentMethodConfigurationModifyParamsMultibanco"] """ @@ -188,15 +188,15 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): "PaymentMethodConfigurationModifyParamsNzBankAccount" ] """ - Stripe users in New Zealand can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with a New Zeland bank account. Check this [page](https://stripe.com/docs/payments/nz-bank-account) for more details. + Stripe users in New Zealand can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with a New Zeland bank account. Check this [page](https://docs.stripe.com/payments/nz-bank-account) for more details. """ oxxo: NotRequired["PaymentMethodConfigurationModifyParamsOxxo"] """ - OXXO is a Mexican chain of convenience stores with thousands of locations across Latin America and represents nearly 20% of online transactions in Mexico. OXXO allows customers to pay bills and online purchases in-store with cash. Check this [page](https://stripe.com/docs/payments/oxxo) for more details. + OXXO is a Mexican chain of convenience stores with thousands of locations across Latin America and represents nearly 20% of online transactions in Mexico. OXXO allows customers to pay bills and online purchases in-store with cash. Check this [page](https://docs.stripe.com/payments/oxxo) for more details. """ p24: NotRequired["PaymentMethodConfigurationModifyParamsP24"] """ - Przelewy24 is a Poland-based payment method aggregator that allows customers to complete transactions online using bank transfers and other methods. Bank transfers account for 30% of online payments in Poland and Przelewy24 provides a way for customers to pay with over 165 banks. Check this [page](https://stripe.com/docs/payments/p24) for more details. + Przelewy24 is a Poland-based payment method aggregator that allows customers to complete transactions online using bank transfers and other methods. Bank transfers account for 30% of online payments in Poland and Przelewy24 provides a way for customers to pay with over 165 banks. Check this [page](https://docs.stripe.com/payments/p24) for more details. """ pay_by_bank: NotRequired["PaymentMethodConfigurationModifyParamsPayByBank"] """ @@ -208,11 +208,11 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ paynow: NotRequired["PaymentMethodConfigurationModifyParamsPaynow"] """ - PayNow is a Singapore-based payment method that allows customers to make a payment using their preferred app from participating banks and participating non-bank financial institutions. Check this [page](https://stripe.com/docs/payments/paynow) for more details. + PayNow is a Singapore-based payment method that allows customers to make a payment using their preferred app from participating banks and participating non-bank financial institutions. Check this [page](https://docs.stripe.com/payments/paynow) for more details. """ paypal: NotRequired["PaymentMethodConfigurationModifyParamsPaypal"] """ - PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this [page](https://stripe.com/docs/payments/paypal) for more details. + PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this [page](https://docs.stripe.com/payments/paypal) for more details. """ paypay: NotRequired["PaymentMethodConfigurationModifyParamsPaypay"] """ @@ -228,7 +228,7 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ promptpay: NotRequired["PaymentMethodConfigurationModifyParamsPromptpay"] """ - PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this [page](https://stripe.com/docs/payments/promptpay) for more details. + PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this [page](https://docs.stripe.com/payments/promptpay) for more details. """ qris: NotRequired["PaymentMethodConfigurationModifyParamsQris"] """ @@ -252,19 +252,19 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): """ sepa_debit: NotRequired["PaymentMethodConfigurationModifyParamsSepaDebit"] """ - The [Single Euro Payments Area (SEPA)](https://en.wikipedia.org/wiki/Single_Euro_Payments_Area) is an initiative of the European Union to simplify payments within and across member countries. SEPA established and enforced banking standards to allow for the direct debiting of every EUR-denominated bank account within the SEPA region, check this [page](https://stripe.com/docs/payments/sepa-debit) for more details. + The [Single Euro Payments Area (SEPA)](https://en.wikipedia.org/wiki/Single_Euro_Payments_Area) is an initiative of the European Union to simplify payments within and across member countries. SEPA established and enforced banking standards to allow for the direct debiting of every EUR-denominated bank account within the SEPA region, check this [page](https://docs.stripe.com/payments/sepa-debit) for more details. """ shopeepay: NotRequired["PaymentMethodConfigurationModifyParamsShopeepay"] """ - ShopeePay is a [single use](https://stripe.com/docs/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Shopee app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Shopee app to confirm payment. + ShopeePay is a [single use](https://docs.stripe.com/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Shopee app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Shopee app to confirm payment. """ sofort: NotRequired["PaymentMethodConfigurationModifyParamsSofort"] """ - Stripe users in Europe and the United States can use the [Payment Intents API](https://stripe.com/docs/payments/payment-intents)—a single integration path for creating payments using any supported method—to accept [Sofort](https://www.sofort.com/) payments from customers. Check this [page](https://stripe.com/docs/payments/sofort) for more details. + Stripe users in Europe and the United States can use the [Payment Intents API](https://stripe.com/docs/payments/payment-intents)—a single integration path for creating payments using any supported method—to accept [Sofort](https://www.sofort.com/) payments from customers. Check this [page](https://docs.stripe.com/payments/sofort) for more details. """ swish: NotRequired["PaymentMethodConfigurationModifyParamsSwish"] """ - Swish is a [real-time](https://stripe.com/docs/payments/real-time) payment method popular in Sweden. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the Swish mobile app and the Swedish BankID mobile app. Check this [page](https://stripe.com/docs/payments/swish) for more details. + Swish is a [real-time](https://docs.stripe.com/payments/real-time) payment method popular in Sweden. It allows customers to [authenticate and approve](https://docs.stripe.com/payments/payment-methods#customer-actions) payments using the Swish mobile app and the Swedish BankID mobile app. Check this [page](https://docs.stripe.com/payments/swish) for more details. """ twint: NotRequired["PaymentMethodConfigurationModifyParamsTwint"] """ @@ -274,15 +274,15 @@ class PaymentMethodConfigurationModifyParams(RequestOptions): "PaymentMethodConfigurationModifyParamsUsBankAccount" ] """ - Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://stripe.com/docs/payments/ach-direct-debit) for more details. + Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://docs.stripe.com/payments/ach-direct-debit) for more details. """ wechat_pay: NotRequired["PaymentMethodConfigurationModifyParamsWechatPay"] """ - WeChat, owned by Tencent, is China's leading mobile app with over 1 billion monthly active users. Chinese consumers can use WeChat Pay to pay for goods and services inside of businesses' apps and websites. WeChat Pay users buy most frequently in gaming, e-commerce, travel, online education, and food/nutrition. Check this [page](https://stripe.com/docs/payments/wechat-pay) for more details. + WeChat, owned by Tencent, is China's leading mobile app with over 1 billion monthly active users. Chinese consumers can use WeChat Pay to pay for goods and services inside of businesses' apps and websites. WeChat Pay users buy most frequently in gaming, e-commerce, travel, online education, and food/nutrition. Check this [page](https://docs.stripe.com/payments/wechat-pay) for more details. """ zip: NotRequired["PaymentMethodConfigurationModifyParamsZip"] """ - Zip gives your customers a way to split purchases over a series of payments. Check this [page](https://stripe.com/docs/payments/zip) for more details like country availability. + Zip gives your customers a way to split purchases over a series of payments. Check this [page](https://docs.stripe.com/payments/zip) for more details like country availability. """ diff --git a/stripe/params/_payment_method_configuration_update_params.py b/stripe/params/_payment_method_configuration_update_params.py index 5b1e45d6d..3c47fc9f0 100644 --- a/stripe/params/_payment_method_configuration_update_params.py +++ b/stripe/params/_payment_method_configuration_update_params.py @@ -7,7 +7,7 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): acss_debit: NotRequired["PaymentMethodConfigurationUpdateParamsAcssDebit"] """ - Canadian pre-authorized debit payments, check this [page](https://stripe.com/docs/payments/acss-debit) for more details like country availability. + Canadian pre-authorized debit payments, check this [page](https://docs.stripe.com/payments/acss-debit) for more details like country availability. """ active: NotRequired[bool] """ @@ -15,17 +15,17 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ affirm: NotRequired["PaymentMethodConfigurationUpdateParamsAffirm"] """ - [Affirm](https://www.affirm.com/) gives your customers a way to split purchases over a series of payments. Depending on the purchase, they can pay with four interest-free payments (Split Pay) or pay over a longer term (Installments), which might include interest. Check this [page](https://stripe.com/docs/payments/affirm) for more details like country availability. + [Affirm](https://www.affirm.com/) gives your customers a way to split purchases over a series of payments. Depending on the purchase, they can pay with four interest-free payments (Split Pay) or pay over a longer term (Installments), which might include interest. Check this [page](https://docs.stripe.com/payments/affirm) for more details like country availability. """ afterpay_clearpay: NotRequired[ "PaymentMethodConfigurationUpdateParamsAfterpayClearpay" ] """ - Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://stripe.com/docs/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products. + Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://docs.stripe.com/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products. """ alipay: NotRequired["PaymentMethodConfigurationUpdateParamsAlipay"] """ - Alipay is a digital wallet in China that has more than a billion active users worldwide. Alipay users can pay on the web or on a mobile device using login credentials or their Alipay app. Alipay has a low dispute rate and reduces fraud by authenticating payments using the customer's login credentials. Check this [page](https://stripe.com/docs/payments/alipay) for more details. + Alipay is a digital wallet in China that has more than a billion active users worldwide. Alipay users can pay on the web or on a mobile device using login credentials or their Alipay app. Alipay has a low dispute rate and reduces fraud by authenticating payments using the customer's login credentials. Check this [page](https://docs.stripe.com/payments/alipay) for more details. """ alma: NotRequired["PaymentMethodConfigurationUpdateParamsAlma"] """ @@ -37,7 +37,7 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ apple_pay: NotRequired["PaymentMethodConfigurationUpdateParamsApplePay"] """ - Stripe users can accept [Apple Pay](https://stripe.com/payments/apple-pay) in iOS applications in iOS 9 and later, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments, and the [pricing](https://stripe.com/pricing) is the same as other card transactions. Check this [page](https://stripe.com/docs/apple-pay) for more details. + Stripe users can accept [Apple Pay](https://stripe.com/payments/apple-pay) in iOS applications in iOS 9 and later, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments, and the [pricing](https://stripe.com/pricing) is the same as other card transactions. Check this [page](https://docs.stripe.com/apple-pay) for more details. """ apple_pay_later: NotRequired[ "PaymentMethodConfigurationUpdateParamsApplePayLater" @@ -49,15 +49,15 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): "PaymentMethodConfigurationUpdateParamsAuBecsDebit" ] """ - Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this [page](https://stripe.com/docs/payments/au-becs-debit) for more details. + Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this [page](https://docs.stripe.com/payments/au-becs-debit) for more details. """ bacs_debit: NotRequired["PaymentMethodConfigurationUpdateParamsBacsDebit"] """ - Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://stripe.com/docs/payments/payment-methods/bacs-debit) for more details. + Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://docs.stripe.com/payments/payment-methods/bacs-debit) for more details. """ bancontact: NotRequired["PaymentMethodConfigurationUpdateParamsBancontact"] """ - Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://stripe.com/docs/api/customers) use a Bancontact card or mobile app linked to a Belgian bank account to make online payments that are secure, guaranteed, and confirmed immediately. Check this [page](https://stripe.com/docs/payments/bancontact) for more details. + Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://docs.stripe.com/api/customers) use a Bancontact card or mobile app linked to a Belgian bank account to make online payments that are secure, guaranteed, and confirmed immediately. Check this [page](https://docs.stripe.com/payments/bancontact) for more details. """ billie: NotRequired["PaymentMethodConfigurationUpdateParamsBillie"] """ @@ -65,11 +65,11 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ blik: NotRequired["PaymentMethodConfigurationUpdateParamsBlik"] """ - BLIK is a [single use](https://stripe.com/docs/payments/payment-methods#usage) payment method that requires customers to authenticate their payments. When customers want to pay online using BLIK, they request a six-digit code from their banking application and enter it into the payment collection form. Check this [page](https://stripe.com/docs/payments/blik) for more details. + BLIK is a [single use](https://docs.stripe.com/payments/payment-methods#usage) payment method that requires customers to authenticate their payments. When customers want to pay online using BLIK, they request a six-digit code from their banking application and enter it into the payment collection form. Check this [page](https://docs.stripe.com/payments/blik) for more details. """ boleto: NotRequired["PaymentMethodConfigurationUpdateParamsBoleto"] """ - Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://stripe.com/docs/payments/boleto) for more details. + Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://docs.stripe.com/payments/boleto) for more details. """ card: NotRequired["PaymentMethodConfigurationUpdateParamsCard"] """ @@ -79,25 +79,25 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): "PaymentMethodConfigurationUpdateParamsCartesBancaires" ] """ - Cartes Bancaires is France's local card network. More than 95% of these cards are co-branded with either Visa or Mastercard, meaning you can process these cards over either Cartes Bancaires or the Visa or Mastercard networks. Check this [page](https://stripe.com/docs/payments/cartes-bancaires) for more details. + Cartes Bancaires is France's local card network. More than 95% of these cards are co-branded with either Visa or Mastercard, meaning you can process these cards over either Cartes Bancaires or the Visa or Mastercard networks. Check this [page](https://docs.stripe.com/payments/cartes-bancaires) for more details. """ cashapp: NotRequired["PaymentMethodConfigurationUpdateParamsCashapp"] """ - Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet. Check this [page](https://stripe.com/docs/payments/cash-app-pay) for more details. + Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet. Check this [page](https://docs.stripe.com/payments/cash-app-pay) for more details. """ crypto: NotRequired["PaymentMethodConfigurationUpdateParamsCrypto"] """ - [Stablecoin payments](https://stripe.com/docs/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask. + [Stablecoin payments](https://docs.stripe.com/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask. """ customer_balance: NotRequired[ "PaymentMethodConfigurationUpdateParamsCustomerBalance" ] """ - Uses a customer's [cash balance](https://stripe.com/docs/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://stripe.com/docs/payments/bank-transfers) for more details. + Uses a customer's [cash balance](https://docs.stripe.com/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://docs.stripe.com/payments/bank-transfers) for more details. """ eps: NotRequired["PaymentMethodConfigurationUpdateParamsEps"] """ - EPS is an Austria-based payment method that allows customers to complete transactions online using their bank credentials. EPS is supported by all Austrian banks and is accepted by over 80% of Austrian online retailers. Check this [page](https://stripe.com/docs/payments/eps) for more details. + EPS is an Austria-based payment method that allows customers to complete transactions online using their bank credentials. EPS is supported by all Austrian banks and is accepted by over 80% of Austrian online retailers. Check this [page](https://docs.stripe.com/payments/eps) for more details. """ expand: NotRequired[List[str]] """ @@ -105,29 +105,29 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ fpx: NotRequired["PaymentMethodConfigurationUpdateParamsFpx"] """ - Financial Process Exchange (FPX) is a Malaysia-based payment method that allows customers to complete transactions online using their bank credentials. Bank Negara Malaysia (BNM), the Central Bank of Malaysia, and eleven other major Malaysian financial institutions are members of the PayNet Group, which owns and operates FPX. It is one of the most popular online payment methods in Malaysia, with nearly 90 million transactions in 2018 according to BNM. Check this [page](https://stripe.com/docs/payments/fpx) for more details. + Financial Process Exchange (FPX) is a Malaysia-based payment method that allows customers to complete transactions online using their bank credentials. Bank Negara Malaysia (BNM), the Central Bank of Malaysia, and eleven other major Malaysian financial institutions are members of the PayNet Group, which owns and operates FPX. It is one of the most popular online payment methods in Malaysia, with nearly 90 million transactions in 2018 according to BNM. Check this [page](https://docs.stripe.com/payments/fpx) for more details. """ fr_meal_voucher_conecs: NotRequired[ "PaymentMethodConfigurationUpdateParamsFrMealVoucherConecs" ] """ - Meal vouchers in France, or “titres-restaurant”, is a local benefits program commonly offered by employers for their employees to purchase prepared food and beverages on working days. Check this [page](https://stripe.com/docs/payments/benefits/fr-meal-vouchers) for more details. + Meal vouchers in France, or “titres-restaurant”, is a local benefits program commonly offered by employers for their employees to purchase prepared food and beverages on working days. Check this [page](https://docs.stripe.com/payments/benefits/fr-meal-vouchers) for more details. """ giropay: NotRequired["PaymentMethodConfigurationUpdateParamsGiropay"] """ - giropay is a German payment method based on online banking, introduced in 2006. It allows customers to complete transactions online using their online banking environment, with funds debited from their bank account. Depending on their bank, customers confirm payments on giropay using a second factor of authentication or a PIN. giropay accounts for 10% of online checkouts in Germany. Check this [page](https://stripe.com/docs/payments/giropay) for more details. + giropay is a German payment method based on online banking, introduced in 2006. It allows customers to complete transactions online using their online banking environment, with funds debited from their bank account. Depending on their bank, customers confirm payments on giropay using a second factor of authentication or a PIN. giropay accounts for 10% of online checkouts in Germany. Check this [page](https://docs.stripe.com/payments/giropay) for more details. """ google_pay: NotRequired["PaymentMethodConfigurationUpdateParamsGooglePay"] """ - Google Pay allows customers to make payments in your app or website using any credit or debit card saved to their Google Account, including those from Google Play, YouTube, Chrome, or an Android device. Use the Google Pay API to request any credit or debit card stored in your customer's Google account. Check this [page](https://stripe.com/docs/google-pay) for more details. + Google Pay allows customers to make payments in your app or website using any credit or debit card saved to their Google Account, including those from Google Play, YouTube, Chrome, or an Android device. Use the Google Pay API to request any credit or debit card stored in your customer's Google account. Check this [page](https://docs.stripe.com/google-pay) for more details. """ gopay: NotRequired["PaymentMethodConfigurationUpdateParamsGopay"] """ - GoPay is a [single use](https://stripe.com/docs/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Gojek app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Gojek app to confirm payment. + GoPay is a [single use](https://docs.stripe.com/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Gojek app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Gojek app to confirm payment. """ grabpay: NotRequired["PaymentMethodConfigurationUpdateParamsGrabpay"] """ - GrabPay is a payment method developed by [Grab](https://www.grab.com/sg/consumer/finance/pay/). GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this [page](https://stripe.com/docs/payments/grabpay) for more details. + GrabPay is a payment method developed by [Grab](https://www.grab.com/sg/consumer/finance/pay/). GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this [page](https://docs.stripe.com/payments/grabpay) for more details. """ id_bank_transfer: NotRequired[ "PaymentMethodConfigurationUpdateParamsIdBankTransfer" @@ -137,7 +137,7 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ ideal: NotRequired["PaymentMethodConfigurationUpdateParamsIdeal"] """ - iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their bank credentials. All major Dutch banks are members of Currence, the scheme that operates iDEAL, making it the most popular online payment method in the Netherlands with a share of online transactions close to 55%. Check this [page](https://stripe.com/docs/payments/ideal) for more details. + iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their bank credentials. All major Dutch banks are members of Currence, the scheme that operates iDEAL, making it the most popular online payment method in the Netherlands with a share of online transactions close to 55%. Check this [page](https://docs.stripe.com/payments/ideal) for more details. """ jcb: NotRequired["PaymentMethodConfigurationUpdateParamsJcb"] """ @@ -149,11 +149,11 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ klarna: NotRequired["PaymentMethodConfigurationUpdateParamsKlarna"] """ - Klarna gives customers a range of [payment options](https://stripe.com/docs/payments/klarna#payment-options) during checkout. Available payment options vary depending on the customer's billing address and the transaction amount. These payment options make it convenient for customers to purchase items in all price ranges. Check this [page](https://stripe.com/docs/payments/klarna) for more details. + Klarna gives customers a range of [payment options](https://docs.stripe.com/payments/klarna#payment-options) during checkout. Available payment options vary depending on the customer's billing address and the transaction amount. These payment options make it convenient for customers to purchase items in all price ranges. Check this [page](https://docs.stripe.com/payments/klarna) for more details. """ konbini: NotRequired["PaymentMethodConfigurationUpdateParamsKonbini"] """ - Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://stripe.com/docs/payments/konbini) for more details. + Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://docs.stripe.com/payments/konbini) for more details. """ kr_card: NotRequired["PaymentMethodConfigurationUpdateParamsKrCard"] """ @@ -161,15 +161,15 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ link: NotRequired["PaymentMethodConfigurationUpdateParamsLink"] """ - [Link](https://stripe.com/docs/payments/link) is a payment method network. With Link, users save their payment details once, then reuse that information to pay with one click for any business on the network. + [Link](https://docs.stripe.com/payments/link) is a payment method network. With Link, users save their payment details once, then reuse that information to pay with one click for any business on the network. """ mb_way: NotRequired["PaymentMethodConfigurationUpdateParamsMbWay"] """ - MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://stripe.com/docs/payments/mb-way) for more details. + MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://docs.stripe.com/payments/mb-way) for more details. """ mobilepay: NotRequired["PaymentMethodConfigurationUpdateParamsMobilepay"] """ - MobilePay is a [single-use](https://stripe.com/docs/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://stripe.com/docs/payments/mobilepay) for more details. + MobilePay is a [single-use](https://docs.stripe.com/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://docs.stripe.com/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://docs.stripe.com/payments/mobilepay) for more details. """ multibanco: NotRequired["PaymentMethodConfigurationUpdateParamsMultibanco"] """ @@ -187,15 +187,15 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): "PaymentMethodConfigurationUpdateParamsNzBankAccount" ] """ - Stripe users in New Zealand can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with a New Zeland bank account. Check this [page](https://stripe.com/docs/payments/nz-bank-account) for more details. + Stripe users in New Zealand can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with a New Zeland bank account. Check this [page](https://docs.stripe.com/payments/nz-bank-account) for more details. """ oxxo: NotRequired["PaymentMethodConfigurationUpdateParamsOxxo"] """ - OXXO is a Mexican chain of convenience stores with thousands of locations across Latin America and represents nearly 20% of online transactions in Mexico. OXXO allows customers to pay bills and online purchases in-store with cash. Check this [page](https://stripe.com/docs/payments/oxxo) for more details. + OXXO is a Mexican chain of convenience stores with thousands of locations across Latin America and represents nearly 20% of online transactions in Mexico. OXXO allows customers to pay bills and online purchases in-store with cash. Check this [page](https://docs.stripe.com/payments/oxxo) for more details. """ p24: NotRequired["PaymentMethodConfigurationUpdateParamsP24"] """ - Przelewy24 is a Poland-based payment method aggregator that allows customers to complete transactions online using bank transfers and other methods. Bank transfers account for 30% of online payments in Poland and Przelewy24 provides a way for customers to pay with over 165 banks. Check this [page](https://stripe.com/docs/payments/p24) for more details. + Przelewy24 is a Poland-based payment method aggregator that allows customers to complete transactions online using bank transfers and other methods. Bank transfers account for 30% of online payments in Poland and Przelewy24 provides a way for customers to pay with over 165 banks. Check this [page](https://docs.stripe.com/payments/p24) for more details. """ pay_by_bank: NotRequired["PaymentMethodConfigurationUpdateParamsPayByBank"] """ @@ -207,11 +207,11 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ paynow: NotRequired["PaymentMethodConfigurationUpdateParamsPaynow"] """ - PayNow is a Singapore-based payment method that allows customers to make a payment using their preferred app from participating banks and participating non-bank financial institutions. Check this [page](https://stripe.com/docs/payments/paynow) for more details. + PayNow is a Singapore-based payment method that allows customers to make a payment using their preferred app from participating banks and participating non-bank financial institutions. Check this [page](https://docs.stripe.com/payments/paynow) for more details. """ paypal: NotRequired["PaymentMethodConfigurationUpdateParamsPaypal"] """ - PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this [page](https://stripe.com/docs/payments/paypal) for more details. + PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this [page](https://docs.stripe.com/payments/paypal) for more details. """ paypay: NotRequired["PaymentMethodConfigurationUpdateParamsPaypay"] """ @@ -227,7 +227,7 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ promptpay: NotRequired["PaymentMethodConfigurationUpdateParamsPromptpay"] """ - PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this [page](https://stripe.com/docs/payments/promptpay) for more details. + PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this [page](https://docs.stripe.com/payments/promptpay) for more details. """ qris: NotRequired["PaymentMethodConfigurationUpdateParamsQris"] """ @@ -251,19 +251,19 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): """ sepa_debit: NotRequired["PaymentMethodConfigurationUpdateParamsSepaDebit"] """ - The [Single Euro Payments Area (SEPA)](https://en.wikipedia.org/wiki/Single_Euro_Payments_Area) is an initiative of the European Union to simplify payments within and across member countries. SEPA established and enforced banking standards to allow for the direct debiting of every EUR-denominated bank account within the SEPA region, check this [page](https://stripe.com/docs/payments/sepa-debit) for more details. + The [Single Euro Payments Area (SEPA)](https://en.wikipedia.org/wiki/Single_Euro_Payments_Area) is an initiative of the European Union to simplify payments within and across member countries. SEPA established and enforced banking standards to allow for the direct debiting of every EUR-denominated bank account within the SEPA region, check this [page](https://docs.stripe.com/payments/sepa-debit) for more details. """ shopeepay: NotRequired["PaymentMethodConfigurationUpdateParamsShopeepay"] """ - ShopeePay is a [single use](https://stripe.com/docs/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Shopee app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Shopee app to confirm payment. + ShopeePay is a [single use](https://docs.stripe.com/payments/payment-methods#usage) digital wallet payment method popular in Indonesia. When paying with GoPay, customers authenticate and approve payments using the Shopee app. Desktop checkout is performed by scanning a QR code. When checking out on mobile, customers are redirected to the Shopee app to confirm payment. """ sofort: NotRequired["PaymentMethodConfigurationUpdateParamsSofort"] """ - Stripe users in Europe and the United States can use the [Payment Intents API](https://stripe.com/docs/payments/payment-intents)—a single integration path for creating payments using any supported method—to accept [Sofort](https://www.sofort.com/) payments from customers. Check this [page](https://stripe.com/docs/payments/sofort) for more details. + Stripe users in Europe and the United States can use the [Payment Intents API](https://stripe.com/docs/payments/payment-intents)—a single integration path for creating payments using any supported method—to accept [Sofort](https://www.sofort.com/) payments from customers. Check this [page](https://docs.stripe.com/payments/sofort) for more details. """ swish: NotRequired["PaymentMethodConfigurationUpdateParamsSwish"] """ - Swish is a [real-time](https://stripe.com/docs/payments/real-time) payment method popular in Sweden. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the Swish mobile app and the Swedish BankID mobile app. Check this [page](https://stripe.com/docs/payments/swish) for more details. + Swish is a [real-time](https://docs.stripe.com/payments/real-time) payment method popular in Sweden. It allows customers to [authenticate and approve](https://docs.stripe.com/payments/payment-methods#customer-actions) payments using the Swish mobile app and the Swedish BankID mobile app. Check this [page](https://docs.stripe.com/payments/swish) for more details. """ twint: NotRequired["PaymentMethodConfigurationUpdateParamsTwint"] """ @@ -273,15 +273,15 @@ class PaymentMethodConfigurationUpdateParams(TypedDict): "PaymentMethodConfigurationUpdateParamsUsBankAccount" ] """ - Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://stripe.com/docs/payments/ach-direct-debit) for more details. + Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://docs.stripe.com/payments/ach-direct-debit) for more details. """ wechat_pay: NotRequired["PaymentMethodConfigurationUpdateParamsWechatPay"] """ - WeChat, owned by Tencent, is China's leading mobile app with over 1 billion monthly active users. Chinese consumers can use WeChat Pay to pay for goods and services inside of businesses' apps and websites. WeChat Pay users buy most frequently in gaming, e-commerce, travel, online education, and food/nutrition. Check this [page](https://stripe.com/docs/payments/wechat-pay) for more details. + WeChat, owned by Tencent, is China's leading mobile app with over 1 billion monthly active users. Chinese consumers can use WeChat Pay to pay for goods and services inside of businesses' apps and websites. WeChat Pay users buy most frequently in gaming, e-commerce, travel, online education, and food/nutrition. Check this [page](https://docs.stripe.com/payments/wechat-pay) for more details. """ zip: NotRequired["PaymentMethodConfigurationUpdateParamsZip"] """ - Zip gives your customers a way to split purchases over a series of payments. Check this [page](https://stripe.com/docs/payments/zip) for more details like country availability. + Zip gives your customers a way to split purchases over a series of payments. Check this [page](https://docs.stripe.com/payments/zip) for more details like country availability. """ diff --git a/stripe/params/_payment_method_create_params.py b/stripe/params/_payment_method_create_params.py index 176861204..e88ee7b2e 100644 --- a/stripe/params/_payment_method_create_params.py +++ b/stripe/params/_payment_method_create_params.py @@ -148,7 +148,7 @@ class PaymentMethodCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired["PaymentMethodCreateParamsMobilepay"] """ @@ -216,7 +216,7 @@ class PaymentMethodCreateParams(RequestOptions): """ radar_options: NotRequired["PaymentMethodCreateParamsRadarOptions"] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["PaymentMethodCreateParamsRechnung"] """ @@ -450,7 +450,7 @@ class PaymentMethodCreateParamsBillingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -620,6 +620,7 @@ class PaymentMethodCreateParamsIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -812,7 +813,7 @@ class PaymentMethodCreateParamsQris(TypedDict): class PaymentMethodCreateParamsRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ diff --git a/stripe/params/_payment_method_modify_params.py b/stripe/params/_payment_method_modify_params.py index 4cd37b02a..c0424e71f 100644 --- a/stripe/params/_payment_method_modify_params.py +++ b/stripe/params/_payment_method_modify_params.py @@ -24,7 +24,7 @@ class PaymentMethodModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payto: NotRequired["PaymentMethodModifyParamsPayto"] """ @@ -84,7 +84,7 @@ class PaymentMethodModifyParamsBillingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_method_update_params.py b/stripe/params/_payment_method_update_params.py index c37a0cfba..b32ed0f0e 100644 --- a/stripe/params/_payment_method_update_params.py +++ b/stripe/params/_payment_method_update_params.py @@ -23,7 +23,7 @@ class PaymentMethodUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payto: NotRequired["PaymentMethodUpdateParamsPayto"] """ @@ -83,7 +83,7 @@ class PaymentMethodUpdateParamsBillingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_record_report_payment_attempt_informational_params.py b/stripe/params/_payment_record_report_payment_attempt_informational_params.py index 462f2e145..8af88e076 100644 --- a/stripe/params/_payment_record_report_payment_attempt_informational_params.py +++ b/stripe/params/_payment_record_report_payment_attempt_informational_params.py @@ -22,7 +22,7 @@ class PaymentRecordReportPaymentAttemptInformationalParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ shipping_details: NotRequired[ "Literal['']|PaymentRecordReportPaymentAttemptInformationalParamsShippingDetails" @@ -97,5 +97,5 @@ class PaymentRecordReportPaymentAttemptInformationalParamsShippingDetailsAddress """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_record_report_payment_attempt_params.py b/stripe/params/_payment_record_report_payment_attempt_params.py index e4eca9b5c..41f456230 100644 --- a/stripe/params/_payment_record_report_payment_attempt_params.py +++ b/stripe/params/_payment_record_report_payment_attempt_params.py @@ -30,7 +30,7 @@ class PaymentRecordReportPaymentAttemptParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ outcome: NotRequired[Literal["failed", "guaranteed"]] """ @@ -135,7 +135,7 @@ class PaymentRecordReportPaymentAttemptParamsPaymentMethodDetailsBillingDetailsA """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -192,5 +192,5 @@ class PaymentRecordReportPaymentAttemptParamsShippingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_record_report_payment_params.py b/stripe/params/_payment_record_report_payment_params.py index bccfe8745..1ccea295e 100644 --- a/stripe/params/_payment_record_report_payment_params.py +++ b/stripe/params/_payment_record_report_payment_params.py @@ -42,7 +42,7 @@ class PaymentRecordReportPaymentParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ outcome: NotRequired[Literal["failed", "guaranteed"]] """ @@ -75,7 +75,7 @@ class PaymentRecordReportPaymentParamsAmountRequested(TypedDict): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ @@ -183,7 +183,7 @@ class PaymentRecordReportPaymentParamsPaymentMethodDetailsBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -258,5 +258,5 @@ class PaymentRecordReportPaymentParamsShippingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_payment_record_report_refund_params.py b/stripe/params/_payment_record_report_refund_params.py index f79bf5bb3..e7756f0e6 100644 --- a/stripe/params/_payment_record_report_refund_params.py +++ b/stripe/params/_payment_record_report_refund_params.py @@ -8,7 +8,7 @@ class PaymentRecordReportRefundParams(RequestOptions): amount: NotRequired["PaymentRecordReportRefundParamsAmount"] """ - A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) representing how much of this payment to refund. Can refund only up to the remaining, unrefunded amount of the payment. + A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) representing how much of this payment to refund. Can refund only up to the remaining, unrefunded amount of the payment. """ expand: NotRequired[List[str]] """ @@ -20,7 +20,7 @@ class PaymentRecordReportRefundParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ outcome: Literal["refunded"] """ @@ -43,7 +43,7 @@ class PaymentRecordReportRefundParamsAmount(TypedDict): """ value: int """ - A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. + A positive integer representing the amount in the currency's [minor unit](https://docs.stripe.com/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY. """ diff --git a/stripe/params/_payout_create_params.py b/stripe/params/_payout_create_params.py index 9df088fda..3611f6284 100644 --- a/stripe/params/_payout_create_params.py +++ b/stripe/params/_payout_create_params.py @@ -28,7 +28,7 @@ class PayoutCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ method: NotRequired[Literal["instant", "standard"]] """ diff --git a/stripe/params/_payout_modify_params.py b/stripe/params/_payout_modify_params.py index 732d10bd7..aed1d9d76 100644 --- a/stripe/params/_payout_modify_params.py +++ b/stripe/params/_payout_modify_params.py @@ -12,5 +12,5 @@ class PayoutModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_payout_reverse_params.py b/stripe/params/_payout_reverse_params.py index 2e95e113a..ddb78fe21 100644 --- a/stripe/params/_payout_reverse_params.py +++ b/stripe/params/_payout_reverse_params.py @@ -12,5 +12,5 @@ class PayoutReverseParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_payout_update_params.py b/stripe/params/_payout_update_params.py index 04a99d7da..7c494f28a 100644 --- a/stripe/params/_payout_update_params.py +++ b/stripe/params/_payout_update_params.py @@ -11,5 +11,5 @@ class PayoutUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_plan_create_params.py b/stripe/params/_plan_create_params.py index 43c20a246..d3cdabcdf 100644 --- a/stripe/params/_plan_create_params.py +++ b/stripe/params/_plan_create_params.py @@ -44,7 +44,7 @@ class PlanCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ meter: NotRequired[str] """ @@ -69,7 +69,7 @@ class PlanCreateParams(RequestOptions): """ trial_period_days: NotRequired[int] """ - Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan). + Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://docs.stripe.com/api#create_subscription-trial_from_plan). """ usage_type: NotRequired[Literal["licensed", "metered"]] """ @@ -88,7 +88,7 @@ class PlanCreateParamsProduct(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -102,7 +102,7 @@ class PlanCreateParamsProduct(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ diff --git a/stripe/params/_plan_modify_params.py b/stripe/params/_plan_modify_params.py index c9efc214b..c491c4195 100644 --- a/stripe/params/_plan_modify_params.py +++ b/stripe/params/_plan_modify_params.py @@ -16,7 +16,7 @@ class PlanModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nickname: NotRequired[str] """ @@ -28,5 +28,5 @@ class PlanModifyParams(RequestOptions): """ trial_period_days: NotRequired[int] """ - Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan). + Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://docs.stripe.com/api#create_subscription-trial_from_plan). """ diff --git a/stripe/params/_plan_update_params.py b/stripe/params/_plan_update_params.py index 7c2ef5cf2..09ac77c26 100644 --- a/stripe/params/_plan_update_params.py +++ b/stripe/params/_plan_update_params.py @@ -15,7 +15,7 @@ class PlanUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nickname: NotRequired[str] """ @@ -27,5 +27,5 @@ class PlanUpdateParams(TypedDict): """ trial_period_days: NotRequired[int] """ - Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan). + Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://docs.stripe.com/api#create_subscription-trial_from_plan). """ diff --git a/stripe/params/_price_create_params.py b/stripe/params/_price_create_params.py index decaa2d7e..b584425ca 100644 --- a/stripe/params/_price_create_params.py +++ b/stripe/params/_price_create_params.py @@ -38,7 +38,7 @@ class PriceCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nickname: NotRequired[str] """ @@ -58,7 +58,7 @@ class PriceCreateParams(RequestOptions): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tiers: NotRequired[List["PriceCreateParamsTier"]] """ @@ -95,7 +95,7 @@ class PriceCreateParamsCurrencyOptions(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tiers: NotRequired[List["PriceCreateParamsCurrencyOptionsTier"]] """ @@ -183,7 +183,7 @@ class PriceCreateParamsProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -197,7 +197,7 @@ class PriceCreateParamsProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ @@ -220,7 +220,7 @@ class PriceCreateParamsRecurring(TypedDict): """ trial_period_days: NotRequired[int] """ - Default number of trial days when subscribing a customer to this price using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan). + Default number of trial days when subscribing a customer to this price using [`trial_from_plan=true`](https://docs.stripe.com/api#create_subscription-trial_from_plan). """ usage_type: NotRequired[Literal["licensed", "metered"]] """ diff --git a/stripe/params/_price_modify_params.py b/stripe/params/_price_modify_params.py index 4057648b6..1e062bdf3 100644 --- a/stripe/params/_price_modify_params.py +++ b/stripe/params/_price_modify_params.py @@ -26,7 +26,7 @@ class PriceModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ migrate_to: NotRequired["Literal['']|PriceModifyParamsMigrateTo"] """ @@ -38,7 +38,7 @@ class PriceModifyParams(RequestOptions): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ transfer_lookup_key: NotRequired[bool] """ @@ -55,7 +55,7 @@ class PriceModifyParamsCurrencyOptions(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tiers: NotRequired[List["PriceModifyParamsCurrencyOptionsTier"]] """ diff --git a/stripe/params/_price_search_params.py b/stripe/params/_price_search_params.py index f10b84c39..d2ab15fed 100644 --- a/stripe/params/_price_search_params.py +++ b/stripe/params/_price_search_params.py @@ -20,5 +20,5 @@ class PriceSearchParams(RequestOptions): """ query: str """ - The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for prices](https://stripe.com/docs/search#query-fields-for-prices). + The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for prices](https://docs.stripe.com/search#query-fields-for-prices). """ diff --git a/stripe/params/_price_update_params.py b/stripe/params/_price_update_params.py index 3949b899c..2929385a1 100644 --- a/stripe/params/_price_update_params.py +++ b/stripe/params/_price_update_params.py @@ -25,7 +25,7 @@ class PriceUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ migrate_to: NotRequired["Literal['']|PriceUpdateParamsMigrateTo"] """ @@ -37,7 +37,7 @@ class PriceUpdateParams(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ transfer_lookup_key: NotRequired[bool] """ @@ -54,7 +54,7 @@ class PriceUpdateParamsCurrencyOptions(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tiers: NotRequired[List["PriceUpdateParamsCurrencyOptionsTier"]] """ diff --git a/stripe/params/_product_create_feature_params.py b/stripe/params/_product_create_feature_params.py index 4ec04f542..a04d9df41 100644 --- a/stripe/params/_product_create_feature_params.py +++ b/stripe/params/_product_create_feature_params.py @@ -8,7 +8,7 @@ class ProductCreateFeatureParams(RequestOptions): entitlement_feature: str """ - The ID of the [Feature](https://stripe.com/docs/api/entitlements/feature) object attached to this product. + The ID of the [Feature](https://docs.stripe.com/api/entitlements/feature) object attached to this product. """ expand: NotRequired[List[str]] """ diff --git a/stripe/params/_product_create_params.py b/stripe/params/_product_create_params.py index 761f0fd6a..d8fb6cbb1 100644 --- a/stripe/params/_product_create_params.py +++ b/stripe/params/_product_create_params.py @@ -12,7 +12,7 @@ class ProductCreateParams(RequestOptions): """ default_price_data: NotRequired["ProductCreateParamsDefaultPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object. This Price will be set as the default price for this product. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object. This Price will be set as the default price for this product. """ description: NotRequired[str] """ @@ -34,11 +34,11 @@ class ProductCreateParams(RequestOptions): List["ProductCreateParamsMarketingFeature"] ] """ - A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://stripe.com/docs/payments/checkout/pricing-table). + A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://docs.stripe.com/payments/checkout/pricing-table). """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -61,7 +61,7 @@ class ProductCreateParams(RequestOptions): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ type: NotRequired[Literal["good", "service"]] """ @@ -96,7 +96,7 @@ class ProductCreateParamsDefaultPriceData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ recurring: NotRequired["ProductCreateParamsDefaultPriceDataRecurring"] """ @@ -104,7 +104,7 @@ class ProductCreateParamsDefaultPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -125,7 +125,7 @@ class ProductCreateParamsDefaultPriceDataCurrencyOptions(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ tiers: NotRequired[ List["ProductCreateParamsDefaultPriceDataCurrencyOptionsTier"] diff --git a/stripe/params/_product_feature_create_params.py b/stripe/params/_product_feature_create_params.py index b52580ed9..04c1b2e04 100644 --- a/stripe/params/_product_feature_create_params.py +++ b/stripe/params/_product_feature_create_params.py @@ -7,7 +7,7 @@ class ProductFeatureCreateParams(TypedDict): entitlement_feature: str """ - The ID of the [Feature](https://stripe.com/docs/api/entitlements/feature) object attached to this product. + The ID of the [Feature](https://docs.stripe.com/api/entitlements/feature) object attached to this product. """ expand: NotRequired[List[str]] """ diff --git a/stripe/params/_product_list_params.py b/stripe/params/_product_list_params.py index c52f65b89..40347b633 100644 --- a/stripe/params/_product_list_params.py +++ b/stripe/params/_product_list_params.py @@ -24,7 +24,7 @@ class ProductListParams(RequestOptions): """ ids: NotRequired[List[str]] """ - Only return products with the given IDs. Cannot be used with [starting_after](https://stripe.com/docs/api#list_products-starting_after) or [ending_before](https://stripe.com/docs/api#list_products-ending_before). + Only return products with the given IDs. Cannot be used with [starting_after](https://api.stripe.com#list_products-starting_after) or [ending_before](https://api.stripe.com#list_products-ending_before). """ limit: NotRequired[int] """ diff --git a/stripe/params/_product_modify_params.py b/stripe/params/_product_modify_params.py index 1a7381951..7db18ce7d 100644 --- a/stripe/params/_product_modify_params.py +++ b/stripe/params/_product_modify_params.py @@ -12,7 +12,7 @@ class ProductModifyParams(RequestOptions): """ default_price: NotRequired[str] """ - The ID of the [Price](https://stripe.com/docs/api/prices) object that is the default price for this product. + The ID of the [Price](https://docs.stripe.com/api/prices) object that is the default price for this product. """ description: NotRequired["Literal['']|str"] """ @@ -30,11 +30,11 @@ class ProductModifyParams(RequestOptions): "Literal['']|List[ProductModifyParamsMarketingFeature]" ] """ - A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://stripe.com/docs/payments/checkout/pricing-table). + A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://docs.stripe.com/payments/checkout/pricing-table). """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -59,7 +59,7 @@ class ProductModifyParams(RequestOptions): """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired["Literal['']|str"] """ diff --git a/stripe/params/_product_search_params.py b/stripe/params/_product_search_params.py index e9ac3e56b..ca74fd7c3 100644 --- a/stripe/params/_product_search_params.py +++ b/stripe/params/_product_search_params.py @@ -20,5 +20,5 @@ class ProductSearchParams(RequestOptions): """ query: str """ - The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for products](https://stripe.com/docs/search#query-fields-for-products). + The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for products](https://docs.stripe.com/search#query-fields-for-products). """ diff --git a/stripe/params/_product_update_params.py b/stripe/params/_product_update_params.py index 685966a0e..dbda248a2 100644 --- a/stripe/params/_product_update_params.py +++ b/stripe/params/_product_update_params.py @@ -11,7 +11,7 @@ class ProductUpdateParams(TypedDict): """ default_price: NotRequired[str] """ - The ID of the [Price](https://stripe.com/docs/api/prices) object that is the default price for this product. + The ID of the [Price](https://docs.stripe.com/api/prices) object that is the default price for this product. """ description: NotRequired["Literal['']|str"] """ @@ -29,11 +29,11 @@ class ProductUpdateParams(TypedDict): "Literal['']|List[ProductUpdateParamsMarketingFeature]" ] """ - A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://stripe.com/docs/payments/checkout/pricing-table). + A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://docs.stripe.com/payments/checkout/pricing-table). """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -58,7 +58,7 @@ class ProductUpdateParams(TypedDict): """ tax_code: NotRequired["Literal['']|str"] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired["Literal['']|str"] """ diff --git a/stripe/params/_promotion_code_create_params.py b/stripe/params/_promotion_code_create_params.py index adc5087f1..e63c0566a 100644 --- a/stripe/params/_promotion_code_create_params.py +++ b/stripe/params/_promotion_code_create_params.py @@ -18,11 +18,11 @@ class PromotionCodeCreateParams(RequestOptions): """ customer: NotRequired[str] """ - The customer that this promotion code can be used by. If not set, the promotion code can be used by all customers. + The customer who can use this promotion code. If not set, all customers can use the promotion code. """ customer_account: NotRequired[str] """ - The account that this promotion code can be used by. If not set, the promotion code can be used by all accounts. + The account representing the customer who can use this promotion code. If not set, all customers can use the promotion code. """ expand: NotRequired[List[str]] """ @@ -38,7 +38,7 @@ class PromotionCodeCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ promotion: "PromotionCodeCreateParamsPromotion" """ diff --git a/stripe/params/_promotion_code_list_params.py b/stripe/params/_promotion_code_list_params.py index a3d0a1755..5393d8e5b 100644 --- a/stripe/params/_promotion_code_list_params.py +++ b/stripe/params/_promotion_code_list_params.py @@ -28,7 +28,7 @@ class PromotionCodeListParams(RequestOptions): """ customer_account: NotRequired[str] """ - Only return promotion codes that are restricted to this account. + Only return promotion codes that are restricted to this account representing the customer. """ ending_before: NotRequired[str] """ diff --git a/stripe/params/_promotion_code_modify_params.py b/stripe/params/_promotion_code_modify_params.py index 671f7047d..5f0763a17 100644 --- a/stripe/params/_promotion_code_modify_params.py +++ b/stripe/params/_promotion_code_modify_params.py @@ -16,7 +16,7 @@ class PromotionCodeModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ restrictions: NotRequired["PromotionCodeModifyParamsRestrictions"] """ diff --git a/stripe/params/_promotion_code_update_params.py b/stripe/params/_promotion_code_update_params.py index 9f05b1a79..626d60482 100644 --- a/stripe/params/_promotion_code_update_params.py +++ b/stripe/params/_promotion_code_update_params.py @@ -15,7 +15,7 @@ class PromotionCodeUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ restrictions: NotRequired["PromotionCodeUpdateParamsRestrictions"] """ diff --git a/stripe/params/_quote_create_params.py b/stripe/params/_quote_create_params.py index 67b598562..630521f09 100644 --- a/stripe/params/_quote_create_params.py +++ b/stripe/params/_quote_create_params.py @@ -82,7 +82,7 @@ class QuoteCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired["Literal['']|str"] """ @@ -221,7 +221,7 @@ class QuoteCreateParamsLineItem(TypedDict): """ price_data: NotRequired["QuoteCreateParamsLineItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -295,7 +295,7 @@ class QuoteCreateParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -461,7 +461,7 @@ class QuoteCreateParamsLineActionAddItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: str """ @@ -854,7 +854,7 @@ class QuoteCreateParamsSubscriptionData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ prebilling: NotRequired[ "Literal['']|QuoteCreateParamsSubscriptionDataPrebilling" @@ -866,11 +866,11 @@ class QuoteCreateParamsSubscriptionData(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`. - Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. + Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. Prorations can be disabled by passing `none`. """ @@ -1046,11 +1046,11 @@ class QuoteCreateParamsSubscriptionDataOverride(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`. - Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. + Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. Prorations can be disabled by passing `none`. """ diff --git a/stripe/params/_quote_list_params.py b/stripe/params/_quote_list_params.py index ce09ee7f7..e5bb1b556 100644 --- a/stripe/params/_quote_list_params.py +++ b/stripe/params/_quote_list_params.py @@ -8,11 +8,11 @@ class QuoteListParams(RequestOptions): customer: NotRequired[str] """ - The ID of the customer whose quotes will be retrieved. + The ID of the customer whose quotes you're retrieving. """ customer_account: NotRequired[str] """ - The ID of the account whose quotes will be retrieved. + The ID of the account representing the customer whose quotes you're retrieving. """ ending_before: NotRequired[str] """ diff --git a/stripe/params/_quote_modify_params.py b/stripe/params/_quote_modify_params.py index 0df3ae8b5..a0f40795f 100644 --- a/stripe/params/_quote_modify_params.py +++ b/stripe/params/_quote_modify_params.py @@ -78,7 +78,7 @@ class QuoteModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired["Literal['']|str"] """ @@ -206,7 +206,7 @@ class QuoteModifyParamsLineItem(TypedDict): """ price_data: NotRequired["QuoteModifyParamsLineItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -280,7 +280,7 @@ class QuoteModifyParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -450,7 +450,7 @@ class QuoteModifyParamsLineActionAddItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: str """ @@ -839,7 +839,7 @@ class QuoteModifyParamsSubscriptionData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ prebilling: NotRequired[ "Literal['']|QuoteModifyParamsSubscriptionDataPrebilling" @@ -851,11 +851,11 @@ class QuoteModifyParamsSubscriptionData(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`. - Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. + Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. Prorations can be disabled by passing `none`. """ @@ -1011,11 +1011,11 @@ class QuoteModifyParamsSubscriptionDataOverride(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`. - Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. + Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. Prorations can be disabled by passing `none`. """ diff --git a/stripe/params/_quote_update_params.py b/stripe/params/_quote_update_params.py index 5e0406b44..e17e88e36 100644 --- a/stripe/params/_quote_update_params.py +++ b/stripe/params/_quote_update_params.py @@ -77,7 +77,7 @@ class QuoteUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired["Literal['']|str"] """ @@ -205,7 +205,7 @@ class QuoteUpdateParamsLineItem(TypedDict): """ price_data: NotRequired["QuoteUpdateParamsLineItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -279,7 +279,7 @@ class QuoteUpdateParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -449,7 +449,7 @@ class QuoteUpdateParamsLineActionAddItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: str """ @@ -838,7 +838,7 @@ class QuoteUpdateParamsSubscriptionData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values. """ prebilling: NotRequired[ "Literal['']|QuoteUpdateParamsSubscriptionDataPrebilling" @@ -850,11 +850,11 @@ class QuoteUpdateParamsSubscriptionData(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`. - Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. + Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. Prorations can be disabled by passing `none`. """ @@ -1010,11 +1010,11 @@ class QuoteUpdateParamsSubscriptionDataOverride(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. + Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations). When creating a subscription, valid values are `create_prorations` or `none`. When updating a subscription, valid values are `create_prorations`, `none`, or `always_invoice`. - Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://stripe.com/docs/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. + Passing `create_prorations` will cause proration invoice items to be created when applicable. These proration items will only be invoiced immediately under [certain conditions](https://docs.stripe.com/subscriptions/upgrading-downgrading#immediate-payment). In order to always invoice immediately for prorations, pass `always_invoice`. Prorations can be disabled by passing `none`. """ diff --git a/stripe/params/_refund_create_params.py b/stripe/params/_refund_create_params.py index c8d7eac1b..3643e9fc0 100644 --- a/stripe/params/_refund_create_params.py +++ b/stripe/params/_refund_create_params.py @@ -29,7 +29,7 @@ class RefundCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ origin: NotRequired[Literal["customer_balance"]] """ @@ -43,7 +43,7 @@ class RefundCreateParams(RequestOptions): Literal["duplicate", "fraudulent", "requested_by_customer"] ] """ - String indicating the reason for the refund. If set, possible values are `duplicate`, `fraudulent`, and `requested_by_customer`. If you believe the charge to be fraudulent, specifying `fraudulent` as the reason will add the associated card and email to your [block lists](https://stripe.com/docs/radar/lists), and will also help us improve our fraud detection algorithms. + String indicating the reason for the refund. If set, possible values are `duplicate`, `fraudulent`, and `requested_by_customer`. If you believe the charge to be fraudulent, specifying `fraudulent` as the reason will add the associated card and email to your [block lists](https://docs.stripe.com/radar/lists), and will also help us improve our fraud detection algorithms. """ refund_application_fee: NotRequired[bool] """ diff --git a/stripe/params/_refund_modify_params.py b/stripe/params/_refund_modify_params.py index 86df6e4ff..137744551 100644 --- a/stripe/params/_refund_modify_params.py +++ b/stripe/params/_refund_modify_params.py @@ -12,5 +12,5 @@ class RefundModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_refund_update_params.py b/stripe/params/_refund_update_params.py index 615d175a3..2de319688 100644 --- a/stripe/params/_refund_update_params.py +++ b/stripe/params/_refund_update_params.py @@ -11,5 +11,5 @@ class RefundUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_setup_intent_confirm_params.py b/stripe/params/_setup_intent_confirm_params.py index 8273204f2..f78d236d1 100644 --- a/stripe/params/_setup_intent_confirm_params.py +++ b/stripe/params/_setup_intent_confirm_params.py @@ -27,7 +27,7 @@ class SetupIntentConfirmParams(RequestOptions): "SetupIntentConfirmParamsPaymentMethodData" ] """ - When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-payment_method) + When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-payment_method) value in the SetupIntent. """ payment_method_options: NotRequired[ @@ -242,7 +242,7 @@ class SetupIntentConfirmParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired[ "SetupIntentConfirmParamsPaymentMethodDataMobilepay" @@ -318,7 +318,7 @@ class SetupIntentConfirmParamsPaymentMethodData(TypedDict): "SetupIntentConfirmParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["SetupIntentConfirmParamsPaymentMethodDataRechnung"] """ @@ -564,7 +564,7 @@ class SetupIntentConfirmParamsPaymentMethodDataBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -693,6 +693,7 @@ class SetupIntentConfirmParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -885,7 +886,7 @@ class SetupIntentConfirmParamsPaymentMethodDataQris(TypedDict): class SetupIntentConfirmParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -1159,7 +1160,7 @@ class SetupIntentConfirmParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ three_d_secure: NotRequired[ "SetupIntentConfirmParamsPaymentMethodOptionsCardThreeDSecure" @@ -1460,56 +1461,35 @@ class SetupIntentConfirmParamsPaymentMethodOptionsPayto(TypedDict): class SetupIntentConfirmParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict, ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. """ - start_date: NotRequired[str] + start_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time. """ diff --git a/stripe/params/_setup_intent_create_params.py b/stripe/params/_setup_intent_create_params.py index 12f13cceb..14b15720a 100644 --- a/stripe/params/_setup_intent_create_params.py +++ b/stripe/params/_setup_intent_create_params.py @@ -121,11 +121,11 @@ class SetupIntentCreateParams(RequestOptions): """ mandate_data: NotRequired["Literal['']|SetupIntentCreateParamsMandateData"] """ - This hash contains details about the mandate to create. This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/setup_intents/create#create_setup_intent-confirm). + This hash contains details about the mandate to create. This parameter can only be used with [`confirm=true`](https://docs.stripe.com/api/setup_intents/create#create_setup_intent-confirm). """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired[str] """ @@ -137,13 +137,13 @@ class SetupIntentCreateParams(RequestOptions): """ payment_method_configuration: NotRequired[str] """ - The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this SetupIntent. + The ID of the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) to use with this SetupIntent. """ payment_method_data: NotRequired[ "SetupIntentCreateParamsPaymentMethodData" ] """ - When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-payment_method) + When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-payment_method) value in the SetupIntent. """ payment_method_options: NotRequired[ @@ -158,7 +158,7 @@ class SetupIntentCreateParams(RequestOptions): """ return_url: NotRequired[str] """ - The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site. To redirect to a mobile application, you can alternatively supply an application URI scheme. This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/setup_intents/create#create_setup_intent-confirm). + The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site. To redirect to a mobile application, you can alternatively supply an application URI scheme. This parameter can only be used with [`confirm=true`](https://docs.stripe.com/api/setup_intents/create#create_setup_intent-confirm). """ single_use: NotRequired["SetupIntentCreateParamsSingleUse"] """ @@ -181,7 +181,7 @@ class SetupIntentCreateParamsAutomaticPaymentMethods(TypedDict): """ Controls whether this SetupIntent will accept redirect-based payment methods. - Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://stripe.com/docs/api/setup_intents/confirm) this SetupIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the setup. + Redirect-based payment methods may require your customer to be redirected to a payment method's app or site for authentication or additional steps. To [confirm](https://docs.stripe.com/api/setup_intents/confirm) this SetupIntent, you may be required to provide a `return_url` to redirect customers back to your site after they authenticate or complete the setup. """ enabled: bool """ @@ -381,7 +381,7 @@ class SetupIntentCreateParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired["SetupIntentCreateParamsPaymentMethodDataMobilepay"] """ @@ -453,7 +453,7 @@ class SetupIntentCreateParamsPaymentMethodData(TypedDict): "SetupIntentCreateParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["SetupIntentCreateParamsPaymentMethodDataRechnung"] """ @@ -695,7 +695,7 @@ class SetupIntentCreateParamsPaymentMethodDataBillingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -824,6 +824,7 @@ class SetupIntentCreateParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -1016,7 +1017,7 @@ class SetupIntentCreateParamsPaymentMethodDataQris(TypedDict): class SetupIntentCreateParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -1290,7 +1291,7 @@ class SetupIntentCreateParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ three_d_secure: NotRequired[ "SetupIntentCreateParamsPaymentMethodOptionsCardThreeDSecure" @@ -1587,56 +1588,35 @@ class SetupIntentCreateParamsPaymentMethodOptionsPayto(TypedDict): class SetupIntentCreateParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. """ - start_date: NotRequired[str] + start_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time. """ @@ -1815,7 +1795,7 @@ class SetupIntentCreateParamsPaymentMethodOptionsUsBankAccountNetworks( class SetupIntentCreateParamsSingleUse(TypedDict): amount: int """ - Amount the customer is granting permission to collect later. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). + Amount the customer is granting permission to collect later. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). """ currency: str """ diff --git a/stripe/params/_setup_intent_modify_params.py b/stripe/params/_setup_intent_modify_params.py index d8044f92f..72a27f0c5 100644 --- a/stripe/params/_setup_intent_modify_params.py +++ b/stripe/params/_setup_intent_modify_params.py @@ -46,7 +46,7 @@ class SetupIntentModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_method: NotRequired[str] """ @@ -54,13 +54,13 @@ class SetupIntentModifyParams(RequestOptions): """ payment_method_configuration: NotRequired[str] """ - The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this SetupIntent. + The ID of the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) to use with this SetupIntent. """ payment_method_data: NotRequired[ "SetupIntentModifyParamsPaymentMethodData" ] """ - When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-payment_method) + When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-payment_method) value in the SetupIntent. """ payment_method_options: NotRequired[ @@ -222,7 +222,7 @@ class SetupIntentModifyParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired["SetupIntentModifyParamsPaymentMethodDataMobilepay"] """ @@ -294,7 +294,7 @@ class SetupIntentModifyParamsPaymentMethodData(TypedDict): "SetupIntentModifyParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["SetupIntentModifyParamsPaymentMethodDataRechnung"] """ @@ -536,7 +536,7 @@ class SetupIntentModifyParamsPaymentMethodDataBillingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -665,6 +665,7 @@ class SetupIntentModifyParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -857,7 +858,7 @@ class SetupIntentModifyParamsPaymentMethodDataQris(TypedDict): class SetupIntentModifyParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -1131,7 +1132,7 @@ class SetupIntentModifyParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ three_d_secure: NotRequired[ "SetupIntentModifyParamsPaymentMethodOptionsCardThreeDSecure" @@ -1428,56 +1429,35 @@ class SetupIntentModifyParamsPaymentMethodOptionsPayto(TypedDict): class SetupIntentModifyParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. """ - start_date: NotRequired[str] + start_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time. """ diff --git a/stripe/params/_setup_intent_update_params.py b/stripe/params/_setup_intent_update_params.py index b494c1af7..aab38860f 100644 --- a/stripe/params/_setup_intent_update_params.py +++ b/stripe/params/_setup_intent_update_params.py @@ -45,7 +45,7 @@ class SetupIntentUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_method: NotRequired[str] """ @@ -53,13 +53,13 @@ class SetupIntentUpdateParams(TypedDict): """ payment_method_configuration: NotRequired[str] """ - The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this SetupIntent. + The ID of the [payment method configuration](https://docs.stripe.com/api/payment_method_configurations) to use with this SetupIntent. """ payment_method_data: NotRequired[ "SetupIntentUpdateParamsPaymentMethodData" ] """ - When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-payment_method) + When included, this hash creates a PaymentMethod that is set as the [`payment_method`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-payment_method) value in the SetupIntent. """ payment_method_options: NotRequired[ @@ -221,7 +221,7 @@ class SetupIntentUpdateParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired["SetupIntentUpdateParamsPaymentMethodDataMobilepay"] """ @@ -293,7 +293,7 @@ class SetupIntentUpdateParamsPaymentMethodData(TypedDict): "SetupIntentUpdateParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired["SetupIntentUpdateParamsPaymentMethodDataRechnung"] """ @@ -535,7 +535,7 @@ class SetupIntentUpdateParamsPaymentMethodDataBillingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -664,6 +664,7 @@ class SetupIntentUpdateParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -856,7 +857,7 @@ class SetupIntentUpdateParamsPaymentMethodDataQris(TypedDict): class SetupIntentUpdateParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -1130,7 +1131,7 @@ class SetupIntentUpdateParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ three_d_secure: NotRequired[ "SetupIntentUpdateParamsPaymentMethodOptionsCardThreeDSecure" @@ -1427,56 +1428,35 @@ class SetupIntentUpdateParamsPaymentMethodOptionsPayto(TypedDict): class SetupIntentUpdateParamsPaymentMethodOptionsPaytoMandateOptions( TypedDict ): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. """ - start_date: NotRequired[str] + start_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time. """ diff --git a/stripe/params/_shipping_rate_create_params.py b/stripe/params/_shipping_rate_create_params.py index 8697e7138..3e8bad043 100644 --- a/stripe/params/_shipping_rate_create_params.py +++ b/stripe/params/_shipping_rate_create_params.py @@ -24,7 +24,7 @@ class ShippingRateCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -32,7 +32,7 @@ class ShippingRateCreateParams(RequestOptions): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ diff --git a/stripe/params/_shipping_rate_modify_params.py b/stripe/params/_shipping_rate_modify_params.py index 85f84f4bb..bae5280a8 100644 --- a/stripe/params/_shipping_rate_modify_params.py +++ b/stripe/params/_shipping_rate_modify_params.py @@ -20,7 +20,7 @@ class ShippingRateModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ diff --git a/stripe/params/_shipping_rate_update_params.py b/stripe/params/_shipping_rate_update_params.py index bdfb36dc7..8008e0291 100644 --- a/stripe/params/_shipping_rate_update_params.py +++ b/stripe/params/_shipping_rate_update_params.py @@ -19,7 +19,7 @@ class ShippingRateUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ diff --git a/stripe/params/_source_create_params.py b/stripe/params/_source_create_params.py index 013849e76..da9714921 100644 --- a/stripe/params/_source_create_params.py +++ b/stripe/params/_source_create_params.py @@ -63,7 +63,7 @@ class SourceCreateParams(RequestOptions): """ type: NotRequired[str] """ - The `type` of the source to create. Required unless `customer` and `original_source` are specified (see the [Cloning card Sources](https://stripe.com/docs/sources/connect#cloning-card-sources) guide) + The `type` of the source to create. Required unless `customer` and `original_source` are specified (see the [Cloning card Sources](https://docs.stripe.com/sources/connect#cloning-card-sources) guide) """ usage: NotRequired[Literal["reusable", "single_use"]] @@ -188,7 +188,7 @@ class SourceCreateParamsOwnerAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -278,5 +278,5 @@ class SourceCreateParamsSourceOrderShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_source_modify_params.py b/stripe/params/_source_modify_params.py index f57584e1d..7e2b77e4f 100644 --- a/stripe/params/_source_modify_params.py +++ b/stripe/params/_source_modify_params.py @@ -20,7 +20,7 @@ class SourceModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ owner: NotRequired["SourceModifyParamsOwner"] """ @@ -152,7 +152,7 @@ class SourceModifyParamsOwnerAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -228,5 +228,5 @@ class SourceModifyParamsSourceOrderShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_source_update_params.py b/stripe/params/_source_update_params.py index ff800484c..25ca98953 100644 --- a/stripe/params/_source_update_params.py +++ b/stripe/params/_source_update_params.py @@ -19,7 +19,7 @@ class SourceUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ owner: NotRequired["SourceUpdateParamsOwner"] """ @@ -151,7 +151,7 @@ class SourceUpdateParamsOwnerAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -227,5 +227,5 @@ class SourceUpdateParamsSourceOrderShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/_subscription_create_params.py b/stripe/params/_subscription_create_params.py index a5bd33036..ab8182c4f 100644 --- a/stripe/params/_subscription_create_params.py +++ b/stripe/params/_subscription_create_params.py @@ -30,7 +30,7 @@ class SubscriptionCreateParams(RequestOptions): """ billing_cycle_anchor: NotRequired[int] """ - A future timestamp in UTC format to anchor the subscription's [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle). The anchor is the reference point that aligns future billing cycle dates. It sets the day of week for `week` intervals, the day of month for `month` and `year` intervals, and the month of year for `year` intervals. + A future timestamp in UTC format to anchor the subscription's [billing cycle](https://docs.stripe.com/subscriptions/billing-cycle). The anchor is the reference point that aligns future billing cycle dates. It sets the day of week for `week` intervals, the day of month for `month` and `year` intervals, and the month of year for `year` intervals. """ billing_cycle_anchor_config: NotRequired[ "SubscriptionCreateParamsBillingCycleAnchorConfig" @@ -78,7 +78,7 @@ class SubscriptionCreateParams(RequestOptions): """ customer_account: NotRequired[str] """ - The identifier of the account to subscribe. + The identifier of the account representing the customer to subscribe. """ days_until_due: NotRequired[int] """ @@ -86,11 +86,11 @@ class SubscriptionCreateParams(RequestOptions): """ default_payment_method: NotRequired[str] """ - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_source: NotRequired[str] """ - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -120,7 +120,7 @@ class SubscriptionCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ off_session: NotRequired[bool] """ @@ -141,11 +141,11 @@ class SubscriptionCreateParams(RequestOptions): """ Only applies to subscriptions with `collection_method=charge_automatically`. - Use `allow_incomplete` to create Subscriptions with `status=incomplete` if the first invoice can't be paid. Creating Subscriptions with this status allows you to manage scenarios where additional customer actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. + Use `allow_incomplete` to create Subscriptions with `status=incomplete` if the first invoice can't be paid. Creating Subscriptions with this status allows you to manage scenarios where additional customer actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. - Use `default_incomplete` to create Subscriptions with `status=incomplete` when the first invoice requires payment, otherwise start as active. Subscriptions transition to `status=active` when successfully confirming the PaymentIntent on the first invoice. This allows simpler management of scenarios where additional customer actions are needed to pay a subscription's invoice, such as failed payments, [SCA regulation](https://stripe.com/docs/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. If the PaymentIntent is not confirmed within 23 hours Subscriptions transition to `status=incomplete_expired`, which is a terminal state. + Use `default_incomplete` to create Subscriptions with `status=incomplete` when the first invoice requires payment, otherwise start as active. Subscriptions transition to `status=active` when successfully confirming the PaymentIntent on the first invoice. This allows simpler management of scenarios where additional customer actions are needed to pay a subscription's invoice, such as failed payments, [SCA regulation](https://docs.stripe.com/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. If the PaymentIntent is not confirmed within 23 hours Subscriptions transition to `status=incomplete_expired`, which is a terminal state. - Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's first invoice can't be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further customer action is needed, this parameter doesn't create a Subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://stripe.com/docs/upgrades#2019-03-14) to learn more. + Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's first invoice can't be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further customer action is needed, this parameter doesn't create a Subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://docs.stripe.com/upgrades#2019-03-14) to learn more. `pending_if_incomplete` is only used with updates and cannot be passed when creating a Subscription. @@ -159,7 +159,7 @@ class SubscriptionCreateParams(RequestOptions): "Literal['']|SubscriptionCreateParamsPendingInvoiceItemInterval" ] """ - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://stripe.com/docs/api#create_invoice) for the given subscription at the specified interval. + Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://docs.stripe.com/api#create_invoice) for the given subscription at the specified interval. """ prebilling: NotRequired["SubscriptionCreateParamsPrebilling"] """ @@ -169,7 +169,7 @@ class SubscriptionCreateParams(RequestOptions): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) resulting from the `billing_cycle_anchor`. If no value is passed, the default is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) resulting from the `billing_cycle_anchor`. If no value is passed, the default is `create_prorations`. """ transfer_data: NotRequired["SubscriptionCreateParamsTransferData"] """ @@ -177,15 +177,15 @@ class SubscriptionCreateParams(RequestOptions): """ trial_end: NotRequired["Literal['now']|int"] """ - Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. If set, trial_end will override the default trial period of the plan the customer is being subscribed to. The special value `now` can be provided to end the customer's trial immediately. Can be at most two years from `billing_cycle_anchor`. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. + Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. If set, trial_end will override the default trial period of the plan the customer is being subscribed to. The special value `now` can be provided to end the customer's trial immediately. Can be at most two years from `billing_cycle_anchor`. See [Using trial periods on subscriptions](https://docs.stripe.com/billing/subscriptions/trials) to learn more. """ trial_from_plan: NotRequired[bool] """ - Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. + Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://docs.stripe.com/billing/subscriptions/trials) to learn more. """ trial_period_days: NotRequired[int] """ - Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. + Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See [Using trial periods on subscriptions](https://docs.stripe.com/billing/subscriptions/trials) to learn more. """ trial_settings: NotRequired["SubscriptionCreateParamsTrialSettings"] """ @@ -202,7 +202,7 @@ class SubscriptionCreateParamsAddInvoiceItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["SubscriptionCreateParamsAddInvoiceItemPeriod"] """ @@ -214,7 +214,7 @@ class SubscriptionCreateParamsAddInvoiceItem(TypedDict): """ price_data: NotRequired["SubscriptionCreateParamsAddInvoiceItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -321,7 +321,7 @@ class SubscriptionCreateParamsAddInvoiceItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -547,7 +547,7 @@ class SubscriptionCreateParamsItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ plan: NotRequired[str] """ @@ -559,7 +559,7 @@ class SubscriptionCreateParamsItem(TypedDict): """ price_data: NotRequired["SubscriptionCreateParamsItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ quantity: NotRequired[int] """ @@ -567,7 +567,7 @@ class SubscriptionCreateParamsItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ trial: NotRequired["SubscriptionCreateParamsItemTrial"] """ @@ -578,7 +578,7 @@ class SubscriptionCreateParamsItem(TypedDict): class SubscriptionCreateParamsItemBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -646,7 +646,7 @@ class SubscriptionCreateParamsItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -688,7 +688,7 @@ class SubscriptionCreateParamsPaymentSettings(TypedDict): Payment-method-specific configuration to provide to invoices created by the subscription. """ payment_method_types: NotRequired[ - "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" + "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'payto', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" ] """ 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](https://dashboard.stripe.com/settings/billing/invoice). Should not be specified with payment_method_configuration @@ -736,6 +736,12 @@ class SubscriptionCreateParamsPaymentSettingsPaymentMethodOptions(TypedDict): """ This sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: NotRequired[ + "Literal['']|SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPayto" + ] + """ + This sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: NotRequired[ "Literal['']|SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPix" ] @@ -830,7 +836,7 @@ class SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsCard( Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ @@ -902,6 +908,44 @@ class SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsKonbini( pass +class SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPayto( + TypedDict, +): + mandate_options: NotRequired[ + "SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions" + ] + """ + Additional fields for Mandate creation. + """ + + +class SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions( + TypedDict, +): + amount: NotRequired[int] + """ + The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit. + """ + purpose: NotRequired[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + class SubscriptionCreateParamsPaymentSettingsPaymentMethodOptionsPix( TypedDict ): diff --git a/stripe/params/_subscription_item_create_params.py b/stripe/params/_subscription_item_create_params.py index 918473a4c..42fc65de7 100644 --- a/stripe/params/_subscription_item_create_params.py +++ b/stripe/params/_subscription_item_create_params.py @@ -24,7 +24,7 @@ class SubscriptionItemCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_behavior: NotRequired[ Literal[ @@ -35,11 +35,11 @@ class SubscriptionItemCreateParams(RequestOptions): ] ] """ - Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. + Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. - Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://stripe.com/docs/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. + Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://docs.stripe.com/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. - Use `pending_if_incomplete` to update the subscription using [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://stripe.com/docs/billing/pending-updates-reference#supported-attributes). + Use `pending_if_incomplete` to update the subscription using [pending updates](https://docs.stripe.com/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://docs.stripe.com/billing/pending-updates-reference#supported-attributes). Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's invoice cannot be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further user action is needed, this parameter does not update the subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://docs.stripe.com/changelog/2019-03-14) to learn more. """ @@ -53,17 +53,17 @@ class SubscriptionItemCreateParams(RequestOptions): """ price_data: NotRequired["SubscriptionItemCreateParamsPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ proration_behavior: NotRequired[ Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. """ proration_date: NotRequired[int] """ - If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://stripe.com/docs/api#retrieve_customer_invoice) endpoint. + If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://api.stripe.com#retrieve_customer_invoice) endpoint. """ quantity: NotRequired[int] """ @@ -75,7 +75,7 @@ class SubscriptionItemCreateParams(RequestOptions): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ trial: NotRequired["SubscriptionItemCreateParamsTrial"] """ @@ -86,7 +86,7 @@ class SubscriptionItemCreateParams(RequestOptions): class SubscriptionItemCreateParamsBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -154,7 +154,7 @@ class SubscriptionItemCreateParamsPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_subscription_item_delete_params.py b/stripe/params/_subscription_item_delete_params.py index 2355bfe58..b03385454 100644 --- a/stripe/params/_subscription_item_delete_params.py +++ b/stripe/params/_subscription_item_delete_params.py @@ -13,9 +13,9 @@ class SubscriptionItemDeleteParams(RequestOptions): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. """ proration_date: NotRequired[int] """ - If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://stripe.com/docs/api#retrieve_customer_invoice) endpoint. + If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://api.stripe.com#retrieve_customer_invoice) endpoint. """ diff --git a/stripe/params/_subscription_item_modify_params.py b/stripe/params/_subscription_item_modify_params.py index a4e987f86..a0724f78f 100644 --- a/stripe/params/_subscription_item_modify_params.py +++ b/stripe/params/_subscription_item_modify_params.py @@ -24,7 +24,7 @@ class SubscriptionItemModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ off_session: NotRequired[bool] """ @@ -39,11 +39,11 @@ class SubscriptionItemModifyParams(RequestOptions): ] ] """ - Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. + Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. - Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://stripe.com/docs/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. + Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://docs.stripe.com/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. - Use `pending_if_incomplete` to update the subscription using [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://stripe.com/docs/billing/pending-updates-reference#supported-attributes). + Use `pending_if_incomplete` to update the subscription using [pending updates](https://docs.stripe.com/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://docs.stripe.com/billing/pending-updates-reference#supported-attributes). Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's invoice cannot be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further user action is needed, this parameter does not update the subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://docs.stripe.com/changelog/2019-03-14) to learn more. """ @@ -57,17 +57,17 @@ class SubscriptionItemModifyParams(RequestOptions): """ price_data: NotRequired["SubscriptionItemModifyParamsPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ proration_behavior: NotRequired[ Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. """ proration_date: NotRequired[int] """ - If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://stripe.com/docs/api#retrieve_customer_invoice) endpoint. + If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://api.stripe.com#retrieve_customer_invoice) endpoint. """ quantity: NotRequired[int] """ @@ -75,14 +75,14 @@ class SubscriptionItemModifyParams(RequestOptions): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ class SubscriptionItemModifyParamsBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -150,7 +150,7 @@ class SubscriptionItemModifyParamsPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_subscription_item_update_params.py b/stripe/params/_subscription_item_update_params.py index 056611b4a..e5dadc505 100644 --- a/stripe/params/_subscription_item_update_params.py +++ b/stripe/params/_subscription_item_update_params.py @@ -23,7 +23,7 @@ class SubscriptionItemUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ off_session: NotRequired[bool] """ @@ -38,11 +38,11 @@ class SubscriptionItemUpdateParams(TypedDict): ] ] """ - Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. + Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. - Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://stripe.com/docs/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. + Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://docs.stripe.com/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. - Use `pending_if_incomplete` to update the subscription using [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://stripe.com/docs/billing/pending-updates-reference#supported-attributes). + Use `pending_if_incomplete` to update the subscription using [pending updates](https://docs.stripe.com/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://docs.stripe.com/billing/pending-updates-reference#supported-attributes). Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's invoice cannot be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further user action is needed, this parameter does not update the subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://docs.stripe.com/changelog/2019-03-14) to learn more. """ @@ -56,17 +56,17 @@ class SubscriptionItemUpdateParams(TypedDict): """ price_data: NotRequired["SubscriptionItemUpdateParamsPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ proration_behavior: NotRequired[ Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. """ proration_date: NotRequired[int] """ - If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://stripe.com/docs/api#retrieve_customer_invoice) endpoint. + If set, the proration will be calculated as though the subscription was updated at the given time. This can be used to apply the same proration that was previewed with the [upcoming invoice](https://api.stripe.com#retrieve_customer_invoice) endpoint. """ quantity: NotRequired[int] """ @@ -74,14 +74,14 @@ class SubscriptionItemUpdateParams(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ class SubscriptionItemUpdateParamsBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -149,7 +149,7 @@ class SubscriptionItemUpdateParamsPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_subscription_list_params.py b/stripe/params/_subscription_list_params.py index bac95b93e..efbcb83ab 100644 --- a/stripe/params/_subscription_list_params.py +++ b/stripe/params/_subscription_list_params.py @@ -34,11 +34,11 @@ class SubscriptionListParams(RequestOptions): """ customer: NotRequired[str] """ - The ID of the customer whose subscriptions will be retrieved. + The ID of the customer whose subscriptions you're retrieving. """ customer_account: NotRequired[str] """ - The ID of the account whose subscriptions will be retrieved. + The ID of the account representing the customer whose subscriptions you're retrieving. """ ending_before: NotRequired[str] """ @@ -79,7 +79,7 @@ class SubscriptionListParams(RequestOptions): ] ] """ - The status of the subscriptions to retrieve. Passing in a value of `canceled` will return all canceled subscriptions, including those belonging to deleted customers. Pass `ended` to find subscriptions that are canceled and subscriptions that are expired due to [incomplete payment](https://stripe.com/docs/billing/subscriptions/overview#subscription-statuses). Passing in a value of `all` will return subscriptions of all statuses. If no value is supplied, all subscriptions that have not been canceled are returned. + The status of the subscriptions to retrieve. Passing in a value of `canceled` will return all canceled subscriptions, including those belonging to deleted customers. Pass `ended` to find subscriptions that are canceled and subscriptions that are expired due to [incomplete payment](https://docs.stripe.com/billing/subscriptions/overview#subscription-statuses). Passing in a value of `all` will return subscriptions of all statuses. If no value is supplied, all subscriptions that have not been canceled are returned. """ test_clock: NotRequired[str] """ diff --git a/stripe/params/_subscription_modify_params.py b/stripe/params/_subscription_modify_params.py index a30bb899f..a21c5e0b0 100644 --- a/stripe/params/_subscription_modify_params.py +++ b/stripe/params/_subscription_modify_params.py @@ -26,7 +26,7 @@ class SubscriptionModifyParams(RequestOptions): """ billing_cycle_anchor: NotRequired[Literal["now", "unchanged"]] """ - Either `now` or `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Either `now` or `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_schedules: NotRequired[ "Literal['']|List[SubscriptionModifyParamsBillingSchedule]" @@ -68,11 +68,11 @@ class SubscriptionModifyParams(RequestOptions): """ default_payment_method: NotRequired[str] """ - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_source: NotRequired["Literal['']|str"] """ - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -102,7 +102,7 @@ class SubscriptionModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ off_session: NotRequired[bool] """ @@ -116,7 +116,7 @@ class SubscriptionModifyParams(RequestOptions): "Literal['']|SubscriptionModifyParamsPauseCollection" ] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ payment_behavior: NotRequired[ Literal[ @@ -127,11 +127,11 @@ class SubscriptionModifyParams(RequestOptions): ] ] """ - Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. + Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. - Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://stripe.com/docs/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. + Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://docs.stripe.com/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. - Use `pending_if_incomplete` to update the subscription using [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://stripe.com/docs/billing/pending-updates-reference#supported-attributes). + Use `pending_if_incomplete` to update the subscription using [pending updates](https://docs.stripe.com/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://docs.stripe.com/billing/pending-updates-reference#supported-attributes). Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's invoice cannot be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further user action is needed, this parameter does not update the subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://docs.stripe.com/changelog/2019-03-14) to learn more. """ @@ -143,7 +143,7 @@ class SubscriptionModifyParams(RequestOptions): "Literal['']|SubscriptionModifyParamsPendingInvoiceItemInterval" ] """ - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://stripe.com/docs/api#create_invoice) for the given subscription at the specified interval. + Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://docs.stripe.com/api#create_invoice) for the given subscription at the specified interval. """ prebilling: NotRequired["SubscriptionModifyParamsPrebilling"] """ @@ -153,7 +153,7 @@ class SubscriptionModifyParams(RequestOptions): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. """ proration_date: NotRequired[int] """ @@ -171,7 +171,7 @@ class SubscriptionModifyParams(RequestOptions): """ trial_from_plan: NotRequired[bool] """ - Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. + Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://docs.stripe.com/billing/subscriptions/trials) to learn more. """ trial_settings: NotRequired["SubscriptionModifyParamsTrialSettings"] """ @@ -188,7 +188,7 @@ class SubscriptionModifyParamsAddInvoiceItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["SubscriptionModifyParamsAddInvoiceItemPeriod"] """ @@ -200,7 +200,7 @@ class SubscriptionModifyParamsAddInvoiceItem(TypedDict): """ price_data: NotRequired["SubscriptionModifyParamsAddInvoiceItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -307,7 +307,7 @@ class SubscriptionModifyParamsAddInvoiceItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -517,7 +517,7 @@ class SubscriptionModifyParamsItem(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ plan: NotRequired[str] """ @@ -529,7 +529,7 @@ class SubscriptionModifyParamsItem(TypedDict): """ price_data: NotRequired["SubscriptionModifyParamsItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -537,14 +537,14 @@ class SubscriptionModifyParamsItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ class SubscriptionModifyParamsItemBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -612,7 +612,7 @@ class SubscriptionModifyParamsItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -654,7 +654,7 @@ class SubscriptionModifyParamsPaymentSettings(TypedDict): Payment-method-specific configuration to provide to invoices created by the subscription. """ payment_method_types: NotRequired[ - "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" + "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'payto', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" ] """ 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](https://dashboard.stripe.com/settings/billing/invoice). Should not be specified with payment_method_configuration @@ -702,6 +702,12 @@ class SubscriptionModifyParamsPaymentSettingsPaymentMethodOptions(TypedDict): """ This sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: NotRequired[ + "Literal['']|SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPayto" + ] + """ + This sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: NotRequired[ "Literal['']|SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPix" ] @@ -796,7 +802,7 @@ class SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsCard( Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ @@ -868,6 +874,44 @@ class SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsKonbini( pass +class SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPayto( + TypedDict, +): + mandate_options: NotRequired[ + "SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions" + ] + """ + Additional fields for Mandate creation. + """ + + +class SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions( + TypedDict, +): + amount: NotRequired[int] + """ + The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit. + """ + purpose: NotRequired[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + class SubscriptionModifyParamsPaymentSettingsPaymentMethodOptionsPix( TypedDict ): diff --git a/stripe/params/_subscription_resume_params.py b/stripe/params/_subscription_resume_params.py index a74e3c7bb..e1ad4a625 100644 --- a/stripe/params/_subscription_resume_params.py +++ b/stripe/params/_subscription_resume_params.py @@ -8,7 +8,7 @@ class SubscriptionResumeParams(RequestOptions): billing_cycle_anchor: NotRequired[Literal["now", "unchanged"]] """ - The billing cycle anchor that applies when the subscription is resumed. Either `now` or `unchanged`. The default is `now`. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + The billing cycle anchor that applies when the subscription is resumed. Either `now` or `unchanged`. The default is `now`. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ expand: NotRequired[List[str]] """ @@ -18,7 +18,7 @@ class SubscriptionResumeParams(RequestOptions): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) resulting from the `billing_cycle_anchor` being `unchanged`. When the `billing_cycle_anchor` is set to `now` (default value), no prorations are generated. If no value is passed, the default is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) resulting from the `billing_cycle_anchor` being `unchanged`. When the `billing_cycle_anchor` is set to `now` (default value), no prorations are generated. If no value is passed, the default is `create_prorations`. """ proration_date: NotRequired[int] """ diff --git a/stripe/params/_subscription_schedule_amend_params.py b/stripe/params/_subscription_schedule_amend_params.py index c64458290..3c0e7032f 100644 --- a/stripe/params/_subscription_schedule_amend_params.py +++ b/stripe/params/_subscription_schedule_amend_params.py @@ -312,7 +312,7 @@ class SubscriptionScheduleAmendParamsAmendmentItemActionAdd(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: str """ diff --git a/stripe/params/_subscription_schedule_create_params.py b/stripe/params/_subscription_schedule_create_params.py index 2a5b422c2..486d645ee 100644 --- a/stripe/params/_subscription_schedule_create_params.py +++ b/stripe/params/_subscription_schedule_create_params.py @@ -44,7 +44,7 @@ class SubscriptionScheduleCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phases: NotRequired[List["SubscriptionScheduleCreateParamsPhase"]] """ @@ -93,7 +93,7 @@ class SubscriptionScheduleCreateParamsDefaultSettings(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["automatic", "phase_start"]] """ - Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: NotRequired[ "Literal['']|SubscriptionScheduleCreateParamsDefaultSettingsBillingThresholds" @@ -234,7 +234,7 @@ class SubscriptionScheduleCreateParamsPhase(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["automatic", "phase_start"]] """ - Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: NotRequired[ "Literal['']|SubscriptionScheduleCreateParamsPhaseBillingThresholds" @@ -258,7 +258,7 @@ class SubscriptionScheduleCreateParamsPhase(TypedDict): """ default_tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://stripe.com/docs/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://docs.stripe.com/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. """ description: NotRequired["Literal['']|str"] """ @@ -276,7 +276,7 @@ class SubscriptionScheduleCreateParamsPhase(TypedDict): """ end_date: NotRequired[int] """ - The date at which this phase of the subscription schedule ends. If set, `iterations` must not be set. + The date at which this phase of the subscription schedule ends. If set, `duration` must not be set. """ invoice_settings: NotRequired[ "SubscriptionScheduleCreateParamsPhaseInvoiceSettings" @@ -290,7 +290,7 @@ class SubscriptionScheduleCreateParamsPhase(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. """ on_behalf_of: NotRequired[str] """ @@ -300,13 +300,13 @@ class SubscriptionScheduleCreateParamsPhase(TypedDict): "SubscriptionScheduleCreateParamsPhasePauseCollection" ] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ proration_behavior: NotRequired[ Literal["always_invoice", "create_prorations", "none"] ] """ - Controls whether the subscription schedule should create [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://stripe.com/docs/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. + Controls whether the subscription schedule should create [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://docs.stripe.com/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. """ transfer_data: NotRequired[ "SubscriptionScheduleCreateParamsPhaseTransferData" @@ -343,7 +343,7 @@ class SubscriptionScheduleCreateParamsPhaseAddInvoiceItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired[ "SubscriptionScheduleCreateParamsPhaseAddInvoiceItemPeriod" @@ -359,7 +359,7 @@ class SubscriptionScheduleCreateParamsPhaseAddInvoiceItem(TypedDict): "SubscriptionScheduleCreateParamsPhaseAddInvoiceItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -470,7 +470,7 @@ class SubscriptionScheduleCreateParamsPhaseAddInvoiceItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -622,7 +622,7 @@ class SubscriptionScheduleCreateParamsPhaseItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. """ plan: NotRequired[str] """ @@ -636,7 +636,7 @@ class SubscriptionScheduleCreateParamsPhaseItem(TypedDict): "SubscriptionScheduleCreateParamsPhaseItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ quantity: NotRequired[int] """ @@ -644,7 +644,7 @@ class SubscriptionScheduleCreateParamsPhaseItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ trial: NotRequired["SubscriptionScheduleCreateParamsPhaseItemTrial"] """ @@ -655,7 +655,7 @@ class SubscriptionScheduleCreateParamsPhaseItem(TypedDict): class SubscriptionScheduleCreateParamsPhaseItemBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -725,7 +725,7 @@ class SubscriptionScheduleCreateParamsPhaseItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_subscription_schedule_modify_params.py b/stripe/params/_subscription_schedule_modify_params.py index 5f49a3d02..95582da3e 100644 --- a/stripe/params/_subscription_schedule_modify_params.py +++ b/stripe/params/_subscription_schedule_modify_params.py @@ -28,7 +28,7 @@ class SubscriptionScheduleModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phases: NotRequired[List["SubscriptionScheduleModifyParamsPhase"]] """ @@ -59,7 +59,7 @@ class SubscriptionScheduleModifyParamsDefaultSettings(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["automatic", "phase_start"]] """ - Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: NotRequired[ "Literal['']|SubscriptionScheduleModifyParamsDefaultSettingsBillingThresholds" @@ -200,7 +200,7 @@ class SubscriptionScheduleModifyParamsPhase(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["automatic", "phase_start"]] """ - Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: NotRequired[ "Literal['']|SubscriptionScheduleModifyParamsPhaseBillingThresholds" @@ -224,7 +224,7 @@ class SubscriptionScheduleModifyParamsPhase(TypedDict): """ default_tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://stripe.com/docs/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://docs.stripe.com/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. """ description: NotRequired["Literal['']|str"] """ @@ -242,7 +242,7 @@ class SubscriptionScheduleModifyParamsPhase(TypedDict): """ end_date: NotRequired["int|Literal['now']"] """ - The date at which this phase of the subscription schedule ends. If set, `iterations` must not be set. + The date at which this phase of the subscription schedule ends. If set, `duration` must not be set. """ invoice_settings: NotRequired[ "SubscriptionScheduleModifyParamsPhaseInvoiceSettings" @@ -256,7 +256,7 @@ class SubscriptionScheduleModifyParamsPhase(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. """ on_behalf_of: NotRequired[str] """ @@ -266,13 +266,13 @@ class SubscriptionScheduleModifyParamsPhase(TypedDict): "SubscriptionScheduleModifyParamsPhasePauseCollection" ] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ proration_behavior: NotRequired[ Literal["always_invoice", "create_prorations", "none"] ] """ - Controls whether the subscription schedule should create [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://stripe.com/docs/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. + Controls whether the subscription schedule should create [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://docs.stripe.com/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. """ start_date: NotRequired["int|Literal['now']"] """ @@ -313,7 +313,7 @@ class SubscriptionScheduleModifyParamsPhaseAddInvoiceItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired[ "SubscriptionScheduleModifyParamsPhaseAddInvoiceItemPeriod" @@ -329,7 +329,7 @@ class SubscriptionScheduleModifyParamsPhaseAddInvoiceItem(TypedDict): "SubscriptionScheduleModifyParamsPhaseAddInvoiceItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -440,7 +440,7 @@ class SubscriptionScheduleModifyParamsPhaseAddInvoiceItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -592,7 +592,7 @@ class SubscriptionScheduleModifyParamsPhaseItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. """ plan: NotRequired[str] """ @@ -606,7 +606,7 @@ class SubscriptionScheduleModifyParamsPhaseItem(TypedDict): "SubscriptionScheduleModifyParamsPhaseItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ quantity: NotRequired[int] """ @@ -614,7 +614,7 @@ class SubscriptionScheduleModifyParamsPhaseItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ trial: NotRequired["SubscriptionScheduleModifyParamsPhaseItemTrial"] """ @@ -625,7 +625,7 @@ class SubscriptionScheduleModifyParamsPhaseItem(TypedDict): class SubscriptionScheduleModifyParamsPhaseItemBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -695,7 +695,7 @@ class SubscriptionScheduleModifyParamsPhaseItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_subscription_schedule_update_params.py b/stripe/params/_subscription_schedule_update_params.py index 2cb948e36..cb7a2eb66 100644 --- a/stripe/params/_subscription_schedule_update_params.py +++ b/stripe/params/_subscription_schedule_update_params.py @@ -27,7 +27,7 @@ class SubscriptionScheduleUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phases: NotRequired[List["SubscriptionScheduleUpdateParamsPhase"]] """ @@ -58,7 +58,7 @@ class SubscriptionScheduleUpdateParamsDefaultSettings(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["automatic", "phase_start"]] """ - Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: NotRequired[ "Literal['']|SubscriptionScheduleUpdateParamsDefaultSettingsBillingThresholds" @@ -199,7 +199,7 @@ class SubscriptionScheduleUpdateParamsPhase(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["automatic", "phase_start"]] """ - Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_thresholds: NotRequired[ "Literal['']|SubscriptionScheduleUpdateParamsPhaseBillingThresholds" @@ -223,7 +223,7 @@ class SubscriptionScheduleUpdateParamsPhase(TypedDict): """ default_tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://stripe.com/docs/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://docs.stripe.com/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase. """ description: NotRequired["Literal['']|str"] """ @@ -241,7 +241,7 @@ class SubscriptionScheduleUpdateParamsPhase(TypedDict): """ end_date: NotRequired["int|Literal['now']"] """ - The date at which this phase of the subscription schedule ends. If set, `iterations` must not be set. + The date at which this phase of the subscription schedule ends. If set, `duration` must not be set. """ invoice_settings: NotRequired[ "SubscriptionScheduleUpdateParamsPhaseInvoiceSettings" @@ -255,7 +255,7 @@ class SubscriptionScheduleUpdateParamsPhase(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`. """ on_behalf_of: NotRequired[str] """ @@ -265,13 +265,13 @@ class SubscriptionScheduleUpdateParamsPhase(TypedDict): "SubscriptionScheduleUpdateParamsPhasePauseCollection" ] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ proration_behavior: NotRequired[ Literal["always_invoice", "create_prorations", "none"] ] """ - Controls whether the subscription schedule should create [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://stripe.com/docs/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. + Controls whether the subscription schedule should create [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://docs.stripe.com/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase. """ start_date: NotRequired["int|Literal['now']"] """ @@ -312,7 +312,7 @@ class SubscriptionScheduleUpdateParamsPhaseAddInvoiceItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired[ "SubscriptionScheduleUpdateParamsPhaseAddInvoiceItemPeriod" @@ -328,7 +328,7 @@ class SubscriptionScheduleUpdateParamsPhaseAddInvoiceItem(TypedDict): "SubscriptionScheduleUpdateParamsPhaseAddInvoiceItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -439,7 +439,7 @@ class SubscriptionScheduleUpdateParamsPhaseAddInvoiceItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -591,7 +591,7 @@ class SubscriptionScheduleUpdateParamsPhaseItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`. """ plan: NotRequired[str] """ @@ -605,7 +605,7 @@ class SubscriptionScheduleUpdateParamsPhaseItem(TypedDict): "SubscriptionScheduleUpdateParamsPhaseItemPriceData" ] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. """ quantity: NotRequired[int] """ @@ -613,7 +613,7 @@ class SubscriptionScheduleUpdateParamsPhaseItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ trial: NotRequired["SubscriptionScheduleUpdateParamsPhaseItemTrial"] """ @@ -624,7 +624,7 @@ class SubscriptionScheduleUpdateParamsPhaseItem(TypedDict): class SubscriptionScheduleUpdateParamsPhaseItemBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -694,7 +694,7 @@ class SubscriptionScheduleUpdateParamsPhaseItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ diff --git a/stripe/params/_subscription_search_params.py b/stripe/params/_subscription_search_params.py index 7930e586c..7dcd112d4 100644 --- a/stripe/params/_subscription_search_params.py +++ b/stripe/params/_subscription_search_params.py @@ -20,5 +20,5 @@ class SubscriptionSearchParams(RequestOptions): """ query: str """ - The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for subscriptions](https://stripe.com/docs/search#query-fields-for-subscriptions). + The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for subscriptions](https://docs.stripe.com/search#query-fields-for-subscriptions). """ diff --git a/stripe/params/_subscription_update_params.py b/stripe/params/_subscription_update_params.py index 5a5b5c34e..c3c555e3b 100644 --- a/stripe/params/_subscription_update_params.py +++ b/stripe/params/_subscription_update_params.py @@ -25,7 +25,7 @@ class SubscriptionUpdateParams(TypedDict): """ billing_cycle_anchor: NotRequired[Literal["now", "unchanged"]] """ - Either `now` or `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle). + Either `now` or `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). """ billing_schedules: NotRequired[ "Literal['']|List[SubscriptionUpdateParamsBillingSchedule]" @@ -67,11 +67,11 @@ class SubscriptionUpdateParams(TypedDict): """ default_payment_method: NotRequired[str] """ - ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_source: NotRequired["Literal['']|str"] """ - ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source). + ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source). """ default_tax_rates: NotRequired["Literal['']|List[str]"] """ @@ -101,7 +101,7 @@ class SubscriptionUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ off_session: NotRequired[bool] """ @@ -115,7 +115,7 @@ class SubscriptionUpdateParams(TypedDict): "Literal['']|SubscriptionUpdateParamsPauseCollection" ] """ - If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment). + If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment). """ payment_behavior: NotRequired[ Literal[ @@ -126,11 +126,11 @@ class SubscriptionUpdateParams(TypedDict): ] ] """ - Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. + Use `allow_incomplete` to transition the subscription to `status=past_due` if a payment is required but cannot be paid. This allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior. - Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://stripe.com/docs/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. + Use `default_incomplete` to transition the subscription to `status=past_due` when payment is required and await explicit confirmation of the invoice's payment intent. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://docs.stripe.com/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. - Use `pending_if_incomplete` to update the subscription using [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://stripe.com/docs/billing/pending-updates-reference#supported-attributes). + Use `pending_if_incomplete` to update the subscription using [pending updates](https://docs.stripe.com/billing/subscriptions/pending-updates). When you use `pending_if_incomplete` you can only pass the parameters [supported by pending updates](https://docs.stripe.com/billing/pending-updates-reference#supported-attributes). Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's invoice cannot be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further user action is needed, this parameter does not update the subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://docs.stripe.com/changelog/2019-03-14) to learn more. """ @@ -142,7 +142,7 @@ class SubscriptionUpdateParams(TypedDict): "Literal['']|SubscriptionUpdateParamsPendingInvoiceItemInterval" ] """ - Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://stripe.com/docs/api#create_invoice) for the given subscription at the specified interval. + Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://docs.stripe.com/api#create_invoice) for the given subscription at the specified interval. """ prebilling: NotRequired["SubscriptionUpdateParamsPrebilling"] """ @@ -152,7 +152,7 @@ class SubscriptionUpdateParams(TypedDict): Literal["always_invoice", "create_prorations", "none"] ] """ - Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. + Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`. """ proration_date: NotRequired[int] """ @@ -170,7 +170,7 @@ class SubscriptionUpdateParams(TypedDict): """ trial_from_plan: NotRequired[bool] """ - Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more. + Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://docs.stripe.com/billing/subscriptions/trials) to learn more. """ trial_settings: NotRequired["SubscriptionUpdateParamsTrialSettings"] """ @@ -187,7 +187,7 @@ class SubscriptionUpdateParamsAddInvoiceItem(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ period: NotRequired["SubscriptionUpdateParamsAddInvoiceItemPeriod"] """ @@ -199,7 +199,7 @@ class SubscriptionUpdateParamsAddInvoiceItem(TypedDict): """ price_data: NotRequired["SubscriptionUpdateParamsAddInvoiceItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -306,7 +306,7 @@ class SubscriptionUpdateParamsAddInvoiceItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -516,7 +516,7 @@ class SubscriptionUpdateParamsItem(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ plan: NotRequired[str] """ @@ -528,7 +528,7 @@ class SubscriptionUpdateParamsItem(TypedDict): """ price_data: NotRequired["SubscriptionUpdateParamsItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -536,14 +536,14 @@ class SubscriptionUpdateParamsItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. + A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates. """ class SubscriptionUpdateParamsItemBillingThresholds(TypedDict): usage_gte: int """ - Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) + Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte)) """ @@ -611,7 +611,7 @@ class SubscriptionUpdateParamsItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -653,7 +653,7 @@ class SubscriptionUpdateParamsPaymentSettings(TypedDict): Payment-method-specific configuration to provide to invoices created by the subscription. """ payment_method_types: NotRequired[ - "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" + "Literal['']|List[Literal['ach_credit_transfer', 'ach_debit', 'acss_debit', 'affirm', 'amazon_pay', 'au_becs_debit', 'bacs_debit', 'bancontact', 'boleto', 'card', 'cashapp', 'crypto', 'custom', 'customer_balance', 'eps', 'fpx', 'giropay', 'grabpay', 'id_bank_transfer', 'ideal', 'jp_credit_transfer', 'kakao_pay', 'klarna', 'konbini', 'kr_card', 'link', 'multibanco', 'naver_pay', 'nz_bank_account', 'p24', 'payco', 'paynow', 'paypal', 'payto', 'pix', 'promptpay', 'revolut_pay', 'sepa_credit_transfer', 'sepa_debit', 'sofort', 'stripe_balance', 'swish', 'upi', 'us_bank_account', 'wechat_pay']]" ] """ 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](https://dashboard.stripe.com/settings/billing/invoice). Should not be specified with payment_method_configuration @@ -701,6 +701,12 @@ class SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptions(TypedDict): """ This sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent. """ + payto: NotRequired[ + "Literal['']|SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPayto" + ] + """ + This sub-hash contains details about the PayTo payment method options to pass to the invoice's PaymentIntent. + """ pix: NotRequired[ "Literal['']|SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPix" ] @@ -795,7 +801,7 @@ class SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsCard( Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). 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](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). 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](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ @@ -867,6 +873,44 @@ class SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsKonbini( pass +class SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPayto( + TypedDict, +): + mandate_options: NotRequired[ + "SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions" + ] + """ + Additional fields for Mandate creation. + """ + + +class SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPaytoMandateOptions( + TypedDict, +): + amount: NotRequired[int] + """ + The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit. + """ + purpose: NotRequired[ + Literal[ + "dependant_support", + "government", + "loan", + "mortgage", + "other", + "pension", + "personal", + "retail", + "salary", + "tax", + "utility", + ] + ] + """ + The purpose for which payments are made. Has a default value based on your merchant category code. + """ + + class SubscriptionUpdateParamsPaymentSettingsPaymentMethodOptionsPix( TypedDict ): diff --git a/stripe/params/_tax_id_create_params.py b/stripe/params/_tax_id_create_params.py index 33d30f48c..fffda28d7 100644 --- a/stripe/params/_tax_id_create_params.py +++ b/stripe/params/_tax_id_create_params.py @@ -138,7 +138,7 @@ class TaxIdCreateParams(RequestOptions): class TaxIdCreateParamsOwner(TypedDict): account: NotRequired[str] """ - Account the tax ID belongs to. Required when `type=account` + Connected Account the tax ID belongs to. Required when `type=account` """ customer: NotRequired[str] """ @@ -146,7 +146,7 @@ class TaxIdCreateParamsOwner(TypedDict): """ customer_account: NotRequired[str] """ - v2 Account the tax ID belongs to. Can be used in place of `customer` when `type=customer` + ID of the Account representing the customer that the tax ID belongs to. Can be used in place of `customer` when `type=customer` """ type: Literal["account", "application", "customer", "self"] """ diff --git a/stripe/params/_tax_id_list_params.py b/stripe/params/_tax_id_list_params.py index ec89e82f3..7c30b8178 100644 --- a/stripe/params/_tax_id_list_params.py +++ b/stripe/params/_tax_id_list_params.py @@ -31,7 +31,7 @@ class TaxIdListParams(RequestOptions): class TaxIdListParamsOwner(TypedDict): account: NotRequired[str] """ - Account the tax ID belongs to. Required when `type=account` + Connected Account the tax ID belongs to. Required when `type=account` """ customer: NotRequired[str] """ @@ -39,7 +39,7 @@ class TaxIdListParamsOwner(TypedDict): """ customer_account: NotRequired[str] """ - v2 Account the tax ID belongs to. Can be used in place of `customer` when `type=customer` + ID of the Account representing the customer that the tax ID belongs to. Can be used in place of `customer` when `type=customer` """ type: Literal["account", "application", "customer", "self"] """ diff --git a/stripe/params/_tax_rate_create_params.py b/stripe/params/_tax_rate_create_params.py index e92785e0c..d8ebf03af 100644 --- a/stripe/params/_tax_rate_create_params.py +++ b/stripe/params/_tax_rate_create_params.py @@ -36,7 +36,7 @@ class TaxRateCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ percentage: float """ diff --git a/stripe/params/_tax_rate_modify_params.py b/stripe/params/_tax_rate_modify_params.py index 04473b12d..571215003 100644 --- a/stripe/params/_tax_rate_modify_params.py +++ b/stripe/params/_tax_rate_modify_params.py @@ -32,7 +32,7 @@ class TaxRateModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ state: NotRequired[str] """ diff --git a/stripe/params/_tax_rate_update_params.py b/stripe/params/_tax_rate_update_params.py index c049176ad..0e887e9b7 100644 --- a/stripe/params/_tax_rate_update_params.py +++ b/stripe/params/_tax_rate_update_params.py @@ -31,7 +31,7 @@ class TaxRateUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ state: NotRequired[str] """ diff --git a/stripe/params/_token_create_params.py b/stripe/params/_token_create_params.py index 658dc00b0..e66b44517 100644 --- a/stripe/params/_token_create_params.py +++ b/stripe/params/_token_create_params.py @@ -20,7 +20,7 @@ class TokenCreateParams(RequestOptions): """ customer: NotRequired[str] """ - Create a token for the customer, which is owned by the application's account. You can only use this with an [OAuth access token](https://stripe.com/docs/connect/standard-accounts) or [Stripe-Account header](https://stripe.com/docs/connect/authentication). Learn more about [cloning saved payment methods](https://stripe.com/docs/connect/cloning-saved-payment-methods). + Create a token for the customer, which is owned by the application's account. You can only use this with an [OAuth access token](https://docs.stripe.com/connect/standard-accounts) or [Stripe-Account header](https://docs.stripe.com/connect/authentication). Learn more about [cloning saved payment methods](https://docs.stripe.com/connect/cloning-saved-payment-methods). """ cvc_update: NotRequired["TokenCreateParamsCvcUpdate"] """ @@ -195,7 +195,7 @@ class TokenCreateParamsAccountCompanyAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -333,11 +333,11 @@ class TokenCreateParamsAccountCompanyVerification(TypedDict): class TokenCreateParamsAccountCompanyVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of a document returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ @@ -410,7 +410,7 @@ class TokenCreateParamsAccountIndividual(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone: NotRequired[str] """ @@ -463,7 +463,7 @@ class TokenCreateParamsAccountIndividualAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -567,7 +567,7 @@ class TokenCreateParamsAccountIndividualRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -614,22 +614,22 @@ class TokenCreateParamsAccountIndividualVerificationAdditionalDocument( ): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class TokenCreateParamsAccountIndividualVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ @@ -656,7 +656,7 @@ class TokenCreateParamsBankAccount(TypedDict): """ currency: NotRequired[str] """ - The currency the bank account is in. This must be a country/currency pairing that [Stripe supports.](https://stripe.com/docs/payouts) + The currency the bank account is in. This must be a country/currency pairing that [Stripe supports.](https://docs.stripe.com/payouts) """ payment_method: NotRequired[str] """ @@ -814,7 +814,7 @@ class TokenCreateParamsPerson(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nationality: NotRequired[str] """ @@ -897,7 +897,7 @@ class TokenCreateParamsPersonAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -998,21 +998,21 @@ class TokenCreateParamsPersonDocuments(TypedDict): class TokenCreateParamsPersonDocumentsCompanyAuthorization(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class TokenCreateParamsPersonDocumentsPassport(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ class TokenCreateParamsPersonDocumentsVisa(TypedDict): files: NotRequired[List[str]] """ - One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`. + One or more document ids returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `account_requirement`. """ @@ -1039,7 +1039,7 @@ class TokenCreateParamsPersonRegisteredAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1174,22 +1174,22 @@ class TokenCreateParamsPersonVerification(TypedDict): class TokenCreateParamsPersonVerificationAdditionalDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ class TokenCreateParamsPersonVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size. """ diff --git a/stripe/params/_topup_create_params.py b/stripe/params/_topup_create_params.py index e7d682ace..69eea27ce 100644 --- a/stripe/params/_topup_create_params.py +++ b/stripe/params/_topup_create_params.py @@ -24,11 +24,11 @@ class TopupCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ source: NotRequired[str] """ - The ID of a source to transfer funds from. For most users, this should be left unspecified which will use the bank account that was set up in the dashboard for the specified currency. In test mode, this can be a test bank token (see [Testing Top-ups](https://stripe.com/docs/connect/testing#testing-top-ups)). + The ID of a source to transfer funds from. For most users, this should be left unspecified which will use the bank account that was set up in the dashboard for the specified currency. In test mode, this can be a test bank token (see [Testing Top-ups](https://docs.stripe.com/connect/testing#testing-top-ups)). """ statement_descriptor: NotRequired[str] """ diff --git a/stripe/params/_topup_modify_params.py b/stripe/params/_topup_modify_params.py index 1886a84fc..66e5b1473 100644 --- a/stripe/params/_topup_modify_params.py +++ b/stripe/params/_topup_modify_params.py @@ -16,5 +16,5 @@ class TopupModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_topup_update_params.py b/stripe/params/_topup_update_params.py index e4f803fda..66e2b8dfe 100644 --- a/stripe/params/_topup_update_params.py +++ b/stripe/params/_topup_update_params.py @@ -15,5 +15,5 @@ class TopupUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_transfer_create_params.py b/stripe/params/_transfer_create_params.py index a56657799..08c8f56dc 100644 --- a/stripe/params/_transfer_create_params.py +++ b/stripe/params/_transfer_create_params.py @@ -32,11 +32,11 @@ class TransferCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ source_transaction: NotRequired[str] """ - You can use this parameter to transfer funds from a charge before they are added to your available balance. A pending balance will transfer immediately but the funds will not become available until the original charge becomes available. [See the Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-availability) for details. + You can use this parameter to transfer funds from a charge before they are added to your available balance. A pending balance will transfer immediately but the funds will not become available until the original charge becomes available. [See the Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-availability) for details. """ source_type: NotRequired[Literal["bank_account", "card", "fpx"]] """ @@ -44,5 +44,5 @@ class TransferCreateParams(RequestOptions): """ transfer_group: NotRequired[str] """ - A string that identifies this transaction as part of a group. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details. + A string that identifies this transaction as part of a group. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details. """ diff --git a/stripe/params/_transfer_create_reversal_params.py b/stripe/params/_transfer_create_reversal_params.py index e59069fd1..3bed8eed3 100644 --- a/stripe/params/_transfer_create_reversal_params.py +++ b/stripe/params/_transfer_create_reversal_params.py @@ -20,7 +20,7 @@ class TransferCreateReversalParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ refund_application_fee: NotRequired[bool] """ diff --git a/stripe/params/_transfer_modify_params.py b/stripe/params/_transfer_modify_params.py index bfee1cecb..a3aeb4c9f 100644 --- a/stripe/params/_transfer_modify_params.py +++ b/stripe/params/_transfer_modify_params.py @@ -16,5 +16,5 @@ class TransferModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_transfer_modify_reversal_params.py b/stripe/params/_transfer_modify_reversal_params.py index ab2b0d271..d7c223e5b 100644 --- a/stripe/params/_transfer_modify_reversal_params.py +++ b/stripe/params/_transfer_modify_reversal_params.py @@ -12,5 +12,5 @@ class TransferModifyReversalParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_transfer_reversal_create_params.py b/stripe/params/_transfer_reversal_create_params.py index 50268c857..17e623dd1 100644 --- a/stripe/params/_transfer_reversal_create_params.py +++ b/stripe/params/_transfer_reversal_create_params.py @@ -19,7 +19,7 @@ class TransferReversalCreateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ refund_application_fee: NotRequired[bool] """ diff --git a/stripe/params/_transfer_reversal_update_params.py b/stripe/params/_transfer_reversal_update_params.py index aebe79cc1..503053b6c 100644 --- a/stripe/params/_transfer_reversal_update_params.py +++ b/stripe/params/_transfer_reversal_update_params.py @@ -11,5 +11,5 @@ class TransferReversalUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_transfer_update_params.py b/stripe/params/_transfer_update_params.py index 4d0452546..7363dcab7 100644 --- a/stripe/params/_transfer_update_params.py +++ b/stripe/params/_transfer_update_params.py @@ -15,5 +15,5 @@ class TransferUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/_webhook_endpoint_create_params.py b/stripe/params/_webhook_endpoint_create_params.py index 9af48e104..9837a49d8 100644 --- a/stripe/params/_webhook_endpoint_create_params.py +++ b/stripe/params/_webhook_endpoint_create_params.py @@ -126,6 +126,8 @@ class WebhookEndpointCreateParams(RequestOptions): "2025-09-30.clover", "2025-10-29.clover", "2025-11-17.clover", + "2025-12-15.clover", + "2026-01-28.clover", ] ] """ @@ -444,7 +446,7 @@ class WebhookEndpointCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ url: str """ diff --git a/stripe/params/_webhook_endpoint_modify_params.py b/stripe/params/_webhook_endpoint_modify_params.py index 1d9885c35..6139fa21f 100644 --- a/stripe/params/_webhook_endpoint_modify_params.py +++ b/stripe/params/_webhook_endpoint_modify_params.py @@ -321,7 +321,7 @@ class WebhookEndpointModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ url: NotRequired[str] """ diff --git a/stripe/params/_webhook_endpoint_update_params.py b/stripe/params/_webhook_endpoint_update_params.py index b1a10dd74..89a036a7a 100644 --- a/stripe/params/_webhook_endpoint_update_params.py +++ b/stripe/params/_webhook_endpoint_update_params.py @@ -320,7 +320,7 @@ class WebhookEndpointUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ url: NotRequired[str] """ diff --git a/stripe/params/billing/_credit_balance_summary_retrieve_params.py b/stripe/params/billing/_credit_balance_summary_retrieve_params.py index c43626eda..a5ea1a65a 100644 --- a/stripe/params/billing/_credit_balance_summary_retrieve_params.py +++ b/stripe/params/billing/_credit_balance_summary_retrieve_params.py @@ -8,11 +8,11 @@ class CreditBalanceSummaryRetrieveParams(RequestOptions): customer: NotRequired[str] """ - The customer for which to fetch credit balance summary. + The customer whose credit balance summary you're retrieving. """ customer_account: NotRequired[str] """ - The account for which to fetch credit balance summary. + The account representing the customer whose credit balance summary you're retrieving. """ expand: NotRequired[List[str]] """ diff --git a/stripe/params/billing/_credit_balance_transaction_list_params.py b/stripe/params/billing/_credit_balance_transaction_list_params.py index b3c5ef43c..9550b2860 100644 --- a/stripe/params/billing/_credit_balance_transaction_list_params.py +++ b/stripe/params/billing/_credit_balance_transaction_list_params.py @@ -12,11 +12,11 @@ class CreditBalanceTransactionListParams(RequestOptions): """ customer: NotRequired[str] """ - The customer for which to fetch credit balance transactions. + The customer whose credit balance transactions you're retrieving. """ customer_account: NotRequired[str] """ - The account for which to fetch credit balance transactions. + The account representing the customer whose credit balance transactions you're retrieving. """ ending_before: NotRequired[str] """ diff --git a/stripe/params/billing/_credit_grant_create_params.py b/stripe/params/billing/_credit_grant_create_params.py index de037e822..bab9f9ff4 100644 --- a/stripe/params/billing/_credit_grant_create_params.py +++ b/stripe/params/billing/_credit_grant_create_params.py @@ -20,11 +20,11 @@ class CreditGrantCreateParams(RequestOptions): """ customer: NotRequired[str] """ - ID of the customer to receive the billing credits. + ID of the customer receiving the billing credits. """ customer_account: NotRequired[str] """ - ID of the account to receive the billing credits. + ID of the account representing the customer receiving the billing credits. """ effective_at: NotRequired[int] """ diff --git a/stripe/params/billing/_credit_grant_list_params.py b/stripe/params/billing/_credit_grant_list_params.py index e95b6e945..fc2a1cbba 100644 --- a/stripe/params/billing/_credit_grant_list_params.py +++ b/stripe/params/billing/_credit_grant_list_params.py @@ -12,7 +12,7 @@ class CreditGrantListParams(RequestOptions): """ customer_account: NotRequired[str] """ - Only return credit grants for this account. + Only return credit grants for this account representing the customer. """ ending_before: NotRequired[str] """ diff --git a/stripe/params/billing/_meter_event_create_params.py b/stripe/params/billing/_meter_event_create_params.py index 6a65963e3..98bfec24d 100644 --- a/stripe/params/billing/_meter_event_create_params.py +++ b/stripe/params/billing/_meter_event_create_params.py @@ -20,7 +20,7 @@ class MeterEventCreateParams(RequestOptions): """ payload: Dict[str, str] """ - The payload of the event. This must contain the fields corresponding to a meter's `customer_mapping.event_payload_key` (default is `stripe_customer_id`) and `value_settings.event_payload_key` (default is `value`). Read more about the [payload](https://docs.stripe.com/billing/subscriptions/usage-based/recording-usage#payload-key-overrides). + The payload of the event. This must contain the fields corresponding to a meter's `customer_mapping.event_payload_key` (default is `stripe_customer_id`) and `value_settings.event_payload_key` (default is `value`). Read more about the [payload](https://docs.stripe.com/billing/subscriptions/usage-based/meters/configure#meter-configuration-attributes). """ timestamp: NotRequired[int] """ diff --git a/stripe/params/billing_portal/_configuration_create_params.py b/stripe/params/billing_portal/_configuration_create_params.py index 1265f59ac..6c68c9c7b 100644 --- a/stripe/params/billing_portal/_configuration_create_params.py +++ b/stripe/params/billing_portal/_configuration_create_params.py @@ -12,7 +12,7 @@ class ConfigurationCreateParams(RequestOptions): """ default_return_url: NotRequired["Literal['']|str"] """ - The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. + The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. """ expand: NotRequired[List[str]] """ @@ -28,7 +28,7 @@ class ConfigurationCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired["Literal['']|str"] """ @@ -166,6 +166,10 @@ class ConfigurationCreateParamsFeaturesSubscriptionCancelCancellationReason( class ConfigurationCreateParamsFeaturesSubscriptionUpdate(TypedDict): + billing_cycle_anchor: NotRequired[Literal["now", "unchanged"]] + """ + Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). + """ default_allowed_updates: NotRequired[ "Literal['']|List[Literal['price', 'promotion_code', 'quantity']]" ] @@ -259,5 +263,5 @@ class ConfigurationCreateParamsFeaturesSubscriptionUpdateScheduleAtPeriodEndCond class ConfigurationCreateParamsLoginPage(TypedDict): enabled: bool """ - Set to `true` to generate a shareable URL [`login_page.url`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal. + Set to `true` to generate a shareable URL [`login_page.url`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal. """ diff --git a/stripe/params/billing_portal/_configuration_modify_params.py b/stripe/params/billing_portal/_configuration_modify_params.py index 72cbf435c..7f2f3439c 100644 --- a/stripe/params/billing_portal/_configuration_modify_params.py +++ b/stripe/params/billing_portal/_configuration_modify_params.py @@ -16,7 +16,7 @@ class ConfigurationModifyParams(RequestOptions): """ default_return_url: NotRequired["Literal['']|str"] """ - The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. + The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. """ expand: NotRequired[List[str]] """ @@ -32,7 +32,7 @@ class ConfigurationModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired["Literal['']|str"] """ @@ -158,6 +158,10 @@ class ConfigurationModifyParamsFeaturesSubscriptionCancelCancellationReason( class ConfigurationModifyParamsFeaturesSubscriptionUpdate(TypedDict): + billing_cycle_anchor: NotRequired[Literal["now", "unchanged"]] + """ + Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). + """ default_allowed_updates: NotRequired[ "Literal['']|List[Literal['price', 'promotion_code', 'quantity']]" ] @@ -249,7 +253,7 @@ class ConfigurationModifyParamsFeaturesSubscriptionUpdateScheduleAtPeriodEndCond class ConfigurationModifyParamsLoginPage(TypedDict): enabled: bool """ - Set to `true` to generate a shareable URL [`login_page.url`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal. + Set to `true` to generate a shareable URL [`login_page.url`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal. Set to `false` to deactivate the `login_page.url`. """ diff --git a/stripe/params/billing_portal/_configuration_update_params.py b/stripe/params/billing_portal/_configuration_update_params.py index 084ad54b6..7e605f1ec 100644 --- a/stripe/params/billing_portal/_configuration_update_params.py +++ b/stripe/params/billing_portal/_configuration_update_params.py @@ -15,7 +15,7 @@ class ConfigurationUpdateParams(TypedDict): """ default_return_url: NotRequired["Literal['']|str"] """ - The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. + The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session. """ expand: NotRequired[List[str]] """ @@ -31,7 +31,7 @@ class ConfigurationUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired["Literal['']|str"] """ @@ -157,6 +157,10 @@ class ConfigurationUpdateParamsFeaturesSubscriptionCancelCancellationReason( class ConfigurationUpdateParamsFeaturesSubscriptionUpdate(TypedDict): + billing_cycle_anchor: NotRequired[Literal["now", "unchanged"]] + """ + Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle). + """ default_allowed_updates: NotRequired[ "Literal['']|List[Literal['price', 'promotion_code', 'quantity']]" ] @@ -248,7 +252,7 @@ class ConfigurationUpdateParamsFeaturesSubscriptionUpdateScheduleAtPeriodEndCond class ConfigurationUpdateParamsLoginPage(TypedDict): enabled: bool """ - Set to `true` to generate a shareable URL [`login_page.url`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal. + Set to `true` to generate a shareable URL [`login_page.url`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal. Set to `false` to deactivate the `login_page.url`. """ diff --git a/stripe/params/billing_portal/_session_create_params.py b/stripe/params/billing_portal/_session_create_params.py index 56e3179fc..be54d2a44 100644 --- a/stripe/params/billing_portal/_session_create_params.py +++ b/stripe/params/billing_portal/_session_create_params.py @@ -8,7 +8,7 @@ class SessionCreateParams(RequestOptions): configuration: NotRequired[str] """ - The ID of an existing [configuration](https://stripe.com/docs/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration. + The ID of an existing [configuration](https://docs.stripe.com/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration. """ customer: NotRequired[str] """ @@ -24,7 +24,7 @@ class SessionCreateParams(RequestOptions): """ flow_data: NotRequired["SessionCreateParamsFlowData"] """ - Information about a specific flow for the customer to go through. See the [docs](https://stripe.com/docs/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows. + Information about a specific flow for the customer to go through. See the [docs](https://docs.stripe.com/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows. """ locale: NotRequired[ Literal[ @@ -82,7 +82,7 @@ class SessionCreateParams(RequestOptions): """ on_behalf_of: NotRequired[str] """ - The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays. + The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://docs.stripe.com/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://docs.stripe.com/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays. """ return_url: NotRequired[str] """ @@ -206,7 +206,7 @@ class SessionCreateParamsFlowDataSubscriptionUpdateConfirm(TypedDict): """ items: List["SessionCreateParamsFlowDataSubscriptionUpdateConfirmItem"] """ - The [subscription item](https://stripe.com/docs/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable. + The [subscription item](https://docs.stripe.com/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable. """ subscription: str """ @@ -228,13 +228,13 @@ class SessionCreateParamsFlowDataSubscriptionUpdateConfirmDiscount(TypedDict): class SessionCreateParamsFlowDataSubscriptionUpdateConfirmItem(TypedDict): id: str """ - The ID of the [subscription item](https://stripe.com/docs/api/subscriptions/object#subscription_object-items-data-id) to be updated. + The ID of the [subscription item](https://docs.stripe.com/api/subscriptions/object#subscription_object-items-data-id) to be updated. """ price: NotRequired[str] """ - The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products). + The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products). """ quantity: NotRequired[int] """ - [Quantity](https://stripe.com/docs/subscriptions/quantities) for this item that the customer should subscribe to through this flow. + [Quantity](https://docs.stripe.com/subscriptions/quantities) for this item that the customer should subscribe to through this flow. """ diff --git a/stripe/params/checkout/_session_create_params.py b/stripe/params/checkout/_session_create_params.py index 0d1b226e6..38f8c4794 100644 --- a/stripe/params/checkout/_session_create_params.py +++ b/stripe/params/checkout/_session_create_params.py @@ -60,15 +60,15 @@ class SessionCreateParams(RequestOptions): """ ID of an existing Customer, if one exists. In `payment` mode, the customer's most recently saved card payment method will be used to prefill the email, name, card details, and billing address - on the Checkout page. In `subscription` mode, the customer's [default payment method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method) + on the Checkout page. In `subscription` mode, the customer's [default payment method](https://docs.stripe.com/api/customers/update#update_customer-invoice_settings-default_payment_method) will be used if it's a card, otherwise the most recently saved card will be used. A valid billing address, billing name and billing email are required on the payment method for Checkout to prefill the customer's card details. - If the Customer already has a valid [email](https://stripe.com/docs/api/customers/object#customer_object-email) set, the email will be prefilled and not editable in Checkout. + If the Customer already has a valid [email](https://docs.stripe.com/api/customers/object#customer_object-email) set, the email will be prefilled and not editable in Checkout. If the Customer does not have a valid `email`, Checkout will set the email entered during the session on the Customer. If blank for Checkout Sessions in `subscription` mode or with `customer_creation` set as `always` in `payment` mode, Checkout will create a new Customer object based on information provided during the payment flow. - You can set [`payment_intent_data.setup_future_usage`](https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse. + You can set [`payment_intent_data.setup_future_usage`](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse. """ customer_account: NotRequired[str] """ @@ -76,12 +76,12 @@ class SessionCreateParams(RequestOptions): """ customer_creation: NotRequired[Literal["always", "if_required"]] """ - Configure whether a Checkout Session creates a [Customer](https://stripe.com/docs/api/customers) during Session confirmation. + Configure whether a Checkout Session creates a [Customer](https://docs.stripe.com/api/customers) during Session confirmation. When a Customer is not created, you can still retrieve email, address, and other customer data entered in Checkout - with [customer_details](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-customer_details). + with [customer_details](https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-customer_details). - Sessions that don't create Customers instead are grouped by [guest customers](https://stripe.com/docs/payments/checkout/guest-customers) + Sessions that don't create Customers instead are grouped by [guest customers](https://docs.stripe.com/payments/checkout/guest-customers) in the Dashboard. Promotion codes limited to first time customers will return invalid for these Sessions. Can only be set in `payment` and `setup` mode. @@ -179,7 +179,7 @@ class SessionCreateParams(RequestOptions): """ line_items: NotRequired[List["SessionCreateParamsLineItem"]] """ - A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices). The parameter is required for `payment` and `subscription` mode. + A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://docs.stripe.com/api/prices). The parameter is required for `payment` and `subscription` mode. For `payment` mode, there is a maximum of 100 line items, however it is recommended to consolidate line items if there are more than a few dozen. @@ -235,7 +235,7 @@ class SessionCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mode: NotRequired[Literal["payment", "setup", "subscription"]] """ @@ -247,11 +247,11 @@ class SessionCreateParams(RequestOptions): You can configure Checkout to collect your customers' business names, individual names, or both. Each name field can be either required or optional. - If a [Customer](https://stripe.com/docs/api/customers) is created or provided, the names can be saved to the Customer object as well. + If a [Customer](https://docs.stripe.com/api/customers) is created or provided, the names can be saved to the Customer object as well. """ optional_items: NotRequired[List["SessionCreateParamsOptionalItem"]] """ - A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices). + A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://docs.stripe.com/api/prices). There is a maximum of 10 optional items allowed on a Checkout Session, and the existing limits on the number of line items allowed on a Checkout Session apply to the combined number of line items and optional items. @@ -274,7 +274,7 @@ class SessionCreateParams(RequestOptions): Can only be set in `subscription` mode. Defaults to `always`. - If you'd like information on how to collect a payment method outside of Checkout, read the guide on configuring [subscriptions with a free trial](https://stripe.com/docs/payments/checkout/free-trials). + If you'd like information on how to collect a payment method outside of Checkout, read the guide on configuring [subscriptions with a free trial](https://docs.stripe.com/payments/checkout/free-trials). """ payment_method_configuration: NotRequired[str] """ @@ -355,7 +355,7 @@ class SessionCreateParams(RequestOptions): A list of the types of payment methods (e.g., `card`) this Checkout Session can accept. You can omit this attribute to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods). - See [Dynamic Payment Methods](https://stripe.com/docs/payments/payment-methods/integration-options#using-dynamic-payment-methods) for more details. + See [Dynamic Payment Methods](https://docs.stripe.com/payments/payment-methods/integration-options#using-dynamic-payment-methods) for more details. Read more about the supported payment methods and their requirements in our [payment method details guide](https://docs.stripe.com/docs/payments/checkout/payment-methods). @@ -377,13 +377,13 @@ class SessionCreateParams(RequestOptions): Controls phone number collection settings for the session. We recommend that you review your privacy policy and check with your legal contacts - before using this feature. Learn more about [collecting phone numbers with Checkout](https://stripe.com/docs/payments/checkout/phone-numbers). + before using this feature. Learn more about [collecting phone numbers with Checkout](https://docs.stripe.com/payments/checkout/phone-numbers). """ redirect_on_completion: NotRequired[ Literal["always", "if_required", "never"] ] """ - This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://stripe.com/docs/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`. + This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://docs.stripe.com/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`. """ return_url: NotRequired[str] """ @@ -430,7 +430,7 @@ class SessionCreateParams(RequestOptions): is complete. This parameter is not allowed if ui_mode is `embedded` or `custom`. If you'd like to use information from the successful Checkout Session on your page, read the - guide on [customizing your success page](https://stripe.com/docs/payments/checkout/custom-success-page). + guide on [customizing your success page](https://docs.stripe.com/payments/checkout/custom-success-page). """ tax_id_collection: NotRequired["SessionCreateParamsTaxIdCollection"] """ @@ -763,7 +763,7 @@ class SessionCreateParamsDiscount(TypedDict): """ coupon_data: NotRequired["SessionCreateParamsDiscountCouponData"] """ - Data used to generate a new [Coupon](https://stripe.com/docs/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts. + Data used to generate a new [Coupon](https://docs.stripe.com/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts. """ promotion_code: NotRequired[str] """ @@ -786,7 +786,7 @@ class SessionCreateParamsDiscountCouponData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -834,7 +834,7 @@ class SessionCreateParamsInvoiceCreationInvoiceData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ rendering_options: NotRequired[ "Literal['']|SessionCreateParamsInvoiceCreationInvoiceDataRenderingOptions" @@ -888,19 +888,19 @@ class SessionCreateParamsLineItem(TypedDict): """ dynamic_tax_rates: NotRequired[List[str]] """ - The [tax rates](https://stripe.com/docs/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU. + The [tax rates](https://docs.stripe.com/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU. """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: NotRequired[str] """ - The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. One of `price` or `price_data` is required. + The ID of the [Price](https://docs.stripe.com/api/prices) or [Plan](https://docs.stripe.com/api/plans) object. One of `price` or `price_data` is required. """ price_data: NotRequired["SessionCreateParamsLineItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required. """ quantity: NotRequired[int] """ @@ -908,7 +908,7 @@ class SessionCreateParamsLineItem(TypedDict): """ tax_rates: NotRequired[List[str]] """ - The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item. + The [tax rates](https://docs.stripe.com/api/tax_rates) which apply to this line item. """ @@ -948,7 +948,7 @@ class SessionCreateParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -971,7 +971,7 @@ class SessionCreateParamsLineItemPriceDataProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -979,7 +979,7 @@ class SessionCreateParamsLineItemPriceDataProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ @@ -1040,7 +1040,7 @@ class SessionCreateParamsOptionalItem(TypedDict): """ price: str """ - The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. + The ID of the [Price](https://docs.stripe.com/api/prices) or [Plan](https://docs.stripe.com/api/plans) object. """ quantity: int """ @@ -1066,7 +1066,7 @@ class SessionCreateParamsOptionalItemAdjustableQuantity(TypedDict): class SessionCreateParamsPaymentIntentData(TypedDict): application_fee_amount: NotRequired[int] """ - The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ capture_method: NotRequired[ Literal["automatic", "automatic_async", "manual"] @@ -1080,7 +1080,7 @@ class SessionCreateParamsPaymentIntentData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired[str] """ @@ -1094,7 +1094,7 @@ class SessionCreateParamsPaymentIntentData(TypedDict): """ setup_future_usage: NotRequired[Literal["off_session", "on_session"]] """ - Indicates that you intend to [make future payments](https://stripe.com/docs/payments/payment-intents#future-usage) with the payment + Indicates that you intend to [make future payments](https://docs.stripe.com/payments/payment-intents#future-usage) with the payment method collected by this Checkout Session. When setting this to `on_session`, Checkout will show a notice to the @@ -1134,11 +1134,11 @@ class SessionCreateParamsPaymentIntentData(TypedDict): ] """ The parameters used to automatically create a Transfer when the payment succeeds. - For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts). + For more information, see the PaymentIntents [use case for connected accounts](https://docs.stripe.com/payments/connected-accounts). """ transfer_group: NotRequired[str] """ - A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details. + A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers) for details. """ @@ -1188,7 +1188,7 @@ class SessionCreateParamsPaymentIntentDataShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -1678,7 +1678,7 @@ class SessionCreateParamsPaymentMethodOptionsCard(TypedDict): Literal["any", "automatic", "challenge"] ] """ - We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. + We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine. """ restrictions: NotRequired[ "SessionCreateParamsPaymentMethodOptionsCardRestrictions" @@ -2157,7 +2157,7 @@ class SessionCreateParamsPaymentMethodOptionsPaypal(TypedDict): ] ] """ - [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. + [Preferred locale](https://docs.stripe.com/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to. """ reference: NotRequired[str] """ @@ -2211,56 +2211,35 @@ class SessionCreateParamsPaymentMethodOptionsPayto(TypedDict): class SessionCreateParamsPaymentMethodOptionsPaytoMandateOptions(TypedDict): - amount: NotRequired[int] + amount: NotRequired["Literal['']|int"] """ Amount that will be collected. It is required when `amount_type` is `fixed`. """ - amount_type: NotRequired[Literal["fixed", "maximum"]] + amount_type: NotRequired["Literal['']|Literal['fixed', 'maximum']"] """ The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively. Defaults to `maximum`. """ - end_date: NotRequired[str] + end_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date. """ payment_schedule: NotRequired[ - Literal[ - "adhoc", - "annual", - "daily", - "fortnightly", - "monthly", - "quarterly", - "semi_annual", - "weekly", - ] + "Literal['']|Literal['adhoc', 'annual', 'daily', 'fortnightly', 'monthly', 'quarterly', 'semi_annual', 'weekly']" ] """ The periodicity at which payments will be collected. Defaults to `adhoc`. """ - payments_per_period: NotRequired[int] + payments_per_period: NotRequired["Literal['']|int"] """ The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit. """ purpose: NotRequired[ - Literal[ - "dependant_support", - "government", - "loan", - "mortgage", - "other", - "pension", - "personal", - "retail", - "salary", - "tax", - "utility", - ] + "Literal['']|Literal['dependant_support', 'government', 'loan', 'mortgage', 'other', 'pension', 'personal', 'retail', 'salary', 'tax', 'utility']" ] """ The purpose for which payments are made. Has a default value based on your merchant category code. """ - start_date: NotRequired[str] + start_date: NotRequired["Literal['']|str"] """ Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time. """ @@ -2582,7 +2561,7 @@ class SessionCreateParamsSetupIntentData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired[str] """ @@ -2871,7 +2850,7 @@ class SessionCreateParamsShippingOptionShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -2879,7 +2858,7 @@ class SessionCreateParamsShippingOptionShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ @@ -2986,7 +2965,7 @@ class SessionCreateParamsSubscriptionData(TypedDict): """ The subscription's description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription - for rendering in the [customer portal](https://stripe.com/docs/customer-management). + for rendering in the [customer portal](https://docs.stripe.com/customer-management). """ invoice_settings: NotRequired[ "SessionCreateParamsSubscriptionDataInvoiceSettings" @@ -2996,7 +2975,7 @@ class SessionCreateParamsSubscriptionData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ on_behalf_of: NotRequired[str] """ diff --git a/stripe/params/checkout/_session_modify_params.py b/stripe/params/checkout/_session_modify_params.py index 838e8ba67..5772cccac 100644 --- a/stripe/params/checkout/_session_modify_params.py +++ b/stripe/params/checkout/_session_modify_params.py @@ -46,7 +46,7 @@ class SessionModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ shipping_options: NotRequired[ "Literal['']|List[SessionModifyParamsShippingOption]" @@ -121,18 +121,18 @@ class SessionModifyParamsCollectedInformationShippingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class SessionModifyParamsDiscount(TypedDict): coupon: NotRequired[str] """ - The ID of the [Coupon](https://stripe.com/docs/api/coupons) to apply to this Session. One of `coupon` or `coupon_data` is required when updating discounts. + The ID of the [Coupon](https://docs.stripe.com/api/coupons) to apply to this Session. One of `coupon` or `coupon_data` is required when updating discounts. """ coupon_data: NotRequired["SessionModifyParamsDiscountCouponData"] """ - Data used to generate a new [Coupon](https://stripe.com/docs/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts. + Data used to generate a new [Coupon](https://docs.stripe.com/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts. """ @@ -151,7 +151,7 @@ class SessionModifyParamsDiscountCouponData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -201,15 +201,15 @@ class SessionModifyParamsLineItem(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: NotRequired[str] """ - The ID of the [Price](https://stripe.com/docs/api/prices). One of `price` or `price_data` is required when creating a new line item. + The ID of the [Price](https://docs.stripe.com/api/prices). One of `price` or `price_data` is required when creating a new line item. """ price_data: NotRequired["SessionModifyParamsLineItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required when creating a new line item. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required when creating a new line item. """ quantity: NotRequired[int] """ @@ -217,7 +217,7 @@ class SessionModifyParamsLineItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item. + The [tax rates](https://docs.stripe.com/api/tax_rates) which apply to this line item. """ @@ -257,7 +257,7 @@ class SessionModifyParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -280,7 +280,7 @@ class SessionModifyParamsLineItemPriceDataProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -288,7 +288,7 @@ class SessionModifyParamsLineItemPriceDataProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ @@ -339,7 +339,7 @@ class SessionModifyParamsShippingOptionShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -347,7 +347,7 @@ class SessionModifyParamsShippingOptionShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ diff --git a/stripe/params/checkout/_session_update_params.py b/stripe/params/checkout/_session_update_params.py index 3da860a16..f6eabc23a 100644 --- a/stripe/params/checkout/_session_update_params.py +++ b/stripe/params/checkout/_session_update_params.py @@ -45,7 +45,7 @@ class SessionUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ shipping_options: NotRequired[ "Literal['']|List[SessionUpdateParamsShippingOption]" @@ -120,18 +120,18 @@ class SessionUpdateParamsCollectedInformationShippingDetailsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class SessionUpdateParamsDiscount(TypedDict): coupon: NotRequired[str] """ - The ID of the [Coupon](https://stripe.com/docs/api/coupons) to apply to this Session. One of `coupon` or `coupon_data` is required when updating discounts. + The ID of the [Coupon](https://docs.stripe.com/api/coupons) to apply to this Session. One of `coupon` or `coupon_data` is required when updating discounts. """ coupon_data: NotRequired["SessionUpdateParamsDiscountCouponData"] """ - Data used to generate a new [Coupon](https://stripe.com/docs/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts. + Data used to generate a new [Coupon](https://docs.stripe.com/api/coupon) object inline. One of `coupon` or `coupon_data` is required when updating discounts. """ @@ -150,7 +150,7 @@ class SessionUpdateParamsDiscountCouponData(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ @@ -200,15 +200,15 @@ class SessionUpdateParamsLineItem(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ price: NotRequired[str] """ - The ID of the [Price](https://stripe.com/docs/api/prices). One of `price` or `price_data` is required when creating a new line item. + The ID of the [Price](https://docs.stripe.com/api/prices). One of `price` or `price_data` is required when creating a new line item. """ price_data: NotRequired["SessionUpdateParamsLineItemPriceData"] """ - Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required when creating a new line item. + Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required when creating a new line item. """ quantity: NotRequired[int] """ @@ -216,7 +216,7 @@ class SessionUpdateParamsLineItem(TypedDict): """ tax_rates: NotRequired["Literal['']|List[str]"] """ - The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item. + The [tax rates](https://docs.stripe.com/api/tax_rates) which apply to this line item. """ @@ -256,7 +256,7 @@ class SessionUpdateParamsLineItemPriceData(TypedDict): """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ - Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. + Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed. """ unit_amount: NotRequired[int] """ @@ -279,7 +279,7 @@ class SessionUpdateParamsLineItemPriceDataProductData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -287,7 +287,7 @@ class SessionUpdateParamsLineItemPriceDataProductData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ unit_label: NotRequired[str] """ @@ -338,7 +338,7 @@ class SessionUpdateParamsShippingOptionShippingRateData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive", "unspecified"]] """ @@ -346,7 +346,7 @@ class SessionUpdateParamsShippingOptionShippingRateData(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`. """ type: NotRequired[Literal["fixed_amount"]] """ diff --git a/stripe/params/climate/_order_create_params.py b/stripe/params/climate/_order_create_params.py index 45ca42955..7f0785799 100644 --- a/stripe/params/climate/_order_create_params.py +++ b/stripe/params/climate/_order_create_params.py @@ -24,7 +24,7 @@ class OrderCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ metric_tons: NotRequired[str] """ diff --git a/stripe/params/climate/_order_modify_params.py b/stripe/params/climate/_order_modify_params.py index af4371473..42b7b43a5 100644 --- a/stripe/params/climate/_order_modify_params.py +++ b/stripe/params/climate/_order_modify_params.py @@ -16,7 +16,7 @@ class OrderModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/climate/_order_update_params.py b/stripe/params/climate/_order_update_params.py index 05a947f03..5776507cf 100644 --- a/stripe/params/climate/_order_update_params.py +++ b/stripe/params/climate/_order_update_params.py @@ -15,7 +15,7 @@ class OrderUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/financial_connections/_account_list_params.py b/stripe/params/financial_connections/_account_list_params.py index 897d4e10d..fba9b746c 100644 --- a/stripe/params/financial_connections/_account_list_params.py +++ b/stripe/params/financial_connections/_account_list_params.py @@ -35,13 +35,13 @@ class AccountListParams(RequestOptions): class AccountListParamsAccountHolder(TypedDict): account: NotRequired[str] """ - The ID of the Stripe account whose accounts will be retrieved. + The ID of the Stripe account whose accounts you will retrieve. """ customer: NotRequired[str] """ - The ID of the Stripe customer whose accounts will be retrieved. + The ID of the Stripe customer whose accounts you will retrieve. """ customer_account: NotRequired[str] """ - The Account ID of the Stripe customer whose accounts will be retrieved. + The ID of the Account representing a customer whose accounts you will retrieve. """ diff --git a/stripe/params/financial_connections/_session_create_params.py b/stripe/params/financial_connections/_session_create_params.py index 320a267cf..ebb694b62 100644 --- a/stripe/params/financial_connections/_session_create_params.py +++ b/stripe/params/financial_connections/_session_create_params.py @@ -53,15 +53,15 @@ class SessionCreateParams(RequestOptions): class SessionCreateParamsAccountHolder(TypedDict): account: NotRequired[str] """ - The ID of the Stripe account whose accounts will be retrieved. Should only be present if `type` is `account`. + The ID of the Stripe account whose accounts you will retrieve. Only available when `type` is `account`. """ customer: NotRequired[str] """ - The ID of the Stripe customer whose accounts will be retrieved. Should only be present if `type` is `customer`. + The ID of the Stripe customer whose accounts you will retrieve. Only available when `type` is `customer`. """ customer_account: NotRequired[str] """ - The ID of the Stripe customer Account whose accounts will be retrieved. Should only be present if `type` is `customer`. + The ID of Account representing a customer whose accounts you will retrieve. Only available when `type` is `customer`. """ type: Literal["account", "customer"] """ diff --git a/stripe/params/forwarding/_request_create_params.py b/stripe/params/forwarding/_request_create_params.py index e35ebfc51..d507e97ca 100644 --- a/stripe/params/forwarding/_request_create_params.py +++ b/stripe/params/forwarding/_request_create_params.py @@ -12,7 +12,7 @@ class RequestCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_method: str """ diff --git a/stripe/params/identity/_verification_session_create_params.py b/stripe/params/identity/_verification_session_create_params.py index 72a7e8568..09d7f81be 100644 --- a/stripe/params/identity/_verification_session_create_params.py +++ b/stripe/params/identity/_verification_session_create_params.py @@ -16,7 +16,7 @@ class VerificationSessionCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ options: NotRequired["VerificationSessionCreateParamsOptions"] """ @@ -34,7 +34,7 @@ class VerificationSessionCreateParams(RequestOptions): """ related_customer_account: NotRequired[str] """ - Token referencing a Customer Account resource. + The ID of the Account representing a customer. """ related_person: NotRequired["VerificationSessionCreateParamsRelatedPerson"] """ @@ -46,7 +46,7 @@ class VerificationSessionCreateParams(RequestOptions): """ type: NotRequired[Literal["document", "id_number"]] """ - The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. You must provide a `type` if not passing `verification_flow`. + The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed. You must provide a `type` if not passing `verification_flow`. """ verification_flow: NotRequired[str] """ @@ -59,7 +59,7 @@ class VerificationSessionCreateParamsOptions(TypedDict): "Literal['']|VerificationSessionCreateParamsOptionsDocument" ] """ - Options that apply to the [document check](https://stripe.com/docs/identity/verification-checks?type=document). + Options that apply to the [document check](https://docs.stripe.com/identity/verification-checks?type=document). """ @@ -72,7 +72,7 @@ class VerificationSessionCreateParamsOptionsDocument(TypedDict): """ require_id_number: NotRequired[bool] """ - Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. + Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. """ require_live_capture: NotRequired[bool] """ @@ -80,7 +80,7 @@ class VerificationSessionCreateParamsOptionsDocument(TypedDict): """ require_matching_selfie: NotRequired[bool] """ - Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie). + Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie). """ diff --git a/stripe/params/identity/_verification_session_list_params.py b/stripe/params/identity/_verification_session_list_params.py index fd67dec42..3ca5ee030 100644 --- a/stripe/params/identity/_verification_session_list_params.py +++ b/stripe/params/identity/_verification_session_list_params.py @@ -27,7 +27,13 @@ class VerificationSessionListParams(RequestOptions): A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. """ related_customer: NotRequired[str] + """ + Customer ID + """ related_customer_account: NotRequired[str] + """ + The ID of the Account representing a customer. + """ starting_after: NotRequired[str] """ A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. @@ -36,7 +42,7 @@ class VerificationSessionListParams(RequestOptions): Literal["canceled", "processing", "requires_input", "verified"] ] """ - Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work). + Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://docs.stripe.com/identity/how-sessions-work). """ diff --git a/stripe/params/identity/_verification_session_modify_params.py b/stripe/params/identity/_verification_session_modify_params.py index ec4fb2c11..e306a8dd7 100644 --- a/stripe/params/identity/_verification_session_modify_params.py +++ b/stripe/params/identity/_verification_session_modify_params.py @@ -12,7 +12,7 @@ class VerificationSessionModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ options: NotRequired["VerificationSessionModifyParamsOptions"] """ @@ -26,7 +26,7 @@ class VerificationSessionModifyParams(RequestOptions): """ type: NotRequired[Literal["document", "id_number"]] """ - The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. + The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed. """ @@ -35,7 +35,7 @@ class VerificationSessionModifyParamsOptions(TypedDict): "Literal['']|VerificationSessionModifyParamsOptionsDocument" ] """ - Options that apply to the [document check](https://stripe.com/docs/identity/verification-checks?type=document). + Options that apply to the [document check](https://docs.stripe.com/identity/verification-checks?type=document). """ @@ -48,7 +48,7 @@ class VerificationSessionModifyParamsOptionsDocument(TypedDict): """ require_id_number: NotRequired[bool] """ - Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. + Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. """ require_live_capture: NotRequired[bool] """ @@ -56,7 +56,7 @@ class VerificationSessionModifyParamsOptionsDocument(TypedDict): """ require_matching_selfie: NotRequired[bool] """ - Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie). + Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie). """ diff --git a/stripe/params/identity/_verification_session_update_params.py b/stripe/params/identity/_verification_session_update_params.py index 6fe2b7271..67b8788c9 100644 --- a/stripe/params/identity/_verification_session_update_params.py +++ b/stripe/params/identity/_verification_session_update_params.py @@ -11,7 +11,7 @@ class VerificationSessionUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ options: NotRequired["VerificationSessionUpdateParamsOptions"] """ @@ -25,7 +25,7 @@ class VerificationSessionUpdateParams(TypedDict): """ type: NotRequired[Literal["document", "id_number"]] """ - The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed. + The type of [verification check](https://docs.stripe.com/identity/verification-checks) to be performed. """ @@ -34,7 +34,7 @@ class VerificationSessionUpdateParamsOptions(TypedDict): "Literal['']|VerificationSessionUpdateParamsOptionsDocument" ] """ - Options that apply to the [document check](https://stripe.com/docs/identity/verification-checks?type=document). + Options that apply to the [document check](https://docs.stripe.com/identity/verification-checks?type=document). """ @@ -47,7 +47,7 @@ class VerificationSessionUpdateParamsOptionsDocument(TypedDict): """ require_id_number: NotRequired[bool] """ - Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. + Collect an ID number and perform an [ID number check](https://docs.stripe.com/identity/verification-checks?type=id-number) with the document's extracted name and date of birth. """ require_live_capture: NotRequired[bool] """ @@ -55,7 +55,7 @@ class VerificationSessionUpdateParamsOptionsDocument(TypedDict): """ require_matching_selfie: NotRequired[bool] """ - Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://stripe.com/docs/identity/selfie). + Capture a face image and perform a [selfie check](https://docs.stripe.com/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user's face. [Learn more](https://docs.stripe.com/identity/selfie). """ diff --git a/stripe/params/issuing/_authorization_approve_params.py b/stripe/params/issuing/_authorization_approve_params.py index f21d353f1..0f7655163 100644 --- a/stripe/params/issuing/_authorization_approve_params.py +++ b/stripe/params/issuing/_authorization_approve_params.py @@ -8,7 +8,7 @@ class AuthorizationApproveParams(RequestOptions): amount: NotRequired[int] """ - If the authorization's `pending_request.is_amount_controllable` property is `true`, you may provide this value to control how much to hold for the authorization. Must be positive (use [`decline`](https://stripe.com/docs/api/issuing/authorizations/decline) to decline an authorization request). + If the authorization's `pending_request.is_amount_controllable` property is `true`, you may provide this value to control how much to hold for the authorization. Must be positive (use [`decline`](https://docs.stripe.com/api/issuing/authorizations/decline) to decline an authorization request). """ expand: NotRequired[List[str]] """ @@ -16,5 +16,5 @@ class AuthorizationApproveParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_authorization_capture_params.py b/stripe/params/issuing/_authorization_capture_params.py index 79049f779..ceb709ffc 100644 --- a/stripe/params/issuing/_authorization_capture_params.py +++ b/stripe/params/issuing/_authorization_capture_params.py @@ -8,7 +8,7 @@ class AuthorizationCaptureParams(RequestOptions): capture_amount: NotRequired[int] """ - The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ close_authorization: NotRequired[bool] """ diff --git a/stripe/params/issuing/_authorization_create_params.py b/stripe/params/issuing/_authorization_create_params.py index 606a10552..c20825cd5 100644 --- a/stripe/params/issuing/_authorization_create_params.py +++ b/stripe/params/issuing/_authorization_create_params.py @@ -8,11 +8,11 @@ class AuthorizationCreateParams(RequestOptions): amount: NotRequired[int] """ - The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ amount_details: NotRequired["AuthorizationCreateParamsAmountDetails"] """ - Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ authorization_method: NotRequired[ Literal["chip", "contactless", "keyed_in", "online", "swipe"] @@ -48,11 +48,11 @@ class AuthorizationCreateParams(RequestOptions): """ is_amount_controllable: NotRequired[bool] """ - If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. + If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. """ merchant_amount: NotRequired[int] """ - The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ merchant_currency: NotRequired[str] """ @@ -527,7 +527,7 @@ class AuthorizationCreateParamsMerchantData(TypedDict): ] ] """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ city: NotRequired[str] """ diff --git a/stripe/params/issuing/_authorization_decline_params.py b/stripe/params/issuing/_authorization_decline_params.py index d746a8a1c..39e8881fe 100644 --- a/stripe/params/issuing/_authorization_decline_params.py +++ b/stripe/params/issuing/_authorization_decline_params.py @@ -12,5 +12,5 @@ class AuthorizationDeclineParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_authorization_finalize_amount_params.py b/stripe/params/issuing/_authorization_finalize_amount_params.py index a15604fa9..64b9053a9 100644 --- a/stripe/params/issuing/_authorization_finalize_amount_params.py +++ b/stripe/params/issuing/_authorization_finalize_amount_params.py @@ -12,7 +12,7 @@ class AuthorizationFinalizeAmountParams(RequestOptions): """ final_amount: int """ - The final authorization amount that will be captured by the merchant. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The final authorization amount that will be captured by the merchant. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ fleet: NotRequired["AuthorizationFinalizeAmountParamsFleet"] """ diff --git a/stripe/params/issuing/_authorization_increment_params.py b/stripe/params/issuing/_authorization_increment_params.py index 30fe7ede7..176e543f8 100644 --- a/stripe/params/issuing/_authorization_increment_params.py +++ b/stripe/params/issuing/_authorization_increment_params.py @@ -12,9 +12,9 @@ class AuthorizationIncrementParams(RequestOptions): """ increment_amount: int """ - The amount to increment the authorization by. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount to increment the authorization by. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ is_amount_controllable: NotRequired[bool] """ - If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. + If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. """ diff --git a/stripe/params/issuing/_authorization_modify_params.py b/stripe/params/issuing/_authorization_modify_params.py index af0629823..070ecb9a5 100644 --- a/stripe/params/issuing/_authorization_modify_params.py +++ b/stripe/params/issuing/_authorization_modify_params.py @@ -12,5 +12,5 @@ class AuthorizationModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_authorization_reverse_params.py b/stripe/params/issuing/_authorization_reverse_params.py index 5788d84fd..7ca44d5f5 100644 --- a/stripe/params/issuing/_authorization_reverse_params.py +++ b/stripe/params/issuing/_authorization_reverse_params.py @@ -12,5 +12,5 @@ class AuthorizationReverseParams(RequestOptions): """ reverse_amount: NotRequired[int] """ - The amount to reverse from the authorization. If not provided, the full amount of the authorization will be reversed. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount to reverse from the authorization. If not provided, the full amount of the authorization will be reversed. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ diff --git a/stripe/params/issuing/_authorization_update_params.py b/stripe/params/issuing/_authorization_update_params.py index 6734372bf..09d270108 100644 --- a/stripe/params/issuing/_authorization_update_params.py +++ b/stripe/params/issuing/_authorization_update_params.py @@ -11,5 +11,5 @@ class AuthorizationUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_card_create_params.py b/stripe/params/issuing/_card_create_params.py index 6b5059c9a..ed8b0c5b1 100644 --- a/stripe/params/issuing/_card_create_params.py +++ b/stripe/params/issuing/_card_create_params.py @@ -8,7 +8,7 @@ class CardCreateParams(RequestOptions): cardholder: NotRequired[str] """ - The [Cardholder](https://stripe.com/docs/api#issuing_cardholder_object) object with which the card will be associated. + The [Cardholder](https://docs.stripe.com/api#issuing_cardholder_object) object with which the card will be associated. """ currency: str """ @@ -32,7 +32,7 @@ class CardCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ personalization_design: NotRequired[str] """ @@ -62,7 +62,7 @@ class CardCreateParams(RequestOptions): """ spending_controls: NotRequired["CardCreateParamsSpendingControls"] """ - Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. + Rules that control spending for this card. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details. """ status: NotRequired[Literal["active", "inactive"]] """ @@ -141,7 +141,7 @@ class CardCreateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -464,7 +464,7 @@ class CardCreateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: NotRequired[List[str]] """ @@ -772,7 +772,7 @@ class CardCreateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: NotRequired[List[str]] """ @@ -1093,7 +1093,7 @@ class CardCreateParamsSpendingControlsSpendingLimit(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", "daily", "monthly", "per_authorization", "weekly", "yearly" diff --git a/stripe/params/issuing/_card_modify_params.py b/stripe/params/issuing/_card_modify_params.py index f635f349d..0cd14eaab 100644 --- a/stripe/params/issuing/_card_modify_params.py +++ b/stripe/params/issuing/_card_modify_params.py @@ -16,7 +16,7 @@ class CardModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ personalization_design: NotRequired[str] pin: NotRequired["CardModifyParamsPin"] @@ -29,7 +29,7 @@ class CardModifyParams(RequestOptions): """ spending_controls: NotRequired["CardModifyParamsSpendingControls"] """ - Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. + Rules that control spending for this card. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details. """ status: NotRequired[Literal["active", "canceled", "inactive"]] """ @@ -104,7 +104,7 @@ class CardModifyParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -427,7 +427,7 @@ class CardModifyParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: NotRequired[List[str]] """ @@ -735,7 +735,7 @@ class CardModifyParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: NotRequired[List[str]] """ @@ -1056,7 +1056,7 @@ class CardModifyParamsSpendingControlsSpendingLimit(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", "daily", "monthly", "per_authorization", "weekly", "yearly" diff --git a/stripe/params/issuing/_card_update_params.py b/stripe/params/issuing/_card_update_params.py index 74a6a9d98..9bb5bef56 100644 --- a/stripe/params/issuing/_card_update_params.py +++ b/stripe/params/issuing/_card_update_params.py @@ -15,7 +15,7 @@ class CardUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ personalization_design: NotRequired[str] pin: NotRequired["CardUpdateParamsPin"] @@ -28,7 +28,7 @@ class CardUpdateParams(TypedDict): """ spending_controls: NotRequired["CardUpdateParamsSpendingControls"] """ - Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. + Rules that control spending for this card. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details. """ status: NotRequired[Literal["active", "canceled", "inactive"]] """ @@ -103,7 +103,7 @@ class CardUpdateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -426,7 +426,7 @@ class CardUpdateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: NotRequired[List[str]] """ @@ -734,7 +734,7 @@ class CardUpdateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: NotRequired[List[str]] """ @@ -1055,7 +1055,7 @@ class CardUpdateParamsSpendingControlsSpendingLimit(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", "daily", "monthly", "per_authorization", "weekly", "yearly" diff --git a/stripe/params/issuing/_cardholder_create_params.py b/stripe/params/issuing/_cardholder_create_params.py index d4a022525..c115aaf9f 100644 --- a/stripe/params/issuing/_cardholder_create_params.py +++ b/stripe/params/issuing/_cardholder_create_params.py @@ -28,7 +28,7 @@ class CardholderCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ @@ -37,16 +37,16 @@ class CardholderCreateParams(RequestOptions): phone_number: NotRequired[str] """ The cardholder's phone number. This will be transformed to [E.164](https://en.wikipedia.org/wiki/E.164) if it is not provided in that format already. This is required for all cardholders who will be creating EU cards. - While phone number is optional if the cardholder will not be creating EU cards, note that this cardholder will not be eligible for 3DS without a phone number. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure#when-is-3d-secure-applied) for more details. + While phone number is optional if the cardholder will not be creating EU cards, note that this cardholder will not be eligible for 3DS without a phone number. See the [3D Secure documentation](https://docs.stripe.com/issuing/3d-secure#when-is-3d-secure-applied) for more details. """ preferred_locales: NotRequired[List[Literal["de", "en", "es", "fr", "it"]]] """ The cardholder's preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`. - This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder. + This changes the language of the [3D Secure flow](https://docs.stripe.com/issuing/3d-secure) and one-time password messages sent to the cardholder. """ spending_controls: NotRequired["CardholderCreateParamsSpendingControls"] """ - Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. + Rules that control spending across this cardholder's cards. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details. """ status: NotRequired[Literal["active", "inactive"]] """ @@ -54,7 +54,7 @@ class CardholderCreateParams(RequestOptions): """ type: NotRequired[Literal["company", "individual"]] """ - One of `individual` or `company`. See [Choose a cardholder type](https://stripe.com/docs/issuing/other/choose-cardholder) for more details. + One of `individual` or `company`. See [Choose a cardholder type](https://docs.stripe.com/issuing/other/choose-cardholder) for more details. """ @@ -88,7 +88,7 @@ class CardholderCreateParamsBillingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -175,11 +175,11 @@ class CardholderCreateParamsIndividualVerification(TypedDict): class CardholderCreateParamsIndividualVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ @@ -486,7 +486,7 @@ class CardholderCreateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: NotRequired[List[str]] """ @@ -794,7 +794,7 @@ class CardholderCreateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: NotRequired[List[str]] """ @@ -1119,7 +1119,7 @@ class CardholderCreateParamsSpendingControlsSpendingLimit(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", "daily", "monthly", "per_authorization", "weekly", "yearly" diff --git a/stripe/params/issuing/_cardholder_modify_params.py b/stripe/params/issuing/_cardholder_modify_params.py index 74bfc8406..d3b0361bb 100644 --- a/stripe/params/issuing/_cardholder_modify_params.py +++ b/stripe/params/issuing/_cardholder_modify_params.py @@ -28,20 +28,20 @@ class CardholderModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone_number: NotRequired[str] """ - The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure) for more details. + The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://docs.stripe.com/issuing/3d-secure) for more details. """ preferred_locales: NotRequired[List[Literal["de", "en", "es", "fr", "it"]]] """ The cardholder's preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`. - This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder. + This changes the language of the [3D Secure flow](https://docs.stripe.com/issuing/3d-secure) and one-time password messages sent to the cardholder. """ spending_controls: NotRequired["CardholderModifyParamsSpendingControls"] """ - Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. + Rules that control spending across this cardholder's cards. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details. """ status: NotRequired[Literal["active", "inactive"]] """ @@ -79,7 +79,7 @@ class CardholderModifyParamsBillingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -166,11 +166,11 @@ class CardholderModifyParamsIndividualVerification(TypedDict): class CardholderModifyParamsIndividualVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ @@ -477,7 +477,7 @@ class CardholderModifyParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: NotRequired[List[str]] """ @@ -785,7 +785,7 @@ class CardholderModifyParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: NotRequired[List[str]] """ @@ -1110,7 +1110,7 @@ class CardholderModifyParamsSpendingControlsSpendingLimit(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", "daily", "monthly", "per_authorization", "weekly", "yearly" diff --git a/stripe/params/issuing/_cardholder_update_params.py b/stripe/params/issuing/_cardholder_update_params.py index ffc9c2898..9e1d6ceae 100644 --- a/stripe/params/issuing/_cardholder_update_params.py +++ b/stripe/params/issuing/_cardholder_update_params.py @@ -27,20 +27,20 @@ class CardholderUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone_number: NotRequired[str] """ - The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure) for more details. + The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://docs.stripe.com/issuing/3d-secure) for more details. """ preferred_locales: NotRequired[List[Literal["de", "en", "es", "fr", "it"]]] """ The cardholder's preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`. - This changes the language of the [3D Secure flow](https://stripe.com/docs/issuing/3d-secure) and one-time password messages sent to the cardholder. + This changes the language of the [3D Secure flow](https://docs.stripe.com/issuing/3d-secure) and one-time password messages sent to the cardholder. """ spending_controls: NotRequired["CardholderUpdateParamsSpendingControls"] """ - Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details. + Rules that control spending across this cardholder's cards. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details. """ status: NotRequired[Literal["active", "inactive"]] """ @@ -78,7 +78,7 @@ class CardholderUpdateParamsBillingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -165,11 +165,11 @@ class CardholderUpdateParamsIndividualVerification(TypedDict): class CardholderUpdateParamsIndividualVerificationDocument(TypedDict): back: NotRequired[str] """ - The back of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The back of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ front: NotRequired[str] """ - The front of an ID returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `identity_document`. + The front of an ID returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`. """ @@ -476,7 +476,7 @@ class CardholderUpdateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`. """ allowed_merchant_countries: NotRequired[List[str]] """ @@ -784,7 +784,7 @@ class CardholderUpdateParamsSpendingControls(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`. """ blocked_merchant_countries: NotRequired[List[str]] """ @@ -1109,7 +1109,7 @@ class CardholderUpdateParamsSpendingControlsSpendingLimit(TypedDict): ] ] """ - Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. + Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories. """ interval: Literal[ "all_time", "daily", "monthly", "per_authorization", "weekly", "yearly" diff --git a/stripe/params/issuing/_credit_underwriting_record_correct_params.py b/stripe/params/issuing/_credit_underwriting_record_correct_params.py index 4bc3447c8..d7b2c7a51 100644 --- a/stripe/params/issuing/_credit_underwriting_record_correct_params.py +++ b/stripe/params/issuing/_credit_underwriting_record_correct_params.py @@ -30,11 +30,11 @@ class CreditUnderwritingRecordCorrectParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ regulatory_reporting_file: NotRequired[str] """ - File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://stripe.com/docs/issuing/credit/report-required-regulatory-data-for-credit-decisions). Optional if previously provided and no changes are needed. + File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://docs.stripe.com/issuing/credit/report-required-regulatory-data-for-credit-decisions). Optional if previously provided and no changes are needed. """ underwriting_exception: NotRequired[ "CreditUnderwritingRecordCorrectParamsUnderwritingException" @@ -83,7 +83,7 @@ class CreditUnderwritingRecordCorrectParamsDecision(TypedDict): "CreditUnderwritingRecordCorrectParamsDecisionCreditLimitApproved" ] """ - Details about the credit limit approved. An approved credit limit is required before you can set a `credit_limit_amount` in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy/) + Details about the credit limit approved. An approved credit limit is required before you can set a `credit_limit_amount` in the [CreditPolicy API](https://docs.stripe.com/api/issuing/credit_policy/) """ credit_limit_decreased: NotRequired[ "CreditUnderwritingRecordCorrectParamsDecisionCreditLimitDecreased" @@ -195,7 +195,7 @@ class CreditUnderwritingRecordCorrectParamsDecisionCreditLimitApproved( ): amount: int """ - The credit approved, in the currency of the account and [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The credit approved, in the currency of the account and [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ currency: NotRequired[str] """ @@ -208,7 +208,7 @@ class CreditUnderwritingRecordCorrectParamsDecisionCreditLimitDecreased( ): amount: int """ - The credit approved, in the currency of the account and [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The credit approved, in the currency of the account and [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ currency: NotRequired[str] """ diff --git a/stripe/params/issuing/_credit_underwriting_record_create_from_application_params.py b/stripe/params/issuing/_credit_underwriting_record_create_from_application_params.py index 1ebee048d..f6f1672e5 100644 --- a/stripe/params/issuing/_credit_underwriting_record_create_from_application_params.py +++ b/stripe/params/issuing/_credit_underwriting_record_create_from_application_params.py @@ -24,7 +24,7 @@ class CreditUnderwritingRecordCreateFromApplicationParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_credit_underwriting_record_create_from_proactive_review_params.py b/stripe/params/issuing/_credit_underwriting_record_create_from_proactive_review_params.py index 5326c8b44..39d10f711 100644 --- a/stripe/params/issuing/_credit_underwriting_record_create_from_proactive_review_params.py +++ b/stripe/params/issuing/_credit_underwriting_record_create_from_proactive_review_params.py @@ -26,11 +26,11 @@ class CreditUnderwritingRecordCreateFromProactiveReviewParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ regulatory_reporting_file: NotRequired[str] """ - File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://stripe.com/docs/issuing/credit/report-required-regulatory-data-for-credit-decisions). + File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://docs.stripe.com/issuing/credit/report-required-regulatory-data-for-credit-decisions). """ underwriting_exception: NotRequired[ "CreditUnderwritingRecordCreateFromProactiveReviewParamsUnderwritingException" @@ -60,7 +60,7 @@ class CreditUnderwritingRecordCreateFromProactiveReviewParamsDecision( "CreditUnderwritingRecordCreateFromProactiveReviewParamsDecisionCreditLimitApproved" ] """ - Details about the credit limit approved. An approved credit limit is required before you can set a `credit_limit_amount` in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy/) + Details about the credit limit approved. An approved credit limit is required before you can set a `credit_limit_amount` in the [CreditPolicy API](https://docs.stripe.com/api/issuing/credit_policy/) """ credit_limit_decreased: NotRequired[ "CreditUnderwritingRecordCreateFromProactiveReviewParamsDecisionCreditLimitDecreased" @@ -90,7 +90,7 @@ class CreditUnderwritingRecordCreateFromProactiveReviewParamsDecisionCreditLimit ): amount: int """ - The credit approved, in the currency of the account and [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The credit approved, in the currency of the account and [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ currency: NotRequired[str] """ @@ -103,7 +103,7 @@ class CreditUnderwritingRecordCreateFromProactiveReviewParamsDecisionCreditLimit ): amount: int """ - The credit approved, in the currency of the account and [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The credit approved, in the currency of the account and [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ currency: NotRequired[str] """ diff --git a/stripe/params/issuing/_credit_underwriting_record_report_decision_params.py b/stripe/params/issuing/_credit_underwriting_record_report_decision_params.py index b23139b3c..cb1fbbfcb 100644 --- a/stripe/params/issuing/_credit_underwriting_record_report_decision_params.py +++ b/stripe/params/issuing/_credit_underwriting_record_report_decision_params.py @@ -20,11 +20,11 @@ class CreditUnderwritingRecordReportDecisionParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ regulatory_reporting_file: NotRequired[str] """ - File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://stripe.com/docs/issuing/credit/report-required-regulatory-data-for-credit-decisions). + File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://docs.stripe.com/issuing/credit/report-required-regulatory-data-for-credit-decisions). """ underwriting_exception: NotRequired[ "CreditUnderwritingRecordReportDecisionParamsUnderwritingException" @@ -45,7 +45,7 @@ class CreditUnderwritingRecordReportDecisionParamsDecision(TypedDict): "CreditUnderwritingRecordReportDecisionParamsDecisionCreditLimitApproved" ] """ - Details about the credit limit approved. An approved credit limit is required before you can set a `credit_limit_amount` in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy/) + Details about the credit limit approved. An approved credit limit is required before you can set a `credit_limit_amount` in the [CreditPolicy API](https://docs.stripe.com/api/issuing/credit_policy/) """ type: Literal[ "additional_information_requested", @@ -142,7 +142,7 @@ class CreditUnderwritingRecordReportDecisionParamsDecisionCreditLimitApproved( ): amount: int """ - The credit approved, in the currency of the account and [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The credit approved, in the currency of the account and [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ currency: NotRequired[str] """ diff --git a/stripe/params/issuing/_dispute_create_params.py b/stripe/params/issuing/_dispute_create_params.py index 4fdc92093..c87fa31ed 100644 --- a/stripe/params/issuing/_dispute_create_params.py +++ b/stripe/params/issuing/_dispute_create_params.py @@ -8,7 +8,7 @@ class DisputeCreateParams(RequestOptions): amount: NotRequired[int] """ - The dispute amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If not set, defaults to the full transaction amount. + The dispute amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If not set, defaults to the full transaction amount. """ evidence: NotRequired["DisputeCreateParamsEvidence"] """ @@ -20,7 +20,7 @@ class DisputeCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ transaction: NotRequired[str] """ diff --git a/stripe/params/issuing/_dispute_modify_params.py b/stripe/params/issuing/_dispute_modify_params.py index 2843be9cd..18d947990 100644 --- a/stripe/params/issuing/_dispute_modify_params.py +++ b/stripe/params/issuing/_dispute_modify_params.py @@ -8,7 +8,7 @@ class DisputeModifyParams(RequestOptions): amount: NotRequired[int] """ - The dispute amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The dispute amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ evidence: NotRequired["DisputeModifyParamsEvidence"] """ @@ -20,7 +20,7 @@ class DisputeModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_dispute_submit_params.py b/stripe/params/issuing/_dispute_submit_params.py index 3f504f2dc..b0484081e 100644 --- a/stripe/params/issuing/_dispute_submit_params.py +++ b/stripe/params/issuing/_dispute_submit_params.py @@ -12,5 +12,5 @@ class DisputeSubmitParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_dispute_update_params.py b/stripe/params/issuing/_dispute_update_params.py index 3a7d33188..b9e51d546 100644 --- a/stripe/params/issuing/_dispute_update_params.py +++ b/stripe/params/issuing/_dispute_update_params.py @@ -7,7 +7,7 @@ class DisputeUpdateParams(TypedDict): amount: NotRequired[int] """ - The dispute amount in the card's currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The dispute amount in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ evidence: NotRequired["DisputeUpdateParamsEvidence"] """ @@ -19,7 +19,7 @@ class DisputeUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_personalization_design_create_params.py b/stripe/params/issuing/_personalization_design_create_params.py index 39fd71913..235c54aad 100644 --- a/stripe/params/issuing/_personalization_design_create_params.py +++ b/stripe/params/issuing/_personalization_design_create_params.py @@ -24,7 +24,7 @@ class PersonalizationDesignCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/issuing/_personalization_design_modify_params.py b/stripe/params/issuing/_personalization_design_modify_params.py index 1c57a9dfc..e2307719e 100644 --- a/stripe/params/issuing/_personalization_design_modify_params.py +++ b/stripe/params/issuing/_personalization_design_modify_params.py @@ -26,7 +26,7 @@ class PersonalizationDesignModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired["Literal['']|str"] """ diff --git a/stripe/params/issuing/_personalization_design_update_params.py b/stripe/params/issuing/_personalization_design_update_params.py index d5f3f57b5..6b18ec7b2 100644 --- a/stripe/params/issuing/_personalization_design_update_params.py +++ b/stripe/params/issuing/_personalization_design_update_params.py @@ -25,7 +25,7 @@ class PersonalizationDesignUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired["Literal['']|str"] """ diff --git a/stripe/params/issuing/_transaction_create_force_capture_params.py b/stripe/params/issuing/_transaction_create_force_capture_params.py index d9f6709a9..c71bcfca7 100644 --- a/stripe/params/issuing/_transaction_create_force_capture_params.py +++ b/stripe/params/issuing/_transaction_create_force_capture_params.py @@ -8,7 +8,7 @@ class TransactionCreateForceCaptureParams(RequestOptions): amount: int """ - The total amount to attempt to capture. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to capture. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ card: str """ @@ -336,7 +336,7 @@ class TransactionCreateForceCaptureParamsMerchantData(TypedDict): ] ] """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ city: NotRequired[str] """ diff --git a/stripe/params/issuing/_transaction_create_unlinked_refund_params.py b/stripe/params/issuing/_transaction_create_unlinked_refund_params.py index 8a0d378f9..d8d6ef226 100644 --- a/stripe/params/issuing/_transaction_create_unlinked_refund_params.py +++ b/stripe/params/issuing/_transaction_create_unlinked_refund_params.py @@ -8,7 +8,7 @@ class TransactionCreateUnlinkedRefundParams(RequestOptions): amount: int """ - The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ card: str """ @@ -336,7 +336,7 @@ class TransactionCreateUnlinkedRefundParamsMerchantData(TypedDict): ] ] """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ city: NotRequired[str] """ diff --git a/stripe/params/issuing/_transaction_modify_params.py b/stripe/params/issuing/_transaction_modify_params.py index ba255b790..bfc9305fb 100644 --- a/stripe/params/issuing/_transaction_modify_params.py +++ b/stripe/params/issuing/_transaction_modify_params.py @@ -12,5 +12,5 @@ class TransactionModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/issuing/_transaction_refund_params.py b/stripe/params/issuing/_transaction_refund_params.py index 0953e1baa..135ec6b26 100644 --- a/stripe/params/issuing/_transaction_refund_params.py +++ b/stripe/params/issuing/_transaction_refund_params.py @@ -12,5 +12,5 @@ class TransactionRefundParams(RequestOptions): """ refund_amount: NotRequired[int] """ - The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ diff --git a/stripe/params/issuing/_transaction_update_params.py b/stripe/params/issuing/_transaction_update_params.py index 8cb955c53..bf4fa27c9 100644 --- a/stripe/params/issuing/_transaction_update_params.py +++ b/stripe/params/issuing/_transaction_update_params.py @@ -11,5 +11,5 @@ class TransactionUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/radar/_value_list_create_params.py b/stripe/params/radar/_value_list_create_params.py index 1299e35db..a91570312 100644 --- a/stripe/params/radar/_value_list_create_params.py +++ b/stripe/params/radar/_value_list_create_params.py @@ -33,7 +33,7 @@ class ValueListCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: str """ diff --git a/stripe/params/radar/_value_list_modify_params.py b/stripe/params/radar/_value_list_modify_params.py index 31a60cbc3..f5b55fffc 100644 --- a/stripe/params/radar/_value_list_modify_params.py +++ b/stripe/params/radar/_value_list_modify_params.py @@ -16,7 +16,7 @@ class ValueListModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/radar/_value_list_update_params.py b/stripe/params/radar/_value_list_update_params.py index e8cbd9f18..0cb95a76f 100644 --- a/stripe/params/radar/_value_list_update_params.py +++ b/stripe/params/radar/_value_list_update_params.py @@ -15,7 +15,7 @@ class ValueListUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ name: NotRequired[str] """ diff --git a/stripe/params/reporting/_report_run_create_params.py b/stripe/params/reporting/_report_run_create_params.py index d3f0dabb3..2cbc5af43 100644 --- a/stripe/params/reporting/_report_run_create_params.py +++ b/stripe/params/reporting/_report_run_create_params.py @@ -12,11 +12,11 @@ class ReportRunCreateParams(RequestOptions): """ parameters: NotRequired["ReportRunCreateParamsParameters"] """ - Parameters specifying how the report should be run. Different Report Types have different required and optional parameters, listed in the [API Access to Reports](https://stripe.com/docs/reporting/statements/api) documentation. + Parameters specifying how the report should be run. Different Report Types have different required and optional parameters, listed in the [API Access to Reports](https://docs.stripe.com/reporting/statements/api) documentation. """ report_type: str """ - The ID of the [report type](https://stripe.com/docs/reporting/statements/api#report-types) to run, such as `"balance.summary.1"`. + The ID of the [report type](https://docs.stripe.com/reporting/statements/api#report-types) to run, such as `"balance.summary.1"`. """ diff --git a/stripe/params/reserve/__init__.py b/stripe/params/reserve/__init__.py new file mode 100644 index 000000000..83513fd5e --- /dev/null +++ b/stripe/params/reserve/__init__.py @@ -0,0 +1,54 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from importlib import import_module +from typing_extensions import TYPE_CHECKING + +if TYPE_CHECKING: + from stripe.params.reserve._hold_list_params import ( + HoldListParams as HoldListParams, + ) + from stripe.params.reserve._hold_retrieve_params import ( + HoldRetrieveParams as HoldRetrieveParams, + ) + from stripe.params.reserve._plan_retrieve_params import ( + PlanRetrieveParams as PlanRetrieveParams, + ) + from stripe.params.reserve._release_list_params import ( + ReleaseListParams as ReleaseListParams, + ) + from stripe.params.reserve._release_retrieve_params import ( + ReleaseRetrieveParams as ReleaseRetrieveParams, + ) + +# name -> (import_target, is_submodule) +_import_map = { + "HoldListParams": ("stripe.params.reserve._hold_list_params", False), + "HoldRetrieveParams": ( + "stripe.params.reserve._hold_retrieve_params", + False, + ), + "PlanRetrieveParams": ( + "stripe.params.reserve._plan_retrieve_params", + False, + ), + "ReleaseListParams": ("stripe.params.reserve._release_list_params", False), + "ReleaseRetrieveParams": ( + "stripe.params.reserve._release_retrieve_params", + False, + ), +} +if not TYPE_CHECKING: + + def __getattr__(name): + try: + target, is_submodule = _import_map[name] + module = import_module(target) + if is_submodule: + return module + + return getattr( + module, + name, + ) + except KeyError: + raise AttributeError() diff --git a/stripe/params/reserve/_hold_list_params.py b/stripe/params/reserve/_hold_list_params.py new file mode 100644 index 000000000..b561bc6be --- /dev/null +++ b/stripe/params/reserve/_hold_list_params.py @@ -0,0 +1,45 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._request_options import RequestOptions +from typing import List +from typing_extensions import Literal, NotRequired + + +class HoldListParams(RequestOptions): + currency: NotRequired[str] + """ + Only return ReserveHolds associated with the currency specified by this currency code. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + ending_before: NotRequired[str] + """ + A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. + """ + expand: NotRequired[List[str]] + """ + Specifies which fields in the response should be expanded. + """ + is_releasable: NotRequired[bool] + """ + Only return ReserveHolds that are releasable. + """ + limit: NotRequired[int] + """ + A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. + """ + reason: NotRequired[Literal["charge", "standalone"]] + reserve_plan: NotRequired[str] + """ + Only return ReserveHolds associated with the ReservePlan specified by this ReservePlan ID. + """ + reserve_release: NotRequired[str] + """ + Only return ReserveHolds associated with the ReserveRelease specified by this ReserveRelease ID. + """ + source_charge: NotRequired[str] + """ + Only return ReserveHolds associated with the Charge specified by this source charge ID. + """ + starting_after: NotRequired[str] + """ + A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. + """ diff --git a/stripe/params/reserve/_hold_retrieve_params.py b/stripe/params/reserve/_hold_retrieve_params.py new file mode 100644 index 000000000..114d31a94 --- /dev/null +++ b/stripe/params/reserve/_hold_retrieve_params.py @@ -0,0 +1,12 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._request_options import RequestOptions +from typing import List +from typing_extensions import NotRequired + + +class HoldRetrieveParams(RequestOptions): + expand: NotRequired[List[str]] + """ + Specifies which fields in the response should be expanded. + """ diff --git a/stripe/params/reserve/_plan_retrieve_params.py b/stripe/params/reserve/_plan_retrieve_params.py new file mode 100644 index 000000000..f1d5ea9e1 --- /dev/null +++ b/stripe/params/reserve/_plan_retrieve_params.py @@ -0,0 +1,12 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._request_options import RequestOptions +from typing import List +from typing_extensions import NotRequired + + +class PlanRetrieveParams(RequestOptions): + expand: NotRequired[List[str]] + """ + Specifies which fields in the response should be expanded. + """ diff --git a/stripe/params/reserve/_release_list_params.py b/stripe/params/reserve/_release_list_params.py new file mode 100644 index 000000000..0ddd881c8 --- /dev/null +++ b/stripe/params/reserve/_release_list_params.py @@ -0,0 +1,36 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._request_options import RequestOptions +from typing import List +from typing_extensions import NotRequired + + +class ReleaseListParams(RequestOptions): + currency: NotRequired[str] + """ + Only return ReserveReleases associated with the currency specified by this currency code. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + ending_before: NotRequired[str] + """ + A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list. + """ + expand: NotRequired[List[str]] + """ + Specifies which fields in the response should be expanded. + """ + limit: NotRequired[int] + """ + A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10. + """ + reserve_hold: NotRequired[str] + """ + Only return ReserveReleases associated with the ReserveHold specified by this ReserveHold ID. + """ + reserve_plan: NotRequired[str] + """ + Only return ReserveReleases associated with the ReservePlan specified by this ReservePlan ID. + """ + starting_after: NotRequired[str] + """ + A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list. + """ diff --git a/stripe/params/reserve/_release_retrieve_params.py b/stripe/params/reserve/_release_retrieve_params.py new file mode 100644 index 000000000..79dd61eaf --- /dev/null +++ b/stripe/params/reserve/_release_retrieve_params.py @@ -0,0 +1,12 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._request_options import RequestOptions +from typing import List +from typing_extensions import NotRequired + + +class ReleaseRetrieveParams(RequestOptions): + expand: NotRequired[List[str]] + """ + Specifies which fields in the response should be expanded. + """ diff --git a/stripe/params/tax/_association_find_params.py b/stripe/params/tax/_association_find_params.py index 8da73d00f..8bef40e1e 100644 --- a/stripe/params/tax/_association_find_params.py +++ b/stripe/params/tax/_association_find_params.py @@ -12,5 +12,5 @@ class AssociationFindParams(RequestOptions): """ payment_intent: str """ - Valid [PaymentIntent](https://stripe.com/docs/api/payment_intents/object) id + Valid [PaymentIntent](https://docs.stripe.com/api/payment_intents/object) id """ diff --git a/stripe/params/tax/_calculation_create_params.py b/stripe/params/tax/_calculation_create_params.py index f1815268a..5f6f71166 100644 --- a/stripe/params/tax/_calculation_create_params.py +++ b/stripe/params/tax/_calculation_create_params.py @@ -217,12 +217,12 @@ class CalculationCreateParamsCustomerDetailsTaxId(TypedDict): class CalculationCreateParamsLineItem(TypedDict): amount: int """ - A positive integer representing the line item's total price in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + A positive integer representing the line item's total price in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes are calculated on top of this amount. """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ product: NotRequired[str] """ @@ -234,7 +234,7 @@ class CalculationCreateParamsLineItem(TypedDict): """ reference: NotRequired[str] """ - A custom identifier for this line item, which must be unique across the line items in the calculation. The reference helps identify each line item in exported [tax reports](https://stripe.com/docs/tax/reports). + A custom identifier for this line item, which must be unique across the line items in the calculation. The reference helps identify each line item in exported [tax reports](https://docs.stripe.com/tax/reports). """ tax_behavior: NotRequired[Literal["exclusive", "inclusive"]] """ @@ -242,7 +242,7 @@ class CalculationCreateParamsLineItem(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID to use for this line item. If not provided, we will use the tax code from the provided `product` param. If neither `tax_code` nor `product` is provided, we will use the default tax code from your Tax Settings. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID to use for this line item. If not provided, we will use the tax code from the provided `product` param. If neither `tax_code` nor `product` is provided, we will use the default tax code from your Tax Settings. """ @@ -283,11 +283,11 @@ class CalculationCreateParamsShipFromDetailsAddress(TypedDict): class CalculationCreateParamsShippingCost(TypedDict): amount: NotRequired[int] """ - A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) representing the shipping charge. If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes are calculated on top of this amount. + A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) representing the shipping charge. If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes are calculated on top of this amount. """ shipping_rate: NotRequired[str] """ - If provided, the [shipping rate](https://stripe.com/docs/api/shipping_rates/object)'s `amount`, `tax_code` and `tax_behavior` are used. If you provide a shipping rate, then you cannot pass the `amount`, `tax_code`, or `tax_behavior` parameters. + If provided, the [shipping rate](https://docs.stripe.com/api/shipping_rates/object)'s `amount`, `tax_code` and `tax_behavior` are used. If you provide a shipping rate, then you cannot pass the `amount`, `tax_code`, or `tax_behavior` parameters. """ tax_behavior: NotRequired[Literal["exclusive", "inclusive"]] """ @@ -295,5 +295,5 @@ class CalculationCreateParamsShippingCost(TypedDict): """ tax_code: NotRequired[str] """ - The [tax code](https://stripe.com/docs/tax/tax-categories) used to calculate tax on shipping. If not provided, the default shipping tax code from your [Tax Settings](https://dashboard.stripe.com/settings/tax) is used. + The [tax code](https://docs.stripe.com/tax/tax-categories) used to calculate tax on shipping. If not provided, the default shipping tax code from your [Tax Settings](https://dashboard.stripe.com/settings/tax) is used. """ diff --git a/stripe/params/tax/_settings_modify_params.py b/stripe/params/tax/_settings_modify_params.py index 52f9780f1..29f661810 100644 --- a/stripe/params/tax/_settings_modify_params.py +++ b/stripe/params/tax/_settings_modify_params.py @@ -29,7 +29,7 @@ class SettingsModifyParamsDefaults(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ diff --git a/stripe/params/tax/_settings_update_params.py b/stripe/params/tax/_settings_update_params.py index 1d0bb94a1..af11f83fb 100644 --- a/stripe/params/tax/_settings_update_params.py +++ b/stripe/params/tax/_settings_update_params.py @@ -28,7 +28,7 @@ class SettingsUpdateParamsDefaults(TypedDict): """ tax_code: NotRequired[str] """ - A [tax code](https://stripe.com/docs/tax/tax-categories) ID. + A [tax code](https://docs.stripe.com/tax/tax-categories) ID. """ diff --git a/stripe/params/tax/_transaction_create_from_calculation_params.py b/stripe/params/tax/_transaction_create_from_calculation_params.py index 233bb0f08..1600113d3 100644 --- a/stripe/params/tax/_transaction_create_from_calculation_params.py +++ b/stripe/params/tax/_transaction_create_from_calculation_params.py @@ -16,7 +16,7 @@ class TransactionCreateFromCalculationParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ posted_at: NotRequired[int] """ diff --git a/stripe/params/tax/_transaction_create_reversal_params.py b/stripe/params/tax/_transaction_create_reversal_params.py index a86a4b2cd..48764a84a 100644 --- a/stripe/params/tax/_transaction_create_reversal_params.py +++ b/stripe/params/tax/_transaction_create_reversal_params.py @@ -12,7 +12,7 @@ class TransactionCreateReversalParams(RequestOptions): """ flat_amount: NotRequired[int] """ - A flat amount to reverse across the entire transaction, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. This value represents the total amount to refund from the transaction, including taxes. + A flat amount to reverse across the entire transaction, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative. This value represents the total amount to refund from the transaction, including taxes. """ line_items: NotRequired[List["TransactionCreateReversalParamsLineItem"]] """ @@ -20,7 +20,7 @@ class TransactionCreateReversalParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mode: Literal["full", "partial"] """ @@ -32,7 +32,7 @@ class TransactionCreateReversalParams(RequestOptions): """ reference: str """ - A custom identifier for this reversal, such as `myOrder_123-refund_1`, which must be unique across all transactions. The reference helps identify this reversal transaction in exported [tax reports](https://stripe.com/docs/tax/reports). + A custom identifier for this reversal, such as `myOrder_123-refund_1`, which must be unique across all transactions. The reference helps identify this reversal transaction in exported [tax reports](https://docs.stripe.com/tax/reports). """ shipping_cost: NotRequired["TransactionCreateReversalParamsShippingCost"] """ @@ -43,15 +43,15 @@ class TransactionCreateReversalParams(RequestOptions): class TransactionCreateReversalParamsLineItem(TypedDict): amount: int """ - The amount to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. + The amount to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative. """ amount_tax: int """ - The amount of tax to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. + The amount of tax to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative. """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ original_line_item: str """ @@ -59,7 +59,7 @@ class TransactionCreateReversalParamsLineItem(TypedDict): """ quantity: NotRequired[int] """ - The quantity reversed. Appears in [tax exports](https://stripe.com/docs/tax/reports), but does not affect the amount of tax reversed. + The quantity reversed. Appears in [tax exports](https://docs.stripe.com/tax/reports), but does not affect the amount of tax reversed. """ reference: str """ @@ -70,9 +70,9 @@ class TransactionCreateReversalParamsLineItem(TypedDict): class TransactionCreateReversalParamsShippingCost(TypedDict): amount: int """ - The amount to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. + The amount to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative. """ amount_tax: int """ - The amount of tax to reverse, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) in negative. + The amount of tax to reverse, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) in negative. """ diff --git a/stripe/params/terminal/_location_create_params.py b/stripe/params/terminal/_location_create_params.py index 72a484005..31ead0dd5 100644 --- a/stripe/params/terminal/_location_create_params.py +++ b/stripe/params/terminal/_location_create_params.py @@ -40,7 +40,7 @@ class LocationCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone: NotRequired[str] """ @@ -71,7 +71,7 @@ class LocationCreateParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/terminal/_location_modify_params.py b/stripe/params/terminal/_location_modify_params.py index f4c76e275..c3777b860 100644 --- a/stripe/params/terminal/_location_modify_params.py +++ b/stripe/params/terminal/_location_modify_params.py @@ -40,7 +40,7 @@ class LocationModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone: NotRequired["Literal['']|str"] """ @@ -71,7 +71,7 @@ class LocationModifyParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/terminal/_location_update_params.py b/stripe/params/terminal/_location_update_params.py index bd0083cbb..07152294c 100644 --- a/stripe/params/terminal/_location_update_params.py +++ b/stripe/params/terminal/_location_update_params.py @@ -39,7 +39,7 @@ class LocationUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ phone: NotRequired["Literal['']|str"] """ @@ -70,7 +70,7 @@ class LocationUpdateParamsAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/terminal/_reader_collect_inputs_params.py b/stripe/params/terminal/_reader_collect_inputs_params.py index e66b3c064..6c2d41c0b 100644 --- a/stripe/params/terminal/_reader_collect_inputs_params.py +++ b/stripe/params/terminal/_reader_collect_inputs_params.py @@ -16,7 +16,7 @@ class ReaderCollectInputsParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/terminal/_reader_create_params.py b/stripe/params/terminal/_reader_create_params.py index 6e6d550d7..d23e8cde1 100644 --- a/stripe/params/terminal/_reader_create_params.py +++ b/stripe/params/terminal/_reader_create_params.py @@ -20,7 +20,7 @@ class ReaderCreateParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ registration_code: str """ diff --git a/stripe/params/terminal/_reader_modify_params.py b/stripe/params/terminal/_reader_modify_params.py index da2d79c97..cd646f7de 100644 --- a/stripe/params/terminal/_reader_modify_params.py +++ b/stripe/params/terminal/_reader_modify_params.py @@ -16,5 +16,5 @@ class ReaderModifyParams(RequestOptions): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/terminal/_reader_refund_payment_params.py b/stripe/params/terminal/_reader_refund_payment_params.py index 9d1a0297c..885659a7e 100644 --- a/stripe/params/terminal/_reader_refund_payment_params.py +++ b/stripe/params/terminal/_reader_refund_payment_params.py @@ -20,7 +20,7 @@ class ReaderRefundPaymentParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ payment_intent: NotRequired[str] """ diff --git a/stripe/params/terminal/_reader_set_reader_display_params.py b/stripe/params/terminal/_reader_set_reader_display_params.py index 448aa8917..6a2f4b0b8 100644 --- a/stripe/params/terminal/_reader_set_reader_display_params.py +++ b/stripe/params/terminal/_reader_set_reader_display_params.py @@ -31,18 +31,18 @@ class ReaderSetReaderDisplayParamsCart(TypedDict): """ tax: NotRequired[int] """ - The amount of tax in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ total: int """ - Total balance of cart due in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Total balance of cart due in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ class ReaderSetReaderDisplayParamsCartLineItem(TypedDict): amount: int """ - The price of the item in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The price of the item in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ description: str """ diff --git a/stripe/params/terminal/_reader_update_params.py b/stripe/params/terminal/_reader_update_params.py index 25b94dc25..fec59172d 100644 --- a/stripe/params/terminal/_reader_update_params.py +++ b/stripe/params/terminal/_reader_update_params.py @@ -15,5 +15,5 @@ class ReaderUpdateParams(TypedDict): """ metadata: NotRequired["Literal['']|Dict[str, str]"] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ diff --git a/stripe/params/test_helpers/_confirmation_token_create_params.py b/stripe/params/test_helpers/_confirmation_token_create_params.py index e962360bb..4f86906ff 100644 --- a/stripe/params/test_helpers/_confirmation_token_create_params.py +++ b/stripe/params/test_helpers/_confirmation_token_create_params.py @@ -33,7 +33,7 @@ class ConfirmationTokenCreateParams(TypedDict): """ Indicates that you intend to make future payments with this ConfirmationToken's payment method. - The presence of this property will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. + The presence of this property will [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. """ shipping: NotRequired["ConfirmationTokenCreateParamsShipping"] """ @@ -200,7 +200,7 @@ class ConfirmationTokenCreateParamsPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ mobilepay: NotRequired[ "ConfirmationTokenCreateParamsPaymentMethodDataMobilepay" @@ -278,7 +278,7 @@ class ConfirmationTokenCreateParamsPaymentMethodData(TypedDict): "ConfirmationTokenCreateParamsPaymentMethodDataRadarOptions" ] """ - Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information. + Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information. """ rechnung: NotRequired[ "ConfirmationTokenCreateParamsPaymentMethodDataRechnung" @@ -530,7 +530,7 @@ class ConfirmationTokenCreateParamsPaymentMethodDataBillingDetailsAddress( """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -659,6 +659,7 @@ class ConfirmationTokenCreateParamsPaymentMethodDataIdeal(TypedDict): "handelsbanken", "ing", "knab", + "mollie", "moneyou", "n26", "nn", @@ -851,7 +852,7 @@ class ConfirmationTokenCreateParamsPaymentMethodDataQris(TypedDict): class ConfirmationTokenCreateParamsPaymentMethodDataRadarOptions(TypedDict): session: NotRequired[str] """ - A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. + A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments. """ @@ -1041,5 +1042,5 @@ class ConfirmationTokenCreateParamsShippingAddress(TypedDict): """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ diff --git a/stripe/params/test_helpers/_customer_fund_cash_balance_params.py b/stripe/params/test_helpers/_customer_fund_cash_balance_params.py index dde8f3e4a..6ac4948e8 100644 --- a/stripe/params/test_helpers/_customer_fund_cash_balance_params.py +++ b/stripe/params/test_helpers/_customer_fund_cash_balance_params.py @@ -7,7 +7,7 @@ class CustomerFundCashBalanceParams(TypedDict): amount: int """ - Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency). + Amount to be used for this test cash balance transaction. A positive integer representing how much to fund in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to fund $1.00 or 100 to fund ¥100, a zero-decimal currency). """ currency: str """ @@ -19,5 +19,5 @@ class CustomerFundCashBalanceParams(TypedDict): """ reference: NotRequired[str] """ - A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://stripe.com/docs/payments/customer-balance/reconciliation) applies to different user inputs. + A description of the test funding. This simulates free-text references supplied by customers when making bank transfers to their cash balance. You can use this to test how Stripe's [reconciliation algorithm](https://docs.stripe.com/payments/customer-balance/reconciliation) applies to different user inputs. """ diff --git a/stripe/params/test_helpers/issuing/_authorization_capture_params.py b/stripe/params/test_helpers/issuing/_authorization_capture_params.py index a18365064..8902e15aa 100644 --- a/stripe/params/test_helpers/issuing/_authorization_capture_params.py +++ b/stripe/params/test_helpers/issuing/_authorization_capture_params.py @@ -7,7 +7,7 @@ class AuthorizationCaptureParams(TypedDict): capture_amount: NotRequired[int] """ - The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount to capture from the authorization. If not provided, the full amount of the authorization will be captured. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ close_authorization: NotRequired[bool] """ diff --git a/stripe/params/test_helpers/issuing/_authorization_create_params.py b/stripe/params/test_helpers/issuing/_authorization_create_params.py index af7c512c9..92a39a655 100644 --- a/stripe/params/test_helpers/issuing/_authorization_create_params.py +++ b/stripe/params/test_helpers/issuing/_authorization_create_params.py @@ -7,11 +7,11 @@ class AuthorizationCreateParams(TypedDict): amount: NotRequired[int] """ - The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to authorize. This amount is in the provided currency, or defaults to the card's currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ amount_details: NotRequired["AuthorizationCreateParamsAmountDetails"] """ - Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ authorization_method: NotRequired[ Literal["chip", "contactless", "keyed_in", "online", "swipe"] @@ -47,11 +47,11 @@ class AuthorizationCreateParams(TypedDict): """ is_amount_controllable: NotRequired[bool] """ - If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. + If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. """ merchant_amount: NotRequired[int] """ - The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to authorize. This amount is in the provided merchant currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ merchant_currency: NotRequired[str] """ @@ -526,7 +526,7 @@ class AuthorizationCreateParamsMerchantData(TypedDict): ] ] """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ city: NotRequired[str] """ diff --git a/stripe/params/test_helpers/issuing/_authorization_finalize_amount_params.py b/stripe/params/test_helpers/issuing/_authorization_finalize_amount_params.py index 233ee6b26..af6fd8df6 100644 --- a/stripe/params/test_helpers/issuing/_authorization_finalize_amount_params.py +++ b/stripe/params/test_helpers/issuing/_authorization_finalize_amount_params.py @@ -11,7 +11,7 @@ class AuthorizationFinalizeAmountParams(TypedDict): """ final_amount: int """ - The final authorization amount that will be captured by the merchant. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The final authorization amount that will be captured by the merchant. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ fleet: NotRequired["AuthorizationFinalizeAmountParamsFleet"] """ diff --git a/stripe/params/test_helpers/issuing/_authorization_increment_params.py b/stripe/params/test_helpers/issuing/_authorization_increment_params.py index 6190a1399..76c2591aa 100644 --- a/stripe/params/test_helpers/issuing/_authorization_increment_params.py +++ b/stripe/params/test_helpers/issuing/_authorization_increment_params.py @@ -11,9 +11,9 @@ class AuthorizationIncrementParams(TypedDict): """ increment_amount: int """ - The amount to increment the authorization by. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount to increment the authorization by. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ is_amount_controllable: NotRequired[bool] """ - If set `true`, you may provide [amount](https://stripe.com/docs/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. + If set `true`, you may provide [amount](https://docs.stripe.com/api/issuing/authorizations/approve#approve_issuing_authorization-amount) to control how much to hold for the authorization. """ diff --git a/stripe/params/test_helpers/issuing/_authorization_reverse_params.py b/stripe/params/test_helpers/issuing/_authorization_reverse_params.py index 34241359a..015835de3 100644 --- a/stripe/params/test_helpers/issuing/_authorization_reverse_params.py +++ b/stripe/params/test_helpers/issuing/_authorization_reverse_params.py @@ -11,5 +11,5 @@ class AuthorizationReverseParams(TypedDict): """ reverse_amount: NotRequired[int] """ - The amount to reverse from the authorization. If not provided, the full amount of the authorization will be reversed. This amount is in the authorization currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount to reverse from the authorization. If not provided, the full amount of the authorization will be reversed. This amount is in the authorization currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ diff --git a/stripe/params/test_helpers/issuing/_transaction_create_force_capture_params.py b/stripe/params/test_helpers/issuing/_transaction_create_force_capture_params.py index e2818f727..193a40e0a 100644 --- a/stripe/params/test_helpers/issuing/_transaction_create_force_capture_params.py +++ b/stripe/params/test_helpers/issuing/_transaction_create_force_capture_params.py @@ -7,7 +7,7 @@ class TransactionCreateForceCaptureParams(TypedDict): amount: int """ - The total amount to attempt to capture. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to capture. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ card: str """ @@ -335,7 +335,7 @@ class TransactionCreateForceCaptureParamsMerchantData(TypedDict): ] ] """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ city: NotRequired[str] """ diff --git a/stripe/params/test_helpers/issuing/_transaction_create_unlinked_refund_params.py b/stripe/params/test_helpers/issuing/_transaction_create_unlinked_refund_params.py index 1fa13fae8..4ab81df69 100644 --- a/stripe/params/test_helpers/issuing/_transaction_create_unlinked_refund_params.py +++ b/stripe/params/test_helpers/issuing/_transaction_create_unlinked_refund_params.py @@ -7,7 +7,7 @@ class TransactionCreateUnlinkedRefundParams(TypedDict): amount: int """ - The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ card: str """ @@ -335,7 +335,7 @@ class TransactionCreateUnlinkedRefundParamsMerchantData(TypedDict): ] ] """ - A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values. + A categorization of the seller's type of business. See our [merchant categories guide](https://docs.stripe.com/issuing/merchant-categories) for a list of possible values. """ city: NotRequired[str] """ diff --git a/stripe/params/test_helpers/issuing/_transaction_refund_params.py b/stripe/params/test_helpers/issuing/_transaction_refund_params.py index d488f1d6a..05ab847e9 100644 --- a/stripe/params/test_helpers/issuing/_transaction_refund_params.py +++ b/stripe/params/test_helpers/issuing/_transaction_refund_params.py @@ -11,5 +11,5 @@ class TransactionRefundParams(TypedDict): """ refund_amount: NotRequired[int] """ - The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The total amount to attempt to refund. This amount is in the provided currency, or defaults to the cards currency, and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ diff --git a/stripe/params/test_helpers/treasury/_received_credit_create_params.py b/stripe/params/test_helpers/treasury/_received_credit_create_params.py index 6be1e5063..b40f8bc70 100644 --- a/stripe/params/test_helpers/treasury/_received_credit_create_params.py +++ b/stripe/params/test_helpers/treasury/_received_credit_create_params.py @@ -33,7 +33,7 @@ class ReceivedCreditCreateParams(TypedDict): """ network: Literal["ach", "us_domestic_wire"] """ - Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ network_details: NotRequired["ReceivedCreditCreateParamsNetworkDetails"] """ diff --git a/stripe/params/test_helpers/treasury/_received_debit_create_params.py b/stripe/params/test_helpers/treasury/_received_debit_create_params.py index 7b4906a88..24f9ba78f 100644 --- a/stripe/params/test_helpers/treasury/_received_debit_create_params.py +++ b/stripe/params/test_helpers/treasury/_received_debit_create_params.py @@ -33,7 +33,7 @@ class ReceivedDebitCreateParams(TypedDict): """ network: Literal["ach"] """ - Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ network_details: NotRequired["ReceivedDebitCreateParamsNetworkDetails"] """ diff --git a/stripe/params/treasury/_credit_reversal_create_params.py b/stripe/params/treasury/_credit_reversal_create_params.py index 96ad037e2..1326b34da 100644 --- a/stripe/params/treasury/_credit_reversal_create_params.py +++ b/stripe/params/treasury/_credit_reversal_create_params.py @@ -12,7 +12,7 @@ class CreditReversalCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ received_credit: str """ diff --git a/stripe/params/treasury/_debit_reversal_create_params.py b/stripe/params/treasury/_debit_reversal_create_params.py index aa873103c..c3a7e803c 100644 --- a/stripe/params/treasury/_debit_reversal_create_params.py +++ b/stripe/params/treasury/_debit_reversal_create_params.py @@ -12,7 +12,7 @@ class DebitReversalCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ received_debit: str """ diff --git a/stripe/params/treasury/_financial_account_create_params.py b/stripe/params/treasury/_financial_account_create_params.py index 2112d4da1..45ad4fd85 100644 --- a/stripe/params/treasury/_financial_account_create_params.py +++ b/stripe/params/treasury/_financial_account_create_params.py @@ -20,7 +20,7 @@ class FinancialAccountCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nickname: NotRequired["Literal['']|str"] """ diff --git a/stripe/params/treasury/_financial_account_modify_params.py b/stripe/params/treasury/_financial_account_modify_params.py index f82b6a4bb..ef4ac61a7 100644 --- a/stripe/params/treasury/_financial_account_modify_params.py +++ b/stripe/params/treasury/_financial_account_modify_params.py @@ -26,7 +26,7 @@ class FinancialAccountModifyParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nickname: NotRequired["Literal['']|str"] """ diff --git a/stripe/params/treasury/_financial_account_update_params.py b/stripe/params/treasury/_financial_account_update_params.py index fd163a01c..6ea68f019 100644 --- a/stripe/params/treasury/_financial_account_update_params.py +++ b/stripe/params/treasury/_financial_account_update_params.py @@ -25,7 +25,7 @@ class FinancialAccountUpdateParams(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ nickname: NotRequired["Literal['']|str"] """ diff --git a/stripe/params/treasury/_inbound_transfer_create_params.py b/stripe/params/treasury/_inbound_transfer_create_params.py index efc92248e..c5bbcd14d 100644 --- a/stripe/params/treasury/_inbound_transfer_create_params.py +++ b/stripe/params/treasury/_inbound_transfer_create_params.py @@ -28,7 +28,7 @@ class InboundTransferCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ origin_payment_method: str """ @@ -36,5 +36,5 @@ class InboundTransferCreateParams(RequestOptions): """ statement_descriptor: NotRequired[str] """ - The complete description that appears on your customers' statements. Maximum 10 characters. + The complete description that appears on your customers' statements. Maximum 10 characters. Can only include -#.$&*, spaces, and alphanumeric characters. """ diff --git a/stripe/params/treasury/_outbound_payment_create_params.py b/stripe/params/treasury/_outbound_payment_create_params.py index 89cdf5685..565364948 100644 --- a/stripe/params/treasury/_outbound_payment_create_params.py +++ b/stripe/params/treasury/_outbound_payment_create_params.py @@ -52,11 +52,11 @@ class OutboundPaymentCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ statement_descriptor: NotRequired[str] """ - The description that appears on the receiving end for this OutboundPayment (for example, bank statement for external bank transfer). Maximum 10 characters for `ach` payments, 140 characters for `us_domestic_wire` payments, or 500 characters for `stripe` network transfers. The default value is "payment". + The description that appears on the receiving end for this OutboundPayment (for example, bank statement for external bank transfer). Maximum 10 characters for `ach` payments, 140 characters for `us_domestic_wire` payments, or 500 characters for `stripe` network transfers. Can only include -#.$&*, spaces, and alphanumeric characters. The default value is "payment". """ @@ -73,7 +73,7 @@ class OutboundPaymentCreateParamsDestinationPaymentMethodData(TypedDict): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ type: Literal["financial_account", "us_bank_account"] """ @@ -135,7 +135,7 @@ class OutboundPaymentCreateParamsDestinationPaymentMethodDataBillingDetailsAddre """ state: NotRequired[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ @@ -178,7 +178,7 @@ class OutboundPaymentCreateParamsDestinationPaymentMethodOptionsUsBankAccount( ): network: NotRequired[Literal["ach", "us_domestic_wire"]] """ - Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ diff --git a/stripe/params/treasury/_outbound_transfer_create_params.py b/stripe/params/treasury/_outbound_transfer_create_params.py index b616b4e95..04182a9db 100644 --- a/stripe/params/treasury/_outbound_transfer_create_params.py +++ b/stripe/params/treasury/_outbound_transfer_create_params.py @@ -44,7 +44,7 @@ class OutboundTransferCreateParams(RequestOptions): """ metadata: NotRequired[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`. """ network_details: NotRequired["OutboundTransferCreateParamsNetworkDetails"] """ @@ -52,7 +52,7 @@ class OutboundTransferCreateParams(RequestOptions): """ statement_descriptor: NotRequired[str] """ - Statement descriptor to be shown on the receiving end of an OutboundTransfer. Maximum 10 characters for `ach` transfers or 140 characters for `us_domestic_wire` transfers. The default value is "transfer". + Statement descriptor to be shown on the receiving end of an OutboundTransfer. Maximum 10 characters for `ach` transfers or 140 characters for `us_domestic_wire` transfers. The default value is "transfer". Can only include -#.$&*, spaces, and alphanumeric characters. """ @@ -81,7 +81,7 @@ class OutboundTransferCreateParamsDestinationPaymentMethodOptionsUsBankAccount( ): network: NotRequired[Literal["ach", "us_domestic_wire"]] """ - Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ diff --git a/stripe/params/treasury/_received_credit_create_params.py b/stripe/params/treasury/_received_credit_create_params.py index e20083783..c73381441 100644 --- a/stripe/params/treasury/_received_credit_create_params.py +++ b/stripe/params/treasury/_received_credit_create_params.py @@ -34,7 +34,7 @@ class ReceivedCreditCreateParams(RequestOptions): """ network: Literal["ach", "us_domestic_wire"] """ - Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ network_details: NotRequired["ReceivedCreditCreateParamsNetworkDetails"] """ diff --git a/stripe/params/treasury/_received_debit_create_params.py b/stripe/params/treasury/_received_debit_create_params.py index 24d6d3698..1c5d8e1e4 100644 --- a/stripe/params/treasury/_received_debit_create_params.py +++ b/stripe/params/treasury/_received_debit_create_params.py @@ -34,7 +34,7 @@ class ReceivedDebitCreateParams(RequestOptions): """ network: Literal["ach"] """ - Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ network_details: NotRequired["ReceivedDebitCreateParamsNetworkDetails"] """ diff --git a/stripe/params/v2/core/__init__.py b/stripe/params/v2/core/__init__.py index 380fe6d01..da1ce577b 100644 --- a/stripe/params/v2/core/__init__.py +++ b/stripe/params/v2/core/__init__.py @@ -120,6 +120,7 @@ AccountCreateParamsIdentityBusinessDetails as AccountCreateParamsIdentityBusinessDetails, AccountCreateParamsIdentityBusinessDetailsAddress as AccountCreateParamsIdentityBusinessDetailsAddress, AccountCreateParamsIdentityBusinessDetailsAnnualRevenue as AccountCreateParamsIdentityBusinessDetailsAnnualRevenue, + AccountCreateParamsIdentityBusinessDetailsAnnualRevenueAmount as AccountCreateParamsIdentityBusinessDetailsAnnualRevenueAmount, AccountCreateParamsIdentityBusinessDetailsDocuments as AccountCreateParamsIdentityBusinessDetailsDocuments, AccountCreateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification as AccountCreateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification, AccountCreateParamsIdentityBusinessDetailsDocumentsCompanyLicense as AccountCreateParamsIdentityBusinessDetailsDocumentsCompanyLicense, @@ -134,6 +135,7 @@ AccountCreateParamsIdentityBusinessDetailsDocumentsProofOfUltimateBeneficialOwnership as AccountCreateParamsIdentityBusinessDetailsDocumentsProofOfUltimateBeneficialOwnership, AccountCreateParamsIdentityBusinessDetailsIdNumber as AccountCreateParamsIdentityBusinessDetailsIdNumber, AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue as AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue, + AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount as AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount, AccountCreateParamsIdentityBusinessDetailsScriptAddresses as AccountCreateParamsIdentityBusinessDetailsScriptAddresses, AccountCreateParamsIdentityBusinessDetailsScriptAddressesKana as AccountCreateParamsIdentityBusinessDetailsScriptAddressesKana, AccountCreateParamsIdentityBusinessDetailsScriptAddressesKanji as AccountCreateParamsIdentityBusinessDetailsScriptAddressesKanji, @@ -190,6 +192,7 @@ AccountTokenCreateParamsIdentityBusinessDetails as AccountTokenCreateParamsIdentityBusinessDetails, AccountTokenCreateParamsIdentityBusinessDetailsAddress as AccountTokenCreateParamsIdentityBusinessDetailsAddress, AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenue as AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenue, + AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenueAmount as AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenueAmount, AccountTokenCreateParamsIdentityBusinessDetailsDocuments as AccountTokenCreateParamsIdentityBusinessDetailsDocuments, AccountTokenCreateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification as AccountTokenCreateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification, AccountTokenCreateParamsIdentityBusinessDetailsDocumentsCompanyLicense as AccountTokenCreateParamsIdentityBusinessDetailsDocumentsCompanyLicense, @@ -204,6 +207,7 @@ AccountTokenCreateParamsIdentityBusinessDetailsDocumentsProofOfUltimateBeneficialOwnership as AccountTokenCreateParamsIdentityBusinessDetailsDocumentsProofOfUltimateBeneficialOwnership, AccountTokenCreateParamsIdentityBusinessDetailsIdNumber as AccountTokenCreateParamsIdentityBusinessDetailsIdNumber, AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue as AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue, + AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount as AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount, AccountTokenCreateParamsIdentityBusinessDetailsScriptAddresses as AccountTokenCreateParamsIdentityBusinessDetailsScriptAddresses, AccountTokenCreateParamsIdentityBusinessDetailsScriptAddressesKana as AccountTokenCreateParamsIdentityBusinessDetailsScriptAddressesKana, AccountTokenCreateParamsIdentityBusinessDetailsScriptAddressesKanji as AccountTokenCreateParamsIdentityBusinessDetailsScriptAddressesKanji, @@ -348,6 +352,7 @@ AccountUpdateParamsIdentityBusinessDetails as AccountUpdateParamsIdentityBusinessDetails, AccountUpdateParamsIdentityBusinessDetailsAddress as AccountUpdateParamsIdentityBusinessDetailsAddress, AccountUpdateParamsIdentityBusinessDetailsAnnualRevenue as AccountUpdateParamsIdentityBusinessDetailsAnnualRevenue, + AccountUpdateParamsIdentityBusinessDetailsAnnualRevenueAmount as AccountUpdateParamsIdentityBusinessDetailsAnnualRevenueAmount, AccountUpdateParamsIdentityBusinessDetailsDocuments as AccountUpdateParamsIdentityBusinessDetailsDocuments, AccountUpdateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification as AccountUpdateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification, AccountUpdateParamsIdentityBusinessDetailsDocumentsCompanyLicense as AccountUpdateParamsIdentityBusinessDetailsDocumentsCompanyLicense, @@ -362,6 +367,7 @@ AccountUpdateParamsIdentityBusinessDetailsDocumentsProofOfUltimateBeneficialOwnership as AccountUpdateParamsIdentityBusinessDetailsDocumentsProofOfUltimateBeneficialOwnership, AccountUpdateParamsIdentityBusinessDetailsIdNumber as AccountUpdateParamsIdentityBusinessDetailsIdNumber, AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue as AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue, + AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount as AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount, AccountUpdateParamsIdentityBusinessDetailsScriptAddresses as AccountUpdateParamsIdentityBusinessDetailsScriptAddresses, AccountUpdateParamsIdentityBusinessDetailsScriptAddressesKana as AccountUpdateParamsIdentityBusinessDetailsScriptAddressesKana, AccountUpdateParamsIdentityBusinessDetailsScriptAddressesKanji as AccountUpdateParamsIdentityBusinessDetailsScriptAddressesKanji, @@ -877,6 +883,10 @@ "stripe.params.v2.core._account_create_params", False, ), + "AccountCreateParamsIdentityBusinessDetailsAnnualRevenueAmount": ( + "stripe.params.v2.core._account_create_params", + False, + ), "AccountCreateParamsIdentityBusinessDetailsDocuments": ( "stripe.params.v2.core._account_create_params", False, @@ -933,6 +943,10 @@ "stripe.params.v2.core._account_create_params", False, ), + "AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount": ( + "stripe.params.v2.core._account_create_params", + False, + ), "AccountCreateParamsIdentityBusinessDetailsScriptAddresses": ( "stripe.params.v2.core._account_create_params", False, @@ -1122,6 +1136,10 @@ "stripe.params.v2.core._account_token_create_params", False, ), + "AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenueAmount": ( + "stripe.params.v2.core._account_token_create_params", + False, + ), "AccountTokenCreateParamsIdentityBusinessDetailsDocuments": ( "stripe.params.v2.core._account_token_create_params", False, @@ -1178,6 +1196,10 @@ "stripe.params.v2.core._account_token_create_params", False, ), + "AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount": ( + "stripe.params.v2.core._account_token_create_params", + False, + ), "AccountTokenCreateParamsIdentityBusinessDetailsScriptAddresses": ( "stripe.params.v2.core._account_token_create_params", False, @@ -1738,6 +1760,10 @@ "stripe.params.v2.core._account_update_params", False, ), + "AccountUpdateParamsIdentityBusinessDetailsAnnualRevenueAmount": ( + "stripe.params.v2.core._account_update_params", + False, + ), "AccountUpdateParamsIdentityBusinessDetailsDocuments": ( "stripe.params.v2.core._account_update_params", False, @@ -1794,6 +1820,10 @@ "stripe.params.v2.core._account_update_params", False, ), + "AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount": ( + "stripe.params.v2.core._account_update_params", + False, + ), "AccountUpdateParamsIdentityBusinessDetailsScriptAddresses": ( "stripe.params.v2.core._account_update_params", False, diff --git a/stripe/params/v2/core/_account_create_params.py b/stripe/params/v2/core/_account_create_params.py index eb2149fcb..ee68b6c11 100644 --- a/stripe/params/v2/core/_account_create_params.py +++ b/stripe/params/v2/core/_account_create_params.py @@ -1,6 +1,5 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing import Dict, List from typing_extensions import Literal, NotRequired, TypedDict @@ -64,11 +63,11 @@ class AccountCreateParamsConfiguration(TypedDict): """ merchant: NotRequired["AccountCreateParamsConfigurationMerchant"] """ - The Merchant configuration allows the Account to act as a connected account and collect payments facilitated by a Connect platform. You can add this configuration to your connected accounts only if you've completed onboarding as a Connect platform. + Enables the Account to act as a connected account and collect payments facilitated by a Connect platform. You must onboard your platform to Connect before you can add this configuration to your connected accounts. Utilize this configuration when the Account will be the Merchant of Record, like with Direct charges or Destination Charges with on_behalf_of set. """ recipient: NotRequired["AccountCreateParamsConfigurationRecipient"] """ - The Recipient Configuration allows the Account to receive funds. + The Recipient Configuration allows the Account to receive funds. Utilize this configuration if the Account will not be the Merchant of Record, like with Separate Charges & Transfers, or Destination Charges without on_behalf_of set. """ storer: NotRequired["AccountCreateParamsConfigurationStorer"] """ @@ -130,7 +129,7 @@ class AccountCreateParamsConfigurationCustomerBilling(TypedDict): "AccountCreateParamsConfigurationCustomerBillingInvoice" ] """ - Default settings used on invoices for this customer. + Default invoice settings for the customer account. """ @@ -145,21 +144,21 @@ class AccountCreateParamsConfigurationCustomerBillingInvoice(TypedDict): """ footer: NotRequired[str] """ - Default footer to be displayed on invoices for this customer. + Default invoice footer. """ next_sequence: NotRequired[int] """ - The sequence to be used on the customer's next invoice. Defaults to 1. + Sequence number to use on the customer account's next invoice. Defaults to 1. """ prefix: NotRequired[str] """ - The prefix for the customer used to generate unique invoice numbers. Must be 3–12 uppercase letters or numbers. + Prefix used to generate unique invoice numbers. Must be 3-12 uppercase letters or numbers. """ rendering: NotRequired[ "AccountCreateParamsConfigurationCustomerBillingInvoiceRendering" ] """ - Default options for invoice PDF rendering for this customer. + Default invoice PDF rendering options. """ @@ -183,7 +182,7 @@ class AccountCreateParamsConfigurationCustomerBillingInvoiceRendering( Literal["exclude_tax", "include_inclusive_tax"] ] """ - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs. One of exclude_tax or include_inclusive_tax. include_inclusive_tax will include inclusive tax (and exclude exclusive tax) in invoice PDF amounts. exclude_tax will exclude all tax (inclusive and exclusive alike) from invoice PDF amounts. + Indicates whether displayed line item prices and amounts on invoice PDFs include inclusive tax amounts. Must be either `include_inclusive_tax` or `exclude_tax`. """ template: NotRequired[str] """ @@ -284,7 +283,7 @@ class AccountCreateParamsConfigurationMerchant(TypedDict): """ mcc: NotRequired[str] """ - The merchant category code for the Merchant Configuration. MCCs are used to classify businesses based on the goods or services they provide. + The Merchant Category Code (MCC) for the Merchant Configuration. MCCs classify businesses based on the goods or services they provide. """ script_statement_descriptor: NotRequired[ "AccountCreateParamsConfigurationMerchantScriptStatementDescriptor" @@ -307,7 +306,7 @@ class AccountCreateParamsConfigurationMerchant(TypedDict): class AccountCreateParamsConfigurationMerchantBacsDebitPayments(TypedDict): display_name: NotRequired[str] """ - Display name for Bacs debit payments. + Display name for Bacs Direct Debit payments. """ @@ -1156,7 +1155,7 @@ class AccountCreateParamsConfigurationMerchantSupportAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -1239,7 +1238,7 @@ class AccountCreateParamsConfigurationRecipientCapabilitiesStripeBalance( "AccountCreateParamsConfigurationRecipientCapabilitiesStripeBalanceStripeTransfers" ] """ - Allows the account to receive /v1/transfers into their Stripe Balance (/v1/balance). + Enables this Account to receive /v1/transfers into their Stripe Balance (/v1/balance). """ @@ -1802,7 +1801,7 @@ class AccountCreateParamsIdentityBusinessDetails(TypedDict): """ estimated_worker_count: NotRequired[int] """ - An estimated upper bound of employees, contractors, vendors, etc. currently working for the business. + Estimated maximum number of workers currently engaged by the business (including employees, contractors, and vendors). """ id_numbers: NotRequired[ List["AccountCreateParamsIdentityBusinessDetailsIdNumber"] @@ -1899,12 +1898,14 @@ class AccountCreateParamsIdentityBusinessDetailsAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ class AccountCreateParamsIdentityBusinessDetailsAnnualRevenue(TypedDict): - amount: NotRequired[AmountParam] + amount: NotRequired[ + "AccountCreateParamsIdentityBusinessDetailsAnnualRevenueAmount" + ] """ A non-negative integer representing the amount in the smallest currency unit. """ @@ -1914,6 +1915,17 @@ class AccountCreateParamsIdentityBusinessDetailsAnnualRevenue(TypedDict): """ +class AccountCreateParamsIdentityBusinessDetailsAnnualRevenueAmount(TypedDict): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class AccountCreateParamsIdentityBusinessDetailsDocuments(TypedDict): bank_account_ownership_verification: NotRequired[ "AccountCreateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification" @@ -2131,70 +2143,111 @@ class AccountCreateParamsIdentityBusinessDetailsIdNumber(TypedDict): "ao_nif", "ar_cuit", "at_fn", + "at_stn", + "at_vat", "au_abn", "au_acn", "au_in", "az_tin", "bd_etin", "be_cbe", + "be_vat", "bg_uic", + "bg_vat", "br_cnpj", "ca_cn", "ca_crarr", + "ca_gst_hst", "ca_neq", "ca_rid", "ch_chid", "ch_uid", "cr_cpj", "cr_nite", + "cy_he", "cy_tic", + "cy_vat", "cz_ico", + "cz_vat", "de_hrn", + "de_stn", "de_vat", "dk_cvr", + "dk_vat", "do_rcn", "ee_rk", + "ee_vat", "es_cif", + "es_vat", + "fi_vat", "fi_yt", + "fr_rna", "fr_siren", "fr_vat", "gb_crn", "gi_crn", + "gr_afm", "gr_gemi", + "gr_vat", "gt_nit", "hk_br", "hk_cr", - "hk_mbs", + "hr_mbs", + "hr_oib", + "hr_vat", "hu_cjs", + "hu_tin", + "hu_vat", "ie_crn", + "ie_trn", + "ie_vat", "it_rea", "it_vat", "jp_cn", "kz_bin", "li_uid", "lt_ccrn", + "lt_vat", + "lu_nif", "lu_rcs", + "lu_vat", "lv_urn", + "lv_vat", "mt_crn", + "mt_tin", + "mt_vat", "mx_rfc", "my_brn", "my_coid", + "my_itn", "my_sst", "mz_nuit", "nl_kvk", + "nl_rsin", + "nl_vat", "no_orgnr", "nz_bn", + "nz_ird", "pe_ruc", "pk_ntn", + "pl_nip", "pl_regon", + "pl_vat", "pt_vat", "ro_cui", + "ro_orc", + "ro_vat", "sa_crn", "sa_tin", "se_orgnr", + "se_vat", "sg_uen", "si_msp", + "si_tin", + "si_vat", + "sk_dic", "sk_ico", + "sk_vat", "th_crn", "th_prn", "th_tin", @@ -2212,12 +2265,27 @@ class AccountCreateParamsIdentityBusinessDetailsIdNumber(TypedDict): class AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue( TypedDict, ): - amount: NotRequired[AmountParam] + amount: NotRequired[ + "AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount" + ] """ A non-negative integer representing the amount in the smallest currency unit. """ +class AccountCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount( + TypedDict, +): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class AccountCreateParamsIdentityBusinessDetailsScriptAddresses(TypedDict): kana: NotRequired[ "AccountCreateParamsIdentityBusinessDetailsScriptAddressesKana" @@ -2260,7 +2328,7 @@ class AccountCreateParamsIdentityBusinessDetailsScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2293,7 +2361,7 @@ class AccountCreateParamsIdentityBusinessDetailsScriptAddressesKanji( """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2442,7 +2510,7 @@ class AccountCreateParamsIdentityIndividualAdditionalAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2492,7 +2560,7 @@ class AccountCreateParamsIdentityIndividualAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2633,36 +2701,81 @@ class AccountCreateParamsIdentityIndividualIdNumber(TypedDict): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -2738,7 +2851,7 @@ class AccountCreateParamsIdentityIndividualScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2769,7 +2882,7 @@ class AccountCreateParamsIdentityIndividualScriptAddressesKanji(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ diff --git a/stripe/params/v2/core/_account_link_create_params.py b/stripe/params/v2/core/_account_link_create_params.py index 47ff6149c..c7d15ffef 100644 --- a/stripe/params/v2/core/_account_link_create_params.py +++ b/stripe/params/v2/core/_account_link_create_params.py @@ -18,17 +18,17 @@ class AccountLinkCreateParams(TypedDict): class AccountLinkCreateParamsUseCase(TypedDict): type: Literal["account_onboarding", "account_update"] """ - Open Enum. The type of AccountLink the user is requesting. + Open Enum. The type of Account Link the user is requesting. """ account_onboarding: NotRequired[ "AccountLinkCreateParamsUseCaseAccountOnboarding" ] """ - Indicates that the AccountLink provided should onboard an account. + Hash containing configuration options for an Account Link object that onboards a new account. """ account_update: NotRequired["AccountLinkCreateParamsUseCaseAccountUpdate"] """ - Indicates that the AccountLink provided should update a previously onboarded account. + Hash containing configuration options for an Account Link that updates an existing account. """ @@ -83,7 +83,7 @@ class AccountLinkCreateParamsUseCaseAccountUpdate(TypedDict): """ refresh_url: str """ - The URL the user will be redirected to if the AccountLink is expired, has been used, or is otherwise invalid. The URL you specify should attempt to generate a new AccountLink with the same parameters used to create the original AccountLink, then redirect the user to the new AccountLink's URL so they can continue the flow. If a new AccountLink cannot be generated or the redirect fails you should display a useful error to the user. Please make sure to implement authentication before redirecting the user in case this URL is leaked to a third party. + The URL the user will be redirected to if the Account Link is expired, has been used, or is otherwise invalid. The URL you specify should attempt to generate a new Account Link with the same parameters used to create the original Account Link, then redirect the user to the new Account Link URL so they can continue the flow. Make sure to authenticate the user before redirecting to the new Account Link, in case the URL leaks to a third party. If a new Account Link can't be generated, or if the redirect fails, you should display a useful error to the user. """ return_url: NotRequired[str] """ @@ -94,7 +94,7 @@ class AccountLinkCreateParamsUseCaseAccountUpdate(TypedDict): class AccountLinkCreateParamsUseCaseAccountUpdateCollectionOptions(TypedDict): fields: NotRequired[Literal["currently_due", "eventually_due"]] """ - Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). If you don't specify collection_options, the default value is currently_due. + Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). The default value is `currently_due`. """ future_requirements: NotRequired[Literal["include", "omit"]] """ diff --git a/stripe/params/v2/core/_account_list_params.py b/stripe/params/v2/core/_account_list_params.py index 3b1c551fe..c09a1326b 100644 --- a/stripe/params/v2/core/_account_list_params.py +++ b/stripe/params/v2/core/_account_list_params.py @@ -1,11 +1,13 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from typing import List -from typing_extensions import NotRequired, TypedDict +from typing_extensions import Literal, NotRequired, TypedDict class AccountListParams(TypedDict): - applied_configurations: NotRequired[List[str]] + applied_configurations: NotRequired[ + List[Literal["customer", "merchant", "recipient", "storer"]] + ] """ Filter only accounts that have all of the configurations specified. If omitted, returns all accounts regardless of which configurations they have. """ diff --git a/stripe/params/v2/core/_account_token_create_params.py b/stripe/params/v2/core/_account_token_create_params.py index 586837dca..ba6f1fa34 100644 --- a/stripe/params/v2/core/_account_token_create_params.py +++ b/stripe/params/v2/core/_account_token_create_params.py @@ -1,6 +1,5 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing import Dict, List, Optional from typing_extensions import Literal, NotRequired, TypedDict @@ -14,7 +13,7 @@ class AccountTokenCreateParams(TypedDict): """ A descriptive name for the Account. This name will be surfaced in the Stripe Dashboard and on any invoices sent to the Account. """ - identity: "AccountTokenCreateParamsIdentity" + identity: NotRequired["AccountTokenCreateParamsIdentity"] """ Information about the company, individual, and business represented by the Account. """ @@ -181,7 +180,7 @@ class AccountTokenCreateParamsIdentityBusinessDetails(TypedDict): """ estimated_worker_count: NotRequired[int] """ - An estimated upper bound of employees, contractors, vendors, etc. currently working for the business. + Estimated maximum number of workers currently engaged by the business (including employees, contractors, and vendors). """ id_numbers: NotRequired[ List["AccountTokenCreateParamsIdentityBusinessDetailsIdNumber"] @@ -278,12 +277,14 @@ class AccountTokenCreateParamsIdentityBusinessDetailsAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ class AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenue(TypedDict): - amount: NotRequired[AmountParam] + amount: NotRequired[ + "AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenueAmount" + ] """ A non-negative integer representing the amount in the smallest currency unit. """ @@ -293,6 +294,19 @@ class AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenue(TypedDict): """ +class AccountTokenCreateParamsIdentityBusinessDetailsAnnualRevenueAmount( + TypedDict, +): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class AccountTokenCreateParamsIdentityBusinessDetailsDocuments(TypedDict): bank_account_ownership_verification: NotRequired[ "AccountTokenCreateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification" @@ -510,70 +524,111 @@ class AccountTokenCreateParamsIdentityBusinessDetailsIdNumber(TypedDict): "ao_nif", "ar_cuit", "at_fn", + "at_stn", + "at_vat", "au_abn", "au_acn", "au_in", "az_tin", "bd_etin", "be_cbe", + "be_vat", "bg_uic", + "bg_vat", "br_cnpj", "ca_cn", "ca_crarr", + "ca_gst_hst", "ca_neq", "ca_rid", "ch_chid", "ch_uid", "cr_cpj", "cr_nite", + "cy_he", "cy_tic", + "cy_vat", "cz_ico", + "cz_vat", "de_hrn", + "de_stn", "de_vat", "dk_cvr", + "dk_vat", "do_rcn", "ee_rk", + "ee_vat", "es_cif", + "es_vat", + "fi_vat", "fi_yt", + "fr_rna", "fr_siren", "fr_vat", "gb_crn", "gi_crn", + "gr_afm", "gr_gemi", + "gr_vat", "gt_nit", "hk_br", "hk_cr", - "hk_mbs", + "hr_mbs", + "hr_oib", + "hr_vat", "hu_cjs", + "hu_tin", + "hu_vat", "ie_crn", + "ie_trn", + "ie_vat", "it_rea", "it_vat", "jp_cn", "kz_bin", "li_uid", "lt_ccrn", + "lt_vat", + "lu_nif", "lu_rcs", + "lu_vat", "lv_urn", + "lv_vat", "mt_crn", + "mt_tin", + "mt_vat", "mx_rfc", "my_brn", "my_coid", + "my_itn", "my_sst", "mz_nuit", "nl_kvk", + "nl_rsin", + "nl_vat", "no_orgnr", "nz_bn", + "nz_ird", "pe_ruc", "pk_ntn", + "pl_nip", "pl_regon", + "pl_vat", "pt_vat", "ro_cui", + "ro_orc", + "ro_vat", "sa_crn", "sa_tin", "se_orgnr", + "se_vat", "sg_uen", "si_msp", + "si_tin", + "si_vat", + "sk_dic", "sk_ico", + "sk_vat", "th_crn", "th_prn", "th_tin", @@ -591,12 +646,27 @@ class AccountTokenCreateParamsIdentityBusinessDetailsIdNumber(TypedDict): class AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue( TypedDict, ): - amount: NotRequired[AmountParam] + amount: NotRequired[ + "AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount" + ] """ A non-negative integer representing the amount in the smallest currency unit. """ +class AccountTokenCreateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount( + TypedDict, +): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class AccountTokenCreateParamsIdentityBusinessDetailsScriptAddresses( TypedDict ): @@ -643,7 +713,7 @@ class AccountTokenCreateParamsIdentityBusinessDetailsScriptAddressesKana( """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -676,7 +746,7 @@ class AccountTokenCreateParamsIdentityBusinessDetailsScriptAddressesKanji( """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -831,7 +901,7 @@ class AccountTokenCreateParamsIdentityIndividualAdditionalAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -881,7 +951,7 @@ class AccountTokenCreateParamsIdentityIndividualAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -1024,36 +1094,81 @@ class AccountTokenCreateParamsIdentityIndividualIdNumber(TypedDict): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -1129,7 +1244,7 @@ class AccountTokenCreateParamsIdentityIndividualScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -1162,7 +1277,7 @@ class AccountTokenCreateParamsIdentityIndividualScriptAddressesKanji( """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ diff --git a/stripe/params/v2/core/_account_update_params.py b/stripe/params/v2/core/_account_update_params.py index 8e261853c..691843166 100644 --- a/stripe/params/v2/core/_account_update_params.py +++ b/stripe/params/v2/core/_account_update_params.py @@ -1,6 +1,5 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing import Dict, List, Optional from typing_extensions import Literal, NotRequired, TypedDict @@ -64,11 +63,11 @@ class AccountUpdateParamsConfiguration(TypedDict): """ merchant: NotRequired["AccountUpdateParamsConfigurationMerchant"] """ - The Merchant configuration allows the Account to act as a connected account and collect payments facilitated by a Connect platform. You can add this configuration to your connected accounts only if you've completed onboarding as a Connect platform. + Enables the Account to act as a connected account and collect payments facilitated by a Connect platform. You must onboard your platform to Connect before you can add this configuration to your connected accounts. Utilize this configuration when the Account will be the Merchant of Record, like with Direct charges or Destination Charges with on_behalf_of set. """ recipient: NotRequired["AccountUpdateParamsConfigurationRecipient"] """ - The Recipient Configuration allows the Account to receive funds. + The Recipient Configuration allows the Account to receive funds. Utilize this configuration if the Account will not be the Merchant of Record, like with Separate Charges & Transfers, or Destination Charges without on_behalf_of set. """ storer: NotRequired["AccountUpdateParamsConfigurationStorer"] """ @@ -110,7 +109,7 @@ class AccountUpdateParamsConfigurationCustomer(TypedDict): class AccountUpdateParamsConfigurationCustomerAutomaticIndirectTax(TypedDict): exempt: NotRequired[Literal["exempt", "none", "reverse"]] """ - Describes the customer's tax exemption status, which is `none`, `exempt`, or `reverse`. When set to reverse, invoice and receipt PDFs include the following text: “Reverse charge”. + The customer account's tax exemption status: `none`, `exempt`, or `reverse`. When `reverse`, invoice and receipt PDFs include "Reverse charge". """ ip_address: NotRequired[str] """ @@ -125,24 +124,24 @@ class AccountUpdateParamsConfigurationCustomerAutomaticIndirectTax(TypedDict): ] ] """ - The data source used to identify the customer's tax location - defaults to `identity_address`. Will only be used for automatic tax calculation on the customer's Invoices and Subscriptions. This behavior is now deprecated for new users. + Data source used to identify the customer account's tax location. Defaults to `identity_address`. Used for automatic indirect tax calculation. """ validate_location: NotRequired[Literal["auto", "deferred", "immediately"]] """ - A per-request flag that indicates when Stripe should validate the customer tax location - defaults to 'auto'. + A per-request flag that indicates when Stripe should validate the customer tax location - defaults to `auto`. """ class AccountUpdateParamsConfigurationCustomerBilling(TypedDict): default_payment_method: NotRequired[str] """ - ID of a payment method that's attached to the customer, to be used as the customer's default payment method for invoices and subscriptions. + ID of a PaymentMethod attached to the customer account to use as the default for invoices and subscriptions. """ invoice: NotRequired[ "AccountUpdateParamsConfigurationCustomerBillingInvoice" ] """ - Default settings used on invoices for this customer. + Default invoice settings for the customer account. """ @@ -157,21 +156,21 @@ class AccountUpdateParamsConfigurationCustomerBillingInvoice(TypedDict): """ footer: NotRequired[str] """ - Default footer to be displayed on invoices for this customer. + Default invoice footer. """ next_sequence: NotRequired[int] """ - The sequence to be used on the customer's next invoice. Defaults to 1. + Sequence number to use on the customer account's next invoice. Defaults to 1. """ prefix: NotRequired[str] """ - The prefix for the customer used to generate unique invoice numbers. Must be 3–12 uppercase letters or numbers. + Prefix used to generate unique invoice numbers. Must be 3-12 uppercase letters or numbers. """ rendering: NotRequired[ "AccountUpdateParamsConfigurationCustomerBillingInvoiceRendering" ] """ - Default options for invoice PDF rendering for this customer. + Default invoice PDF rendering options. """ @@ -195,7 +194,7 @@ class AccountUpdateParamsConfigurationCustomerBillingInvoiceRendering( Literal["exclude_tax", "include_inclusive_tax"] ] """ - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs. One of exclude_tax or include_inclusive_tax. include_inclusive_tax will include inclusive tax (and exclude exclusive tax) in invoice PDF amounts. exclude_tax will exclude all tax (inclusive and exclusive alike) from invoice PDF amounts. + Indicates whether displayed line item prices and amounts on invoice PDFs include inclusive tax amounts. Must be either `include_inclusive_tax` or `exclude_tax`. """ template: NotRequired[str] """ @@ -274,7 +273,7 @@ class AccountUpdateParamsConfigurationMerchant(TypedDict): "AccountUpdateParamsConfigurationMerchantBacsDebitPayments" ] """ - Settings used for Bacs debit payments. + Settings for Bacs Direct Debit payments. """ branding: NotRequired["AccountUpdateParamsConfigurationMerchantBranding"] """ @@ -300,7 +299,7 @@ class AccountUpdateParamsConfigurationMerchant(TypedDict): """ mcc: NotRequired[str] """ - The merchant category code for the merchant. MCCs are used to classify businesses based on the goods or services they provide. + The Merchant Category Code (MCC) for the merchant. MCCs classify businesses based on the goods or services they provide. """ script_statement_descriptor: NotRequired[ "AccountUpdateParamsConfigurationMerchantScriptStatementDescriptor" @@ -312,7 +311,7 @@ class AccountUpdateParamsConfigurationMerchant(TypedDict): "AccountUpdateParamsConfigurationMerchantStatementDescriptor" ] """ - Statement descriptor. + Settings for the default [statement descriptor](https://docs.stripe.com/connect/statement-descriptors) text. """ support: NotRequired["AccountUpdateParamsConfigurationMerchantSupport"] """ @@ -323,7 +322,7 @@ class AccountUpdateParamsConfigurationMerchant(TypedDict): class AccountUpdateParamsConfigurationMerchantBacsDebitPayments(TypedDict): display_name: NotRequired[str] """ - Display name for Bacs debit payments. + Display name for Bacs Direct Debit payments. """ @@ -1172,7 +1171,7 @@ class AccountUpdateParamsConfigurationMerchantSupportAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -1263,7 +1262,7 @@ class AccountUpdateParamsConfigurationRecipientCapabilitiesStripeBalance( "AccountUpdateParamsConfigurationRecipientCapabilitiesStripeBalanceStripeTransfers" ] """ - Allows the account to receive /v1/transfers into their Stripe Balance (/v1/balance). + Enables this Account to receive /v1/transfers into their Stripe Balance (/v1/balance). """ @@ -1853,7 +1852,7 @@ class AccountUpdateParamsIdentityBusinessDetails(TypedDict): """ estimated_worker_count: NotRequired[int] """ - An estimated upper bound of employees, contractors, vendors, etc. currently working for the business. + Estimated maximum number of workers currently engaged by the business (including employees, contractors, and vendors). """ id_numbers: NotRequired[ List["AccountUpdateParamsIdentityBusinessDetailsIdNumber"] @@ -1950,12 +1949,14 @@ class AccountUpdateParamsIdentityBusinessDetailsAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ class AccountUpdateParamsIdentityBusinessDetailsAnnualRevenue(TypedDict): - amount: NotRequired[AmountParam] + amount: NotRequired[ + "AccountUpdateParamsIdentityBusinessDetailsAnnualRevenueAmount" + ] """ A non-negative integer representing the amount in the smallest currency unit. """ @@ -1965,6 +1966,17 @@ class AccountUpdateParamsIdentityBusinessDetailsAnnualRevenue(TypedDict): """ +class AccountUpdateParamsIdentityBusinessDetailsAnnualRevenueAmount(TypedDict): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class AccountUpdateParamsIdentityBusinessDetailsDocuments(TypedDict): bank_account_ownership_verification: NotRequired[ "AccountUpdateParamsIdentityBusinessDetailsDocumentsBankAccountOwnershipVerification" @@ -2182,70 +2194,111 @@ class AccountUpdateParamsIdentityBusinessDetailsIdNumber(TypedDict): "ao_nif", "ar_cuit", "at_fn", + "at_stn", + "at_vat", "au_abn", "au_acn", "au_in", "az_tin", "bd_etin", "be_cbe", + "be_vat", "bg_uic", + "bg_vat", "br_cnpj", "ca_cn", "ca_crarr", + "ca_gst_hst", "ca_neq", "ca_rid", "ch_chid", "ch_uid", "cr_cpj", "cr_nite", + "cy_he", "cy_tic", + "cy_vat", "cz_ico", + "cz_vat", "de_hrn", + "de_stn", "de_vat", "dk_cvr", + "dk_vat", "do_rcn", "ee_rk", + "ee_vat", "es_cif", + "es_vat", + "fi_vat", "fi_yt", + "fr_rna", "fr_siren", "fr_vat", "gb_crn", "gi_crn", + "gr_afm", "gr_gemi", + "gr_vat", "gt_nit", "hk_br", "hk_cr", - "hk_mbs", + "hr_mbs", + "hr_oib", + "hr_vat", "hu_cjs", + "hu_tin", + "hu_vat", "ie_crn", + "ie_trn", + "ie_vat", "it_rea", "it_vat", "jp_cn", "kz_bin", "li_uid", "lt_ccrn", + "lt_vat", + "lu_nif", "lu_rcs", + "lu_vat", "lv_urn", + "lv_vat", "mt_crn", + "mt_tin", + "mt_vat", "mx_rfc", "my_brn", "my_coid", + "my_itn", "my_sst", "mz_nuit", "nl_kvk", + "nl_rsin", + "nl_vat", "no_orgnr", "nz_bn", + "nz_ird", "pe_ruc", "pk_ntn", + "pl_nip", "pl_regon", + "pl_vat", "pt_vat", "ro_cui", + "ro_orc", + "ro_vat", "sa_crn", "sa_tin", "se_orgnr", + "se_vat", "sg_uen", "si_msp", + "si_tin", + "si_vat", + "sk_dic", "sk_ico", + "sk_vat", "th_crn", "th_prn", "th_tin", @@ -2263,12 +2316,27 @@ class AccountUpdateParamsIdentityBusinessDetailsIdNumber(TypedDict): class AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenue( TypedDict, ): - amount: NotRequired[AmountParam] + amount: NotRequired[ + "AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount" + ] """ A non-negative integer representing the amount in the smallest currency unit. """ +class AccountUpdateParamsIdentityBusinessDetailsMonthlyEstimatedRevenueAmount( + TypedDict, +): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class AccountUpdateParamsIdentityBusinessDetailsScriptAddresses(TypedDict): kana: NotRequired[ "AccountUpdateParamsIdentityBusinessDetailsScriptAddressesKana" @@ -2311,7 +2379,7 @@ class AccountUpdateParamsIdentityBusinessDetailsScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2344,7 +2412,7 @@ class AccountUpdateParamsIdentityBusinessDetailsScriptAddressesKanji( """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2493,7 +2561,7 @@ class AccountUpdateParamsIdentityIndividualAdditionalAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2543,7 +2611,7 @@ class AccountUpdateParamsIdentityIndividualAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2684,36 +2752,81 @@ class AccountUpdateParamsIdentityIndividualIdNumber(TypedDict): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -2789,7 +2902,7 @@ class AccountUpdateParamsIdentityIndividualScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -2820,7 +2933,7 @@ class AccountUpdateParamsIdentityIndividualScriptAddressesKanji(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ diff --git a/stripe/params/v2/core/accounts/_person_create_params.py b/stripe/params/v2/core/accounts/_person_create_params.py index 74bdd6bc6..2c8bd0cda 100644 --- a/stripe/params/v2/core/accounts/_person_create_params.py +++ b/stripe/params/v2/core/accounts/_person_create_params.py @@ -118,7 +118,7 @@ class PersonCreateParamsAdditionalAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -190,7 +190,7 @@ class PersonCreateParamsAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -319,36 +319,81 @@ class PersonCreateParamsIdNumber(TypedDict): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -362,7 +407,7 @@ class PersonCreateParamsIdNumber(TypedDict): class PersonCreateParamsRelationship(TypedDict): authorizer: NotRequired[bool] """ - Whether the individual is an authorizer of the Account's legal entity. + Whether the individual is an authorizer of the Account's identity. """ director: NotRequired[bool] """ @@ -432,7 +477,7 @@ class PersonCreateParamsScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -463,7 +508,7 @@ class PersonCreateParamsScriptAddressesKanji(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ diff --git a/stripe/params/v2/core/accounts/_person_token_create_params.py b/stripe/params/v2/core/accounts/_person_token_create_params.py index 75d4fc894..846020361 100644 --- a/stripe/params/v2/core/accounts/_person_token_create_params.py +++ b/stripe/params/v2/core/accounts/_person_token_create_params.py @@ -116,7 +116,7 @@ class PersonTokenCreateParamsAdditionalAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -182,7 +182,7 @@ class PersonTokenCreateParamsAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -315,36 +315,81 @@ class PersonTokenCreateParamsIdNumber(TypedDict): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -358,7 +403,7 @@ class PersonTokenCreateParamsIdNumber(TypedDict): class PersonTokenCreateParamsRelationship(TypedDict): authorizer: NotRequired[bool] """ - Whether the individual is an authorizer of the Account's legal entity. + Whether the individual is an authorizer of the Account's identity. """ director: NotRequired[bool] """ @@ -428,7 +473,7 @@ class PersonTokenCreateParamsScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -459,7 +504,7 @@ class PersonTokenCreateParamsScriptAddressesKanji(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ diff --git a/stripe/params/v2/core/accounts/_person_update_params.py b/stripe/params/v2/core/accounts/_person_update_params.py index f6a08b422..a56cca6f8 100644 --- a/stripe/params/v2/core/accounts/_person_update_params.py +++ b/stripe/params/v2/core/accounts/_person_update_params.py @@ -118,7 +118,7 @@ class PersonUpdateParamsAdditionalAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -190,7 +190,7 @@ class PersonUpdateParamsAddress(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -319,36 +319,81 @@ class PersonUpdateParamsIdNumber(TypedDict): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -362,7 +407,7 @@ class PersonUpdateParamsIdNumber(TypedDict): class PersonUpdateParamsRelationship(TypedDict): authorizer: NotRequired[bool] """ - Whether the individual is an authorizer of the Account's legal entity. + Whether the individual is an authorizer of the Account's identity. """ director: NotRequired[bool] """ @@ -432,7 +477,7 @@ class PersonUpdateParamsScriptAddressesKana(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ @@ -463,7 +508,7 @@ class PersonUpdateParamsScriptAddressesKanji(TypedDict): """ town: NotRequired[str] """ - Town or cho-me. + Town or district. """ diff --git a/stripe/params/v2/money_management/__init__.py b/stripe/params/v2/money_management/__init__.py index f8dd9ccf7..dc9dc1c1e 100644 --- a/stripe/params/v2/money_management/__init__.py +++ b/stripe/params/v2/money_management/__init__.py @@ -38,6 +38,7 @@ ) from stripe.params.v2.money_management._inbound_transfer_create_params import ( InboundTransferCreateParams as InboundTransferCreateParams, + InboundTransferCreateParamsAmount as InboundTransferCreateParamsAmount, InboundTransferCreateParamsFrom as InboundTransferCreateParamsFrom, InboundTransferCreateParamsTo as InboundTransferCreateParamsTo, ) @@ -52,6 +53,7 @@ ) from stripe.params.v2.money_management._outbound_payment_create_params import ( OutboundPaymentCreateParams as OutboundPaymentCreateParams, + OutboundPaymentCreateParamsAmount as OutboundPaymentCreateParamsAmount, OutboundPaymentCreateParamsDeliveryOptions as OutboundPaymentCreateParamsDeliveryOptions, OutboundPaymentCreateParamsFrom as OutboundPaymentCreateParamsFrom, OutboundPaymentCreateParamsRecipientNotification as OutboundPaymentCreateParamsRecipientNotification, @@ -62,6 +64,7 @@ ) from stripe.params.v2.money_management._outbound_payment_quote_create_params import ( OutboundPaymentQuoteCreateParams as OutboundPaymentQuoteCreateParams, + OutboundPaymentQuoteCreateParamsAmount as OutboundPaymentQuoteCreateParamsAmount, OutboundPaymentQuoteCreateParamsDeliveryOptions as OutboundPaymentQuoteCreateParamsDeliveryOptions, OutboundPaymentQuoteCreateParamsFrom as OutboundPaymentQuoteCreateParamsFrom, OutboundPaymentQuoteCreateParamsTo as OutboundPaymentQuoteCreateParamsTo, @@ -98,6 +101,7 @@ ) from stripe.params.v2.money_management._outbound_transfer_create_params import ( OutboundTransferCreateParams as OutboundTransferCreateParams, + OutboundTransferCreateParamsAmount as OutboundTransferCreateParamsAmount, OutboundTransferCreateParamsDeliveryOptions as OutboundTransferCreateParamsDeliveryOptions, OutboundTransferCreateParamsFrom as OutboundTransferCreateParamsFrom, OutboundTransferCreateParamsTo as OutboundTransferCreateParamsTo, @@ -203,6 +207,10 @@ "stripe.params.v2.money_management._inbound_transfer_create_params", False, ), + "InboundTransferCreateParamsAmount": ( + "stripe.params.v2.money_management._inbound_transfer_create_params", + False, + ), "InboundTransferCreateParamsFrom": ( "stripe.params.v2.money_management._inbound_transfer_create_params", False, @@ -227,6 +235,10 @@ "stripe.params.v2.money_management._outbound_payment_create_params", False, ), + "OutboundPaymentCreateParamsAmount": ( + "stripe.params.v2.money_management._outbound_payment_create_params", + False, + ), "OutboundPaymentCreateParamsDeliveryOptions": ( "stripe.params.v2.money_management._outbound_payment_create_params", False, @@ -251,6 +263,10 @@ "stripe.params.v2.money_management._outbound_payment_quote_create_params", False, ), + "OutboundPaymentQuoteCreateParamsAmount": ( + "stripe.params.v2.money_management._outbound_payment_quote_create_params", + False, + ), "OutboundPaymentQuoteCreateParamsDeliveryOptions": ( "stripe.params.v2.money_management._outbound_payment_quote_create_params", False, @@ -323,6 +339,10 @@ "stripe.params.v2.money_management._outbound_transfer_create_params", False, ), + "OutboundTransferCreateParamsAmount": ( + "stripe.params.v2.money_management._outbound_transfer_create_params", + False, + ), "OutboundTransferCreateParamsDeliveryOptions": ( "stripe.params.v2.money_management._outbound_transfer_create_params", False, diff --git a/stripe/params/v2/money_management/_inbound_transfer_create_params.py b/stripe/params/v2/money_management/_inbound_transfer_create_params.py index db5250ed2..6d32f1730 100644 --- a/stripe/params/v2/money_management/_inbound_transfer_create_params.py +++ b/stripe/params/v2/money_management/_inbound_transfer_create_params.py @@ -1,6 +1,5 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing_extensions import NotRequired, TypedDict _InboundTransferCreateParamsBase = TypedDict( @@ -10,7 +9,7 @@ class InboundTransferCreateParams(_InboundTransferCreateParamsBase): - amount: AmountParam + amount: "InboundTransferCreateParamsAmount" """ The amount, in specified currency, by which the FinancialAccount balance will increase due to the InboundTransfer. """ @@ -24,6 +23,17 @@ class InboundTransferCreateParams(_InboundTransferCreateParamsBase): """ +class InboundTransferCreateParamsAmount(TypedDict): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class InboundTransferCreateParamsFrom(TypedDict): currency: NotRequired[str] """ diff --git a/stripe/params/v2/money_management/_outbound_payment_create_params.py b/stripe/params/v2/money_management/_outbound_payment_create_params.py index 819395958..99202b6bb 100644 --- a/stripe/params/v2/money_management/_outbound_payment_create_params.py +++ b/stripe/params/v2/money_management/_outbound_payment_create_params.py @@ -1,6 +1,5 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing import Dict from typing_extensions import Literal, NotRequired, TypedDict @@ -11,7 +10,7 @@ class OutboundPaymentCreateParams(_OutboundPaymentCreateParamsBase): - amount: AmountParam + amount: "OutboundPaymentCreateParamsAmount" """ The "presentment amount" to be sent to the recipient. """ @@ -43,6 +42,17 @@ class OutboundPaymentCreateParams(_OutboundPaymentCreateParamsBase): """ +class OutboundPaymentCreateParamsAmount(TypedDict): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class OutboundPaymentCreateParamsDeliveryOptions(TypedDict): bank_account: NotRequired[Literal["automatic", "local", "wire"]] """ diff --git a/stripe/params/v2/money_management/_outbound_payment_quote_create_params.py b/stripe/params/v2/money_management/_outbound_payment_quote_create_params.py index dda1272cd..2164459e5 100644 --- a/stripe/params/v2/money_management/_outbound_payment_quote_create_params.py +++ b/stripe/params/v2/money_management/_outbound_payment_quote_create_params.py @@ -1,6 +1,5 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing_extensions import Literal, NotRequired, TypedDict _OutboundPaymentQuoteCreateParamsBase = TypedDict( @@ -10,7 +9,7 @@ class OutboundPaymentQuoteCreateParams(_OutboundPaymentQuoteCreateParamsBase): - amount: AmountParam + amount: "OutboundPaymentQuoteCreateParamsAmount" """ The "presentment amount" to be sent to the recipient. """ @@ -26,6 +25,17 @@ class OutboundPaymentQuoteCreateParams(_OutboundPaymentQuoteCreateParamsBase): """ +class OutboundPaymentQuoteCreateParamsAmount(TypedDict): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class OutboundPaymentQuoteCreateParamsDeliveryOptions(TypedDict): bank_account: NotRequired[Literal["automatic", "local", "wire"]] """ diff --git a/stripe/params/v2/money_management/_outbound_transfer_create_params.py b/stripe/params/v2/money_management/_outbound_transfer_create_params.py index 5955628f4..fef4e5eee 100644 --- a/stripe/params/v2/money_management/_outbound_transfer_create_params.py +++ b/stripe/params/v2/money_management/_outbound_transfer_create_params.py @@ -1,6 +1,5 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing import Dict from typing_extensions import Literal, NotRequired, TypedDict @@ -11,7 +10,7 @@ class OutboundTransferCreateParams(_OutboundTransferCreateParamsBase): - amount: AmountParam + amount: "OutboundTransferCreateParamsAmount" """ The "presentment amount" for the OutboundPayment. """ @@ -35,6 +34,17 @@ class OutboundTransferCreateParams(_OutboundTransferCreateParamsBase): """ +class OutboundTransferCreateParamsAmount(TypedDict): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + + class OutboundTransferCreateParamsDeliveryOptions(TypedDict): bank_account: NotRequired[Literal["automatic", "local", "wire"]] """ diff --git a/stripe/params/v2/test_helpers/__init__.py b/stripe/params/v2/test_helpers/__init__.py index 07c7ea915..9a48a10c7 100644 --- a/stripe/params/v2/test_helpers/__init__.py +++ b/stripe/params/v2/test_helpers/__init__.py @@ -6,6 +6,7 @@ if TYPE_CHECKING: from stripe.params.v2.test_helpers._financial_address_credit_params import ( FinancialAddressCreditParams as FinancialAddressCreditParams, + FinancialAddressCreditParamsAmount as FinancialAddressCreditParamsAmount, ) from stripe.params.v2.test_helpers._financial_address_generate_microdeposits_params import ( FinancialAddressGenerateMicrodepositsParams as FinancialAddressGenerateMicrodepositsParams, @@ -17,6 +18,10 @@ "stripe.params.v2.test_helpers._financial_address_credit_params", False, ), + "FinancialAddressCreditParamsAmount": ( + "stripe.params.v2.test_helpers._financial_address_credit_params", + False, + ), "FinancialAddressGenerateMicrodepositsParams": ( "stripe.params.v2.test_helpers._financial_address_generate_microdeposits_params", False, diff --git a/stripe/params/v2/test_helpers/_financial_address_credit_params.py b/stripe/params/v2/test_helpers/_financial_address_credit_params.py index 99625b139..b4e5823d8 100644 --- a/stripe/params/v2/test_helpers/_financial_address_credit_params.py +++ b/stripe/params/v2/test_helpers/_financial_address_credit_params.py @@ -1,11 +1,10 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec -from stripe.v2._amount import AmountParam from typing_extensions import Literal, NotRequired, TypedDict class FinancialAddressCreditParams(TypedDict): - amount: AmountParam + amount: "FinancialAddressCreditParamsAmount" """ Object containing the amount value and currency to credit. """ @@ -17,3 +16,14 @@ class FinancialAddressCreditParams(TypedDict): """ String explaining funds flow. Use this field to populate the statement descriptor of the ReceivedCredit created as an eventual result of this simulation. """ + + +class FinancialAddressCreditParamsAmount(TypedDict): + value: NotRequired[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + currency: NotRequired[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ diff --git a/stripe/radar/_early_fraud_warning.py b/stripe/radar/_early_fraud_warning.py index 14d60429d..63defa05f 100644 --- a/stripe/radar/_early_fraud_warning.py +++ b/stripe/radar/_early_fraud_warning.py @@ -22,7 +22,7 @@ class EarlyFraudWarning(ListableAPIResource["EarlyFraudWarning"]): 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://docs.stripe.com/disputes/measuring#early-fraud-warnings) """ OBJECT_NAME: ClassVar[Literal["radar.early_fraud_warning"]] = ( diff --git a/stripe/radar/_value_list.py b/stripe/radar/_value_list.py index eb9623d1a..6192c53d5 100644 --- a/stripe/radar/_value_list.py +++ b/stripe/radar/_value_list.py @@ -35,7 +35,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://docs.stripe.com/radar/lists#managing-list-items) """ OBJECT_NAME: ClassVar[Literal["radar.value_list"]] = "radar.value_list" @@ -84,7 +84,7 @@ class ValueList( """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ name: str """ diff --git a/stripe/radar/_value_list_item.py b/stripe/radar/_value_list_item.py index 6ef11fe6f..8c680a31b 100644 --- a/stripe/radar/_value_list_item.py +++ b/stripe/radar/_value_list_item.py @@ -31,7 +31,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://docs.stripe.com/radar/lists#managing-list-items) """ OBJECT_NAME: ClassVar[Literal["radar.value_list_item"]] = ( diff --git a/stripe/reporting/_report_run.py b/stripe/reporting/_report_run.py index aba84bc9a..3eda46c25 100644 --- a/stripe/reporting/_report_run.py +++ b/stripe/reporting/_report_run.py @@ -29,10 +29,10 @@ class ReportRun( specific run parameters. Once the object is created, Stripe begins processing the report. When the report has finished running, it will give you a reference to a file where you can retrieve your results. For an overview, see - [API Access to Reports](https://stripe.com/docs/reporting/statements/api). + [API Access to Reports](https://docs.stripe.com/reporting/statements/api). Note that certain report types can only be run based on your live-mode data (not test-mode - data), and will error when queried without a [live-mode API key](https://stripe.com/docs/keys#test-live-modes). + data), and will error when queried without a [live-mode API key](https://docs.stripe.com/keys#test-live-modes). """ OBJECT_NAME: ClassVar[Literal["reporting.report_run"]] = ( @@ -97,7 +97,7 @@ class Parameters(StripeObject): parameters: Parameters report_type: str """ - The ID of the [report type](https://stripe.com/docs/reports/report-types) to run, such as `"balance.summary.1"`. + The ID of the [report type](https://docs.stripe.com/reports/report-types) to run, such as `"balance.summary.1"`. """ result: Optional["File"] """ diff --git a/stripe/reporting/_report_type.py b/stripe/reporting/_report_type.py index 8d765a769..1cf2a57f2 100644 --- a/stripe/reporting/_report_type.py +++ b/stripe/reporting/_report_type.py @@ -19,11 +19,11 @@ class ReportType(ListableAPIResource["ReportType"]): The Report Type resource corresponds to a particular type of report, such as the "Activity summary" or "Itemized payouts" reports. These objects are identified by an ID belonging to a set of enumerated values. See - [API Access to Reports documentation](https://stripe.com/docs/reporting/statements/api) + [API Access to Reports documentation](https://docs.stripe.com/reporting/statements/api) for those Report Type IDs, along with required and optional parameters. Note that certain report types can only be run based on your live-mode data (not test-mode - data), and will error when queried without a [live-mode API key](https://stripe.com/docs/keys#test-live-modes). + data), and will error when queried without a [live-mode API key](https://docs.stripe.com/keys#test-live-modes). """ OBJECT_NAME: ClassVar[Literal["reporting.report_type"]] = ( @@ -43,7 +43,7 @@ class ReportType(ListableAPIResource["ReportType"]): """ id: str """ - The [ID of the Report Type](https://stripe.com/docs/reporting/statements/api#available-report-types), such as `balance.summary.1`. + The [ID of the Report Type](https://docs.stripe.com/reporting/statements/api#available-report-types), such as `balance.summary.1`. """ livemode: bool """ diff --git a/stripe/reserve/__init__.py b/stripe/reserve/__init__.py new file mode 100644 index 000000000..46a5000a3 --- /dev/null +++ b/stripe/reserve/__init__.py @@ -0,0 +1,39 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from importlib import import_module +from typing_extensions import TYPE_CHECKING + +if TYPE_CHECKING: + from stripe.reserve._hold import Hold as Hold + from stripe.reserve._hold_service import HoldService as HoldService + from stripe.reserve._plan import Plan as Plan + from stripe.reserve._plan_service import PlanService as PlanService + from stripe.reserve._release import Release as Release + from stripe.reserve._release_service import ( + ReleaseService as ReleaseService, + ) + +# name -> (import_target, is_submodule) +_import_map = { + "Hold": ("stripe.reserve._hold", False), + "HoldService": ("stripe.reserve._hold_service", False), + "Plan": ("stripe.reserve._plan", False), + "PlanService": ("stripe.reserve._plan_service", False), + "Release": ("stripe.reserve._release", False), + "ReleaseService": ("stripe.reserve._release_service", False), +} +if not TYPE_CHECKING: + + def __getattr__(name): + try: + target, is_submodule = _import_map[name] + module = import_module(target) + if is_submodule: + return module + + return getattr( + module, + name, + ) + except KeyError: + raise AttributeError() diff --git a/stripe/reserve/_hold.py b/stripe/reserve/_hold.py new file mode 100644 index 000000000..bb2a5ac67 --- /dev/null +++ b/stripe/reserve/_hold.py @@ -0,0 +1,152 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._expandable_field import ExpandableField +from stripe._list_object import ListObject +from stripe._listable_api_resource import ListableAPIResource +from stripe._stripe_object import StripeObject +from typing import ClassVar, Dict, Optional +from typing_extensions import Literal, Unpack, TYPE_CHECKING + +if TYPE_CHECKING: + from stripe._charge import Charge + from stripe.params.reserve._hold_list_params import HoldListParams + from stripe.params.reserve._hold_retrieve_params import HoldRetrieveParams + from stripe.reserve._plan import Plan + + +class Hold(ListableAPIResource["Hold"]): + """ + ReserveHolds are used to place a temporary ReserveHold on a merchant's funds. + """ + + OBJECT_NAME: ClassVar[Literal["reserve.hold"]] = "reserve.hold" + + class ReleaseSchedule(StripeObject): + release_after: Optional[int] + """ + The time after which the ReserveHold is requested to be released. + """ + scheduled_release: Optional[int] + """ + The time at which the ReserveHold is scheduled to be released, automatically set to midnight UTC of the day after `release_after`. + """ + + amount: int + """ + Amount reserved. A positive integer representing how much is reserved in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). + """ + amount_releasable: Optional[int] + """ + Amount in cents that can be released from this ReserveHold + """ + created: int + """ + Time at which the object was created. Measured in seconds since the Unix epoch. + """ + created_by: Literal["application", "stripe"] + """ + Indicates which party created this ReserveHold. + """ + currency: str + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + id: str + """ + Unique identifier for the object. + """ + is_releasable: Optional[bool] + """ + Whether there are any funds available to release on this ReserveHold. Note that if the ReserveHold is in the process of being released, this could be false, even though the funds haven't been fully released yet. + """ + livemode: bool + """ + Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. + """ + metadata: Optional[Dict[str, str]] + """ + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + """ + object: Literal["reserve.hold"] + """ + String representing the object's type. Objects of the same type share the same value. + """ + reason: Literal["charge", "standalone"] + """ + The reason for the ReserveHold. + """ + release_schedule: ReleaseSchedule + reserve_plan: Optional[ExpandableField["Plan"]] + """ + The ReservePlan which produced this ReserveHold (i.e., resplan_123) + """ + source_charge: Optional[ExpandableField["Charge"]] + """ + The Charge which funded this ReserveHold (e.g., ch_123) + """ + source_type: Literal["bank_account", "card", "fpx"] + """ + Which source balance type this ReserveHold reserves funds from. One of `bank_account`, `card`, or `fpx`. + """ + + @classmethod + def list(cls, **params: Unpack["HoldListParams"]) -> ListObject["Hold"]: + """ + Returns a list of ReserveHolds previously created. The ReserveHolds are returned in sorted order, with the most recent ReserveHolds appearing first. + """ + result = cls._static_request( + "get", + cls.class_url(), + params=params, + ) + if not isinstance(result, ListObject): + raise TypeError( + "Expected list object from API, got %s" + % (type(result).__name__) + ) + + return result + + @classmethod + async def list_async( + cls, **params: Unpack["HoldListParams"] + ) -> ListObject["Hold"]: + """ + Returns a list of ReserveHolds previously created. The ReserveHolds are returned in sorted order, with the most recent ReserveHolds appearing first. + """ + result = await cls._static_request_async( + "get", + cls.class_url(), + params=params, + ) + if not isinstance(result, ListObject): + raise TypeError( + "Expected list object from API, got %s" + % (type(result).__name__) + ) + + return result + + @classmethod + def retrieve( + cls, id: str, **params: Unpack["HoldRetrieveParams"] + ) -> "Hold": + """ + Retrieve a ReserveHold. + """ + instance = cls(id, **params) + instance.refresh() + return instance + + @classmethod + async def retrieve_async( + cls, id: str, **params: Unpack["HoldRetrieveParams"] + ) -> "Hold": + """ + Retrieve a ReserveHold. + """ + instance = cls(id, **params) + await instance.refresh_async() + return instance + + _inner_class_types = {"release_schedule": ReleaseSchedule} diff --git a/stripe/reserve/_hold_service.py b/stripe/reserve/_hold_service.py new file mode 100644 index 000000000..16de9bc3e --- /dev/null +++ b/stripe/reserve/_hold_service.py @@ -0,0 +1,93 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._stripe_service import StripeService +from stripe._util import sanitize_id +from typing import Optional, cast +from typing_extensions import TYPE_CHECKING + +if TYPE_CHECKING: + from stripe._list_object import ListObject + from stripe._request_options import RequestOptions + from stripe.params.reserve._hold_list_params import HoldListParams + from stripe.params.reserve._hold_retrieve_params import HoldRetrieveParams + from stripe.reserve._hold import Hold + + +class HoldService(StripeService): + def list( + self, + params: Optional["HoldListParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "ListObject[Hold]": + """ + Returns a list of ReserveHolds previously created. The ReserveHolds are returned in sorted order, with the most recent ReserveHolds appearing first. + """ + return cast( + "ListObject[Hold]", + self._request( + "get", + "/v1/reserve/holds", + base_address="api", + params=params, + options=options, + ), + ) + + async def list_async( + self, + params: Optional["HoldListParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "ListObject[Hold]": + """ + Returns a list of ReserveHolds previously created. The ReserveHolds are returned in sorted order, with the most recent ReserveHolds appearing first. + """ + return cast( + "ListObject[Hold]", + await self._request_async( + "get", + "/v1/reserve/holds", + base_address="api", + params=params, + options=options, + ), + ) + + def retrieve( + self, + id: str, + params: Optional["HoldRetrieveParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "Hold": + """ + Retrieve a ReserveHold. + """ + return cast( + "Hold", + self._request( + "get", + "/v1/reserve/holds/{id}".format(id=sanitize_id(id)), + base_address="api", + params=params, + options=options, + ), + ) + + async def retrieve_async( + self, + id: str, + params: Optional["HoldRetrieveParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "Hold": + """ + Retrieve a ReserveHold. + """ + return cast( + "Hold", + await self._request_async( + "get", + "/v1/reserve/holds/{id}".format(id=sanitize_id(id)), + base_address="api", + params=params, + options=options, + ), + ) diff --git a/stripe/reserve/_plan.py b/stripe/reserve/_plan.py new file mode 100644 index 000000000..fefe87453 --- /dev/null +++ b/stripe/reserve/_plan.py @@ -0,0 +1,111 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._api_resource import APIResource +from stripe._stripe_object import StripeObject +from typing import ClassVar, Dict, Optional +from typing_extensions import Literal, Unpack, TYPE_CHECKING + +if TYPE_CHECKING: + from stripe.params.reserve._plan_retrieve_params import PlanRetrieveParams + + +class Plan(APIResource["Plan"]): + """ + ReservePlans are used to automatically place holds on a merchant's funds until the plan expires. It takes a portion of each incoming Charge (including those resulting from a Transfer from a platform account). + """ + + OBJECT_NAME: ClassVar[Literal["reserve.plan"]] = "reserve.plan" + + class FixedRelease(StripeObject): + release_after: int + """ + The time after which all reserved funds are requested for release. + """ + scheduled_release: int + """ + The time at which reserved funds are scheduled for release, automatically set to midnight UTC of the day after `release_after`. + """ + + class RollingRelease(StripeObject): + days_after_charge: int + """ + The number of days to reserve funds before releasing. + """ + expires_on: Optional[int] + """ + The time at which the ReservePlan expires. + """ + + created: int + """ + Time at which the object was created. Measured in seconds since the Unix epoch. + """ + created_by: Literal["application", "stripe"] + """ + Indicates which party created this ReservePlan. + """ + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). An unset currency indicates that the plan applies to all currencies. + """ + disabled_at: Optional[int] + """ + Time at which the ReservePlan was disabled. + """ + fixed_release: Optional[FixedRelease] + id: str + """ + Unique identifier for the object. + """ + livemode: bool + """ + Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. + """ + metadata: Optional[Dict[str, str]] + """ + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + """ + object: Literal["reserve.plan"] + """ + String representing the object's type. Objects of the same type share the same value. + """ + percent: int + """ + The percent of each Charge to reserve. + """ + rolling_release: Optional[RollingRelease] + status: Literal["active", "disabled", "expired"] + """ + The current status of the ReservePlan. The ReservePlan only affects charges if it is `active`. + """ + type: Literal["fixed_release", "rolling_release"] + """ + The type of the ReservePlan. + """ + + @classmethod + def retrieve( + cls, id: str, **params: Unpack["PlanRetrieveParams"] + ) -> "Plan": + """ + Retrieve a ReservePlan. + """ + instance = cls(id, **params) + instance.refresh() + return instance + + @classmethod + async def retrieve_async( + cls, id: str, **params: Unpack["PlanRetrieveParams"] + ) -> "Plan": + """ + Retrieve a ReservePlan. + """ + instance = cls(id, **params) + await instance.refresh_async() + return instance + + _inner_class_types = { + "fixed_release": FixedRelease, + "rolling_release": RollingRelease, + } diff --git a/stripe/reserve/_plan_service.py b/stripe/reserve/_plan_service.py new file mode 100644 index 000000000..c33d93a51 --- /dev/null +++ b/stripe/reserve/_plan_service.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._stripe_service import StripeService +from stripe._util import sanitize_id +from typing import Optional, cast +from typing_extensions import TYPE_CHECKING + +if TYPE_CHECKING: + from stripe._request_options import RequestOptions + from stripe.params.reserve._plan_retrieve_params import PlanRetrieveParams + from stripe.reserve._plan import Plan + + +class PlanService(StripeService): + def retrieve( + self, + id: str, + params: Optional["PlanRetrieveParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "Plan": + """ + Retrieve a ReservePlan. + """ + return cast( + "Plan", + self._request( + "get", + "/v1/reserve/plans/{id}".format(id=sanitize_id(id)), + base_address="api", + params=params, + options=options, + ), + ) + + async def retrieve_async( + self, + id: str, + params: Optional["PlanRetrieveParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "Plan": + """ + Retrieve a ReservePlan. + """ + return cast( + "Plan", + await self._request_async( + "get", + "/v1/reserve/plans/{id}".format(id=sanitize_id(id)), + base_address="api", + params=params, + options=options, + ), + ) diff --git a/stripe/reserve/_release.py b/stripe/reserve/_release.py new file mode 100644 index 000000000..e82474628 --- /dev/null +++ b/stripe/reserve/_release.py @@ -0,0 +1,159 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._expandable_field import ExpandableField +from stripe._list_object import ListObject +from stripe._listable_api_resource import ListableAPIResource +from stripe._stripe_object import StripeObject +from typing import ClassVar, Dict, Optional +from typing_extensions import Literal, Unpack, TYPE_CHECKING + +if TYPE_CHECKING: + from stripe._dispute import Dispute + from stripe._refund import Refund + from stripe.params.reserve._release_list_params import ReleaseListParams + from stripe.params.reserve._release_retrieve_params import ( + ReleaseRetrieveParams, + ) + from stripe.reserve._hold import Hold + from stripe.reserve._plan import Plan + + +class Release(ListableAPIResource["Release"]): + """ + ReserveReleases represent the release of funds from a ReserveHold. + """ + + OBJECT_NAME: ClassVar[Literal["reserve.release"]] = "reserve.release" + + class SourceTransaction(StripeObject): + dispute: Optional[ExpandableField["Dispute"]] + """ + The ID of the dispute. + """ + refund: Optional[ExpandableField["Refund"]] + """ + The ID of the refund. + """ + type: Literal["dispute", "refund"] + """ + The type of source transaction. + """ + + amount: int + """ + Amount released. A positive integer representing how much is released in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). + """ + created: int + """ + Time at which the object was created. Measured in seconds since the Unix epoch. + """ + created_by: Literal["application", "stripe"] + """ + Indicates which party created this ReserveRelease. + """ + currency: str + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + id: str + """ + Unique identifier for the object. + """ + livemode: bool + """ + Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode. + """ + metadata: Optional[Dict[str, str]] + """ + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + """ + object: Literal["reserve.release"] + """ + String representing the object's type. Objects of the same type share the same value. + """ + reason: Literal[ + "bulk_hold_expiry", + "hold_released_early", + "hold_reversed", + "plan_disabled", + ] + """ + The reason for the ReserveRelease, indicating why the funds were released. + """ + released_at: int + """ + The release timestamp of the funds. + """ + reserve_hold: Optional[ExpandableField["Hold"]] + """ + The ReserveHold this ReserveRelease is associated with. + """ + reserve_plan: Optional[ExpandableField["Plan"]] + """ + The ReservePlan ID this ReserveRelease is associated with. This field is only populated if a ReserveRelease is created by a ReservePlan disable operation, or from a scheduled ReservedHold expiry. + """ + source_transaction: Optional[SourceTransaction] + + @classmethod + def list( + cls, **params: Unpack["ReleaseListParams"] + ) -> ListObject["Release"]: + """ + Returns a list of ReserveReleases previously created. The ReserveReleases are returned in sorted order, with the most recent ReserveReleases appearing first. + """ + result = cls._static_request( + "get", + cls.class_url(), + params=params, + ) + if not isinstance(result, ListObject): + raise TypeError( + "Expected list object from API, got %s" + % (type(result).__name__) + ) + + return result + + @classmethod + async def list_async( + cls, **params: Unpack["ReleaseListParams"] + ) -> ListObject["Release"]: + """ + Returns a list of ReserveReleases previously created. The ReserveReleases are returned in sorted order, with the most recent ReserveReleases appearing first. + """ + result = await cls._static_request_async( + "get", + cls.class_url(), + params=params, + ) + if not isinstance(result, ListObject): + raise TypeError( + "Expected list object from API, got %s" + % (type(result).__name__) + ) + + return result + + @classmethod + def retrieve( + cls, id: str, **params: Unpack["ReleaseRetrieveParams"] + ) -> "Release": + """ + Retrieve a ReserveRelease. + """ + instance = cls(id, **params) + instance.refresh() + return instance + + @classmethod + async def retrieve_async( + cls, id: str, **params: Unpack["ReleaseRetrieveParams"] + ) -> "Release": + """ + Retrieve a ReserveRelease. + """ + instance = cls(id, **params) + await instance.refresh_async() + return instance + + _inner_class_types = {"source_transaction": SourceTransaction} diff --git a/stripe/reserve/_release_service.py b/stripe/reserve/_release_service.py new file mode 100644 index 000000000..20f8a9c0f --- /dev/null +++ b/stripe/reserve/_release_service.py @@ -0,0 +1,95 @@ +# -*- coding: utf-8 -*- +# File generated from our OpenAPI spec +from stripe._stripe_service import StripeService +from stripe._util import sanitize_id +from typing import Optional, cast +from typing_extensions import TYPE_CHECKING + +if TYPE_CHECKING: + from stripe._list_object import ListObject + from stripe._request_options import RequestOptions + from stripe.params.reserve._release_list_params import ReleaseListParams + from stripe.params.reserve._release_retrieve_params import ( + ReleaseRetrieveParams, + ) + from stripe.reserve._release import Release + + +class ReleaseService(StripeService): + def list( + self, + params: Optional["ReleaseListParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "ListObject[Release]": + """ + Returns a list of ReserveReleases previously created. The ReserveReleases are returned in sorted order, with the most recent ReserveReleases appearing first. + """ + return cast( + "ListObject[Release]", + self._request( + "get", + "/v1/reserve/releases", + base_address="api", + params=params, + options=options, + ), + ) + + async def list_async( + self, + params: Optional["ReleaseListParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "ListObject[Release]": + """ + Returns a list of ReserveReleases previously created. The ReserveReleases are returned in sorted order, with the most recent ReserveReleases appearing first. + """ + return cast( + "ListObject[Release]", + await self._request_async( + "get", + "/v1/reserve/releases", + base_address="api", + params=params, + options=options, + ), + ) + + def retrieve( + self, + id: str, + params: Optional["ReleaseRetrieveParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "Release": + """ + Retrieve a ReserveRelease. + """ + return cast( + "Release", + self._request( + "get", + "/v1/reserve/releases/{id}".format(id=sanitize_id(id)), + base_address="api", + params=params, + options=options, + ), + ) + + async def retrieve_async( + self, + id: str, + params: Optional["ReleaseRetrieveParams"] = None, + options: Optional["RequestOptions"] = None, + ) -> "Release": + """ + Retrieve a ReserveRelease. + """ + return cast( + "Release", + await self._request_async( + "get", + "/v1/reserve/releases/{id}".format(id=sanitize_id(id)), + base_address="api", + params=params, + options=options, + ), + ) diff --git a/stripe/sigma/_scheduled_query_run.py b/stripe/sigma/_scheduled_query_run.py index 7aa8a2f25..29cae6df0 100644 --- a/stripe/sigma/_scheduled_query_run.py +++ b/stripe/sigma/_scheduled_query_run.py @@ -18,7 +18,7 @@ class ScheduledQueryRun(ListableAPIResource["ScheduledQueryRun"]): """ - If you have [scheduled a Sigma query](https://stripe.com/docs/sigma/scheduled-queries), you'll + If you have [scheduled a Sigma query](https://docs.stripe.com/sigma/scheduled-queries), you'll receive a `sigma.scheduled_query_run.created` webhook each time the query runs. The webhook contains a `ScheduledQueryRun` object, which you can use to retrieve the query results. diff --git a/stripe/tax/_association.py b/stripe/tax/_association.py index 5f3ef6bcc..a44800b1f 100644 --- a/stripe/tax/_association.py +++ b/stripe/tax/_association.py @@ -22,7 +22,7 @@ class TaxTransactionAttempt(StripeObject): class Committed(StripeObject): transaction: str """ - The [Tax Transaction](https://stripe.com/docs/api/tax/transaction/object) + The [Tax Transaction](https://docs.stripe.com/api/tax/transaction/object) """ class Errored(StripeObject): @@ -51,7 +51,7 @@ class Errored(StripeObject): calculation: str """ - The [Tax Calculation](https://stripe.com/docs/api/tax/calculations/object) that was included in PaymentIntent. + The [Tax Calculation](https://docs.stripe.com/api/tax/calculations/object) that was included in PaymentIntent. """ id: str """ @@ -63,7 +63,7 @@ class Errored(StripeObject): """ payment_intent: str """ - The [PaymentIntent](https://stripe.com/docs/api/payment_intents/object) that this Tax Association is tracking. + The [PaymentIntent](https://docs.stripe.com/api/payment_intents/object) that this Tax Association is tracking. """ tax_transaction_attempts: Optional[List[TaxTransactionAttempt]] """ diff --git a/stripe/tax/_calculation.py b/stripe/tax/_calculation.py index f3a19992c..60239a652 100644 --- a/stripe/tax/_calculation.py +++ b/stripe/tax/_calculation.py @@ -24,7 +24,7 @@ class Calculation(CreateableAPIResource["Calculation"]): """ 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://docs.stripe.com/tax/custom) """ OBJECT_NAME: ClassVar[Literal["tax.calculation"]] = "tax.calculation" @@ -285,7 +285,7 @@ class TaxRateDetails(StripeObject): amount: int """ - The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ jurisdiction: Jurisdiction sourcing: Literal["destination", "origin"] @@ -318,7 +318,7 @@ class TaxRateDetails(StripeObject): """ taxable_amount: int """ - The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ _inner_class_types = { "jurisdiction": Jurisdiction, @@ -327,15 +327,15 @@ class TaxRateDetails(StripeObject): amount: int """ - The shipping amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. + The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. """ amount_tax: int """ - The amount of tax calculated for shipping, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ shipping_rate: Optional[str] """ - The ID of an existing [ShippingRate](https://stripe.com/docs/api/shipping_rates/object). + The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object). """ tax_behavior: Literal["exclusive", "inclusive"] """ @@ -347,7 +347,7 @@ class TaxRateDetails(StripeObject): """ tax_code: str """ - The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for shipping. + The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping. """ _inner_class_types = {"tax_breakdown": TaxBreakdown} @@ -381,7 +381,7 @@ class FlatAmount(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ tax_type: Optional[ Literal[ @@ -408,7 +408,7 @@ class FlatAmount(StripeObject): amount: int """ - The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ inclusive: bool """ @@ -437,13 +437,13 @@ class FlatAmount(StripeObject): """ taxable_amount: int """ - The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ _inner_class_types = {"tax_rate_details": TaxRateDetails} amount_total: int """ - Total amount after taxes in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Total amount after taxes in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ currency: str """ @@ -451,7 +451,7 @@ class FlatAmount(StripeObject): """ customer: Optional[str] """ - The ID of an existing [Customer](https://stripe.com/docs/api/customers/object) used for the resource. + The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource. """ customer_details: CustomerDetails expires_at: Optional[int] diff --git a/stripe/tax/_calculation_line_item.py b/stripe/tax/_calculation_line_item.py index 7a62d267d..702b039e6 100644 --- a/stripe/tax/_calculation_line_item.py +++ b/stripe/tax/_calculation_line_item.py @@ -60,7 +60,7 @@ class TaxRateDetails(StripeObject): amount: int """ - The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ jurisdiction: Jurisdiction sourcing: Literal["destination", "origin"] @@ -93,7 +93,7 @@ class TaxRateDetails(StripeObject): """ taxable_amount: int """ - The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ _inner_class_types = { "jurisdiction": Jurisdiction, @@ -102,11 +102,11 @@ class TaxRateDetails(StripeObject): amount: int """ - The line item amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. + The line item amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. """ amount_tax: int """ - The amount of tax calculated for this line item, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax calculated for this line item, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ id: str """ @@ -118,7 +118,7 @@ class TaxRateDetails(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["tax.calculation_line_item"] """ @@ -126,7 +126,7 @@ class TaxRateDetails(StripeObject): """ product: Optional[str] """ - The ID of an existing [Product](https://stripe.com/docs/api/products/object). + The ID of an existing [Product](https://docs.stripe.com/api/products/object). """ quantity: int """ @@ -146,6 +146,6 @@ class TaxRateDetails(StripeObject): """ tax_code: str """ - The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for this resource. + The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource. """ _inner_class_types = {"tax_breakdown": TaxBreakdown} diff --git a/stripe/tax/_registration.py b/stripe/tax/_registration.py index 09bbc9c93..328747a08 100644 --- a/stripe/tax/_registration.py +++ b/stripe/tax/_registration.py @@ -30,11 +30,11 @@ class Registration( UpdateableAPIResource["Registration"], ): """ - A Tax `Registration` lets us know that your business is registered to collect tax on payments within a region, enabling you to [automatically collect tax](https://stripe.com/docs/tax). + A Tax `Registration` lets us know that your business is registered to collect tax on payments within a region, enabling you to [automatically collect tax](https://docs.stripe.com/tax). - Stripe doesn't register on your behalf with the relevant authorities when you create a Tax `Registration` object. For more information on how to register to collect tax, see [our guide](https://stripe.com/docs/tax/registering). + Stripe doesn't register on your behalf with the relevant authorities when you create a Tax `Registration` object. For more information on how to register to collect tax, see [our guide](https://docs.stripe.com/tax/registering). - Related guide: [Using the Registrations API](https://stripe.com/docs/tax/registrations-api) + Related guide: [Using the Registrations API](https://docs.stripe.com/tax/registrations-api) """ OBJECT_NAME: ClassVar[Literal["tax.registration"]] = "tax.registration" diff --git a/stripe/tax/_settings.py b/stripe/tax/_settings.py index c67ed2f99..7a3f7988d 100644 --- a/stripe/tax/_settings.py +++ b/stripe/tax/_settings.py @@ -20,7 +20,7 @@ class Settings( """ You can use Tax `Settings` to manage configurations used by Stripe Tax calculations. - Related guide: [Using the Settings API](https://stripe.com/docs/tax/settings-api) + Related guide: [Using the Settings API](https://docs.stripe.com/tax/settings-api) """ OBJECT_NAME: ClassVar[Literal["tax.settings"]] = "tax.settings" @@ -65,7 +65,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address diff --git a/stripe/tax/_transaction.py b/stripe/tax/_transaction.py index d2851fee2..d76506217 100644 --- a/stripe/tax/_transaction.py +++ b/stripe/tax/_transaction.py @@ -27,7 +27,7 @@ class Transaction(APIResource["Transaction"]): """ 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://docs.stripe.com/tax/custom#tax-transaction) """ OBJECT_NAME: ClassVar[Literal["tax.transaction"]] = "tax.transaction" @@ -294,7 +294,7 @@ class TaxRateDetails(StripeObject): amount: int """ - The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ jurisdiction: Jurisdiction sourcing: Literal["destination", "origin"] @@ -327,7 +327,7 @@ class TaxRateDetails(StripeObject): """ taxable_amount: int """ - The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ _inner_class_types = { "jurisdiction": Jurisdiction, @@ -336,15 +336,15 @@ class TaxRateDetails(StripeObject): amount: int """ - The shipping amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. + The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. """ amount_tax: int """ - The amount of tax calculated for shipping, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ shipping_rate: Optional[str] """ - The ID of an existing [ShippingRate](https://stripe.com/docs/api/shipping_rates/object). + The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object). """ tax_behavior: Literal["exclusive", "inclusive"] """ @@ -356,7 +356,7 @@ class TaxRateDetails(StripeObject): """ tax_code: str """ - The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for shipping. + The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping. """ _inner_class_types = {"tax_breakdown": TaxBreakdown} @@ -370,7 +370,7 @@ class TaxRateDetails(StripeObject): """ customer: Optional[str] """ - The ID of an existing [Customer](https://stripe.com/docs/api/customers/object) used for the resource. + The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource. """ customer_details: CustomerDetails id: str @@ -387,7 +387,7 @@ class TaxRateDetails(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["tax.transaction"] """ diff --git a/stripe/tax/_transaction_line_item.py b/stripe/tax/_transaction_line_item.py index 87c817b36..9f575613d 100644 --- a/stripe/tax/_transaction_line_item.py +++ b/stripe/tax/_transaction_line_item.py @@ -18,11 +18,11 @@ class Reversal(StripeObject): amount: int """ - The line item amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. + The line item amount in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount. """ amount_tax: int """ - The amount of tax calculated for this line item, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of tax calculated for this line item, in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ id: str """ @@ -34,7 +34,7 @@ class Reversal(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["tax.transaction_line_item"] """ @@ -42,7 +42,7 @@ class Reversal(StripeObject): """ product: Optional[str] """ - The ID of an existing [Product](https://stripe.com/docs/api/products/object). + The ID of an existing [Product](https://docs.stripe.com/api/products/object). """ quantity: int """ @@ -62,7 +62,7 @@ class Reversal(StripeObject): """ tax_code: str """ - The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for this resource. + The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource. """ type: Literal["reversal", "transaction"] """ diff --git a/stripe/terminal/_connection_token.py b/stripe/terminal/_connection_token.py index 0804333cb..ccb3d46e5 100644 --- a/stripe/terminal/_connection_token.py +++ b/stripe/terminal/_connection_token.py @@ -14,7 +14,7 @@ class ConnectionToken(CreateableAPIResource["ConnectionToken"]): """ 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://docs.stripe.com/terminal/fleet/locations) """ OBJECT_NAME: ClassVar[Literal["terminal.connection_token"]] = ( diff --git a/stripe/terminal/_location.py b/stripe/terminal/_location.py index d7d44b6b7..03cb2a0db 100644 --- a/stripe/terminal/_location.py +++ b/stripe/terminal/_location.py @@ -35,7 +35,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://docs.stripe.com/terminal/fleet/locations) """ OBJECT_NAME: ClassVar[Literal["terminal.location"]] = "terminal.location" @@ -63,7 +63,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ class AddressKana(StripeObject): @@ -159,7 +159,7 @@ class AddressKanji(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["terminal.location"] """ diff --git a/stripe/terminal/_reader.py b/stripe/terminal/_reader.py index aaeb2c796..a4219c2c7 100644 --- a/stripe/terminal/_reader.py +++ b/stripe/terminal/_reader.py @@ -70,7 +70,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://docs.stripe.com/terminal/payments/connect-reader) """ OBJECT_NAME: ClassVar[Literal["terminal.reader"]] = "terminal.reader" @@ -241,7 +241,7 @@ class Toggle(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ _inner_class_types = {"inputs": Input} @@ -282,10 +282,10 @@ class Tipping(StripeObject): payment_method: Optional["PaymentMethod"] """ PaymentMethod objects represent your customer's payment instruments. - You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to + You can use them with [PaymentIntents](https://docs.stripe.com/payments/payment-intents) to collect payments or save them to Customer objects to store instrument details for future payments. - Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios). + Related guides: [Payment Methods](https://docs.stripe.com/payments/payment-methods) and [More Payment Scenarios](https://docs.stripe.com/payments/more-payment-scenarios). """ _inner_class_types = {"collect_config": CollectConfig} @@ -392,7 +392,7 @@ class RefundPaymentConfig(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ payment_intent: Optional[ExpandableField["PaymentIntent"]] """ @@ -427,7 +427,7 @@ class Cart(StripeObject): class LineItem(StripeObject): amount: int """ - The amount of the line item. A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + The amount of the line item. A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ description: str """ @@ -448,11 +448,11 @@ class LineItem(StripeObject): """ tax: Optional[int] """ - Tax amount for the entire cart. A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Tax amount for the entire cart. A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ total: int """ - Total amount for the entire cart, including tax. A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). + Total amount for the entire cart, including tax. A positive integer in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). """ _inner_class_types = {"line_items": LineItem} @@ -568,7 +568,7 @@ class LineItem(StripeObject): """ last_seen_at: Optional[int] """ - The last time this reader reported to Stripe backend. + The last time this reader reported to Stripe backend. Timestamp is measured in milliseconds since the Unix epoch. Unlike most other Stripe timestamp fields which use seconds, this field uses milliseconds. """ livemode: bool """ @@ -580,7 +580,7 @@ class LineItem(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["terminal.reader"] """ diff --git a/stripe/treasury/_credit_reversal.py b/stripe/treasury/_credit_reversal.py index 4ed324cb6..d3724e5df 100644 --- a/stripe/treasury/_credit_reversal.py +++ b/stripe/treasury/_credit_reversal.py @@ -26,7 +26,7 @@ class CreditReversal( ListableAPIResource["CreditReversal"], ): """ - You can reverse some [ReceivedCredits](https://stripe.com/docs/api#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. + You can reverse some [ReceivedCredits](https://api.stripe.com#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. """ OBJECT_NAME: ClassVar[Literal["treasury.credit_reversal"]] = ( @@ -57,7 +57,7 @@ class StatusTransitions(StripeObject): """ hosted_regulatory_receipt_url: Optional[str] """ - A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. + A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. """ id: str """ @@ -69,7 +69,7 @@ class StatusTransitions(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ network: Literal["ach", "stripe"] """ diff --git a/stripe/treasury/_debit_reversal.py b/stripe/treasury/_debit_reversal.py index ff98a4e23..3a32d5778 100644 --- a/stripe/treasury/_debit_reversal.py +++ b/stripe/treasury/_debit_reversal.py @@ -26,7 +26,7 @@ class DebitReversal( ListableAPIResource["DebitReversal"], ): """ - You can reverse some [ReceivedDebits](https://stripe.com/docs/api#received_debits) depending on their network and source flow. Reversing a ReceivedDebit leads to the creation of a new object known as a DebitReversal. + You can reverse some [ReceivedDebits](https://api.stripe.com#received_debits) depending on their network and source flow. Reversing a ReceivedDebit leads to the creation of a new object known as a DebitReversal. """ OBJECT_NAME: ClassVar[Literal["treasury.debit_reversal"]] = ( @@ -63,7 +63,7 @@ class StatusTransitions(StripeObject): """ hosted_regulatory_receipt_url: Optional[str] """ - A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. + A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. """ id: str """ @@ -79,7 +79,7 @@ class StatusTransitions(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ network: Literal["ach", "card"] """ diff --git a/stripe/treasury/_financial_account.py b/stripe/treasury/_financial_account.py index 340bd7621..e7141ff82 100644 --- a/stripe/treasury/_financial_account.py +++ b/stripe/treasury/_financial_account.py @@ -182,7 +182,7 @@ class Closed(StripeObject): """ metadata: Optional[Dict[str, str]] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ nickname: Optional[str] """ diff --git a/stripe/treasury/_inbound_transfer.py b/stripe/treasury/_inbound_transfer.py index 2c06ec5fb..7c7704948 100644 --- a/stripe/treasury/_inbound_transfer.py +++ b/stripe/treasury/_inbound_transfer.py @@ -41,7 +41,7 @@ class InboundTransfer( ListableAPIResource["InboundTransfer"], ): """ - Use [InboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) to add funds to your [FinancialAccount](https://stripe.com/docs/api#financial_accounts) via a PaymentMethod that is owned by you. The funds will be transferred via an ACH debit. + Use [InboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) to add funds to your [FinancialAccount](https://api.stripe.com#financial_accounts) via a PaymentMethod that is owned by you. The funds will be transferred via an ACH debit. Related guide: [Moving money with Treasury using InboundTransfer objects](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) """ @@ -101,7 +101,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -142,7 +142,7 @@ class UsBankAccount(StripeObject): """ network: Literal["ach"] """ - The network rails used. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + The network rails used. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ routing_number: Optional[str] """ @@ -204,7 +204,7 @@ class StatusTransitions(StripeObject): """ hosted_regulatory_receipt_url: Optional[str] """ - A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. + A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. """ id: str """ @@ -217,7 +217,7 @@ class StatusTransitions(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["treasury.inbound_transfer"] """ diff --git a/stripe/treasury/_outbound_payment.py b/stripe/treasury/_outbound_payment.py index 08a834cdc..d855c0ffc 100644 --- a/stripe/treasury/_outbound_payment.py +++ b/stripe/treasury/_outbound_payment.py @@ -44,7 +44,7 @@ class OutboundPayment( ListableAPIResource["OutboundPayment"], ): """ - Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://stripe.com/docs/api#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://stripe.com/docs/api#outbound_transfers). + Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://api.stripe.com#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://api.stripe.com#outbound_transfers). Simulate OutboundPayment state changes with the `/v1/test_helpers/treasury/outbound_payments` endpoints. These methods can only be called on test mode objects. @@ -80,7 +80,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -131,7 +131,7 @@ class UsBankAccount(StripeObject): """ network: Literal["ach", "us_domestic_wire"] """ - The network rails used. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + The network rails used. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ routing_number: Optional[str] """ @@ -247,7 +247,7 @@ class UsDomesticWire(StripeObject): """ customer: Optional[str] """ - ID of the [customer](https://stripe.com/docs/api/customers) to whom an OutboundPayment is sent. + ID of the [customer](https://docs.stripe.com/api/customers) to whom an OutboundPayment is sent. """ description: Optional[str] """ @@ -277,7 +277,7 @@ class UsDomesticWire(StripeObject): """ hosted_regulatory_receipt_url: Optional[str] """ - A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. + A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. """ id: str """ @@ -289,7 +289,7 @@ class UsDomesticWire(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ object: Literal["treasury.outbound_payment"] """ diff --git a/stripe/treasury/_outbound_transfer.py b/stripe/treasury/_outbound_transfer.py index 86455e582..3e281e539 100644 --- a/stripe/treasury/_outbound_transfer.py +++ b/stripe/treasury/_outbound_transfer.py @@ -44,7 +44,7 @@ class OutboundTransfer( ListableAPIResource["OutboundTransfer"], ): """ - Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://stripe.com/docs/api#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. + Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://api.stripe.com#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://api.stripe.com#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. Simulate OutboundTransfer state changes with the `/v1/test_helpers/treasury/outbound_transfers` endpoints. These methods can only be called on test mode objects. @@ -80,7 +80,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -131,7 +131,7 @@ class UsBankAccount(StripeObject): """ network: Literal["ach", "us_domestic_wire"] """ - The network rails used. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. + The network rails used. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type. """ routing_number: Optional[str] """ @@ -271,7 +271,7 @@ class UsDomesticWire(StripeObject): """ hosted_regulatory_receipt_url: Optional[str] """ - A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. + A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. """ id: str """ @@ -283,7 +283,7 @@ class UsDomesticWire(StripeObject): """ metadata: Dict[str, str] """ - Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. + Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. """ network_details: Optional[NetworkDetails] """ diff --git a/stripe/treasury/_received_credit.py b/stripe/treasury/_received_credit.py index 375a1ab04..193c7f0ff 100644 --- a/stripe/treasury/_received_credit.py +++ b/stripe/treasury/_received_credit.py @@ -27,7 +27,7 @@ class ReceivedCredit(ListableAPIResource["ReceivedCredit"]): """ - ReceivedCredits represent funds sent to a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) (for example, via ACH or wire). These money movements are not initiated from the FinancialAccount. + ReceivedCredits represent funds sent to a [FinancialAccount](https://api.stripe.com#financial_accounts) (for example, via ACH or wire). These money movements are not initiated from the FinancialAccount. """ OBJECT_NAME: ClassVar[Literal["treasury.received_credit"]] = ( @@ -59,7 +59,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -105,7 +105,7 @@ class UsBankAccount(StripeObject): financial_account: Optional[FinancialAccount] issuing_card: Optional[str] """ - Set when `type` is `issuing_card`. This is an [Issuing Card](https://stripe.com/docs/api#issuing_cards) ID. + Set when `type` is `issuing_card`. This is an [Issuing Card](https://api.stripe.com#issuing_cards) ID. """ type: Literal[ "balance", @@ -128,11 +128,11 @@ class LinkedFlows(StripeObject): class SourceFlowDetails(StripeObject): credit_reversal: Optional["CreditReversal"] """ - You can reverse some [ReceivedCredits](https://stripe.com/docs/api#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. + You can reverse some [ReceivedCredits](https://api.stripe.com#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. """ outbound_payment: Optional["OutboundPayment"] """ - Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://stripe.com/docs/api#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://stripe.com/docs/api#outbound_transfers). + Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://api.stripe.com#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://api.stripe.com#outbound_transfers). Simulate OutboundPayment state changes with the `/v1/test_helpers/treasury/outbound_payments` endpoints. These methods can only be called on test mode objects. @@ -140,7 +140,7 @@ class SourceFlowDetails(StripeObject): """ outbound_transfer: Optional["OutboundTransfer"] """ - Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://stripe.com/docs/api#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. + Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://api.stripe.com#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://api.stripe.com#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. Simulate OutboundTransfer state changes with the `/v1/test_helpers/treasury/outbound_transfers` endpoints. These methods can only be called on test mode objects. @@ -155,7 +155,7 @@ class SourceFlowDetails(StripeObject): schedules](https://docs.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://docs.stripe.com/payouts) """ type: Literal[ "credit_reversal", @@ -174,11 +174,11 @@ class SourceFlowDetails(StripeObject): """ issuing_authorization: Optional[str] """ - Set if the ReceivedCredit was created due to an [Issuing Authorization](https://stripe.com/docs/api#issuing_authorizations) object. + Set if the ReceivedCredit was created due to an [Issuing Authorization](https://api.stripe.com#issuing_authorizations) object. """ issuing_transaction: Optional[str] """ - Set if the ReceivedCredit is also viewable as an [Issuing transaction](https://stripe.com/docs/api#issuing_transactions) object. + Set if the ReceivedCredit is also viewable as an [Issuing transaction](https://api.stripe.com#issuing_transactions) object. """ source_flow: Optional[str] """ @@ -262,7 +262,7 @@ class ReversalDetails(StripeObject): """ hosted_regulatory_receipt_url: Optional[str] """ - A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. + A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. """ id: str """ diff --git a/stripe/treasury/_received_debit.py b/stripe/treasury/_received_debit.py index 94a32d3f3..b3e2d75a7 100644 --- a/stripe/treasury/_received_debit.py +++ b/stripe/treasury/_received_debit.py @@ -23,7 +23,7 @@ class ReceivedDebit(ListableAPIResource["ReceivedDebit"]): """ - ReceivedDebits represent funds pulled from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts). These are not initiated from the FinancialAccount. + ReceivedDebits represent funds pulled from a [FinancialAccount](https://api.stripe.com#financial_accounts). These are not initiated from the FinancialAccount. """ OBJECT_NAME: ClassVar[Literal["treasury.received_debit"]] = ( @@ -55,7 +55,7 @@ class Address(StripeObject): """ state: Optional[str] """ - State, county, province, or region. + State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)). """ address: Address @@ -101,7 +101,7 @@ class UsBankAccount(StripeObject): financial_account: Optional[FinancialAccount] issuing_card: Optional[str] """ - Set when `type` is `issuing_card`. This is an [Issuing Card](https://stripe.com/docs/api#issuing_cards) ID. + Set when `type` is `issuing_card`. This is an [Issuing Card](https://api.stripe.com#issuing_cards) ID. """ type: Literal[ "balance", @@ -131,15 +131,15 @@ class LinkedFlows(StripeObject): """ issuing_authorization: Optional[str] """ - Set if the ReceivedDebit was created due to an [Issuing Authorization](https://stripe.com/docs/api#issuing_authorizations) object. + Set if the ReceivedDebit was created due to an [Issuing Authorization](https://api.stripe.com#issuing_authorizations) object. """ issuing_transaction: Optional[str] """ - Set if the ReceivedDebit is also viewable as an [Issuing Dispute](https://stripe.com/docs/api#issuing_disputes) object. + Set if the ReceivedDebit is also viewable as an [Issuing Dispute](https://api.stripe.com#issuing_disputes) object. """ payout: Optional[str] """ - Set if the ReceivedDebit was created due to a [Payout](https://stripe.com/docs/api#payouts) object. + Set if the ReceivedDebit was created due to a [Payout](https://api.stripe.com#payouts) object. """ received_credit_capital_withholding: Optional[str] """ @@ -215,7 +215,7 @@ class ReversalDetails(StripeObject): """ hosted_regulatory_receipt_url: Optional[str] """ - A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. + A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses. """ id: str """ diff --git a/stripe/treasury/_transaction.py b/stripe/treasury/_transaction.py index 3892b1764..d747cffef 100644 --- a/stripe/treasury/_transaction.py +++ b/stripe/treasury/_transaction.py @@ -26,7 +26,7 @@ class Transaction(ListableAPIResource["Transaction"]): """ - Transactions represent changes to a [FinancialAccount's](https://stripe.com/docs/api#financial_accounts) balance. + Transactions represent changes to a [FinancialAccount's](https://api.stripe.com#financial_accounts) balance. """ OBJECT_NAME: ClassVar[Literal["treasury.transaction"]] = ( @@ -50,29 +50,29 @@ class BalanceImpact(StripeObject): class FlowDetails(StripeObject): credit_reversal: Optional["CreditReversal"] """ - You can reverse some [ReceivedCredits](https://stripe.com/docs/api#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. + You can reverse some [ReceivedCredits](https://api.stripe.com#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. """ debit_reversal: Optional["DebitReversal"] """ - You can reverse some [ReceivedDebits](https://stripe.com/docs/api#received_debits) depending on their network and source flow. Reversing a ReceivedDebit leads to the creation of a new object known as a DebitReversal. + You can reverse some [ReceivedDebits](https://api.stripe.com#received_debits) depending on their network and source flow. Reversing a ReceivedDebit leads to the creation of a new object known as a DebitReversal. """ inbound_transfer: Optional["InboundTransfer"] """ - Use [InboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) to add funds to your [FinancialAccount](https://stripe.com/docs/api#financial_accounts) via a PaymentMethod that is owned by you. The funds will be transferred via an ACH debit. + Use [InboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) to add funds to your [FinancialAccount](https://api.stripe.com#financial_accounts) via a PaymentMethod that is owned by you. The funds will be transferred via an ACH debit. Related guide: [Moving money with Treasury using InboundTransfer objects](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) """ issuing_authorization: Optional["Authorization"] """ - When an [issued card](https://stripe.com/docs/issuing) is used to make a purchase, an Issuing `Authorization` - object is created. [Authorizations](https://stripe.com/docs/issuing/purchases/authorizations) must be approved for the + When an [issued card](https://docs.stripe.com/issuing) is used to make a purchase, an Issuing `Authorization` + object is created. [Authorizations](https://docs.stripe.com/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://docs.stripe.com/issuing/purchases/authorizations) """ outbound_payment: Optional["OutboundPayment"] """ - Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://stripe.com/docs/api#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://stripe.com/docs/api#outbound_transfers). + Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://api.stripe.com#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://api.stripe.com#outbound_transfers). Simulate OutboundPayment state changes with the `/v1/test_helpers/treasury/outbound_payments` endpoints. These methods can only be called on test mode objects. @@ -80,7 +80,7 @@ class FlowDetails(StripeObject): """ outbound_transfer: Optional["OutboundTransfer"] """ - Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://stripe.com/docs/api#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. + Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://api.stripe.com#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://api.stripe.com#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. Simulate OutboundTransfer state changes with the `/v1/test_helpers/treasury/outbound_transfers` endpoints. These methods can only be called on test mode objects. @@ -88,11 +88,11 @@ class FlowDetails(StripeObject): """ received_credit: Optional["ReceivedCredit"] """ - ReceivedCredits represent funds sent to a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) (for example, via ACH or wire). These money movements are not initiated from the FinancialAccount. + ReceivedCredits represent funds sent to a [FinancialAccount](https://api.stripe.com#financial_accounts) (for example, via ACH or wire). These money movements are not initiated from the FinancialAccount. """ received_debit: Optional["ReceivedDebit"] """ - ReceivedDebits represent funds pulled from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts). These are not initiated from the FinancialAccount. + ReceivedDebits represent funds pulled from a [FinancialAccount](https://api.stripe.com#financial_accounts). These are not initiated from the FinancialAccount. """ type: Literal[ "credit_reversal", diff --git a/stripe/treasury/_transaction_entry.py b/stripe/treasury/_transaction_entry.py index 2e4012cb2..66845f811 100644 --- a/stripe/treasury/_transaction_entry.py +++ b/stripe/treasury/_transaction_entry.py @@ -27,7 +27,7 @@ class TransactionEntry(ListableAPIResource["TransactionEntry"]): """ - TransactionEntries represent individual units of money movements within a single [Transaction](https://stripe.com/docs/api#transactions). + TransactionEntries represent individual units of money movements within a single [Transaction](https://api.stripe.com#transactions). """ OBJECT_NAME: ClassVar[Literal["treasury.transaction_entry"]] = ( @@ -51,29 +51,29 @@ class BalanceImpact(StripeObject): class FlowDetails(StripeObject): credit_reversal: Optional["CreditReversal"] """ - You can reverse some [ReceivedCredits](https://stripe.com/docs/api#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. + You can reverse some [ReceivedCredits](https://api.stripe.com#received_credits) depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal. """ debit_reversal: Optional["DebitReversal"] """ - You can reverse some [ReceivedDebits](https://stripe.com/docs/api#received_debits) depending on their network and source flow. Reversing a ReceivedDebit leads to the creation of a new object known as a DebitReversal. + You can reverse some [ReceivedDebits](https://api.stripe.com#received_debits) depending on their network and source flow. Reversing a ReceivedDebit leads to the creation of a new object known as a DebitReversal. """ inbound_transfer: Optional["InboundTransfer"] """ - Use [InboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) to add funds to your [FinancialAccount](https://stripe.com/docs/api#financial_accounts) via a PaymentMethod that is owned by you. The funds will be transferred via an ACH debit. + Use [InboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) to add funds to your [FinancialAccount](https://api.stripe.com#financial_accounts) via a PaymentMethod that is owned by you. The funds will be transferred via an ACH debit. Related guide: [Moving money with Treasury using InboundTransfer objects](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/into/inbound-transfers) """ issuing_authorization: Optional["Authorization"] """ - When an [issued card](https://stripe.com/docs/issuing) is used to make a purchase, an Issuing `Authorization` - object is created. [Authorizations](https://stripe.com/docs/issuing/purchases/authorizations) must be approved for the + When an [issued card](https://docs.stripe.com/issuing) is used to make a purchase, an Issuing `Authorization` + object is created. [Authorizations](https://docs.stripe.com/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://docs.stripe.com/issuing/purchases/authorizations) """ outbound_payment: Optional["OutboundPayment"] """ - Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://stripe.com/docs/api#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://stripe.com/docs/api#outbound_transfers). + Use [OutboundPayments](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-payments) to send funds to another party's external bank account or [FinancialAccount](https://api.stripe.com#financial_accounts). To send money to an account belonging to the same user, use an [OutboundTransfer](https://api.stripe.com#outbound_transfers). Simulate OutboundPayment state changes with the `/v1/test_helpers/treasury/outbound_payments` endpoints. These methods can only be called on test mode objects. @@ -81,7 +81,7 @@ class FlowDetails(StripeObject): """ outbound_transfer: Optional["OutboundTransfer"] """ - Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://stripe.com/docs/api#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. + Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://api.stripe.com#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://api.stripe.com#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account. Simulate OutboundTransfer state changes with the `/v1/test_helpers/treasury/outbound_transfers` endpoints. These methods can only be called on test mode objects. @@ -89,11 +89,11 @@ class FlowDetails(StripeObject): """ received_credit: Optional["ReceivedCredit"] """ - ReceivedCredits represent funds sent to a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) (for example, via ACH or wire). These money movements are not initiated from the FinancialAccount. + ReceivedCredits represent funds sent to a [FinancialAccount](https://api.stripe.com#financial_accounts) (for example, via ACH or wire). These money movements are not initiated from the FinancialAccount. """ received_debit: Optional["ReceivedDebit"] """ - ReceivedDebits represent funds pulled from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts). These are not initiated from the FinancialAccount. + ReceivedDebits represent funds pulled from a [FinancialAccount](https://api.stripe.com#financial_accounts). These are not initiated from the FinancialAccount. """ type: Literal[ "credit_reversal", diff --git a/stripe/v2/_financial_address_generated_microdeposits.py b/stripe/v2/_financial_address_generated_microdeposits.py index 0f082a964..ec75a062c 100644 --- a/stripe/v2/_financial_address_generated_microdeposits.py +++ b/stripe/v2/_financial_address_generated_microdeposits.py @@ -1,8 +1,7 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount -from typing import ClassVar, List +from typing import ClassVar, List, Optional from typing_extensions import Literal @@ -10,6 +9,17 @@ class FinancialAddressGeneratedMicrodeposits(StripeObject): OBJECT_NAME: ClassVar[ Literal["financial_address_generated_microdeposits"] ] = "financial_address_generated_microdeposits" + + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + amounts: List[Amount] """ The amounts of the microdeposits that were generated. @@ -26,3 +36,4 @@ class FinancialAddressGeneratedMicrodeposits(StripeObject): """ Closed Enum. The status of the request. """ + _inner_class_types = {"amounts": Amount} diff --git a/stripe/v2/core/_account.py b/stripe/v2/core/_account.py index 84f71be1c..0dacbe7fb 100644 --- a/stripe/v2/core/_account.py +++ b/stripe/v2/core/_account.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Dict, List, Optional from typing_extensions import Literal @@ -28,7 +27,7 @@ class Location(StripeObject): exempt: Optional[Literal["exempt", "none", "reverse"]] """ - Describes the customer's tax exemption status, which is `none`, `exempt`, or `reverse`. When set to reverse, invoice and receipt PDFs include the following text: “Reverse charge”. + The customer account's tax exemption status: `none`, `exempt`, or `reverse`. When `reverse`, invoice and receipt PDFs include "Reverse charge". """ ip_address: Optional[str] """ @@ -36,7 +35,7 @@ class Location(StripeObject): """ location: Optional[Location] """ - The [identified](https://docs.stripe.com/tax/customer-locations#address-hierarchy-other) tax location of the customer. Will only be rendered if the `automatic_indirect_tax` feature is requested and `active`. + The customer account's identified tax location, derived from `location_source`. Only rendered if the `automatic_indirect_tax` feature is requested and `active`. """ location_source: Optional[ Literal[ @@ -47,7 +46,7 @@ class Location(StripeObject): ] ] """ - The data source used to identify the customer's tax location. Will only be used for automatic tax calculation on the customer's Invoices and Subscriptions. + Data source used to identify the customer account's tax location. Defaults to `identity_address`. Used for automatic indirect tax calculation. """ _inner_class_types = {"location": Location} @@ -68,7 +67,7 @@ class Rendering(StripeObject): Literal["exclude_tax", "include_inclusive_tax"] ] """ - How line-item prices and amounts will be displayed with respect to tax on invoice PDFs. One of exclude_tax or include_inclusive_tax. include_inclusive_tax will include inclusive tax (and exclude exclusive tax) in invoice PDF amounts. exclude_tax will exclude all tax (inclusive and exclusive alike) from invoice PDF amounts. + Indicates whether displayed line item prices and amounts on invoice PDFs include inclusive tax amounts. Must be either `include_inclusive_tax` or `exclude_tax`. """ template: Optional[str] """ @@ -81,19 +80,19 @@ class Rendering(StripeObject): """ footer: Optional[str] """ - Default footer to be displayed on invoices for this customer. + Default invoice footer. """ next_sequence: Optional[int] """ - The sequence to be used on the customer's next invoice. Defaults to 1. + Sequence number to use on the customer account's next invoice. Defaults to 1. """ prefix: Optional[str] """ - The prefix for the customer used to generate unique invoice numbers. Must be 3–12 uppercase letters or numbers. + Prefix used to generate unique invoice numbers. Must be 3-12 uppercase letters or numbers. """ rendering: Optional[Rendering] """ - Default options for invoice PDF rendering for this customer. + Default invoice PDF rendering options. """ _inner_class_types = { "custom_fields": CustomField, @@ -102,11 +101,11 @@ class Rendering(StripeObject): default_payment_method: Optional[str] """ - ID of a payment method that's attached to the customer, to be used as the customer's default payment method for invoices and subscriptions. + ID of a PaymentMethod attached to the customer account to use as the default for invoices and subscriptions. """ invoice: Optional[Invoice] """ - Default settings used on invoices for this customer. + Default invoice settings for the customer account. """ _inner_class_types = {"invoice": Invoice} @@ -132,10 +131,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -144,7 +139,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -199,15 +194,15 @@ class Address(StripeObject): applied: bool """ - Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration. + Indicates whether the customer configuration is active. You can deactivate or reactivate the customer configuration by updating this property. Deactivating the configuration by setting this value to false will unrequest all capabilities within the configuration. It will not delete any of the configuration's other properties. """ automatic_indirect_tax: Optional[AutomaticIndirectTax] """ - Automatic indirect tax settings to be used when automatic tax calculation is enabled on the customer's invoices, subscriptions, checkout sessions, or payment links. Surfaces if automatic tax calculation is possible given the current customer location information. + Settings for automatic indirect tax calculation on the customer's invoices, subscriptions, Checkout Sessions, and Payment Links. Available when automatic tax calculation is available for the customer account's location. """ billing: Optional[Billing] """ - Billing settings - default settings used for this customer in Billing flows such as Invoices and Subscriptions. + Default Billing settings for the customer account, used in Invoices and Subscriptions. """ capabilities: Optional[Capabilities] """ @@ -232,11 +227,11 @@ class Merchant(StripeObject): class BacsDebitPayments(StripeObject): display_name: Optional[str] """ - Display name for Bacs debit payments. + Display name for Bacs Direct Debit payments. """ service_user_number: Optional[str] """ - Service user number for Bacs debit payments. + Service User Number (SUN) for Bacs Direct Debit payments. """ class Branding(StripeObject): @@ -279,10 +274,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -291,7 +282,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -316,10 +307,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -328,7 +315,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -353,10 +340,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -365,7 +348,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -390,10 +373,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -402,7 +381,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -427,10 +406,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -439,7 +414,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -464,10 +439,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -476,7 +447,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -501,10 +472,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -513,7 +480,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -538,10 +505,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -550,7 +513,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -575,10 +538,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -587,7 +546,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -612,10 +571,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -624,7 +579,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -649,10 +604,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -661,7 +612,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -686,10 +637,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -698,7 +645,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -723,10 +670,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -735,7 +678,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -760,10 +703,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -772,7 +711,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -797,10 +736,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -809,7 +744,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -834,10 +769,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -846,7 +777,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -871,10 +802,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -883,7 +810,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -908,10 +835,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -920,7 +843,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -945,10 +868,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -957,7 +876,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -982,10 +901,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -994,7 +909,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1019,10 +934,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1031,7 +942,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1056,10 +967,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1068,7 +975,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1093,10 +1000,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1105,7 +1008,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1130,10 +1033,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1142,7 +1041,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1167,10 +1066,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1179,7 +1074,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1204,10 +1099,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1216,7 +1107,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1241,10 +1132,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1253,7 +1140,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1278,10 +1165,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1290,7 +1173,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1315,10 +1198,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1327,7 +1206,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1352,10 +1231,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1364,7 +1239,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1389,10 +1264,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1401,7 +1272,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1426,10 +1297,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1438,7 +1305,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1463,10 +1330,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1475,7 +1338,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1500,10 +1363,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1512,7 +1371,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1537,10 +1396,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1549,7 +1404,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1574,10 +1429,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1586,7 +1437,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1611,10 +1462,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1623,7 +1470,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1648,10 +1495,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1660,7 +1503,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1685,10 +1528,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1697,7 +1536,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1722,10 +1561,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1734,7 +1569,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1762,10 +1597,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1774,13 +1605,13 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} payouts: Optional[Payouts] """ - Allows the account to do payouts using their Stripe Balance (/v1/balance). + Enables this Account to complete payouts from their Stripe Balance (/v1/balance). """ _inner_class_types = {"payouts": Payouts} @@ -1805,10 +1636,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1817,7 +1644,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1842,10 +1669,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1854,7 +1677,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1879,10 +1702,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1891,7 +1710,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -1916,10 +1735,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -1928,7 +1743,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2243,7 +2058,7 @@ class Kanji(StripeObject): class SepaDebitPayments(StripeObject): creditor_id: Optional[str] """ - Creditor ID for SEPA debit payments. + Creditor ID for SEPA Direct Debit payments. """ class StatementDescriptor(StripeObject): @@ -2284,7 +2099,7 @@ class Address(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ address: Optional[Address] @@ -2307,11 +2122,11 @@ class Address(StripeObject): applied: bool """ - Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration. + Indicates whether the merchant configuration is active. You can deactivate or reactivate the merchant configuration by updating this property. Deactivating the configuration by setting this value to false doesn't delete the configuration's properties. """ bacs_debit_payments: Optional[BacsDebitPayments] """ - Settings used for Bacs debit payments. + Settings for Bacs Direct Debit payments. """ branding: Optional[Branding] """ @@ -2331,7 +2146,7 @@ class Address(StripeObject): """ mcc: Optional[str] """ - The merchant category code for the merchant. MCCs are used to classify businesses based on the goods or services they provide. + The Merchant Category Code (MCC) for the merchant. MCCs classify businesses based on the goods or services they provide. """ script_statement_descriptor: Optional[ScriptStatementDescriptor] """ @@ -2339,7 +2154,7 @@ class Address(StripeObject): """ sepa_debit_payments: Optional[SepaDebitPayments] """ - Settings used for SEPA debit payments. + Settings for SEPA Direct Debit payments. """ statement_descriptor: Optional[StatementDescriptor] """ @@ -2387,10 +2202,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2399,7 +2210,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2426,10 +2237,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2438,7 +2245,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2473,10 +2280,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2485,7 +2288,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2513,10 +2316,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2525,7 +2324,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2552,10 +2351,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2564,17 +2359,17 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} payouts: Optional[Payouts] """ - Allows the account to do payouts using their Stripe Balance (/v1/balance). + Enables this Account to complete payouts from their Stripe Balance (/v1/balance). """ stripe_transfers: Optional[StripeTransfers] """ - Allows the account to receive /v1/transfers into their Stripe Balance (/v1/balance). + Enables this Account to receive /v1/transfers into their Stripe Balance (/v1/balance). """ _inner_class_types = { "payouts": Payouts, @@ -2587,7 +2382,7 @@ class StatusDetail(StripeObject): """ cards: Optional[Cards] """ - Capability that enable OutboundPayments to a debit card linked to this Account. + Enables this Account to receive OutboundPayments to a linked debit card. """ stripe_balance: Optional[StripeBalance] """ @@ -2605,13 +2400,17 @@ class DefaultOutboundDestination(StripeObject): The payout method ID of the default outbound destination. """ type: Literal[ + "al_bank_account", + "am_bank_account", "at_bank_account", "au_bank_account", "ba_bank_account", "be_bank_account", "bg_bank_account", "bj_bank_account", + "bn_bank_account", "bs_bank_account", + "bw_bank_account", "card", "ca_bank_account", "ch_bank_account", @@ -2621,6 +2420,7 @@ class DefaultOutboundDestination(StripeObject): "cz_bank_account", "de_bank_account", "dk_bank_account", + "dz_bank_account", "ec_bank_account", "ee_bank_account", "es_bank_account", @@ -2629,6 +2429,7 @@ class DefaultOutboundDestination(StripeObject): "fr_bank_account", "gb_bank_account", "gr_bank_account", + "gy_bank_account", "hr_bank_account", "hu_bank_account", "id_bank_account", @@ -2637,11 +2438,16 @@ class DefaultOutboundDestination(StripeObject): "in_bank_account", "is_bank_account", "it_bank_account", + "jm_bank_account", + "jo_bank_account", "ke_bank_account", + "kw_bank_account", "li_bank_account", + "lk_bank_account", "lt_bank_account", "lu_bank_account", "lv_bank_account", + "ma_bank_account", "mn_bank_account", "mt_bank_account", "mu_bank_account", @@ -2650,6 +2456,7 @@ class DefaultOutboundDestination(StripeObject): "nl_bank_account", "no_bank_account", "nz_bank_account", + "om_bank_account", "pa_bank_account", "ph_bank_account", "pl_bank_account", @@ -2664,6 +2471,7 @@ class DefaultOutboundDestination(StripeObject): "sv_bank_account", "tn_bank_account", "tr_bank_account", + "tz_bank_account", "us_bank_account", "za_bank_account", ] @@ -2673,7 +2481,7 @@ class DefaultOutboundDestination(StripeObject): applied: bool """ - Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration. + Indicates whether the recipient configuration is active. You can deactivate or reactivate the recipient configuration by updating this property. Deactivating the configuration by setting this value to false unrequest all capabilities within the configuration. It will not delete any of the configuration's other properties. """ capabilities: Optional[Capabilities] """ @@ -2714,10 +2522,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2726,7 +2530,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2760,10 +2564,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2772,7 +2572,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2799,10 +2599,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2811,7 +2607,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2838,10 +2634,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2850,7 +2642,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2892,10 +2684,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2904,13 +2692,13 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} bank_accounts: Optional[BankAccounts] """ - Can pull funds from an external bank account, owned by yourself, to a FinancialAccount. + Can pull funds into a FinancialAccount from an external bank account owned by the user. """ _inner_class_types = {"bank_accounts": BankAccounts} @@ -2938,10 +2726,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2950,7 +2734,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -2977,10 +2761,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -2989,7 +2769,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -3016,10 +2796,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -3028,21 +2804,21 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} bank_accounts: Optional[BankAccounts] """ - Can send funds from a FinancialAccount to a bank account, owned by someone else. + Can send funds from a FinancialAccount to a bank account owned by a different entity. """ cards: Optional[Cards] """ - Can send funds from a FinancialAccount to a debit card, owned by someone else. + Can send funds from a FinancialAccount to a debit card owned by a different entity. """ financial_accounts: Optional[FinancialAccounts] """ - Can send funds from a FinancialAccount to another FinancialAccount, owned by someone else. + Can send funds from a FinancialAccount to a FinancialAccount owned by a different entity. """ _inner_class_types = { "bank_accounts": BankAccounts, @@ -3074,10 +2850,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -3086,7 +2858,7 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} @@ -3113,10 +2885,6 @@ class StatusDetail(StripeObject): Machine-readable code explaining how to make the Capability active. """ - requested: bool - """ - Whether the Capability has been requested. - """ status: Literal[ "active", "pending", "restricted", "unsupported" ] @@ -3125,17 +2893,17 @@ class StatusDetail(StripeObject): """ status_details: List[StatusDetail] """ - Additional details regarding the status of the Capability. `status_details` will be empty if the Capability's status is `active`. + Additional details about the capability's status. This value is empty when `status` is `active`. """ _inner_class_types = {"status_details": StatusDetail} bank_accounts: Optional[BankAccounts] """ - Can send funds from a FinancialAccount, to a bank account, owned by yourself. + Can send funds from a FinancialAccount to a bank account belonging to the same user. """ financial_accounts: Optional[FinancialAccounts] """ - Can send funds from a FinancialAccount to another FinancialAccount, owned by yourself. + Can send funds from a FinancialAccount to another FinancialAccount belonging to the same user. """ _inner_class_types = { "bank_accounts": BankAccounts, @@ -3152,15 +2920,15 @@ class StatusDetail(StripeObject): """ inbound_transfers: Optional[InboundTransfers] """ - Can pull funds from an external source, owned by yourself, to a FinancialAccount. + Hash containing capabilities related to InboundTransfers. """ outbound_payments: Optional[OutboundPayments] """ - Can send funds from a FinancialAccount to a destination owned by someone else. + Hash containing capabilities related to [OutboundPayments](https://docs.stripe.com/api/treasury/outbound_payments?api-version=preview). """ outbound_transfers: Optional[OutboundTransfers] """ - Can send funds from a FinancialAccount to a destination owned by yourself. + Hash containing capabilities related to [OutboundTransfers](https://docs.stripe.com/api/treasury/outbound_transfers?api-version=preview). """ _inner_class_types = { "financial_addresses": FinancialAddresses, @@ -3172,7 +2940,7 @@ class StatusDetail(StripeObject): applied: bool """ - Represents the state of the configuration, and can be updated to deactivate or re-apply a configuration. + Indicates whether the storer configuration is active. You cannot deactivate (or reactivate) the storer configuration by updating this property. """ capabilities: Optional[Capabilities] """ @@ -3186,11 +2954,11 @@ class StatusDetail(StripeObject): """ merchant: Optional[Merchant] """ - The Merchant configuration allows the Account to act as a connected account and collect payments facilitated by a Connect platform. You can add this configuration to your connected accounts only if you've completed onboarding as a Connect platform. + Enables the Account to act as a connected account and collect payments facilitated by a Connect platform. You must onboard your platform to Connect before you can add this configuration to your connected accounts. Utilize this configuration when the Account will be the Merchant of Record, like with Direct charges or Destination Charges with on_behalf_of set. """ recipient: Optional[Recipient] """ - The Recipient Configuration allows the Account to receive funds. + The Recipient Configuration allows the Account to receive funds. Utilize this configuration if the Account will not be the Merchant of Record, like with Separate Charges & Transfers, or Destination Charges without on_behalf_of set. """ storer: Optional[Storer] """ @@ -3211,7 +2979,7 @@ class Profile(StripeObject): """ doing_business_as: Optional[str] """ - The company's legal name. + The customer-facing business name. """ product_description: Optional[str] """ @@ -3219,18 +2987,20 @@ class Profile(StripeObject): """ class Responsibilities(StripeObject): - fees_collector: Literal[ - "application", - "application_custom", - "application_express", - "stripe", + fees_collector: Optional[ + Literal[ + "application", + "application_custom", + "application_express", + "stripe", + ] ] """ - A value indicating the responsible payer of a bundle of Stripe fees for pricing-control eligible products on this Account. + Indicates whether the platform or connected account is responsible for paying Stripe fees for pricing-control-eligible products. """ - losses_collector: Literal["application", "stripe"] + losses_collector: Optional[Literal["application", "stripe"]] """ - A value indicating who is responsible for losses when this Account can't pay back negative balances from payments. + A value indicating responsibility for collecting requirements on this account. """ requirements_collector: Literal["application", "stripe"] """ @@ -3338,7 +3108,7 @@ class Responsibilities(StripeObject): """ Account profile information. """ - responsibilities: Optional[Responsibilities] + responsibilities: Responsibilities """ Default responsibilities held by either Stripe or the platform. """ @@ -3580,7 +3350,7 @@ class RequestedReason(StripeObject): awaiting_action_from: Literal["stripe", "user"] """ - Whether the responsibility is with the integrator or with Stripe (to review info, to wait for some condition, etc.) to action the requirement. + Indicates whether the platform or Stripe is currently responsible for taking action on the requirement. Value can be `user` or `stripe`. """ description: str """ @@ -3807,18 +3577,29 @@ class Address(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class AnnualRevenue(StripeObject): + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + amount: Optional[Amount] """ - A non-negative integer representing the amount in the smallest currency unit. + Annual revenue amount in minor currency units (for example, '123' for 1.23 USD). """ fiscal_year_end: Optional[str] """ The close-out date of the preceding fiscal year in ISO 8601 format. E.g. 2023-12-31 for the 31st of December, 2023. """ + _inner_class_types = {"amount": Amount} class Documents(StripeObject): class BankAccountOwnershipVerification(StripeObject): @@ -4004,70 +3785,111 @@ class IdNumber(StripeObject): "ao_nif", "ar_cuit", "at_fn", + "at_stn", + "at_vat", "au_abn", "au_acn", "au_in", "az_tin", "bd_etin", "be_cbe", + "be_vat", "bg_uic", + "bg_vat", "br_cnpj", "ca_cn", "ca_crarr", + "ca_gst_hst", "ca_neq", "ca_rid", "ch_chid", "ch_uid", "cr_cpj", "cr_nite", + "cy_he", "cy_tic", + "cy_vat", "cz_ico", + "cz_vat", "de_hrn", + "de_stn", "de_vat", "dk_cvr", + "dk_vat", "do_rcn", "ee_rk", + "ee_vat", "es_cif", + "es_vat", + "fi_vat", "fi_yt", + "fr_rna", "fr_siren", "fr_vat", "gb_crn", "gi_crn", + "gr_afm", "gr_gemi", + "gr_vat", "gt_nit", "hk_br", "hk_cr", - "hk_mbs", + "hr_mbs", + "hr_oib", + "hr_vat", "hu_cjs", + "hu_tin", + "hu_vat", "ie_crn", + "ie_trn", + "ie_vat", "it_rea", "it_vat", "jp_cn", "kz_bin", "li_uid", "lt_ccrn", + "lt_vat", + "lu_nif", "lu_rcs", + "lu_vat", "lv_urn", + "lv_vat", "mt_crn", + "mt_tin", + "mt_vat", "mx_rfc", "my_brn", "my_coid", + "my_itn", "my_sst", "mz_nuit", "nl_kvk", + "nl_rsin", + "nl_vat", "no_orgnr", "nz_bn", + "nz_ird", "pe_ruc", "pk_ntn", + "pl_nip", "pl_regon", + "pl_vat", "pt_vat", "ro_cui", + "ro_orc", + "ro_vat", "sa_crn", "sa_tin", "se_orgnr", + "se_vat", "sg_uen", "si_msp", + "si_tin", + "si_vat", + "sk_dic", "sk_ico", + "sk_vat", "th_crn", "th_prn", "th_tin", @@ -4078,10 +3900,21 @@ class IdNumber(StripeObject): """ class MonthlyEstimatedRevenue(StripeObject): + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + amount: Optional[Amount] """ - A non-negative integer representing the amount in the smallest currency unit. + Estimated monthly revenue amount in minor currency units (for example, '123' for 1.23 USD). """ + _inner_class_types = {"amount": Amount} class ScriptAddresses(StripeObject): class Kana(StripeObject): @@ -4111,7 +3944,7 @@ class Kana(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class Kanji(StripeObject): @@ -4141,7 +3974,7 @@ class Kanji(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ kana: Optional[Kana] @@ -4191,7 +4024,7 @@ class Kanji(StripeObject): """ estimated_worker_count: Optional[int] """ - An estimated upper bound of employees, contractors, vendors, etc. currently working for the business. + Estimated maximum number of workers currently engaged by the business (including employees, contractors, and vendors). """ id_numbers: Optional[List[IdNumber]] """ @@ -4199,7 +4032,7 @@ class Kanji(StripeObject): """ monthly_estimated_revenue: Optional[MonthlyEstimatedRevenue] """ - An estimate of the monthly revenue of the business. + An estimate of the monthly revenue of the business. Only accepted for accounts in Brazil and India. """ phone: Optional[str] """ @@ -4293,7 +4126,7 @@ class AdditionalAddress(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class AdditionalName(StripeObject): @@ -4362,7 +4195,7 @@ class Address(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class DateOfBirth(StripeObject): @@ -4484,36 +4317,81 @@ class IdNumber(StripeObject): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -4522,11 +4400,11 @@ class IdNumber(StripeObject): class Relationship(StripeObject): authorizer: Optional[bool] """ - Whether the individual is an authorizer of the Account's legal entity. + Whether the individual is an authorizer of the Account's identity. """ director: Optional[bool] """ - Whether the individual is a director of the Account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations. + Whether the individual is a director of the Account's identity. Directors are typically members of the governing board of the company or are responsible for making sure that the company meets its regulatory obligations. """ executive: Optional[bool] """ @@ -4538,11 +4416,11 @@ class Relationship(StripeObject): """ owner: Optional[bool] """ - Whether the individual is an owner of the Account's legal entity. + Whether the individual is an owner of the Account's identity. """ percent_ownership: Optional[str] """ - The percent owned by the individual of the Account's legal entity. + The percentage of the Account's identity that the individual owns. """ representative: Optional[bool] """ @@ -4581,7 +4459,7 @@ class Kana(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class Kanji(StripeObject): @@ -4611,7 +4489,7 @@ class Kanji(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ kana: Optional[Kana] @@ -5021,7 +4899,7 @@ class RequestedReason(StripeObject): awaiting_action_from: Literal["stripe", "user"] """ - Whether the responsibility is with the integrator or with Stripe (to review info, to wait for some condition, etc.) to action the requirement. + Indicates whether the platform or Stripe is currently responsible for taking action on the requirement. Value can be `user` or `stripe`. """ description: str """ @@ -5086,15 +4964,15 @@ class MinimumDeadline(StripeObject): Literal["customer", "merchant", "recipient", "storer"] ] """ - Filter only accounts that have all of the configurations specified. If omitted, returns all accounts regardless of which configurations they have. + The configurations that have been applied to this account. """ closed: Optional[bool] """ - A value indicating if the Account has been closed. + Indicates whether the account has been closed. """ configuration: Optional[Configuration] """ - An Account Configuration which allows the Account to take on a key persona across Stripe products. + An Account represents a company, individual, or other entity that a user interacts with. Accounts store identity information and one or more configurations that enable product-specific capabilities. You can assign configurations at creation or add them later. """ contact_email: Optional[str] """ @@ -5110,7 +4988,7 @@ class MinimumDeadline(StripeObject): """ defaults: Optional[Defaults] """ - Default values to be used on Account Configurations. + Default values for settings shared across Account configurations. """ display_name: Optional[str] """ diff --git a/stripe/v2/core/_account_link.py b/stripe/v2/core/_account_link.py index e59de9690..c0d2a2e0e 100644 --- a/stripe/v2/core/_account_link.py +++ b/stripe/v2/core/_account_link.py @@ -7,7 +7,7 @@ class AccountLink(StripeObject): """ - AccountLinks are the means by which a Merchant grants an Account permission to access Stripe-hosted applications, such as Recipient Onboarding. This API is only available for users enrolled in the public preview for Accounts v2. + Account Links let a platform create a temporary, single-use URL that an account can use to access a Stripe-hosted flow for collecting or updating required information. """ OBJECT_NAME: ClassVar[Literal["v2.core.account_link"]] = ( @@ -50,7 +50,7 @@ class AccountUpdate(StripeObject): class CollectionOptions(StripeObject): fields: Optional[Literal["currently_due", "eventually_due"]] """ - Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). If you don't specify collection_options, the default value is currently_due. + Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). The default value is `currently_due`. """ future_requirements: Optional[Literal["include", "omit"]] """ @@ -69,7 +69,7 @@ class CollectionOptions(StripeObject): """ refresh_url: str """ - The URL the user will be redirected to if the AccountLink is expired, has been used, or is otherwise invalid. The URL you specify should attempt to generate a new AccountLink with the same parameters used to create the original AccountLink, then redirect the user to the new AccountLink's URL so they can continue the flow. If a new AccountLink cannot be generated or the redirect fails you should display a useful error to the user. Please make sure to implement authentication before redirecting the user in case this URL is leaked to a third party. + The URL the user will be redirected to if the Account Link is expired, has been used, or is otherwise invalid. The URL you specify should attempt to generate a new Account Link with the same parameters used to create the original Account Link, then redirect the user to the new Account Link URL so they can continue the flow. Make sure to authenticate the user before redirecting to the new Account Link, in case the URL leaks to a third party. If a new Account Link can't be generated, or if the redirect fails, you should display a useful error to the user. """ return_url: Optional[str] """ @@ -79,15 +79,15 @@ class CollectionOptions(StripeObject): account_onboarding: Optional[AccountOnboarding] """ - Indicates that the AccountLink provided should onboard an account. + Hash containing configuration options for an Account Link object that onboards a new account. """ account_update: Optional[AccountUpdate] """ - Indicates that the AccountLink provided should update a previously onboarded account. + Hash containing configuration options for an Account Link that updates an existing account. """ type: Literal["account_onboarding", "account_update"] """ - Open Enum. The type of AccountLink the user is requesting. + Open Enum. The type of Account Link the user is requesting. """ _inner_class_types = { "account_onboarding": AccountOnboarding, @@ -96,15 +96,15 @@ class CollectionOptions(StripeObject): account: str """ - The ID of the Account the link was created for. + The ID of the connected account this Account Link applies to. """ created: str """ - The timestamp at which this AccountLink was created. + The timestamp at which this Account Link was created. """ expires_at: str """ - The timestamp at which this AccountLink will expire. + The timestamp at which this Account Link will expire. """ livemode: bool """ @@ -116,10 +116,10 @@ class CollectionOptions(StripeObject): """ url: str """ - The URL for the AccountLink. + The URL at which the account can access the Stripe-hosted flow. """ use_case: UseCase """ - The use case of AccountLink the user is requesting. + Hash containing usage options. """ _inner_class_types = {"use_case": UseCase} diff --git a/stripe/v2/core/_account_link_service.py b/stripe/v2/core/_account_link_service.py index 4b87f8384..19b868c0c 100644 --- a/stripe/v2/core/_account_link_service.py +++ b/stripe/v2/core/_account_link_service.py @@ -19,7 +19,7 @@ def create( options: Optional["RequestOptions"] = None, ) -> "AccountLink": """ - Creates an AccountLink object that includes a single-use Stripe URL that the merchant can redirect their user to in order to take them to a Stripe-hosted application such as Recipient Onboarding. + Creates an AccountLink object that includes a single-use URL that an account can use to access a Stripe-hosted flow for collecting or updating required information. """ return cast( "AccountLink", @@ -38,7 +38,7 @@ async def create_async( options: Optional["RequestOptions"] = None, ) -> "AccountLink": """ - Creates an AccountLink object that includes a single-use Stripe URL that the merchant can redirect their user to in order to take them to a Stripe-hosted application such as Recipient Onboarding. + Creates an AccountLink object that includes a single-use URL that an account can use to access a Stripe-hosted flow for collecting or updating required information. """ return cast( "AccountLink", diff --git a/stripe/v2/core/_account_person.py b/stripe/v2/core/_account_person.py index 8cc0c25bc..05d51e4b2 100644 --- a/stripe/v2/core/_account_person.py +++ b/stripe/v2/core/_account_person.py @@ -7,7 +7,7 @@ class AccountPerson(StripeObject): """ - Person retrieval response schema. + A Person represents an individual associated with an Account's identity (for example, an owner, director, executive, or representative). Use Persons to provide and update identity information for verification and compliance. """ OBJECT_NAME: ClassVar[Literal["v2.core.account_person"]] = ( @@ -45,7 +45,7 @@ class AdditionalAddress(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class AdditionalName(StripeObject): @@ -114,7 +114,7 @@ class Address(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class DateOfBirth(StripeObject): @@ -236,36 +236,81 @@ class IdNumber(StripeObject): type: Literal[ "ae_eid", "ao_nif", + "ar_cuil", "ar_dni", + "at_stn", "az_tin", "bd_brc", "bd_etin", "bd_nid", + "be_nrn", + "bg_ucn", + "bn_nric", "br_cpf", + "ca_sin", + "ch_oasi", + "cl_rut", + "cn_pp", + "co_nuip", + "cr_ci", "cr_cpf", "cr_dimex", "cr_nite", + "cy_tic", + "cz_rc", "de_stn", + "dk_cpr", + "do_cie", "do_rcn", + "ec_ci", + "ee_ik", + "es_nif", + "fi_hetu", + "fr_nir", + "gb_nino", + "gr_afm", "gt_nit", "hk_id", + "hr_oib", + "hu_ad", + "id_nik", + "ie_ppsn", + "is_kt", + "it_cf", + "jp_inc", + "ke_pin", "kz_iin", + "li_peid", + "lt_ak", + "lu_nif", + "lv_pk", "mx_rfc", "my_nric", "mz_nuit", + "ng_nin", "nl_bsn", + "no_nin", + "nz_ird", "pe_dni", "pk_cnic", "pk_snic", + "pl_pesel", + "pt_nif", + "ro_cnp", "sa_tin", + "se_pin", "sg_fin", "sg_nric", + "sk_dic", "th_lc", "th_pin", + "tr_tin", "us_itin", "us_itin_last_4", "us_ssn", "us_ssn_last_4", + "uy_dni", + "za_id", ] """ The ID number type of an individual. @@ -274,11 +319,11 @@ class IdNumber(StripeObject): class Relationship(StripeObject): authorizer: Optional[bool] """ - Whether the individual is an authorizer of the Account's legal entity. + Whether the individual is an authorizer of the Account's identity. """ director: Optional[bool] """ - Whether the individual is a director of the Account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations. + Whether the individual is a director of the Account's identity. Directors are typically members of the governing board of the company or are responsible for making sure that the company meets its regulatory obligations. """ executive: Optional[bool] """ @@ -290,11 +335,11 @@ class Relationship(StripeObject): """ owner: Optional[bool] """ - Whether the individual is an owner of the Account's legal entity. + Whether the individual is an owner of the Account's identity. """ percent_ownership: Optional[str] """ - The percent owned by the individual of the Account's legal entity. + The percentage of the Account's identity that the individual owns. """ representative: Optional[bool] """ @@ -333,7 +378,7 @@ class Kana(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ class Kanji(StripeObject): @@ -363,7 +408,7 @@ class Kanji(StripeObject): """ town: Optional[str] """ - Town or cho-me. + Town or district. """ kana: Optional[Kana] diff --git a/stripe/v2/core/_account_token_service.py b/stripe/v2/core/_account_token_service.py index a36e8a4ec..a79949eee 100644 --- a/stripe/v2/core/_account_token_service.py +++ b/stripe/v2/core/_account_token_service.py @@ -19,7 +19,7 @@ class AccountTokenService(StripeService): def create( self, - params: "AccountTokenCreateParams", + params: Optional["AccountTokenCreateParams"] = None, options: Optional["RequestOptions"] = None, ) -> "AccountToken": """ @@ -38,7 +38,7 @@ def create( async def create_async( self, - params: "AccountTokenCreateParams", + params: Optional["AccountTokenCreateParams"] = None, options: Optional["RequestOptions"] = None, ) -> "AccountToken": """ diff --git a/stripe/v2/core/accounts/_person_service.py b/stripe/v2/core/accounts/_person_service.py index a39889760..0d99f5344 100644 --- a/stripe/v2/core/accounts/_person_service.py +++ b/stripe/v2/core/accounts/_person_service.py @@ -35,7 +35,7 @@ def list( options: Optional["RequestOptions"] = None, ) -> "ListObject[AccountPerson]": """ - Returns a list of Persons associated with an Account. + Returns a paginated list of Persons associated with an Account. """ return cast( "ListObject[AccountPerson]", @@ -57,7 +57,7 @@ async def list_async( options: Optional["RequestOptions"] = None, ) -> "ListObject[AccountPerson]": """ - Returns a list of Persons associated with an Account. + Returns a paginated list of Persons associated with an Account. """ return cast( "ListObject[AccountPerson]", @@ -79,7 +79,7 @@ def create( options: Optional["RequestOptions"] = None, ) -> "AccountPerson": """ - Create a Person associated with an Account. + Create a Person. Adds an individual to an Account's identity. You can set relationship attributes and identity information at creation. """ return cast( "AccountPerson", @@ -101,7 +101,7 @@ async def create_async( options: Optional["RequestOptions"] = None, ) -> "AccountPerson": """ - Create a Person associated with an Account. + Create a Person. Adds an individual to an Account's identity. You can set relationship attributes and identity information at creation. """ return cast( "AccountPerson", diff --git a/stripe/v2/core/vault/_us_bank_account.py b/stripe/v2/core/vault/_us_bank_account.py index fa2c1ad61..711c6f7ac 100644 --- a/stripe/v2/core/vault/_us_bank_account.py +++ b/stripe/v2/core/vault/_us_bank_account.py @@ -68,6 +68,10 @@ class MicrodepositVerificationDetails(StripeObject): """ The fedwire routing number of the bank account. """ + financial_connections_account: Optional[str] + """ + The ID of the Financial Connections Account used to create the bank account. + """ id: str """ The ID of the USBankAccount object. diff --git a/stripe/v2/money_management/_adjustment.py b/stripe/v2/money_management/_adjustment.py index 6006e2db5..eef2371e3 100644 --- a/stripe/v2/money_management/_adjustment.py +++ b/stripe/v2/money_management/_adjustment.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Optional from typing_extensions import Literal @@ -54,6 +53,16 @@ class AdjustedFlow(StripeObject): Closed Enum. If applicable, the type of flow linked to this Adjustment. The field matching this value will contain the ID of the flow. """ + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + adjusted_flow: Optional[AdjustedFlow] """ If applicable, contains information about the original flow linked to this Adjustment. @@ -90,4 +99,4 @@ class AdjustedFlow(StripeObject): """ A link to the Stripe-hosted receipt that is provided when money movement is considered regulated under Stripe's money transmission licenses. The receipt link remains active for 60 days from the Adjustment creation date. After this period, the link will expire and the receipt url value will be null. """ - _inner_class_types = {"adjusted_flow": AdjustedFlow} + _inner_class_types = {"adjusted_flow": AdjustedFlow, "amount": Amount} diff --git a/stripe/v2/money_management/_financial_account.py b/stripe/v2/money_management/_financial_account.py index 02561c4f8..b2361c056 100644 --- a/stripe/v2/money_management/_financial_account.py +++ b/stripe/v2/money_management/_financial_account.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Dict, List, Optional from typing_extensions import Literal @@ -16,18 +15,58 @@ class FinancialAccount(StripeObject): ) class Balance(StripeObject): - available: Dict[str, Amount] + class Available(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + class InboundPending(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + class OutboundPending(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + available: Dict[str, Available] """ Balance that can be used for money movement. """ - inbound_pending: Dict[str, Amount] + inbound_pending: Dict[str, InboundPending] """ Balance of inbound funds that will later transition to the `available` balance. """ - outbound_pending: Dict[str, Amount] + outbound_pending: Dict[str, OutboundPending] """ Balance of funds that are being used for a pending outbound money movement. """ + _inner_class_types = { + "available": Available, + "inbound_pending": InboundPending, + "outbound_pending": OutboundPending, + } + _inner_class_dicts = [ + "available", + "inbound_pending", + "outbound_pending", + ] class Other(StripeObject): type: str diff --git a/stripe/v2/money_management/_inbound_transfer.py b/stripe/v2/money_management/_inbound_transfer.py index 18ff38e20..46f80f32e 100644 --- a/stripe/v2/money_management/_inbound_transfer.py +++ b/stripe/v2/money_management/_inbound_transfer.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Dict, List, Optional from typing_extensions import Literal, TYPE_CHECKING @@ -19,7 +18,27 @@ class InboundTransfer(StripeObject): "v2.money_management.inbound_transfer" ) + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class From(StripeObject): + class Debited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class PaymentMethod(StripeObject): type: str """ @@ -30,7 +49,7 @@ class PaymentMethod(StripeObject): The destination US bank account identifier. eg "usba_***". """ - debited: Amount + debited: Debited """ The amount in specified currency that was debited from the Payment Method. """ @@ -38,10 +57,23 @@ class PaymentMethod(StripeObject): """ The Payment Method object used to create the InboundTransfer. """ - _inner_class_types = {"payment_method": PaymentMethod} + _inner_class_types = { + "debited": Debited, + "payment_method": PaymentMethod, + } class To(StripeObject): - credited: Amount + class Credited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + credited: Credited """ The amount by which the FinancialAccount balance is credited. """ @@ -49,6 +81,7 @@ class To(StripeObject): """ The FinancialAccount that funds will land in. """ + _inner_class_types = {"credited": Credited} class TransferHistory(StripeObject): class BankDebitFailed(StripeObject): @@ -167,6 +200,7 @@ class BankDebitReturned(StripeObject): A list of history objects, representing changes in the state of the InboundTransfer. """ _inner_class_types = { + "amount": Amount, "from": From, "to": To, "transfer_history": TransferHistory, diff --git a/stripe/v2/money_management/_outbound_payment.py b/stripe/v2/money_management/_outbound_payment.py index 14fb74116..9d3699ac4 100644 --- a/stripe/v2/money_management/_outbound_payment.py +++ b/stripe/v2/money_management/_outbound_payment.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Dict, Optional from typing_extensions import Literal @@ -15,6 +14,16 @@ class OutboundPayment(StripeObject): "v2.money_management.outbound_payment" ) + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class DeliveryOptions(StripeObject): bank_account: Optional[Literal["automatic", "local", "wire"]] """ @@ -22,7 +31,17 @@ class DeliveryOptions(StripeObject): """ class From(StripeObject): - debited: Amount + class Debited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + debited: Debited """ The monetary amount debited from the sender, only set on responses. """ @@ -30,6 +49,7 @@ class From(StripeObject): """ The FinancialAccount that funds were pulled from. """ + _inner_class_types = {"debited": Debited} class RecipientNotification(StripeObject): setting: Literal["configured", "none"] @@ -103,7 +123,17 @@ class StatusTransitions(StripeObject): """ class To(StripeObject): - credited: Amount + class Credited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + credited: Credited """ The monetary amount being credited to the destination. """ @@ -115,6 +145,7 @@ class To(StripeObject): """ To which account the OutboundPayment is sent. """ + _inner_class_types = {"credited": Credited} class TraceId(StripeObject): status: Literal["pending", "supported", "unsupported"] @@ -215,6 +246,7 @@ class TraceId(StripeObject): A unique identifier that can be used to track this OutboundPayment with recipient bank. Banks might call this a “reference number” or something similar. """ _inner_class_types = { + "amount": Amount, "delivery_options": DeliveryOptions, "from": From, "recipient_notification": RecipientNotification, diff --git a/stripe/v2/money_management/_outbound_payment_quote.py b/stripe/v2/money_management/_outbound_payment_quote.py index e918e753a..7e02c1e8a 100644 --- a/stripe/v2/money_management/_outbound_payment_quote.py +++ b/stripe/v2/money_management/_outbound_payment_quote.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Dict, List, Optional from typing_extensions import Literal @@ -15,6 +14,16 @@ class OutboundPaymentQuote(StripeObject): Literal["v2.money_management.outbound_payment_quote"] ] = "v2.money_management.outbound_payment_quote" + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class DeliveryOptions(StripeObject): bank_account: Optional[Literal["automatic", "local", "wire"]] """ @@ -22,6 +31,16 @@ class DeliveryOptions(StripeObject): """ class EstimatedFee(StripeObject): + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + amount: Amount """ The fee amount for corresponding fee type. @@ -36,9 +55,20 @@ class EstimatedFee(StripeObject): """ The fee type. """ + _inner_class_types = {"amount": Amount} class From(StripeObject): - debited: Amount + class Debited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + debited: Debited """ The monetary amount debited from the sender, only set on responses. """ @@ -46,6 +76,7 @@ class From(StripeObject): """ The FinancialAccount that funds were pulled from. """ + _inner_class_types = {"debited": Debited} class FxQuote(StripeObject): class Rates(StripeObject): @@ -78,7 +109,17 @@ class Rates(StripeObject): _inner_class_dicts = ["rates"] class To(StripeObject): - credited: Amount + class Credited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + credited: Credited """ The monetary amount being credited to the destination. """ @@ -90,6 +131,7 @@ class To(StripeObject): """ To which account the OutboundPayment is sent. """ + _inner_class_types = {"credited": Credited} amount: Amount """ @@ -133,6 +175,7 @@ class To(StripeObject): Details about the recipient of an OutboundPaymentQuote. """ _inner_class_types = { + "amount": Amount, "delivery_options": DeliveryOptions, "estimated_fees": EstimatedFee, "from": From, diff --git a/stripe/v2/money_management/_outbound_transfer.py b/stripe/v2/money_management/_outbound_transfer.py index 16d87dcca..abf0ad957 100644 --- a/stripe/v2/money_management/_outbound_transfer.py +++ b/stripe/v2/money_management/_outbound_transfer.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Dict, Optional from typing_extensions import Literal @@ -15,6 +14,16 @@ class OutboundTransfer(StripeObject): "v2.money_management.outbound_transfer" ) + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class DeliveryOptions(StripeObject): bank_account: Optional[Literal["automatic", "local", "wire"]] """ @@ -22,7 +31,17 @@ class DeliveryOptions(StripeObject): """ class From(StripeObject): - debited: Amount + class Debited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + debited: Debited """ The monetary amount debited from the sender, only set on responses. """ @@ -30,6 +49,7 @@ class From(StripeObject): """ The FinancialAccount that funds were pulled from. """ + _inner_class_types = {"debited": Debited} class StatusDetails(StripeObject): class Failed(StripeObject): @@ -96,7 +116,17 @@ class StatusTransitions(StripeObject): """ class To(StripeObject): - credited: Amount + class Credited(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + credited: Credited """ The monetary amount being credited to the destination. """ @@ -104,6 +134,7 @@ class To(StripeObject): """ The payout method which the OutboundTransfer uses to send payout. """ + _inner_class_types = {"credited": Credited} class TraceId(StripeObject): status: Literal["pending", "supported", "unsupported"] @@ -196,6 +227,7 @@ class TraceId(StripeObject): A unique identifier that can be used to track this OutboundTransfer with recipient bank. Banks might call this a “reference number” or something similar. """ _inner_class_types = { + "amount": Amount, "delivery_options": DeliveryOptions, "from": From, "status_details": StatusDetails, diff --git a/stripe/v2/money_management/_payout_method.py b/stripe/v2/money_management/_payout_method.py index ed5844cd1..1ae47d035 100644 --- a/stripe/v2/money_management/_payout_method.py +++ b/stripe/v2/money_management/_payout_method.py @@ -37,6 +37,10 @@ class BankAccount(StripeObject): """ List of enabled flows for this bank account (wire or local). """ + financial_connections_account: Optional[str] + """ + The ID of the Financial Connections Account used to create the bank account. + """ last4: str """ The last 4 digits of the account number. diff --git a/stripe/v2/money_management/_received_credit.py b/stripe/v2/money_management/_received_credit.py index 85d6f34f8..62cfd6511 100644 --- a/stripe/v2/money_management/_received_credit.py +++ b/stripe/v2/money_management/_received_credit.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Optional from typing_extensions import Literal @@ -15,6 +14,16 @@ class ReceivedCredit(StripeObject): "v2.money_management.received_credit" ) + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class BalanceTransfer(StripeObject): from_account: Optional[str] """ @@ -32,7 +41,13 @@ class BalanceTransfer(StripeObject): """ The ID of the payout object that originated the ReceivedCredit. """ - type: Literal["outbound_payment", "outbound_transfer", "payout_v1"] + transfer: Optional[str] + """ + The ID of the v1 transfer object that originated the ReceivedCredit. + """ + type: Literal[ + "outbound_payment", "outbound_transfer", "transfer", "payout_v1" + ] """ Open Enum. The type of Stripe Money Movement that originated the ReceivedCredit. """ @@ -239,6 +254,7 @@ class StatusTransitions(StripeObject): Open Enum. The type of flow that caused the ReceivedCredit. """ _inner_class_types = { + "amount": Amount, "balance_transfer": BalanceTransfer, "bank_transfer": BankTransfer, "status_details": StatusDetails, diff --git a/stripe/v2/money_management/_received_debit.py b/stripe/v2/money_management/_received_debit.py index b50f6b432..b8b7caee6 100644 --- a/stripe/v2/money_management/_received_debit.py +++ b/stripe/v2/money_management/_received_debit.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Optional from typing_extensions import Literal @@ -15,6 +14,16 @@ class ReceivedDebit(StripeObject): "v2.money_management.received_debit" ) + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class BankTransfer(StripeObject): class UsBankAccount(StripeObject): bank_name: Optional[str] @@ -134,9 +143,10 @@ class StatusTransitions(StripeObject): """ type: Literal["bank_transfer", "external_debit"] """ - Open Enum. The type of the ReceivedDebit. + Open enum, the type of the received debit. """ _inner_class_types = { + "amount": Amount, "bank_transfer": BankTransfer, "status_details": StatusDetails, "status_transitions": StatusTransitions, diff --git a/stripe/v2/money_management/_transaction.py b/stripe/v2/money_management/_transaction.py index b4fc713f5..a66224280 100644 --- a/stripe/v2/money_management/_transaction.py +++ b/stripe/v2/money_management/_transaction.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Optional from typing_extensions import Literal @@ -15,19 +14,64 @@ class Transaction(StripeObject): "v2.money_management.transaction" ) + class Amount(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + class BalanceImpact(StripeObject): - available: Amount + class Available(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + class InboundPending(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + class OutboundPending(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + available: Available """ Impact to the available balance. """ - inbound_pending: Amount + inbound_pending: InboundPending """ Impact to the inbound_pending balance. """ - outbound_pending: Amount + outbound_pending: OutboundPending """ Impact to the outbound_pending balance. """ + _inner_class_types = { + "available": Available, + "inbound_pending": InboundPending, + "outbound_pending": OutboundPending, + } class Flow(StripeObject): adjustment: Optional[str] @@ -146,6 +190,7 @@ class StatusTransitions(StripeObject): Timestamps for when the Transaction transitioned to a particular status. """ _inner_class_types = { + "amount": Amount, "balance_impact": BalanceImpact, "flow": Flow, "status_transitions": StatusTransitions, diff --git a/stripe/v2/money_management/_transaction_entry.py b/stripe/v2/money_management/_transaction_entry.py index 995487444..c3b3bee2d 100644 --- a/stripe/v2/money_management/_transaction_entry.py +++ b/stripe/v2/money_management/_transaction_entry.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # File generated from our OpenAPI spec from stripe._stripe_object import StripeObject -from stripe.v2._amount import Amount from typing import ClassVar, Optional from typing_extensions import Literal @@ -16,18 +15,53 @@ class TransactionEntry(StripeObject): ) class BalanceImpact(StripeObject): - available: Amount + class Available(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + class InboundPending(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + class OutboundPending(StripeObject): + currency: Optional[str] + """ + Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). + """ + value: Optional[int] + """ + A non-negative integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). + """ + + available: Available """ Impact to the available balance. """ - inbound_pending: Amount + inbound_pending: InboundPending """ Impact to the inbound_pending balance. """ - outbound_pending: Amount + outbound_pending: OutboundPending """ Impact to the outbound_pending balance. """ + _inner_class_types = { + "available": Available, + "inbound_pending": InboundPending, + "outbound_pending": OutboundPending, + } class TransactionDetails(StripeObject): class Flow(StripeObject): diff --git a/tests/api_resources/test_ephemeral_key.py b/tests/api_resources/test_ephemeral_key.py index fc5110595..0e7e76b94 100644 --- a/tests/api_resources/test_ephemeral_key.py +++ b/tests/api_resources/test_ephemeral_key.py @@ -38,3 +38,27 @@ def test_can_delete(self, http_client_mock): "delete", path="/v1/ephemeral_keys/ephkey_123" ) assert isinstance(resource, stripe.EphemeralKey) + + +class TestEphemeralKeyAsync(object): + @pytest.mark.anyio + async def test_is_creatable_async(self, http_client_mock): + resource = await stripe.EphemeralKey.create_async( + customer="cus_123", stripe_version="2017-05-25" + ) + http_client_mock.assert_requested( + "post", + path="/v1/ephemeral_keys", + stripe_version="2017-05-25", + post_data="customer=cus_123", + ) + assert isinstance(resource, stripe.EphemeralKey) + + @pytest.mark.anyio + async def test_is_not_creatable_without_an_explicit_api_version_async( + self, + ): + with pytest.raises( + ValueError, match="stripe_version must be specified" + ): + await stripe.EphemeralKey.create_async(customer="cus_123") diff --git a/tests/test_generated_examples.py b/tests/test_generated_examples.py index 68e740b97..aa5f1c3e3 100644 --- a/tests/test_generated_examples.py +++ b/tests/test_generated_examples.py @@ -44563,236 +44563,13 @@ def test_v2_core_account_token_post_service( http_client=http_client_mock.get_mock_http_client(), ) - client.v2.core.account_tokens.create( - { - "identity": { - "attestations": { - "directorship_declaration": {"attested": True}, - "ownership_declaration": {"attested": True}, - "persons_provided": { - "directors": True, - "executives": True, - "owners": True, - "ownership_exemption_reason": "qualified_entity_exceeds_ownership_threshold", - }, - "representative_declaration": {"attested": True}, - "terms_of_service": { - "account": {"shown_and_accepted": True}, - "storer": {"shown_and_accepted": True}, - }, - }, - "business_details": { - "address": { - "city": "city", - "country": "country", - "line1": "line1", - "line2": "line2", - "postal_code": "postal_code", - "state": "state", - "town": "town", - }, - "annual_revenue": { - "amount": {"currency": "USD", "value": 96}, - "fiscal_year_end": "fiscal_year_end", - }, - "documents": { - "bank_account_ownership_verification": { - "files": ["files"], - "type": "files", - }, - "company_license": { - "files": ["files"], - "type": "files", - }, - "company_memorandum_of_association": { - "files": ["files"], - "type": "files", - }, - "company_ministerial_decree": { - "files": ["files"], - "type": "files", - }, - "company_registration_verification": { - "files": ["files"], - "type": "files", - }, - "company_tax_id_verification": { - "files": ["files"], - "type": "files", - }, - "primary_verification": { - "front_back": { - "back": "back", - "front": "front", - }, - "type": "front_back", - }, - "proof_of_address": { - "files": ["files"], - "type": "files", - }, - "proof_of_registration": { - "files": ["files"], - "type": "files", - }, - "proof_of_ultimate_beneficial_ownership": { - "files": ["files"], - "type": "files", - }, - }, - "estimated_worker_count": 884794319, - "id_numbers": [ - { - "registrar": "registrar", - "type": "th_prn", - "value": "value", - }, - ], - "monthly_estimated_revenue": { - "amount": {"currency": "USD", "value": 96}, - }, - "phone": "phone", - "registered_name": "registered_name", - "script_addresses": { - "kana": { - "city": "city", - "country": "country", - "line1": "line1", - "line2": "line2", - "postal_code": "postal_code", - "state": "state", - "town": "town", - }, - "kanji": { - "city": "city", - "country": "country", - "line1": "line1", - "line2": "line2", - "postal_code": "postal_code", - "state": "state", - "town": "town", - }, - }, - "script_names": { - "kana": {"registered_name": "registered_name"}, - "kanji": {"registered_name": "registered_name"}, - }, - "structure": "public_listed_corporation", - }, - "entity_type": "individual", - "individual": { - "additional_addresses": [ - { - "city": "city", - "country": "country", - "line1": "line1", - "line2": "line2", - "postal_code": "postal_code", - "purpose": "registered", - "state": "state", - "town": "town", - }, - ], - "additional_names": [ - { - "full_name": "full_name", - "given_name": "given_name", - "purpose": "alias", - "surname": "surname", - }, - ], - "address": { - "city": "city", - "country": "country", - "line1": "line1", - "line2": "line2", - "postal_code": "postal_code", - "state": "state", - "town": "town", - }, - "date_of_birth": { - "day": 99228, - "month": 104080000, - "year": 3704893, - }, - "documents": { - "company_authorization": { - "files": ["files"], - "type": "files", - }, - "passport": {"files": ["files"], "type": "files"}, - "primary_verification": { - "front_back": { - "back": "back", - "front": "front", - }, - "type": "front_back", - }, - "secondary_verification": { - "front_back": { - "back": "back", - "front": "front", - }, - "type": "front_back", - }, - "visa": {"files": ["files"], "type": "files"}, - }, - "email": "email", - "given_name": "given_name", - "id_numbers": [{"type": "th_lc", "value": "value"}], - "legal_gender": "male", - "metadata": {"key": "metadata"}, - "nationalities": ["nationalities"], - "phone": "phone", - "political_exposure": "none", - "relationship": { - "director": True, - "executive": True, - "owner": True, - "percent_ownership": "percent_ownership", - "title": "title", - }, - "script_addresses": { - "kana": { - "city": "city", - "country": "country", - "line1": "line1", - "line2": "line2", - "postal_code": "postal_code", - "state": "state", - "town": "town", - }, - "kanji": { - "city": "city", - "country": "country", - "line1": "line1", - "line2": "line2", - "postal_code": "postal_code", - "state": "state", - "town": "town", - }, - }, - "script_names": { - "kana": { - "given_name": "given_name", - "surname": "surname", - }, - "kanji": { - "given_name": "given_name", - "surname": "surname", - }, - }, - "surname": "surname", - }, - }, - } - ) + client.v2.core.account_tokens.create() http_client_mock.assert_requested( "post", path="/v2/core/account_tokens", query_string="", api_base="https://api.stripe.com", - post_data='{"identity":{"attestations":{"directorship_declaration":{"attested":true},"ownership_declaration":{"attested":true},"persons_provided":{"directors":true,"executives":true,"owners":true,"ownership_exemption_reason":"qualified_entity_exceeds_ownership_threshold"},"representative_declaration":{"attested":true},"terms_of_service":{"account":{"shown_and_accepted":true},"storer":{"shown_and_accepted":true}}},"business_details":{"address":{"city":"city","country":"country","line1":"line1","line2":"line2","postal_code":"postal_code","state":"state","town":"town"},"annual_revenue":{"amount":{"currency":"USD","value":96},"fiscal_year_end":"fiscal_year_end"},"documents":{"bank_account_ownership_verification":{"files":["files"],"type":"files"},"company_license":{"files":["files"],"type":"files"},"company_memorandum_of_association":{"files":["files"],"type":"files"},"company_ministerial_decree":{"files":["files"],"type":"files"},"company_registration_verification":{"files":["files"],"type":"files"},"company_tax_id_verification":{"files":["files"],"type":"files"},"primary_verification":{"front_back":{"back":"back","front":"front"},"type":"front_back"},"proof_of_address":{"files":["files"],"type":"files"},"proof_of_registration":{"files":["files"],"type":"files"},"proof_of_ultimate_beneficial_ownership":{"files":["files"],"type":"files"}},"estimated_worker_count":884794319,"id_numbers":[{"registrar":"registrar","type":"th_prn","value":"value"}],"monthly_estimated_revenue":{"amount":{"currency":"USD","value":96}},"phone":"phone","registered_name":"registered_name","script_addresses":{"kana":{"city":"city","country":"country","line1":"line1","line2":"line2","postal_code":"postal_code","state":"state","town":"town"},"kanji":{"city":"city","country":"country","line1":"line1","line2":"line2","postal_code":"postal_code","state":"state","town":"town"}},"script_names":{"kana":{"registered_name":"registered_name"},"kanji":{"registered_name":"registered_name"}},"structure":"public_listed_corporation"},"entity_type":"individual","individual":{"additional_addresses":[{"city":"city","country":"country","line1":"line1","line2":"line2","postal_code":"postal_code","purpose":"registered","state":"state","town":"town"}],"additional_names":[{"full_name":"full_name","given_name":"given_name","purpose":"alias","surname":"surname"}],"address":{"city":"city","country":"country","line1":"line1","line2":"line2","postal_code":"postal_code","state":"state","town":"town"},"date_of_birth":{"day":99228,"month":104080000,"year":3704893},"documents":{"company_authorization":{"files":["files"],"type":"files"},"passport":{"files":["files"],"type":"files"},"primary_verification":{"front_back":{"back":"back","front":"front"},"type":"front_back"},"secondary_verification":{"front_back":{"back":"back","front":"front"},"type":"front_back"},"visa":{"files":["files"],"type":"files"}},"email":"email","given_name":"given_name","id_numbers":[{"type":"th_lc","value":"value"}],"legal_gender":"male","metadata":{"key":"metadata"},"nationalities":["nationalities"],"phone":"phone","political_exposure":"none","relationship":{"director":true,"executive":true,"owner":true,"percent_ownership":"percent_ownership","title":"title"},"script_addresses":{"kana":{"city":"city","country":"country","line1":"line1","line2":"line2","postal_code":"postal_code","state":"state","town":"town"},"kanji":{"city":"city","country":"country","line1":"line1","line2":"line2","postal_code":"postal_code","state":"state","town":"town"}},"script_names":{"kana":{"given_name":"given_name","surname":"surname"},"kanji":{"given_name":"given_name","surname":"surname"}},"surname":"surname"}}}', + post_data="{}", is_json=True, ) @@ -45575,7 +45352,7 @@ def test_v2_money_management_inbound_transfer_post_service( client.v2.money_management.inbound_transfers.create( { - "amount": {"currency": "USD", "value": 96}, + "amount": {"value": 111972721, "currency": "usd"}, "from": { "currency": "usd", "payment_method": "payment_method", @@ -45591,7 +45368,7 @@ def test_v2_money_management_inbound_transfer_post_service( path="/v2/money_management/inbound_transfers", query_string="", api_base="https://api.stripe.com", - post_data='{"amount":{"currency":"USD","value":96},"from":{"currency":"usd","payment_method":"payment_method"},"to":{"currency":"usd","financial_account":"financial_account"}}', + post_data='{"amount":{"value":111972721,"currency":"usd"},"from":{"currency":"usd","payment_method":"payment_method"},"to":{"currency":"usd","financial_account":"financial_account"}}', is_json=True, ) @@ -45649,7 +45426,7 @@ def test_v2_money_management_outbound_payment_post_service( client.v2.money_management.outbound_payments.create( { - "amount": {"currency": "USD", "value": 96}, + "amount": {"value": 111972721, "currency": "usd"}, "from": { "currency": "usd", "financial_account": "financial_account", @@ -45666,7 +45443,7 @@ def test_v2_money_management_outbound_payment_post_service( path="/v2/money_management/outbound_payments", query_string="", api_base="https://api.stripe.com", - post_data='{"amount":{"currency":"USD","value":96},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"currency":"usd","payout_method":"payout_method","recipient":"recipient"}}', + post_data='{"amount":{"value":111972721,"currency":"usd"},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"currency":"usd","payout_method":"payout_method","recipient":"recipient"}}', is_json=True, ) @@ -45726,7 +45503,7 @@ def test_v2_money_management_outbound_payment_quote_post_service( client.v2.money_management.outbound_payment_quotes.create( { - "amount": {"currency": "USD", "value": 96}, + "amount": {"value": 111972721, "currency": "usd"}, "from": { "currency": "usd", "financial_account": "financial_account", @@ -45743,7 +45520,7 @@ def test_v2_money_management_outbound_payment_quote_post_service( path="/v2/money_management/outbound_payment_quotes", query_string="", api_base="https://api.stripe.com", - post_data='{"amount":{"currency":"USD","value":96},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"currency":"usd","payout_method":"payout_method","recipient":"recipient"}}', + post_data='{"amount":{"value":111972721,"currency":"usd"},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"currency":"usd","payout_method":"payout_method","recipient":"recipient"}}', is_json=True, ) @@ -45907,7 +45684,7 @@ def test_v2_money_management_outbound_transfer_post_service( client.v2.money_management.outbound_transfers.create( { - "amount": {"currency": "USD", "value": 96}, + "amount": {"value": 111972721, "currency": "usd"}, "from": { "currency": "usd", "financial_account": "financial_account", @@ -45920,7 +45697,7 @@ def test_v2_money_management_outbound_transfer_post_service( path="/v2/money_management/outbound_transfers", query_string="", api_base="https://api.stripe.com", - post_data='{"amount":{"currency":"USD","value":96},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"currency":"usd","payout_method":"payout_method"}}', + post_data='{"amount":{"value":111972721,"currency":"usd"},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"currency":"usd","payout_method":"payout_method"}}', is_json=True, ) @@ -46244,14 +46021,17 @@ def test_v2_test_helpers_financial_address_post_service( client.v2.test_helpers.financial_addresses.credit( "id_123", - {"amount": {"currency": "USD", "value": 96}, "network": "rtp"}, + { + "amount": {"value": 111972721, "currency": "usd"}, + "network": "rtp", + }, ) http_client_mock.assert_requested( "post", path="/v2/test_helpers/financial_addresses/id_123/credit", query_string="", api_base="https://api.stripe.com", - post_data='{"amount":{"currency":"USD","value":96},"network":"rtp"}', + post_data='{"amount":{"value":111972721,"currency":"usd"},"network":"rtp"}', is_json=True, ) @@ -46368,6 +46148,33 @@ def test_blocked_by_stripe_error_service( is_json=True, ) + def test_controlled_by_alternate_resource_error_service( + self, http_client_mock: HTTPClientMock + ) -> None: + http_client_mock.stub_request( + "post", + "/v2/money_management/outbound_setup_intents", + rbody='{"error":{"type":"controlled_by_alternate_resource","code":"payout_method_cannot_be_archived"}}', + rcode=400, + ) + client = StripeClient( + "sk_test_123", + http_client=http_client_mock.get_mock_http_client(), + ) + + try: + client.v2.money_management.outbound_setup_intents.create() + except _error.ControlledByAlternateResourceError: + pass + http_client_mock.assert_requested( + "post", + path="/v2/money_management/outbound_setup_intents", + query_string="", + api_base="https://api.stripe.com", + post_data="{}", + is_json=True, + ) + def test_controlled_by_dashboard_error_service( self, http_client_mock: HTTPClientMock ) -> None: @@ -46475,7 +46282,7 @@ def test_insufficient_funds_error_service( try: client.v2.money_management.outbound_payments.create( { - "amount": {"currency": "USD", "value": 96}, + "amount": {}, "from": { "currency": "usd", "financial_account": "financial_account", @@ -46490,7 +46297,7 @@ def test_insufficient_funds_error_service( path="/v2/money_management/outbound_payments", query_string="", api_base="https://api.stripe.com", - post_data='{"amount":{"currency":"USD","value":96},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"recipient":"recipient"}}', + post_data='{"amount":{},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"recipient":"recipient"}}', is_json=True, ) @@ -46637,31 +46444,6 @@ def test_quota_exceeded_error_service( is_json=True, ) - def test_rate_limit_error_service( - self, http_client_mock: HTTPClientMock - ) -> None: - http_client_mock.stub_request( - "get", - "/v2/core/accounts/id_123", - rbody='{"error":{"type":"rate_limit","code":"account_rate_limit_exceeded"}}', - rcode=400, - ) - client = StripeClient( - "sk_test_123", - http_client=http_client_mock.get_mock_http_client(), - ) - - try: - client.v2.core.accounts.retrieve("id_123") - except _error.RateLimitError: - pass - http_client_mock.assert_requested( - "get", - path="/v2/core/accounts/id_123", - query_string="", - api_base="https://api.stripe.com", - ) - def test_recipient_not_notifiable_error_service( self, http_client_mock: HTTPClientMock ) -> None: @@ -46679,7 +46461,7 @@ def test_recipient_not_notifiable_error_service( try: client.v2.money_management.outbound_payments.create( { - "amount": {"currency": "USD", "value": 96}, + "amount": {}, "from": { "currency": "usd", "financial_account": "financial_account", @@ -46694,7 +46476,7 @@ def test_recipient_not_notifiable_error_service( path="/v2/money_management/outbound_payments", query_string="", api_base="https://api.stripe.com", - post_data='{"amount":{"currency":"USD","value":96},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"recipient":"recipient"}}', + post_data='{"amount":{},"from":{"currency":"usd","financial_account":"financial_account"},"to":{"recipient":"recipient"}}', is_json=True, ) diff --git a/tests/test_stripe_object.py b/tests/test_stripe_object.py index c6356d672..a963fcc5d 100644 --- a/tests/test_stripe_object.py +++ b/tests/test_stripe_object.py @@ -6,6 +6,7 @@ import pytest import stripe +from stripe._invoice import Invoice from stripe._stripe_object import StripeObject # We use this because it has a map, "restriction.currency_options" from string -> CurrencyOptions nested class. @@ -433,3 +434,36 @@ def test_can_update_api_key(self, http_client_mock): api_key="key2", stripe_account=None, ) + + def test_invoice_payment_method_gets_special_error(self): + def is_good_error(e: Exception) -> bool: + return "multiple-partial-payments-on-invoices" in str(e) + + i = Invoice() + + with pytest.raises(AttributeError) as e: + i.payment_intent # type: ignore + assert is_good_error(e.value) + + with pytest.raises(KeyError) as e: + i["payment_intent"] + assert is_good_error(e.value) + + # only that property gets the special error + with pytest.raises(AttributeError) as e: + i.blah # type: ignore + assert not is_good_error(e.value) + + with pytest.raises(KeyError) as e: + i["blah"] + assert not is_good_error(e.value) + + # other classes don't have that special error + so = StripeObject() + with pytest.raises(AttributeError) as e: + so.payment_intent # type: ignore + assert not is_good_error(e.value) + + with pytest.raises(KeyError) as e: + so["payment_intent"] + assert not is_good_error(e.value)