stripe 15.2.1 → 15.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. checksums.yaml +4 -4
  2. data/API_VERSION +1 -0
  3. data/CHANGELOG.md +66 -39
  4. data/OPENAPI_VERSION +1 -1
  5. data/README.md +14 -50
  6. data/VERSION +1 -1
  7. data/lib/stripe/api_version.rb +2 -1
  8. data/lib/stripe/events/v2_core_event_destination_ping_event.rb +1 -1
  9. data/lib/stripe/resources/account.rb +89 -5
  10. data/lib/stripe/resources/account_session.rb +79 -79
  11. data/lib/stripe/resources/billing_portal/session.rb +2 -2
  12. data/lib/stripe/resources/charge.rb +28 -15
  13. data/lib/stripe/resources/checkout/session.rb +57 -7
  14. data/lib/stripe/resources/confirmation_token.rb +19 -11
  15. data/lib/stripe/resources/credit_note.rb +9 -9
  16. data/lib/stripe/resources/customer_session.rb +2 -2
  17. data/lib/stripe/resources/event.rb +1 -1
  18. data/lib/stripe/resources/identity/verification_session.rb +34 -0
  19. data/lib/stripe/resources/invoice.rb +29 -4
  20. data/lib/stripe/resources/invoice_item.rb +1 -4
  21. data/lib/stripe/resources/mandate.rb +3 -0
  22. data/lib/stripe/resources/payment_intent.rb +331 -12
  23. data/lib/stripe/resources/payment_method.rb +17 -9
  24. data/lib/stripe/resources/quote.rb +26 -3
  25. data/lib/stripe/resources/setup_attempt.rb +1 -1
  26. data/lib/stripe/resources/setup_intent.rb +285 -3
  27. data/lib/stripe/resources/subscription.rb +68 -6
  28. data/lib/stripe/resources/subscription_schedule.rb +22 -0
  29. data/lib/stripe/resources/tax/registration.rb +20 -0
  30. data/lib/stripe/resources/terminal/configuration.rb +1 -0
  31. data/lib/stripe/resources/terminal/reader.rb +152 -4
  32. data/lib/stripe/resources/token.rb +1 -1
  33. data/lib/stripe/resources/treasury/financial_account.rb +5 -1
  34. data/lib/stripe/services/account_service.rb +83 -5
  35. data/lib/stripe/services/account_session_service.rb +48 -48
  36. data/lib/stripe/services/billing_portal/session_service.rb +1 -1
  37. data/lib/stripe/services/checkout/session_service.rb +57 -7
  38. data/lib/stripe/services/credit_note_preview_lines_service.rb +3 -3
  39. data/lib/stripe/services/credit_note_service.rb +6 -6
  40. data/lib/stripe/services/customer_session_service.rb +1 -1
  41. data/lib/stripe/services/identity/verification_session_service.rb +16 -0
  42. data/lib/stripe/services/invoice_service.rb +29 -4
  43. data/lib/stripe/services/payment_intent_service.rb +315 -9
  44. data/lib/stripe/services/payment_method_service.rb +5 -0
  45. data/lib/stripe/services/quote_service.rb +20 -3
  46. data/lib/stripe/services/setup_intent_service.rb +275 -2
  47. data/lib/stripe/services/subscription_schedule_service.rb +13 -0
  48. data/lib/stripe/services/subscription_service.rb +48 -4
  49. data/lib/stripe/services/tax/registration_service.rb +13 -0
  50. data/lib/stripe/services/terminal/reader_service.rb +90 -0
  51. data/lib/stripe/services/test_helpers/confirmation_token_service.rb +6 -1
  52. data/lib/stripe/services/token_service.rb +1 -1
  53. data/lib/stripe/services/treasury/financial_account_service.rb +5 -1
  54. data/lib/stripe/services/v2/billing_service.rb +2 -2
  55. data/lib/stripe/services/v2/core/event_destination_service.rb +16 -16
  56. data/lib/stripe/version.rb +1 -1
  57. data/rbi/stripe/resources/account.rbi +78 -9
  58. data/rbi/stripe/resources/account_session.rbi +79 -79
  59. data/rbi/stripe/resources/billing_portal/session.rbi +2 -2
  60. data/rbi/stripe/resources/charge.rbi +32 -15
  61. data/rbi/stripe/resources/checkout/session.rbi +65 -9
  62. data/rbi/stripe/resources/confirmation_token.rbi +23 -12
  63. data/rbi/stripe/resources/credit_note.rbi +9 -9
  64. data/rbi/stripe/resources/customer_session.rbi +2 -2
  65. data/rbi/stripe/resources/event.rbi +1 -1
  66. data/rbi/stripe/resources/identity/verification_session.rbi +39 -1
  67. data/rbi/stripe/resources/invoice.rbi +36 -6
  68. data/rbi/stripe/resources/invoice_item.rbi +1 -4
  69. data/rbi/stripe/resources/mandate.rbi +4 -0
  70. data/rbi/stripe/resources/payment_intent.rbi +361 -21
  71. data/rbi/stripe/resources/payment_method.rbi +19 -10
  72. data/rbi/stripe/resources/quote.rbi +22 -3
  73. data/rbi/stripe/resources/setup_attempt.rbi +1 -1
  74. data/rbi/stripe/resources/setup_intent.rbi +332 -9
  75. data/rbi/stripe/resources/subscription.rbi +60 -7
  76. data/rbi/stripe/resources/subscription_schedule.rbi +23 -1
  77. data/rbi/stripe/resources/tax/registration.rbi +20 -1
  78. data/rbi/stripe/resources/terminal/configuration.rbi +1 -0
  79. data/rbi/stripe/resources/terminal/location.rbi +2 -2
  80. data/rbi/stripe/resources/terminal/reader.rbi +151 -4
  81. data/rbi/stripe/resources/token.rbi +1 -1
  82. data/rbi/stripe/resources/treasury/financial_account.rbi +6 -2
  83. data/rbi/stripe/services/account_service.rbi +77 -9
  84. data/rbi/stripe/services/account_session_service.rbi +48 -48
  85. data/rbi/stripe/services/billing_portal/session_service.rbi +1 -1
  86. data/rbi/stripe/services/checkout/session_service.rbi +65 -9
  87. data/rbi/stripe/services/credit_note_preview_lines_service.rbi +3 -3
  88. data/rbi/stripe/services/credit_note_service.rbi +6 -6
  89. data/rbi/stripe/services/customer_session_service.rbi +1 -1
  90. data/rbi/stripe/services/identity/verification_session_service.rbi +17 -1
  91. data/rbi/stripe/services/invoice_service.rbi +36 -6
  92. data/rbi/stripe/services/payment_intent_service.rbi +348 -18
  93. data/rbi/stripe/services/payment_method_service.rbi +6 -1
  94. data/rbi/stripe/services/quote_service.rbi +16 -3
  95. data/rbi/stripe/services/setup_intent_service.rbi +326 -8
  96. data/rbi/stripe/services/subscription_schedule_service.rbi +12 -1
  97. data/rbi/stripe/services/subscription_service.rbi +41 -5
  98. data/rbi/stripe/services/tax/registration_service.rbi +14 -1
  99. data/rbi/stripe/services/terminal/location_service.rbi +2 -2
  100. data/rbi/stripe/services/terminal/reader_service.rbi +85 -0
  101. data/rbi/stripe/services/test_helpers/confirmation_token_service.rbi +9 -2
  102. data/rbi/stripe/services/token_service.rbi +1 -1
  103. data/rbi/stripe/services/treasury/financial_account_service.rbi +6 -2
  104. data/rbi/stripe/services/v2/billing_service.rbi +1 -1
  105. data/rbi/stripe/services/v2/core/event_destination_service.rbi +13 -13
  106. metadata +3 -2
