From fa02db50abf59d545e3b8da4be78678bb026b527 Mon Sep 17 00:00:00 2001 From: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com> Date: Mon, 22 Apr 2024 22:18:23 +0000 Subject: [PATCH] Update generated code for v979 --- OPENAPI_VERSION | 2 +- lib/stripe/resources/account.rb | 43 ++++++++++++++++++---------- lib/stripe/resources/bank_account.rb | 7 +++-- lib/stripe/resources/login_link.rb | 2 +- lib/stripe/resources/person.rb | 5 ++-- lib/stripe/resources/token.rb | 4 +-- 6 files changed, 38 insertions(+), 25 deletions(-) diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION index e0b27350..ee183957 100644 --- a/OPENAPI_VERSION +++ b/OPENAPI_VERSION @@ -1 +1 @@ -v972 \ No newline at end of file +v979 \ No newline at end of file diff --git a/lib/stripe/resources/account.rb b/lib/stripe/resources/account.rb index 5968b8e3..8d20fe6c 100644 --- a/lib/stripe/resources/account.rb +++ b/lib/stripe/resources/account.rb @@ -6,9 +6,14 @@ module Stripe # properties on the account like its current requirements or if the account is # enabled to make live charges or receive payouts. # - # For Custom accounts, the properties below are always returned. For other accounts, some properties are returned until that - # account has started to go through Connect Onboarding. Once you create an [Account Link](https://stripe.com/docs/api/account_links) or [Account Session](https://stripe.com/docs/api/account_sessions), - # some properties are only returned for Custom accounts. Learn about the differences [between accounts](https://stripe.com/docs/connect/accounts). + # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) + # is `application`, which includes Custom accounts, the properties below are always + # returned. + # + # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) + # is `stripe`, which includes Standard and Express accounts, some properties are only returned + # until you create an [Account Link](https://stripe.com/api/account_links) or [Account Session](https://stripe.com/api/account_sessions) + # to start Connect Onboarding. Learn about the [differences between accounts](https://stripe.com/connect/accounts). class Account < APIResource extend Stripe::APIOperations::Create include Stripe::APIOperations::Delete @@ -39,9 +44,11 @@ module Stripe request_stripe_object(method: :post, path: "/v1/accounts", params: params, opts: opts) end - # With [Connect](https://stripe.com/docs/connect), you can delete accounts you manage. + # With [Connect](https://stripe.com/connect), you can delete accounts you manage. # - # Accounts created using test-mode keys can be deleted at any time. Standard accounts created using live-mode keys cannot be deleted. Custom or Express accounts created using live-mode keys can only be deleted once all balances are zero. + # Test-mode accounts can be deleted at any time. + # + # Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://stripe.com/api/balance/balanace_object) are zero. # # If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead. def self.delete(id, params = {}, opts = {}) @@ -53,9 +60,11 @@ module Stripe ) end - # With [Connect](https://stripe.com/docs/connect), you can delete accounts you manage. + # With [Connect](https://stripe.com/connect), you can delete accounts you manage. # - # Accounts created using test-mode keys can be deleted at any time. Standard accounts created using live-mode keys cannot be deleted. Custom or Express accounts created using live-mode keys can only be deleted once all balances are zero. + # Test-mode accounts can be deleted at any time. + # + # Live-mode accounts where Stripe is responsible for negative account balances cannot be deleted, which includes Standard accounts. Live-mode accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be deleted when all [balances](https://stripe.com/api/balance/balanace_object) are zero. # # If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/settings/account) instead. def delete(params = {}, opts = {}) @@ -92,9 +101,9 @@ module Stripe ) end - # With [Connect](https://stripe.com/docs/connect), you may flag accounts as suspicious. + # With [Connect](https://stripe.com/connect), you can reject accounts that you have flagged as suspicious. # - # Test-mode Custom and Express accounts can be rejected at any time. Accounts created using live-mode keys may only be rejected once all balances are zero. + # Only accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be rejected. Test-mode accounts can be rejected at any time. Live-mode accounts can only be rejected after all balances are zero. def reject(params = {}, opts = {}) request_stripe_object( method: :post, @@ -104,9 +113,9 @@ module Stripe ) end - # With [Connect](https://stripe.com/docs/connect), you may flag accounts as suspicious. + # With [Connect](https://stripe.com/connect), you can reject accounts that you have flagged as suspicious. # - # Test-mode Custom and Express accounts can be rejected at any time. Accounts created using live-mode keys may only be rejected once all balances are zero. + # Only accounts where your platform is liable for negative account balances, which includes Custom and Express accounts, can be rejected. Test-mode accounts can be rejected at any time. Live-mode accounts can only be rejected after all balances are zero. def self.reject(account, params = {}, opts = {}) request_stripe_object( method: :post, @@ -116,12 +125,16 @@ module Stripe ) end - # Updates a [connected account](https://stripe.com/docs/connect/accounts) by setting the values of the parameters passed. Any parameters not provided are + # Updates a [connected account](https://stripe.com/connect/accounts) by setting the values of the parameters passed. Any parameters not provided are # left unchanged. # - # For Custom accounts, you can update any information on the account. For other accounts, you can update all information until that - # account has started to go through Connect Onboarding. Once you create an [Account Link or Account Session](https://stripe.com/docs/api/account_links), - # some properties can only be changed or updated for Custom accounts. + # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) + # is application, which includes Custom accounts, you can update any information on the account. + # + # For accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) + # is stripe, which includes Standard and Express accounts, you can update all information until you create + # an [Account Link or Account Session](https://stripe.com/api/account_links) to start Connect onboarding, + # after which some properties can no longer be updated. # # To update your own account, use the [Dashboard](https://dashboard.stripe.com/settings/account). Refer to our # [Connect](https://stripe.com/docs/connect/updating-accounts) documentation to learn more about updating accounts. diff --git a/lib/stripe/resources/bank_account.rb b/lib/stripe/resources/bank_account.rb index df0200a4..656ef711 100644 --- a/lib/stripe/resources/bank_account.rb +++ b/lib/stripe/resources/bank_account.rb @@ -4,11 +4,12 @@ module Stripe # These bank accounts are payment methods on `Customer` objects. # - # On the other hand [External Accounts](https://stripe.com/docs/api#external_accounts) are transfer - # destinations on `Account` objects for [Custom accounts](https://stripe.com/docs/connect/custom-accounts). + # On the other hand [External Accounts](https://stripe.com/api#external_accounts) are transfer + # destinations on `Account` objects for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) + # is `application`, which includes [Custom accounts](https://stripe.com/connect/custom-accounts). # They can be bank accounts or debit cards as well, and are documented in the links above. # - # Related guide: [Bank debits and transfers](https://stripe.com/docs/payments/bank-debits-transfers) + # Related guide: [Bank debits and transfers](https://stripe.com/payments/bank-debits-transfers) class BankAccount < APIResource include Stripe::APIOperations::Delete extend Stripe::APIOperations::List diff --git a/lib/stripe/resources/login_link.rb b/lib/stripe/resources/login_link.rb index d76df2d0..81322512 100644 --- a/lib/stripe/resources/login_link.rb +++ b/lib/stripe/resources/login_link.rb @@ -2,7 +2,7 @@ # frozen_string_literal: true module Stripe - # Login Links are single-use login link for an Express account to access their Stripe dashboard. + # Login Links are single-use URLs for a connected account to access the Express Dashboard. The connected account's [account.controller.stripe_dashboard.type](https://stripe.com/api/accounts/object#account_object-controller-stripe_dashboard-type) must be `express` to have access to the Express Dashboard. class LoginLink < APIResource OBJECT_NAME = "login_link" def self.object_name diff --git a/lib/stripe/resources/person.rb b/lib/stripe/resources/person.rb index 69454b8d..1262a5ad 100644 --- a/lib/stripe/resources/person.rb +++ b/lib/stripe/resources/person.rb @@ -4,10 +4,9 @@ module Stripe # This is an object representing a person associated with a Stripe account. # - # A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account. - # See the [Standard onboarding](https://stripe.com/docs/connect/standard-accounts) or [Express onboarding documentation](https://stripe.com/docs/connect/express-accounts) for information about platform prefilling and account onboarding steps. + # A platform cannot access a person for an account where [account.controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding. # - # Related guide: [Handling identity verification with the API](https://stripe.com/docs/connect/handling-api-verification#person-information) + # See the [Standard onboarding](https://stripe.com/connect/standard-accounts) or [Express onboarding](https://stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://stripe.com/connect/handling-api-verification#person-information). class Person < APIResource include Stripe::APIOperations::Save diff --git a/lib/stripe/resources/token.rb b/lib/stripe/resources/token.rb index 565c5d90..9ae3b7f6 100644 --- a/lib/stripe/resources/token.rb +++ b/lib/stripe/resources/token.rb @@ -19,7 +19,7 @@ module Stripe # # 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) - # objects or [Custom accounts](https://stripe.com/docs/api#external_accounts). + # objects or [External accounts](https://stripe.com/api#external_accounts). # [Radar](https://stripe.com/docs/radar), our integrated solution for automatic fraud protection, # performs best with integrations that use client-side tokenization. class Token < APIResource @@ -31,7 +31,7 @@ module Stripe end # Creates a single-use token that represents a bank account's details. - # You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [Custom account](https://stripe.com/docs/api#accounts). + # You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts. def self.create(params = {}, opts = {}) request_stripe_object(method: :post, path: "/v1/tokens", params: params, opts: opts) end