stripe 15.0.0 → 15.3.0

data/lib/stripe/resources/payment_method.rb

@@ -80,6 +80,8 @@ module Stripe
       attr_reader :name
       # Billing phone number (including extension).
       attr_reader :phone
+      # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+      attr_reader :tax_id
     end
 
     class Blik < Stripe::StripeObject; end
@@ -112,9 +114,9 @@ module Stripe
             class Receipt < Stripe::StripeObject
               # The type of account being debited or credited
               attr_reader :account_type
-              # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+              # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
               attr_reader :application_cryptogram
-              # Mnenomic of the Application Identifier.
+              # The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
               attr_reader :application_preferred_name
               # Identifier for this transaction.
               attr_reader :authorization_code
@@ -122,11 +124,11 @@ module Stripe
               attr_reader :authorization_response_code
               # Describes the method used by the cardholder to verify ownership of the card. One of the following: `approval`, `failure`, `none`, `offline_pin`, `offline_pin_and_signature`, `online_pin`, or `signature`.
               attr_reader :cardholder_verification_method
-              # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+              # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
               attr_reader :dedicated_file_name
-              # The outcome of a series of EMV functions performed by the card reader.
+              # A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
               attr_reader :terminal_verification_results
-              # An indication of various EMV functions performed during the transaction.
+              # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
               attr_reader :transaction_status_information
             end
 
@@ -178,7 +180,7 @@ module Stripe
             attr_reader :offline
             # Defines whether the authorized amount can be over-captured or not
             attr_reader :overcapture_supported
-            # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+            # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
             attr_reader :preferred_locales
             # How card details were read in this transaction.
             attr_reader :read_method
@@ -405,7 +407,7 @@ module Stripe
       attr_reader :networks
       # Details about payment methods collected offline.
       attr_reader :offline
-      # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+      # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
       attr_reader :preferred_locales
       # How card details were read in this transaction.
       attr_reader :read_method
@@ -420,6 +422,7 @@ module Stripe
       attr_reader :cashtag
     end
 
+    class Crypto < Stripe::StripeObject; end
     class CustomerBalance < Stripe::StripeObject; end
 
     class Eps < Stripe::StripeObject
@@ -438,7 +441,7 @@ module Stripe
     class Grabpay < Stripe::StripeObject; end
 
     class Ideal < Stripe::StripeObject
-      # The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `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`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
       attr_reader :bank
       # The Bank Identifier Code of the customer's bank, if the bank was provided.
       attr_reader :bic
@@ -477,7 +480,7 @@ module Stripe
       attr_reader :last4
       # Contains information about card networks that can be used to process the payment.
       attr_reader :networks
-      # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+      # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
       attr_reader :preferred_locales
       # How card details were read in this transaction.
       attr_reader :read_method
@@ -689,20 +692,11 @@ module Stripe
         end
       end
 
-      class Affirm < Stripe::RequestParams
-      end
-
-      class AfterpayClearpay < Stripe::RequestParams
-      end
-
-      class Alipay < Stripe::RequestParams
-      end
-
-      class Alma < Stripe::RequestParams
-      end
-
-      class AmazonPay < Stripe::RequestParams
-      end
+      class Affirm < Stripe::RequestParams; end
+      class AfterpayClearpay < Stripe::RequestParams; end
+      class Alipay < Stripe::RequestParams; end
+      class Alma < Stripe::RequestParams; end
+      class AmazonPay < Stripe::RequestParams; end
 
       class AuBecsDebit < Stripe::RequestParams
         # The account number for the bank account.
@@ -728,11 +722,8 @@ module Stripe
         end
       end
 
-      class Bancontact < Stripe::RequestParams
-      end
-
-      class Billie < Stripe::RequestParams
-      end
+      class Bancontact < Stripe::RequestParams; end
+      class Billie < Stripe::RequestParams; end
 
       class BillingDetails < Stripe::RequestParams
         class Address < Stripe::RequestParams
@@ -773,17 +764,19 @@ module Stripe
         attr_accessor :name
         # Billing phone number (including extension).
         attr_accessor :phone
+        # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+        attr_accessor :tax_id
 
-        def initialize(address: nil, email: nil, name: nil, phone: nil)
+        def initialize(address: nil, email: nil, name: nil, phone: nil, tax_id: nil)
           @address = address
           @email = email
           @name = name
           @phone = phone
+          @tax_id = tax_id
         end
       end
 
-      class Blik < Stripe::RequestParams
-      end
+      class Blik < Stripe::RequestParams; end
 
       class Boleto < Stripe::RequestParams
         # The tax ID of the customer (CPF for individual consumers or CNPJ for businesses consumers)
@@ -833,11 +826,9 @@ module Stripe
         end
       end
 