@@ -353,7 +353,7 @@ module Stripe
353
353
  # One of `month`.
354
354
  sig { returns(T.nilable(String)) }
355
355
  attr_reader :interval
356
- # Type of installment plan, one of `fixed_count`.
356
+ # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
357
357
  sig { returns(String) }
358
358
  attr_reader :type
359
359
  end
@@ -596,7 +596,7 @@ module Stripe
596
596
  # Attribute for field incremental_authorization
597
597
  sig { returns(IncrementalAuthorization) }
598
598
  attr_reader :incremental_authorization
599
- # Installment details for this payment (Mexico only).
599
+ # Installment details for this payment.
600
600
  #
601
601
  # For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
602
602
  sig { returns(T.nilable(Installments)) }
@@ -651,10 +651,10 @@ module Stripe
651
651
  # The type of account being debited or credited
652
652
  sig { returns(String) }
653
653
  attr_reader :account_type
654
- # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
654
+ # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
655
655
  sig { returns(T.nilable(String)) }
656
656
  attr_reader :application_cryptogram
657
- # Mnenomic of the Application Identifier.
657
+ # 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.
658
658
  sig { returns(T.nilable(String)) }
659
659
  attr_reader :application_preferred_name
660
660
  # Identifier for this transaction.
@@ -666,13 +666,13 @@ module Stripe
666
666
  # 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`.
667
667
  sig { returns(T.nilable(String)) }
668
668
  attr_reader :cardholder_verification_method
669
- # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
669
+ # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
670
670
  sig { returns(T.nilable(String)) }
671
671
  attr_reader :dedicated_file_name
672
- # The outcome of a series of EMV functions performed by the card reader.
672
+ # 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.
673
673
  sig { returns(T.nilable(String)) }
674
674
  attr_reader :terminal_verification_results
675
- # An indication of various EMV functions performed during the transaction.
675
+ # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
676
676
  sig { returns(T.nilable(String)) }
677
677
  attr_reader :transaction_status_information
678
678
  end
@@ -746,7 +746,7 @@ module Stripe
746
746
  # Defines whether the authorized amount can be over-captured or not
747
747
  sig { returns(T::Boolean) }
748
748
  attr_reader :overcapture_supported
749
- # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
749
+ # 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.
750
750
  sig { returns(T.nilable(T::Array[String])) }
751
751
  attr_reader :preferred_locales
752
752
  # How card details were read in this transaction.
@@ -767,6 +767,20 @@ module Stripe
767
767
  sig { returns(T.nilable(String)) }
768
768
  attr_reader :cashtag
769
769
  end
770
+ class Crypto < Stripe::StripeObject
771
+ # The wallet address of the customer.
772
+ sig { returns(String) }
773
+ attr_reader :buyer_address
774
+ # The blockchain network that the transaction was sent on.
775
+ sig { returns(String) }
776
+ attr_reader :network
777
+ # The token currency that the transaction was sent with.
778
+ sig { returns(String) }
779
+ attr_reader :token_currency
780
+ # The blockchain transaction hash of the crypto payment.
781
+ sig { returns(String) }
782
+ attr_reader :transaction_hash
783
+ end
770
784
  class CustomerBalance < Stripe::StripeObject; end
