stripe 15.0.0 → 15.3.0

data/lib/stripe/resources/customer_session.rb

@@ -5,9 +5,9 @@ module Stripe
   # A Customer Session allows you to grant Stripe's frontend SDKs (like Stripe.js) client-side access
   # control over a Customer.
   #
-  # Related guides: [Customer Session with the Payment Element](https://stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
-  # [Customer Session with the Pricing Table](https://stripe.com/payments/checkout/pricing-table#customer-session),
-  # [Customer Session with the Buy Button](https://stripe.com/payment-links/buy-button#pass-an-existing-customer).
+  # Related guides: [Customer Session with the Payment Element](https://docs.stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
+  # [Customer Session with the Pricing Table](https://docs.stripe.com/payments/checkout/pricing-table#customer-session),
+  # [Customer Session with the Buy Button](https://docs.stripe.com/payment-links/buy-button#pass-an-existing-customer).
   class CustomerSession < APIResource
     extend Stripe::APIOperations::Create
 
@@ -30,7 +30,7 @@ module Stripe
           attr_reader :payment_method_allow_redisplay_filters
           # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
           attr_reader :payment_method_redisplay
-          # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
+          # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`. The maximum redisplay limit is `10`.
           attr_reader :payment_method_redisplay_limit
           # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
           #
@@ -82,7 +82,7 @@ module Stripe
             attr_accessor :payment_method_allow_redisplay_filters
             # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
             attr_accessor :payment_method_redisplay
-            # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
+            # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`. The maximum redisplay limit is `10`.
             attr_accessor :payment_method_redisplay_limit
             # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
             #

data/lib/stripe/resources/dispute.rb

@@ -621,7 +621,7 @@ module Stripe
     attr_reader :payment_intent
     # Attribute for field payment_method_details
     attr_reader :payment_method_details
-    # 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`, `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://stripe.com/docs/disputes/categories).
     attr_reader :reason
     # Current status of dispute. Possible values are `warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, or `lost`.
     attr_reader :status
@@ -657,7 +657,7 @@ module Stripe
 
     # When you get a dispute, contacting your customer is always the best first step. If that doesn't work, you can submit evidence to help us resolve the dispute in your favor. You can do this in your [dashboard](https://dashboard.stripe.com/disputes), but if you prefer, you can use the API to submit evidence programmatically.
     #