-      class Cashapp < Stripe::RequestParams
-      end
-
-      class CustomerBalance < Stripe::RequestParams
-      end
+      class Cashapp < Stripe::RequestParams; end
+      class Crypto < Stripe::RequestParams; end
+      class CustomerBalance < Stripe::RequestParams; end
 
       class Eps < Stripe::RequestParams
         # The customer's bank.
@@ -860,11 +851,8 @@ module Stripe
         end
       end
 
-      class Giropay < Stripe::RequestParams
-      end
-
-      class Grabpay < Stripe::RequestParams
-      end
+      class Giropay < Stripe::RequestParams; end
+      class Grabpay < Stripe::RequestParams; end
 
       class Ideal < Stripe::RequestParams
         # The customer's bank. Only use this parameter for existing customers. Don't use it for new customers.
@@ -875,11 +863,8 @@ module Stripe
         end
       end
 
-      class InteracPresent < Stripe::RequestParams
-      end
-
-      class KakaoPay < Stripe::RequestParams
-      end
+      class InteracPresent < Stripe::RequestParams; end
+      class KakaoPay < Stripe::RequestParams; end
 
       class Klarna < Stripe::RequestParams
         class Dob < Stripe::RequestParams
@@ -904,20 +889,11 @@ module Stripe
         end
       end
 
-      class Konbini < Stripe::RequestParams
-      end
-
-      class KrCard < Stripe::RequestParams
-      end
-
-      class Link < Stripe::RequestParams
-      end
-
-      class Mobilepay < Stripe::RequestParams
-      end
-
-      class Multibanco < Stripe::RequestParams
-      end
+      class Konbini < Stripe::RequestParams; end
+      class KrCard < Stripe::RequestParams; end
+      class Link < Stripe::RequestParams; end
+      class Mobilepay < Stripe::RequestParams; end
+      class Multibanco < Stripe::RequestParams; end
 
       class NaverPay < Stripe::RequestParams
         # Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
@@ -959,8 +935,7 @@ module Stripe
         end
       end
 
-      class Oxxo < Stripe::RequestParams
-      end
+      class Oxxo < Stripe::RequestParams; end
 
       class P24 < Stripe::RequestParams
         # The customer's bank.
@@ -971,23 +946,12 @@ module Stripe
         end
       end
 
-      class PayByBank < Stripe::RequestParams
-      end
-
-      class Payco < Stripe::RequestParams
-      end
-
-      class Paynow < Stripe::RequestParams
-      end
-
-      class Paypal < Stripe::RequestParams
-      end
-
-      class Pix < Stripe::RequestParams
-      end
-
-      class Promptpay < Stripe::RequestParams
-      end
+      class PayByBank < Stripe::RequestParams; end
+      class Payco < Stripe::RequestParams; end
+      class Paynow < Stripe::RequestParams; end
+      class Paypal < Stripe::RequestParams; end
+      class Pix < Stripe::RequestParams; end
+      class Promptpay < Stripe::RequestParams; end
 
       class RadarOptions < Stripe::RequestParams
         # 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.
@@ -998,14 +962,9 @@ module Stripe
         end
       end
 
-      class RevolutPay < Stripe::RequestParams
-      end
-
-      class SamsungPay < Stripe::RequestParams
-      end
-
-      class Satispay < Stripe::RequestParams
-      end
+      class RevolutPay < Stripe::RequestParams; end
+      class SamsungPay < Stripe::RequestParams; end
+      class Satispay < Stripe::RequestParams; end
 
       class SepaDebit < Stripe::RequestParams
         # IBAN of the bank account.
@@ -1025,11 +984,8 @@ module Stripe
         end
       end
 
-      class Swish < Stripe::RequestParams
-      end
-
-      class Twint < Stripe::RequestParams
-      end
+      class Swish < Stripe::RequestParams; end
+      class Twint < Stripe::RequestParams; end
 
       class UsBankAccount < Stripe::RequestParams
         # Account holder type: individual or company.
@@ -1058,11 +1014,8 @@ module Stripe
         end
       end
 
-      class WechatPay < Stripe::RequestParams
-      end
-
-      class Zip < Stripe::RequestParams
-      end
+      class WechatPay < Stripe::RequestParams; end
+      class Zip < Stripe::RequestParams; end
       # If this is an `acss_debit` PaymentMethod, this hash contains details about the ACSS Debit payment method.
       attr_accessor :acss_debit
       # If this is an `affirm` PaymentMethod, this hash contains details about the Affirm payment method.
@@ -1083,7 +1036,7 @@ module Stripe
       attr_accessor :bacs_debit
       # If this is a `bancontact` PaymentMethod, this hash contains details about the Bancontact payment method.
       attr_accessor :bancontact
-      # If this is a `billie` PaymentMethod, this hash contains details about the billie payment method.
+      # If this is a `billie` PaymentMethod, this hash contains details about the Billie payment method.
       attr_accessor :billie
       # Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
       attr_accessor :billing_details