771
785
  class Eps < Stripe::StripeObject
772
786
  # The customer's bank. Should be one of `arzte_und_apotheker_bank`, `austrian_anadi_bank_ag`, `bank_austria`, `bankhaus_carl_spangler`, `bankhaus_schelhammer_und_schattera_ag`, `bawag_psk_ag`, `bks_bank_ag`, `brull_kallmus_bank_ag`, `btv_vier_lander_bank`, `capital_bank_grawe_gruppe_ag`, `deutsche_bank_ag`, `dolomitenbank`, `easybank_ag`, `erste_bank_und_sparkassen`, `hypo_alpeadriabank_international_ag`, `hypo_noe_lb_fur_niederosterreich_u_wien`, `hypo_oberosterreich_salzburg_steiermark`, `hypo_tirol_bank_ag`, `hypo_vorarlberg_bank_ag`, `hypo_bank_burgenland_aktiengesellschaft`, `marchfelder_bank`, `oberbank_ag`, `raiffeisen_bankengruppe_osterreich`, `schoellerbank_ag`, `sparda_bank_wien`, `volksbank_gruppe`, `volkskreditbank_ag`, or `vr_bank_braunau`.
@@ -811,7 +825,7 @@ module Stripe
811
825
  attr_reader :transaction_id
812
826
  end
813
827
  class Ideal < Stripe::StripeObject
814
- # The customer's bank. 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`.
828
+ # The customer's bank. 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`.
815
829
  sig { returns(T.nilable(String)) }
816
830
  attr_reader :bank
817
831
  # The Bank Identifier Code of the customer's bank.
@@ -836,10 +850,10 @@ module Stripe
836
850
  # The type of account being debited or credited
837
851
  sig { returns(String) }
838
852
  attr_reader :account_type
839
- # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
853
+ # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
840
854
  sig { returns(T.nilable(String)) }
841
855
  attr_reader :application_cryptogram
842
- # Mnenomic of the Application Identifier.
856
+ # 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.
843
857
  sig { returns(T.nilable(String)) }
844
858
  attr_reader :application_preferred_name
845
859
  # Identifier for this transaction.
@@ -851,13 +865,13 @@ module Stripe
851
865
  # 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`.
852
866
  sig { returns(T.nilable(String)) }
853
867
  attr_reader :cardholder_verification_method
854
- # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
868
+ # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
855
869
  sig { returns(T.nilable(String)) }
856
870
  attr_reader :dedicated_file_name
857
- # The outcome of a series of EMV functions performed by the card reader.
871
+ # 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.
858
872
  sig { returns(T.nilable(String)) }
859
873
  attr_reader :terminal_verification_results
860
- # An indication of various EMV functions performed during the transaction.
874
+ # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
861
875
  sig { returns(T.nilable(String)) }
862
876
  attr_reader :transaction_status_information
863
877
  end
@@ -908,7 +922,7 @@ module Stripe
908
922
  # 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.
909
923
  sig { returns(T.nilable(String)) }
910
924
  attr_reader :network_transaction_id
911
- # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
925
+ # 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.
912
926
  sig { returns(T.nilable(T::Array[String])) }
913
927
  attr_reader :preferred_locales
914
928
  # How card details were read in this transaction.
@@ -1304,6 +1318,9 @@ module Stripe
1304
1318
  # Attribute for field cashapp
1305
1319
  sig { returns(Cashapp) }
1306
1320
  attr_reader :cashapp
1321
+ # Attribute for field crypto
1322
+ sig { returns(Crypto) }
1323
+ attr_reader :crypto
1307
1324
  # Attribute for field customer_balance
1308
1325
  sig { returns(CustomerBalance) }
1309
1326
  attr_reader :customer_balance
@@ -2578,6 +2578,45 @@ module Stripe
2578
2578
  def initialize(capture_method: nil, setup_future_usage: nil); end
2579
2579
  end
2580
2580
  class Klarna < Stripe::RequestParams
2581
+ class Subscription < Stripe::RequestParams
2582
+ class NextBilling < Stripe::RequestParams
2583
+ # The amount of the next charge for the subscription.
2584
+ sig { returns(Integer) }
2585
+ attr_accessor :amount
2586
+ # The date of the next charge for the subscription in YYYY-MM-DD format.
2587
+ sig { returns(String) }
2588
+ attr_accessor :date
2589
+ sig { params(amount: Integer, date: String).void }
2590
+ def initialize(amount: nil, date: nil); end
2591
+ end
2592
+ # Unit of time between subscription charges.
2593
+ sig { returns(String) }
2594
+ attr_accessor :interval
2595
+ # The number of intervals (specified in the `interval` attribute) between subscription charges. For example, `interval=month` and `interval_count=3` charges every 3 months.
2596
+ sig { returns(T.nilable(Integer)) }
2597
+ attr_accessor :interval_count
2598
+ # Name for subscription.
2599
+ sig { returns(T.nilable(String)) }
2600
+ attr_accessor :name
2601
+ # Describes the upcoming charge for this subscription.
2602
+ sig {
2603
+ returns(::Stripe::Checkout::Session::CreateParams::PaymentMethodOptions::Klarna::Subscription::NextBilling)
2604
+ }
2605
+ attr_accessor :next_billing
2606
+ # A non-customer-facing reference to correlate subscription charges in the Klarna app. Use a value that persists across subscription charges.
2607
+ sig { returns(String) }
2608
+ attr_accessor :reference
2609
+ sig {
2610
+ params(interval: String, interval_count: T.nilable(Integer), name: T.nilable(String), next_billing: ::Stripe::Checkout::Session::CreateParams::PaymentMethodOptions::Klarna::Subscription::NextBilling, reference: String).void
2611
+ }
2612
+ def initialize(
2613
+ interval: nil,
2614
+ interval_count: nil,
2615
+ name: nil,
2616
+ next_billing: nil,
2617
+ reference: nil
2618
+ ); end
2619
+ end
2581
2620
  # Indicates that you intend to make future payments with this PaymentIntent's payment method.