-    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://stripe.com/docs/disputes/categories).
+    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://docs.stripe.com/docs/disputes/categories).
     def self.update(dispute, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/event.rb

@@ -111,8 +111,10 @@ module Stripe
     end
     # The connected account that originates the event.
     attr_reader :account
-    # The Stripe API version used to render `data`. This property is populated only for events on or after October 31, 2014.
+    # The Stripe API version used to render `data` when the event was created. The contents of `data` never change, so this value remains static regardless of the API version currently in use. This property is populated only for events created on or after October 31, 2014.
     attr_reader :api_version
+    # Authentication context needed to fetch the event or related object.
+    attr_reader :context
     # Time at which the object was created. Measured in seconds since the Unix epoch.
     attr_reader :created
     # Attribute for field data

data/lib/stripe/resources/file.rb

@@ -6,7 +6,7 @@ module Stripe
   # files with the [create file](https://stripe.com/docs/api#create_file) request
   # (for example, when uploading dispute evidence). Stripe also
   # creates files independently (for example, the results of a [Sigma scheduled
-  # query](https://stripe.com/docs/api#scheduled_queries)).
+  # query](https://docs.stripe.com/api#scheduled_queries)).
   #
   # Related guide: [File upload guide](https://stripe.com/docs/file-upload)
   class File < APIResource

data/lib/stripe/resources/funding_instructions.rb

@@ -326,7 +326,7 @@ module Stripe
         raise NotImplementedError,
               "FundingInstructions cannot be accessed without a customer ID."
       end
-      "#{Customer.resource_url}/#{CGI.escape(customer)}/funding_instructions" "/#{CGI.escape(id)}"
+      "#{Customer.resource_url}/#{CGI.escape(customer)}/funding_instructions" + "/#{CGI.escape(id)}"
     end
   end
 end

data/lib/stripe/resources/identity/verification_report.rb

@@ -91,10 +91,16 @@ module Stripe
         attr_reader :last_name
         # Document ID number.
         attr_reader :number
+        # Sex of the person in the document.
+        attr_reader :sex
         # Status of this `document` check.
         attr_reader :status
         # Type of the document.
         attr_reader :type
+        # Place of birth as it appears in the document.
+        attr_reader :unparsed_place_of_birth
+        # Sex as it appears in the document.
+        attr_reader :unparsed_sex
       end
 
       class Email < Stripe::StripeObject

data/lib/stripe/resources/identity/verification_session.rb

@@ -5,11 +5,11 @@ module Stripe
   module Identity
     # A VerificationSession guides you through the process of collecting and verifying the identities
     # of your users. It contains details about the type of verification, such as what [verification
-    # check](https://stripe.com/docs/identity/verification-checks) to perform. Only create one VerificationSession for
+    # check](https://docs.stripe.com/docs/identity/verification-checks) to perform. Only create one VerificationSession for
     # each verification in your system.
     #
     # A VerificationSession transitions through [multiple
-    # statuses](https://stripe.com/docs/identity/how-sessions-work) throughout its lifetime as it progresses through
+    # statuses](https://docs.stripe.com/docs/identity/how-sessions-work) throughout its lifetime as it progresses through
     # the verification flow. The VerificationSession contains the user's verified data after
     # verification checks are complete.
     #
@@ -50,6 +50,13 @@ module Stripe
 
         class IdNumber < Stripe::StripeObject; end
 
+        class Matching < Stripe::StripeObject
+          # Strictness of the DOB matching policy to apply.
+          attr_reader :dob
+          # Strictness of the name matching policy to apply.
+          attr_reader :name
+        end
+
         class Phone < Stripe::StripeObject
           # Request one time password verification of `provided_details.phone`.
           attr_reader :require_verification
@@ -60,6 +67,8 @@ module Stripe
         attr_reader :email
         # Attribute for field id_number
         attr_reader :id_number
+        # Attribute for field matching
+        attr_reader :matching
         # Attribute for field phone
         attr_reader :phone
       end
@@ -76,6 +85,13 @@ module Stripe
         attr_reader :status
       end
 
+      class RelatedPerson < Stripe::StripeObject
+        # Token referencing the associated Account of the related Person resource.
+        attr_reader :account
+        # Token referencing the related Person resource.
+        attr_reader :person
+      end
+
       class VerifiedOutputs < Stripe::StripeObject
         class Address < Stripe::StripeObject
           # City, district, suburb, town, or village.
@@ -116,6 +132,12 @@ module Stripe
         attr_reader :last_name
         # The user's verified phone number
         attr_reader :phone
+        # The user's verified sex.
+        attr_reader :sex
+        # The user's verified place of birth as it appears in the document.
+        attr_reader :unparsed_place_of_birth
+        # The user's verified sex as it appears in the document.
+        attr_reader :unparsed_sex
       end
 
       class ListParams < Stripe::RequestParams
@@ -217,6 +239,18 @@ module Stripe
             @phone = phone
           end
         end
+
+        class RelatedPerson < Stripe::RequestParams
+          # A token representing a connected account. If provided, the person parameter is also required and must be associated with the account.
+          attr_accessor :account
+          # A token referencing a Person resource that this verification is being used to verify.
+          attr_accessor :person
+
+          def initialize(account: nil, person: nil)
+            @account = account
+            @person = person
+          end
+        end
         # A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.
         attr_accessor :client_reference_id
         # Specifies which fields in the response should be expanded.
@@ -229,6 +263,8 @@ module Stripe
         attr_accessor :provided_details
         # Customer ID
         attr_accessor :related_customer
+        # Tokens referencing a Person resource and it's associated account.
+        attr_accessor :related_person
         # The URL that the user will be redirected to upon completing the verification flow.
         attr_accessor :return_url
         # 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`.
@@ -243,6 +279,7 @@ module Stripe
           options: nil,
           provided_details: nil,
           related_customer: nil,
+          related_person: nil,
           return_url: nil,
           type: nil,
           verification_flow: nil
@@ -253,6 +290,7 @@ module Stripe
           @options = options
           @provided_details = provided_details
           @related_customer = related_customer
+          @related_person = related_person
           @return_url = return_url
           @type = type
           @verification_flow = verification_flow
@@ -365,6 +403,8 @@ module Stripe
       attr_reader :redaction
       # Customer ID
       attr_reader :related_customer
+      # Attribute for field related_person
+      attr_reader :related_person
       # Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work).
       attr_reader :status
       # The type of [verification check](https://stripe.com/docs/identity/verification-checks) to be performed.
@@ -376,9 +416,9 @@ module Stripe
       # The user’s verified data.
       attr_reader :verified_outputs
 
-      # A VerificationSession object can be canceled when it is in requires_input [status](https://stripe.com/docs/identity/how-sessions-work).
+      # A VerificationSession object can be canceled when it is in requires_input [status](https://docs.stripe.com/docs/identity/how-sessions-work).
       #
-      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://stripe.com/docs/identity/verification-sessions#cancel).
+      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#cancel).
       def cancel(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -388,9 +428,9 @@ module Stripe
         )
       end
 
-      # A VerificationSession object can be canceled when it is in requires_input [status](https://stripe.com/docs/identity/how-sessions-work).
+      # A VerificationSession object can be canceled when it is in requires_input [status](https://docs.stripe.com/docs/identity/how-sessions-work).
       #
-      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://stripe.com/docs/identity/verification-sessions#cancel).
+      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#cancel).
       def self.cancel(session, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -406,7 +446,7 @@ module Stripe
       #
       # If your API key is in test mode, verification checks won't actually process, though everything else will occur as if in live mode.
       #
-      # Related guide: [Verify your users' identity documents](https://stripe.com/docs/identity/verify-identity-documents)
+      # Related guide: [Verify your users' identity documents](https://docs.stripe.com/docs/identity/verify-identity-documents)
       def self.create(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -431,7 +471,7 @@ module Stripe
       # request logs, etc.
       #
       # A VerificationSession object can be redacted when it is in requires_input or verified
-      # [status](https://stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
+      # [status](https://docs.stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
       # state will automatically cancel it.
       #
       # The redaction process may take up to four days. When the redaction process is in progress, the
@@ -444,7 +484,7 @@ module Stripe
       # placeholder. The metadata field will also be erased. Redacted objects cannot be updated or
       # used for any purpose.
       #
-      # [Learn more](https://stripe.com/docs/identity/verification-sessions#redact).
+      # [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#redact).
       def redact(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -459,7 +499,7 @@ module Stripe
       # request logs, etc.
       #
       # A VerificationSession object can be redacted when it is in requires_input or verified
-      # [status](https://stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
+      # [status](https://docs.stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
       # state will automatically cancel it.
       #
       # The redaction process may take up to four days. When the redaction process is in progress, the
@@ -472,7 +512,7 @@ module Stripe
       # placeholder. The metadata field will also be erased. Redacted objects cannot be updated or
       # used for any purpose.
       #
-      # [Learn more](https://stripe.com/docs/identity/verification-sessions#redact).
+      # [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#redact).
       def self.redact(session, params = {}, opts = {})
         request_stripe_object(
           method: :post,