@@ -1095,6 +1048,8 @@ module Stripe
       attr_accessor :card
       # If this is a `cashapp` PaymentMethod, this hash contains details about the Cash App Pay payment method.
       attr_accessor :cashapp
+      # If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
+      attr_accessor :crypto
       # The `Customer` to whom the original PaymentMethod is attached.
       attr_accessor :customer
       # If this is a `customer_balance` PaymentMethod, this hash contains details about the CustomerBalance payment method.
@@ -1153,11 +1108,11 @@ module Stripe
       attr_accessor :promptpay
       # Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information.
       attr_accessor :radar_options
-      # If this is a `Revolut Pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
+      # If this is a `revolut_pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
       attr_accessor :revolut_pay
       # If this is a `samsung_pay` PaymentMethod, this hash contains details about the SamsungPay payment method.
       attr_accessor :samsung_pay
-      # If this is a `satispay` PaymentMethod, this hash contains details about the satispay payment method.
+      # If this is a `satispay` PaymentMethod, this hash contains details about the Satispay payment method.
       attr_accessor :satispay
       # If this is a `sepa_debit` PaymentMethod, this hash contains details about the SEPA debit bank account.
       attr_accessor :sepa_debit
@@ -1193,6 +1148,7 @@ module Stripe
         boleto: nil,
         card: nil,
         cashapp: nil,
+        crypto: nil,
         customer: nil,
         customer_balance: nil,
         eps: nil,
@@ -1250,6 +1206,7 @@ module Stripe
         @boleto = boleto
         @card = card
         @cashapp = cashapp
+        @crypto = crypto
         @customer = customer
         @customer_balance = customer_balance
         @eps = eps
@@ -1333,12 +1290,15 @@ module Stripe
         attr_accessor :name
         # Billing phone number (including extension).
         attr_accessor :phone
+        # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+        attr_accessor :tax_id
 
-        def initialize(address: nil, email: nil, name: nil, phone: nil)
+        def initialize(address: nil, email: nil, name: nil, phone: nil, tax_id: nil)
           @address = address
           @email = email
           @name = name
           @phone = phone
+          @tax_id = tax_id
         end
       end
 
@@ -1365,11 +1325,8 @@ module Stripe
         end
       end
 
-      class Link < Stripe::RequestParams
-      end
-
-      class PayByBank < Stripe::RequestParams
-      end
+      class Link < Stripe::RequestParams; end
+      class PayByBank < Stripe::RequestParams; end
 
       class UsBankAccount < Stripe::RequestParams
         # Bank account holder type.
@@ -1476,6 +1433,8 @@ module Stripe
     attr_reader :cashapp
     # Time at which the object was created. Measured in seconds since the Unix epoch.
     attr_reader :created
+    # Attribute for field crypto
+    attr_reader :crypto
     # The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer.
     attr_reader :customer
     # Attribute for field customer_balance
@@ -1561,16 +1520,16 @@ module Stripe
 
     # Attaches a PaymentMethod object to a Customer.
     #
-    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
-    # or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
+    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://docs.stripe.com/docs/api/setup_intents)
+    # or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
     # These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
     # endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
     # future use, which makes later declines and payment friction more likely.
-    # See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
+    # See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
     # future payments.
     #
     # To use this PaymentMethod as the default for invoice or subscription payments,
-    # set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
+    # set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
     # on the Customer to the PaymentMethod's ID.
     def attach(params = {}, opts = {})
       request_stripe_object(
@@ -1583,16 +1542,16 @@ module Stripe
 
     # Attaches a PaymentMethod object to a Customer.
     #
-    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
-    # or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
+    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://docs.stripe.com/docs/api/setup_intents)
+    # or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
     # These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
     # endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
     # future use, which makes later declines and payment friction more likely.
-    # See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
+    # See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
     # future payments.
     #
     # To use this PaymentMethod as the default for invoice or subscription payments,
-    # set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
+    # set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
     # on the Customer to the PaymentMethod's ID.
     def self.attach(payment_method, params = {}, opts = {})
       request_stripe_object(
@@ -1603,9 +1562,9 @@ module Stripe
       )
     end
 
-    # Creates a PaymentMethod object. Read the [Stripe.js reference](https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
+    # Creates a PaymentMethod object. Read the [Stripe.js reference](https://docs.stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
     #
-    # Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
+    # Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://docs.stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/payment_methods", params: params, opts: opts)
     end
@@ -1630,7 +1589,7 @@ module Stripe
       )
     end
 
-    # 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://stripe.com/docs/api/payment_methods/customer_list) API instead.
+    # 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.
     def self.list(params = {}, opts = {})
       request_stripe_object(method: :get, path: "/v1/payment_methods", params: params, opts: opts)
     end