2582
2621
  #
2583
2622
  # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
@@ -2587,8 +2626,15 @@ module Stripe
2587
2626
  # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
2588
2627
  sig { returns(T.nilable(String)) }
2589
2628
  attr_accessor :setup_future_usage
2590
- sig { params(setup_future_usage: T.nilable(String)).void }
2591
- def initialize(setup_future_usage: nil); end
2629
+ # Subscription details if the Checkout Session sets up a future subscription.
2630
+ sig {
2631
+ returns(T.nilable(T.nilable(T.any(String, T::Array[::Stripe::Checkout::Session::CreateParams::PaymentMethodOptions::Klarna::Subscription]))))
2632
+ }
2633
+ attr_accessor :subscriptions
2634
+ sig {
2635
+ params(setup_future_usage: T.nilable(String), subscriptions: T.nilable(T.nilable(T.any(String, T::Array[::Stripe::Checkout::Session::CreateParams::PaymentMethodOptions::Klarna::Subscription])))).void
2636
+ }
2637
+ def initialize(setup_future_usage: nil, subscriptions: nil); end
2592
2638
  end
2593
2639
  class Konbini < Stripe::RequestParams
2594
2640
  # The number of calendar days (between 1 and 60) after which Konbini payment instructions will expire. For example, if a PaymentIntent is confirmed with Konbini and `expires_after_days` set to 2 on Monday JST, the instructions will expire on Wednesday 23:59:59 JST. Defaults to 3 days.
@@ -3335,6 +3381,13 @@ module Stripe
3335
3381
  def initialize(shipping_rate: nil, shipping_rate_data: nil); end
3336
3382
  end
3337
3383
  class SubscriptionData < Stripe::RequestParams
3384
+ class BillingMode < Stripe::RequestParams
3385
+ # Attribute for param field type
3386
+ sig { returns(String) }
3387
+ attr_accessor :type
3388
+ sig { params(type: String).void }
3389
+ def initialize(type: nil); end
3390
+ end
3338
3391
  class InvoiceSettings < Stripe::RequestParams
3339
3392
  class Issuer < Stripe::RequestParams
3340
3393
  # The connected account being referenced when `type` is `account`.
@@ -3390,6 +3443,11 @@ module Stripe
3390
3443
  # A future timestamp to anchor the subscription's billing cycle for new subscriptions.
3391
3444
  sig { returns(T.nilable(Integer)) }
3392
3445
  attr_accessor :billing_cycle_anchor
3446
+ # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
3447
+ sig {
3448
+ returns(T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::BillingMode))
3449
+ }
3450
+ attr_accessor :billing_mode
3393
3451
  # The tax rates that will apply to any subscription item that does not have
3394
3452
  # `tax_rates` set. Invoices created will have their `default_tax_rates` populated
3395
3453
  # from the subscription.
@@ -3419,13 +3477,10 @@ module Stripe
3419
3477
  returns(T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::TransferData))
3420
3478
  }
3421
3479
  attr_accessor :transfer_data
3422
- # Unix timestamp representing the end of the trial period the customer
3423
- # will get before being charged for the first time. Has to be at least
3424
- # 48 hours in the future.
3480
+ # Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. Has to be at least 48 hours in the future.
3425
3481
  sig { returns(T.nilable(Integer)) }
3426
3482
  attr_accessor :trial_end
3427
- # Integer representing the number of trial period days before the
3428
- # customer is charged for the first time. Has to be at least 1.
3483
+ # Integer representing the number of trial period days before the customer is charged for the first time. Has to be at least 1.
3429
3484
  sig { returns(T.nilable(Integer)) }
3430
3485
  attr_accessor :trial_period_days
3431
3486
  # Settings related to subscription trials.
@@ -3434,11 +3489,12 @@ module Stripe
3434
3489
  }
3435
3490
  attr_accessor :trial_settings
3436
3491
  sig {
3437
- params(application_fee_percent: T.nilable(Float), billing_cycle_anchor: T.nilable(Integer), default_tax_rates: T.nilable(T::Array[String]), description: T.nilable(String), invoice_settings: T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::InvoiceSettings), metadata: T.nilable(T::Hash[String, String]), on_behalf_of: T.nilable(String), proration_behavior: T.nilable(String), transfer_data: T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::TransferData), trial_end: T.nilable(Integer), trial_period_days: T.nilable(Integer), trial_settings: T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::TrialSettings)).void
3492
+ params(application_fee_percent: T.nilable(Float), billing_cycle_anchor: T.nilable(Integer), billing_mode: T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::BillingMode), default_tax_rates: T.nilable(T::Array[String]), description: T.nilable(String), invoice_settings: T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::InvoiceSettings), metadata: T.nilable(T::Hash[String, String]), on_behalf_of: T.nilable(String), proration_behavior: T.nilable(String), transfer_data: T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::TransferData), trial_end: T.nilable(Integer), trial_period_days: T.nilable(Integer), trial_settings: T.nilable(::Stripe::Checkout::Session::CreateParams::SubscriptionData::TrialSettings)).void
3438
3493
  }
3439
3494
  def initialize(
3440
3495
  application_fee_percent: nil,
3441
3496
  billing_cycle_anchor: nil,
3497
+ billing_mode: nil,
3442
3498
  default_tax_rates: nil,
3443
3499
  description: nil,
3444
3500
  invoice_settings: nil,
@@ -3558,7 +3614,7 @@ module Stripe
3558
3614
  # Generate a post-purchase Invoice for one-time payments.
3559
3615
  sig { returns(T.nilable(::Stripe::Checkout::Session::CreateParams::InvoiceCreation)) }
3560
3616
  attr_accessor :invoice_creation
3561
- # A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices).
3617
+ # 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.
3562
3618
  #
3563
3619
  # 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.
3564
3620
  #
@@ -43,7 +43,7 @@ module Stripe
43
43
  # One of `month`.
44
44
  sig { returns(T.nilable(String)) }
45
45
  attr_reader :interval
46
- # Type of installment plan, one of `fixed_count`.
46
+ # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
47
47
  sig { returns(String) }
48
48
  attr_reader :type
49
49
  end
@@ -179,10 +179,10 @@ module Stripe
179
179
  # The type of account being debited or credited
180
180
  sig { returns(String) }
181
181
  attr_reader :account_type
182
- # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
182
+ # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
183
183
  sig { returns(T.nilable(String)) }
184
184
  attr_reader :application_cryptogram
185
- # Mnenomic of the Application Identifier.
185
+ # 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.
186
186
  sig { returns(T.nilable(String)) }
187
187
  attr_reader :application_preferred_name
188
188
  # Identifier for this transaction.
@@ -194,13 +194,13 @@ module Stripe
194
194
  # 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`.
195
195
  sig { returns(T.nilable(String)) }
196
196
  attr_reader :cardholder_verification_method
197
- # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
197
+ # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
198
198
  sig { returns(T.nilable(String)) }
199
199
  attr_reader :dedicated_file_name
200
- # The outcome of a series of EMV functions performed by the card reader.
200
+ # 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.
201
201
  sig { returns(T.nilable(String)) }
202
202
  attr_reader :terminal_verification_results
203
- # An indication of various EMV functions performed during the transaction.
203
+ # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
204
204
  sig { returns(T.nilable(String)) }
205
205
  attr_reader :transaction_status_information
206
206
  end
@@ -274,7 +274,7 @@ module Stripe
274
274
  # Defines whether the authorized amount can be over-captured or not
275
275
  sig { returns(T::Boolean) }
276
276
  attr_reader :overcapture_supported
277
- # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
277
+ # 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.
278
278
  sig { returns(T.nilable(T::Array[String])) }
279
279
  attr_reader :preferred_locales
280
280
  # How card details were read in this transaction.
@@ -579,7 +579,7 @@ module Stripe
579
579
  # Details about payment methods collected offline.
580
580
  sig { returns(T.nilable(Offline)) }
581
581
  attr_reader :offline
582
- # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
582
+ # 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.
583
583
  sig { returns(T.nilable(T::Array[String])) }
584
584
  attr_reader :preferred_locales
585
585
  # How card details were read in this transaction.
@@ -597,6 +597,7 @@ module Stripe
597
597
  sig { returns(T.nilable(String)) }
598
598
  attr_reader :cashtag
599
599
  end
600
+ class Crypto < Stripe::StripeObject; end
600
601
  class CustomerBalance < Stripe::StripeObject; end
601
602
  class Eps < Stripe::StripeObject
602
603
  # The customer's bank. Should be one of `arzte_und_apotheker_bank`, `austrian_anadi_bank_ag`, `bank_austria`, `bankhaus_carl_spangler`, `bankhaus_schelhammer_und_schattera_ag`, `bawag_psk_ag`, `bks_bank_ag`, `brull_kallmus_bank_ag`, `btv_vier_lander_bank`, `capital_bank_grawe_gruppe_ag`, `deutsche_bank_ag`, `dolomitenbank`, `easybank_ag`, `erste_bank_und_sparkassen`, `hypo_alpeadriabank_international_ag`, `hypo_noe_lb_fur_niederosterreich_u_wien`, `hypo_oberosterreich_salzburg_steiermark`, `hypo_tirol_bank_ag`, `hypo_vorarlberg_bank_ag`, `hypo_bank_burgenland_aktiengesellschaft`, `marchfelder_bank`, `oberbank_ag`, `raiffeisen_bankengruppe_osterreich`, `schoellerbank_ag`, `sparda_bank_wien`, `volksbank_gruppe`, `volkskreditbank_ag`, or `vr_bank_braunau`.
@@ -614,7 +615,7 @@ module Stripe
614
615
  class Giropay < Stripe::StripeObject; end
615
616
  class Grabpay < Stripe::StripeObject; end
616
617
  class Ideal < Stripe::StripeObject
617
- # 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`.
618
+ # 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`.
618
619
  sig { returns(T.nilable(String)) }
619
620
  attr_reader :bank
620
621
  # The Bank Identifier Code of the customer's bank, if the bank was provided.
@@ -668,7 +669,7 @@ module Stripe
668
669
  # Contains information about card networks that can be used to process the payment.
669
670
  sig { returns(T.nilable(Networks)) }
670
671
  attr_reader :networks
671
- # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
672
+ # 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.
672
673
  sig { returns(T.nilable(T::Array[String])) }
673
674
  attr_reader :preferred_locales
674
675
  # How card details were read in this transaction.
@@ -903,6 +904,9 @@ module Stripe
903
904
  # Attribute for field cashapp
904
905
  sig { returns(Cashapp) }
905
906
  attr_reader :cashapp
907
+ # Attribute for field crypto
908
+ sig { returns(Crypto) }
909
+ attr_reader :crypto
906
910
  # 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.
907
911
  sig { returns(T.nilable(T.any(String, Stripe::Customer))) }
908
912
  attr_reader :customer
@@ -1194,6 +1198,7 @@ module Stripe
1194
1198
  def initialize(tax_id: nil); end
1195
1199
  end
1196
1200
  class Cashapp < Stripe::RequestParams; end
1201
+ class Crypto < Stripe::RequestParams; end
1197
1202
  class CustomerBalance < Stripe::RequestParams; end
1198
1203
  class Eps < Stripe::RequestParams
1199
1204
  # The customer's bank.
@@ -1432,6 +1437,11 @@ module Stripe
1432
1437
  returns(T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Cashapp))
1433
1438
  }
1434
1439
  attr_accessor :cashapp
1440
+ # If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
1441
+ sig {
1442
+ returns(T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Crypto))
1443
+ }
1444
+ attr_accessor :crypto
1435
1445
  # If this is a `customer_balance` PaymentMethod, this hash contains details about the CustomerBalance payment method.
1436
1446
  sig {
1437
1447
  returns(T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::CustomerBalance))
@@ -1614,7 +1624,7 @@ module Stripe
1614
1624
  }
1615
1625
  attr_accessor :zip
1616
1626
  sig {
1617
- params(acss_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AcssDebit), affirm: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Affirm), afterpay_clearpay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AfterpayClearpay), alipay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Alipay), allow_redisplay: T.nilable(String), alma: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Alma), amazon_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AmazonPay), au_becs_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AuBecsDebit), bacs_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::BacsDebit), bancontact: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Bancontact), billie: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Billie), billing_details: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::BillingDetails), blik: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Blik), boleto: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Boleto), cashapp: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Cashapp), customer_balance: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::CustomerBalance), eps: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Eps), fpx: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Fpx), giropay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Giropay), grabpay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Grabpay), ideal: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Ideal), interac_present: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::InteracPresent), kakao_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::KakaoPay), klarna: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Klarna), konbini: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Konbini), kr_card: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::KrCard), link: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Link), metadata: T.nilable(T::Hash[String, String]), mobilepay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Mobilepay), multibanco: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Multibanco), naver_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::NaverPay), nz_bank_account: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::NzBankAccount), oxxo: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Oxxo), p24: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::P24), pay_by_bank: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::PayByBank), payco: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Payco), paynow: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Paynow), paypal: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Paypal), pix: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Pix), promptpay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Promptpay), radar_options: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::RadarOptions), revolut_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::RevolutPay), samsung_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::SamsungPay), satispay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Satispay), sepa_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::SepaDebit), sofort: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Sofort), swish: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Swish), twint: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Twint), type: String, us_bank_account: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::UsBankAccount), wechat_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::WechatPay), zip: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Zip)).void
1627
+ params(acss_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AcssDebit), affirm: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Affirm), afterpay_clearpay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AfterpayClearpay), alipay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Alipay), allow_redisplay: T.nilable(String), alma: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Alma), amazon_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AmazonPay), au_becs_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::AuBecsDebit), bacs_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::BacsDebit), bancontact: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Bancontact), billie: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Billie), billing_details: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::BillingDetails), blik: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Blik), boleto: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Boleto), cashapp: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Cashapp), crypto: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Crypto), customer_balance: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::CustomerBalance), eps: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Eps), fpx: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Fpx), giropay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Giropay), grabpay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Grabpay), ideal: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Ideal), interac_present: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::InteracPresent), kakao_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::KakaoPay), klarna: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Klarna), konbini: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Konbini), kr_card: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::KrCard), link: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Link), metadata: T.nilable(T::Hash[String, String]), mobilepay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Mobilepay), multibanco: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Multibanco), naver_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::NaverPay), nz_bank_account: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::NzBankAccount), oxxo: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Oxxo), p24: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::P24), pay_by_bank: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::PayByBank), payco: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Payco), paynow: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Paynow), paypal: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Paypal), pix: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Pix), promptpay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Promptpay), radar_options: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::RadarOptions), revolut_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::RevolutPay), samsung_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::SamsungPay), satispay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Satispay), sepa_debit: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::SepaDebit), sofort: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Sofort), swish: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Swish), twint: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Twint), type: String, us_bank_account: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::UsBankAccount), wechat_pay: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::WechatPay), zip: T.nilable(::Stripe::ConfirmationToken::CreateParams::PaymentMethodData::Zip)).void
1618
1628
  }
1619
1629
  def initialize(
1620
1630
  acss_debit: nil,
@@ -1632,6 +1642,7 @@ module Stripe
1632
1642
  blik: nil,
1633
1643
  boleto: nil,
1634
1644
  cashapp: nil,
1645
+ crypto: nil,
1635
1646
  customer_balance: nil,
1636
1647
  eps: nil,
1637
1648
  fpx: nil,
@@ -1682,7 +1693,7 @@ module Stripe
1682
1693
  # One of `month`.
1683
1694
  sig { returns(T.nilable(String)) }
1684
1695
  attr_accessor :interval
1685
- # Type of installment plan, one of `fixed_count`.
1696
+ # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
1686
1697
  sig { returns(String) }
1687
1698
  attr_accessor :type
1688
1699
  sig {
@@ -323,7 +323,7 @@ module Stripe
323
323
  sig { params(shipping_rate: T.nilable(String)).void }
324
324
  def initialize(shipping_rate: nil); end
325
325
  end
326
- # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
326
+ # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
327
327
  sig { returns(T.nilable(Integer)) }
328
328
  attr_accessor :amount
329
329
  # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
@@ -341,7 +341,7 @@ module Stripe
341
341
  # ID of the invoice.
342
342
  sig { returns(String) }
343
343
  attr_accessor :invoice
344
- # Line items that make up the credit note.
344
+ # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
345
345
  sig { returns(T.nilable(T::Array[::Stripe::CreditNote::CreateParams::Line])) }
346
346
  attr_accessor :lines
347
347
  # The credit note's memo appears on the credit note PDF.
@@ -362,7 +362,7 @@ module Stripe
362
362
  # Refunds to link to this credit note.
363
363
  sig { returns(T.nilable(T::Array[::Stripe::CreditNote::CreateParams::Refund])) }
364
364
  attr_accessor :refunds
365
- # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
365
+ # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
366
366
  sig { returns(T.nilable(::Stripe::CreditNote::CreateParams::ShippingCost)) }
367
367
  attr_accessor :shipping_cost
368
368
  sig {
@@ -476,7 +476,7 @@ module Stripe
476
476
  sig { params(shipping_rate: T.nilable(String)).void }
477
477
  def initialize(shipping_rate: nil); end
478
478
  end
479
- # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
479
+ # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
480
480
  sig { returns(T.nilable(Integer)) }
481
481
  attr_accessor :amount
482
482
  # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
@@ -494,7 +494,7 @@ module Stripe
494
494
  # ID of the invoice.
495
495
  sig { returns(String) }
496
496
  attr_accessor :invoice
497
- # Line items that make up the credit note.
497
+ # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
498
498
  sig { returns(T.nilable(T::Array[::Stripe::CreditNote::PreviewParams::Line])) }
499
499
  attr_accessor :lines
500
500
  # The credit note's memo appears on the credit note PDF.
@@ -515,7 +515,7 @@ module Stripe
515
515
  # Refunds to link to this credit note.
516
516
  sig { returns(T.nilable(T::Array[::Stripe::CreditNote::PreviewParams::Refund])) }
517
517
  attr_accessor :refunds
518
- # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
518
+ # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
519
519
  sig { returns(T.nilable(::Stripe::CreditNote::PreviewParams::ShippingCost)) }
520
520
  attr_accessor :shipping_cost
521
521
  sig {
@@ -614,7 +614,7 @@ module Stripe
614
614
  sig { params(shipping_rate: T.nilable(String)).void }
615
615
  def initialize(shipping_rate: nil); end
616
616
  end
617
- # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
617
+ # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
618
618
  sig { returns(T.nilable(Integer)) }
619
619
  attr_accessor :amount
620
620
  # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
@@ -638,7 +638,7 @@ module Stripe
638
638
  # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
639
639
  sig { returns(T.nilable(Integer)) }
640
640
  attr_accessor :limit
641
- # Line items that make up the credit note.
641
+ # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
642
642
  sig { returns(T.nilable(T::Array[::Stripe::CreditNote::ListPreviewLineItemsParams::Line])) }
643
643
  attr_accessor :lines
644
644
  # The credit note's memo appears on the credit note PDF.
@@ -659,7 +659,7 @@ module Stripe
659
659
  # Refunds to link to this credit note.
660
660
  sig { returns(T.nilable(T::Array[::Stripe::CreditNote::ListPreviewLineItemsParams::Refund])) }
661
661
  attr_accessor :refunds
662
- # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
662
+ # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
663
663
  sig { returns(T.nilable(::Stripe::CreditNote::ListPreviewLineItemsParams::ShippingCost)) }
664
664
  attr_accessor :shipping_cost
665
665
  # 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.
@@ -26,7 +26,7 @@ module Stripe
26
26
  # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
27
27
  sig { returns(String) }
28
28
  attr_reader :payment_method_redisplay
29
- # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
29
+ # 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`.
30
30
  sig { returns(T.nilable(Integer)) }
31
31
  attr_reader :payment_method_redisplay_limit
32
32
  # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
@@ -109,7 +109,7 @@ module Stripe
109
109
  # Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
110
110
  sig { returns(T.nilable(String)) }
111
111
  attr_accessor :payment_method_redisplay
112
- # Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `3`.
112
+ # 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`.
113
113
  sig { returns(T.nilable(Integer)) }
114
114
  attr_accessor :payment_method_redisplay_limit
115
115
  # Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
@@ -53,7 +53,7 @@ module Stripe
53
53
  # The connected account that originates the event.
54
54
  sig { returns(String) }
55
55
  attr_reader :account
56
- # The Stripe API version used to render `data`. This property is populated only for events on or after October 31, 2014.
56
+ # 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.
57
57
  sig { returns(T.nilable(String)) }
58
58
  attr_reader :api_version
59
59
  # Authentication context needed to fetch the event or related object.
@@ -45,6 +45,14 @@ module Stripe
45
45
  attr_reader :require_verification
46
46
  end
47
47
  class IdNumber < Stripe::StripeObject; end
48
+ class Matching < Stripe::StripeObject
49
+ # Strictness of the DOB matching policy to apply.
50
+ sig { returns(String) }
51
+ attr_reader :dob
52
+ # Strictness of the name matching policy to apply.
53
+ sig { returns(String) }
54
+ attr_reader :name
55
+ end
48
56
  class Phone < Stripe::StripeObject
49
57
  # Request one time password verification of `provided_details.phone`.
50
58
  sig { returns(T::Boolean) }
@@ -59,6 +67,9 @@ module Stripe
59
67
  # Attribute for field id_number
60
68
  sig { returns(IdNumber) }
61
69
  attr_reader :id_number
70
+ # Attribute for field matching
71
+ sig { returns(Matching) }
72
+ attr_reader :matching
62
73
  # Attribute for field phone
63
74
  sig { returns(Phone) }
64
75
  attr_reader :phone
@@ -76,6 +87,14 @@ module Stripe
76
87
  sig { returns(String) }
77
88
  attr_reader :status
78
89
  end
90
+ class RelatedPerson < Stripe::StripeObject
91
+ # Token referencing the associated Account of the related Person resource.
92
+ sig { returns(String) }
93
+ attr_reader :account
94
+ # Token referencing the related Person resource.
95
+ sig { returns(String) }
96
+ attr_reader :person
97
+ end
79
98
  class VerifiedOutputs < Stripe::StripeObject
80
99
  class Address < Stripe::StripeObject
81
100
  # City, district, suburb, town, or village.
@@ -181,6 +200,9 @@ module Stripe
181
200
  # Customer ID
182
201
  sig { returns(T.nilable(String)) }
183
202
  attr_reader :related_customer
203
+ # Attribute for field related_person
204
+ sig { returns(RelatedPerson) }
205
+ attr_reader :related_person
184
206
  # Status of this VerificationSession. [Learn more about the lifecycle of sessions](https://stripe.com/docs/identity/how-sessions-work).
185
207
  sig { returns(String) }
186
208
  attr_reader :status
@@ -300,6 +322,16 @@ module Stripe
300
322
  sig { params(email: T.nilable(String), phone: T.nilable(String)).void }
301
323
  def initialize(email: nil, phone: nil); end
302
324
  end
325
+ class RelatedPerson < Stripe::RequestParams
326
+ # A token representing a connected account. If provided, the person parameter is also required and must be associated with the account.
327
+ sig { returns(String) }
328
+ attr_accessor :account
329
+ # A token referencing a Person resource that this verification is being used to verify.
330
+ sig { returns(String) }
331
+ attr_accessor :person
332
+ sig { params(account: String, person: String).void }
333
+ def initialize(account: nil, person: nil); end
334
+ end
303
335
  # 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.
304
336
  sig { returns(T.nilable(String)) }
305
337
  attr_accessor :client_reference_id
@@ -320,6 +352,11 @@ module Stripe
320
352
  # Customer ID
321
353
  sig { returns(T.nilable(String)) }
322
354
  attr_accessor :related_customer
355
+ # Tokens referencing a Person resource and it's associated account.
356
+ sig {
357
+ returns(T.nilable(::Stripe::Identity::VerificationSession::CreateParams::RelatedPerson))
358
+ }
359
+ attr_accessor :related_person
323
360
  # The URL that the user will be redirected to upon completing the verification flow.
324
361
  sig { returns(T.nilable(String)) }
325
362
  attr_accessor :return_url
@@ -330,7 +367,7 @@ module Stripe
330
367
  sig { returns(T.nilable(String)) }
331
368
  attr_accessor :verification_flow
332
369
  sig {
333
- params(client_reference_id: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T::Hash[String, String]), options: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::Options), provided_details: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::ProvidedDetails), related_customer: T.nilable(String), return_url: T.nilable(String), type: T.nilable(String), verification_flow: T.nilable(String)).void
370
+ params(client_reference_id: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T::Hash[String, String]), options: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::Options), provided_details: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::ProvidedDetails), related_customer: T.nilable(String), related_person: T.nilable(::Stripe::Identity::VerificationSession::CreateParams::RelatedPerson), return_url: T.nilable(String), type: T.nilable(String), verification_flow: T.nilable(String)).void
334
371
  }
335
372
  def initialize(
336
373
  client_reference_id: nil,
@@ -339,6 +376,7 @@ module Stripe
339
376
  options: nil,
340
377
  provided_details: nil,
341
378
  related_customer: nil,
379
+ related_person: nil,
342
380
  return_url: nil,
343
381
  type: nil,
344
382
  verification_flow: nil