stripe 15.2.0.pre.beta.1 → 15.3.0.pre.beta.1

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 (196) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +92 -0
  3. data/CONTRIBUTING.md +25 -0
  4. data/OPENAPI_VERSION +1 -1
  5. data/README.md +10 -7
  6. data/VERSION +1 -1
  7. data/lib/stripe/api_version.rb +1 -1
  8. data/lib/stripe/event_types.rb +9 -0
  9. data/lib/stripe/events/v2_core_account_link_completed_event.rb +1 -1
  10. data/lib/stripe/events/v2_money_management_inbound_transfer_bank_debit_failed_event.rb +1 -1
  11. data/lib/stripe/events/v2_money_management_inbound_transfer_bank_debit_processing_event.rb +1 -1
  12. data/lib/stripe/events/v2_money_management_inbound_transfer_bank_debit_queued_event.rb +1 -1
  13. data/lib/stripe/events/v2_money_management_inbound_transfer_bank_debit_returned_event.rb +1 -1
  14. data/lib/stripe/events/v2_money_management_inbound_transfer_bank_debit_succeeded_event.rb +1 -1
  15. data/lib/stripe/events/v2_money_management_outbound_payment_canceled_event.rb +1 -1
  16. data/lib/stripe/events/v2_money_management_outbound_payment_failed_event.rb +1 -1
  17. data/lib/stripe/events/v2_money_management_outbound_payment_posted_event.rb +1 -1
  18. data/lib/stripe/events/v2_money_management_outbound_payment_returned_event.rb +1 -1
  19. data/lib/stripe/events/v2_money_management_outbound_payment_updated_event.rb +1 -1
  20. data/lib/stripe/events/v2_off_session_payment_requires_capture_event.rb +21 -0
  21. data/lib/stripe/events/v2_payments_off_session_payment_authorization_attempt_failed_event.rb +21 -0
  22. data/lib/stripe/events/v2_payments_off_session_payment_authorization_attempt_started_event.rb +21 -0
  23. data/lib/stripe/events/v2_payments_off_session_payment_canceled_event.rb +21 -0
  24. data/lib/stripe/events/v2_payments_off_session_payment_created_event.rb +21 -0
  25. data/lib/stripe/events/v2_payments_off_session_payment_failed_event.rb +21 -0
  26. data/lib/stripe/events/v2_payments_off_session_payment_succeeded_event.rb +21 -0
  27. data/lib/stripe/object_types.rb +1 -3
  28. data/lib/stripe/resources/account.rb +47 -20
  29. data/lib/stripe/resources/account_session.rb +85 -24
  30. data/lib/stripe/resources/apple_pay_domain.rb +1 -2
  31. data/lib/stripe/resources/balance.rb +42 -0
  32. data/lib/stripe/resources/balance_transaction.rb +2 -0
  33. data/lib/stripe/resources/bank_account.rb +2 -2
  34. data/lib/stripe/resources/billing_portal/session.rb +1 -1
  35. data/lib/stripe/resources/capability.rb +1 -1
  36. data/lib/stripe/resources/charge.rb +85 -9
  37. data/lib/stripe/resources/checkout/session.rb +22 -6
  38. data/lib/stripe/resources/confirmation_token.rb +37 -97
  39. data/lib/stripe/resources/country_spec.rb +1 -1
  40. data/lib/stripe/resources/coupon.rb +1 -2
  41. data/lib/stripe/resources/credit_note.rb +10 -11
  42. data/lib/stripe/resources/customer.rb +2 -4
  43. data/lib/stripe/resources/customer_session.rb +3 -3
  44. data/lib/stripe/resources/dispute.rb +2 -2
  45. data/lib/stripe/resources/event.rb +1 -1
  46. data/lib/stripe/resources/file.rb +1 -1
  47. data/lib/stripe/resources/financial_connections/account.rb +2 -0
  48. data/lib/stripe/resources/financial_connections/institution.rb +2 -0
  49. data/lib/stripe/resources/identity/verification_report.rb +6 -0
  50. data/lib/stripe/resources/identity/verification_session.rb +17 -11
  51. data/lib/stripe/resources/invoice.rb +70 -43
  52. data/lib/stripe/resources/invoice_item.rb +2 -3
  53. data/lib/stripe/resources/invoice_line_item.rb +1 -1
  54. data/lib/stripe/resources/invoice_payment.rb +9 -2
  55. data/lib/stripe/resources/issuing/authorization.rb +8 -8
  56. data/lib/stripe/resources/issuing/card.rb +1 -1
  57. data/lib/stripe/resources/issuing/dispute.rb +3 -3
  58. data/lib/stripe/resources/order.rb +2 -55
  59. data/lib/stripe/resources/payment_attempt_record.rb +8 -0
  60. data/lib/stripe/resources/payment_intent.rb +439 -411
  61. data/lib/stripe/resources/payment_intent_amount_details_line_item.rb +7 -0
  62. data/lib/stripe/resources/payment_method.rb +50 -113
  63. data/lib/stripe/resources/payment_method_configuration.rb +297 -2
  64. data/lib/stripe/resources/payment_method_domain.rb +2 -2
  65. data/lib/stripe/resources/payment_record.rb +8 -0
  66. data/lib/stripe/resources/payout.rb +4 -4
  67. data/lib/stripe/resources/person.rb +2 -2
  68. data/lib/stripe/resources/plan.rb +2 -3
  69. data/lib/stripe/resources/price.rb +1 -1
  70. data/lib/stripe/resources/privacy/redaction_job.rb +52 -29
  71. data/lib/stripe/resources/privacy/redaction_job_validation_error.rb +12 -4
  72. data/lib/stripe/resources/product.rb +1 -61
  73. data/lib/stripe/resources/quote.rb +1 -1
  74. data/lib/stripe/resources/quote_preview_invoice.rb +2 -2
  75. data/lib/stripe/resources/quote_preview_subscription_schedule.rb +26 -1
  76. data/lib/stripe/resources/radar/value_list.rb +1 -2
  77. data/lib/stripe/resources/radar/value_list_item.rb +1 -2
  78. data/lib/stripe/resources/refund.rb +6 -1
  79. data/lib/stripe/resources/reversal.rb +1 -1
  80. data/lib/stripe/resources/review.rb +1 -1
  81. data/lib/stripe/resources/setup_intent.rb +123 -311
  82. data/lib/stripe/resources/source.rb +1 -1
  83. data/lib/stripe/resources/subscription.rb +132 -37
  84. data/lib/stripe/resources/subscription_item.rb +33 -0
  85. data/lib/stripe/resources/subscription_schedule.rb +120 -5
  86. data/lib/stripe/resources/tax/association.rb +8 -31
  87. data/lib/stripe/resources/tax/calculation.rb +4 -0
  88. data/lib/stripe/resources/tax/calculation_line_item.rb +2 -0
  89. data/lib/stripe/resources/tax/registration.rb +1 -1
  90. data/lib/stripe/resources/tax_id.rb +1 -2
  91. data/lib/stripe/resources/tax_rate.rb +2 -2
  92. data/lib/stripe/resources/terminal/configuration.rb +1 -2
  93. data/lib/stripe/resources/terminal/location.rb +2 -3
  94. data/lib/stripe/resources/terminal/reader.rb +26 -4
  95. data/lib/stripe/resources/test_helpers/test_clock.rb +1 -2
  96. data/lib/stripe/resources/token.rb +2 -2
  97. data/lib/stripe/resources/transfer.rb +1 -1
  98. data/lib/stripe/resources/v2/core/account.rb +5 -5
  99. data/lib/stripe/resources/v2/money_management/received_credit.rb +0 -20
  100. data/lib/stripe/resources/v2/money_management/received_debit.rb +0 -24
  101. data/lib/stripe/resources/v2/payments/off_session_payment.rb +74 -0
  102. data/lib/stripe/resources/webhook_endpoint.rb +1 -2
  103. data/lib/stripe/resources.rb +8 -3
  104. data/lib/stripe/services/account_external_account_service.rb +2 -3
  105. data/lib/stripe/services/account_login_link_service.rb +1 -1
  106. data/lib/stripe/services/account_person_service.rb +1 -2
  107. data/lib/stripe/services/account_service.rb +38 -13
  108. data/lib/stripe/services/account_session_service.rb +49 -24
  109. data/lib/stripe/services/apple_pay_domain_service.rb +1 -2
  110. data/lib/stripe/services/balance_service.rb +1 -1
  111. data/lib/stripe/services/balance_settings_service.rb +2 -2
  112. data/lib/stripe/services/charge_service.rb +76 -8
  113. data/lib/stripe/services/checkout/session_service.rb +14 -6
  114. data/lib/stripe/services/coupon_service.rb +1 -2
  115. data/lib/stripe/services/credit_note_service.rb +7 -8
  116. data/lib/stripe/services/customer_balance_transaction_service.rb +3 -3
  117. data/lib/stripe/services/customer_cash_balance_transaction_service.rb +2 -2
  118. data/lib/stripe/services/customer_payment_source_service.rb +1 -1
  119. data/lib/stripe/services/customer_service.rb +3 -5
  120. data/lib/stripe/services/customer_tax_id_service.rb +1 -2
  121. data/lib/stripe/services/dispute_service.rb +1 -1
  122. data/lib/stripe/services/external_account_service.rb +2 -3
  123. data/lib/stripe/services/file_service.rb +1 -1
  124. data/lib/stripe/services/identity/verification_session_service.rb +5 -5
  125. data/lib/stripe/services/invoice_item_service.rb +1 -2
  126. data/lib/stripe/services/invoice_service.rb +65 -35
  127. data/lib/stripe/services/issuing/authorization_service.rb +4 -4
  128. data/lib/stripe/services/issuing/card_service.rb +1 -1
  129. data/lib/stripe/services/issuing/dispute_service.rb +2 -2
  130. data/lib/stripe/services/order_service.rb +1 -33
  131. data/lib/stripe/services/payment_intent_service.rb +385 -386
  132. data/lib/stripe/services/payment_method_configuration_service.rb +212 -2
  133. data/lib/stripe/services/payment_method_domain_service.rb +1 -1
  134. data/lib/stripe/services/payment_method_service.rb +47 -110
  135. data/lib/stripe/services/payout_service.rb +2 -2
  136. data/lib/stripe/services/plan_service.rb +2 -3
  137. data/lib/stripe/services/price_service.rb +2 -2
  138. data/lib/stripe/services/privacy/redaction_job_service.rb +22 -13
  139. data/lib/stripe/services/privacy/redaction_job_validation_error_service.rb +1 -1
  140. data/lib/stripe/services/product_feature_service.rb +1 -2
  141. data/lib/stripe/services/product_service.rb +2 -41
  142. data/lib/stripe/services/promotion_code_service.rb +1 -1
  143. data/lib/stripe/services/quote_service.rb +1 -1
  144. data/lib/stripe/services/radar/early_fraud_warning_service.rb +1 -1
  145. data/lib/stripe/services/radar/value_list_item_service.rb +1 -2
  146. data/lib/stripe/services/radar/value_list_service.rb +1 -2
  147. data/lib/stripe/services/setup_intent_service.rb +122 -310
  148. data/lib/stripe/services/source_service.rb +1 -1
  149. data/lib/stripe/services/subscription_item_service.rb +26 -0
  150. data/lib/stripe/services/subscription_schedule_service.rb +94 -4
  151. data/lib/stripe/services/subscription_service.rb +103 -33
  152. data/lib/stripe/services/tax/calculation_service.rb +4 -0
  153. data/lib/stripe/services/tax/registration_service.rb +1 -1
  154. data/lib/stripe/services/tax_id_service.rb +1 -2
  155. data/lib/stripe/services/terminal/configuration_service.rb +1 -2
  156. data/lib/stripe/services/terminal/location_service.rb +2 -3
  157. data/lib/stripe/services/terminal/reader_service.rb +17 -3
  158. data/lib/stripe/services/test_helpers/confirmation_token_service.rb +37 -97
  159. data/lib/stripe/services/test_helpers/test_clock_service.rb +1 -2
  160. data/lib/stripe/services/token_service.rb +1 -1
  161. data/lib/stripe/services/transfer_service.rb +1 -1
  162. data/lib/stripe/services/v1_services.rb +1 -2
  163. data/lib/stripe/services/v2/billing/meter_event_session_service.rb +1 -2
  164. data/lib/stripe/services/v2/core/accounts/person_service.rb +2 -4
  165. data/lib/stripe/services/v2/core/event_destination_service.rb +4 -10
  166. data/lib/stripe/services/v2/core/event_service.rb +1 -2
  167. data/lib/stripe/services/v2/core/vault/gb_bank_account_service.rb +3 -7
  168. data/lib/stripe/services/v2/core/vault/us_bank_account_service.rb +2 -4
  169. data/lib/stripe/services/v2/money_management/adjustment_service.rb +1 -2
  170. data/lib/stripe/services/v2/money_management/financial_account_service.rb +1 -2
  171. data/lib/stripe/services/v2/money_management/financial_address_service.rb +1 -1
  172. data/lib/stripe/services/v2/money_management/inbound_transfer_service.rb +1 -2
  173. data/lib/stripe/services/v2/money_management/outbound_payment_quote_service.rb +1 -2
  174. data/lib/stripe/services/v2/money_management/outbound_payment_service.rb +2 -4
  175. data/lib/stripe/services/v2/money_management/outbound_setup_intent_service.rb +2 -4
  176. data/lib/stripe/services/v2/money_management/outbound_transfer_service.rb +2 -4
  177. data/lib/stripe/services/v2/money_management/payout_method_service.rb +3 -7
  178. data/lib/stripe/services/v2/money_management/received_credit_service.rb +1 -2
  179. data/lib/stripe/services/v2/money_management/received_debit_service.rb +1 -2
  180. data/lib/stripe/services/v2/money_management/transaction_entry_service.rb +1 -2
  181. data/lib/stripe/services/v2/money_management/transaction_service.rb +1 -2
  182. data/lib/stripe/services/v2/payment_service.rb +15 -0
  183. data/lib/stripe/services/v2/payments/off_session_payment_service.rb +138 -0
  184. data/lib/stripe/services/v2/test_helpers/financial_address_service.rb +1 -2
  185. data/lib/stripe/services/v2_services.rb +2 -1
  186. data/lib/stripe/services/webhook_endpoint_service.rb +1 -2
  187. data/lib/stripe/services.rb +2 -3
  188. data/lib/stripe/version.rb +1 -1
  189. data/rbi/stripe.rbi +3903 -4131
  190. metadata +13 -8
  191. data/lib/stripe/resources/billing/meter_error_report.rb +0 -59
  192. data/lib/stripe/resources/gift_cards/card.rb +0 -208
  193. data/lib/stripe/resources/gift_cards/transaction.rb +0 -272
  194. data/lib/stripe/services/gift_cards/card_service.rb +0 -170
  195. data/lib/stripe/services/gift_cards/transaction_service.rb +0 -209
  196. data/lib/stripe/services/gift_cards_service.rb +0 -14
@@ -14,6 +14,11 @@ module Stripe
14
14
  attr_reader :commodity_code
15
15
  end
16
16
 
17
+ class CardPresent < Stripe::StripeObject
18
+ # Attribute for field commodity_code
19
+ attr_reader :commodity_code
20
+ end
21
+
17
22
  class Klarna < Stripe::StripeObject
18
23
  # Attribute for field image_url
19
24
  attr_reader :image_url
@@ -31,6 +36,8 @@ module Stripe
31
36
  end
32
37
  # Attribute for field card
33
38
  attr_reader :card
39
+ # Attribute for field card_present
40
+ attr_reader :card_present
34
41
  # Attribute for field klarna
35
42
  attr_reader :klarna
36
43
  # Attribute for field paypal
@@ -745,20 +745,11 @@ module Stripe
745
745
  end
746
746
  end
747
747
 
748
- class Affirm < Stripe::RequestParams
749
- end
750
-
751
- class AfterpayClearpay < Stripe::RequestParams
752
- end
753
-
754
- class Alipay < Stripe::RequestParams
755
- end
756
-
757
- class Alma < Stripe::RequestParams
758
- end
759
-
760
- class AmazonPay < Stripe::RequestParams
761
- end
748
+ class Affirm < Stripe::RequestParams; end
749
+ class AfterpayClearpay < Stripe::RequestParams; end
750
+ class Alipay < Stripe::RequestParams; end
751
+ class Alma < Stripe::RequestParams; end
752
+ class AmazonPay < Stripe::RequestParams; end
762
753
 
763
754
  class AuBecsDebit < Stripe::RequestParams
764
755
  # The account number for the bank account.
@@ -784,11 +775,8 @@ module Stripe
784
775
  end
785
776
  end
786
777
 
787
- class Bancontact < Stripe::RequestParams
788
- end
789
-
790
- class Billie < Stripe::RequestParams
791
- end
778
+ class Bancontact < Stripe::RequestParams; end
779
+ class Billie < Stripe::RequestParams; end
792
780
 
793
781
  class BillingDetails < Stripe::RequestParams
794
782
  class Address < Stripe::RequestParams
@@ -841,8 +829,7 @@ module Stripe
841
829
  end
842
830
  end
843
831
 
844
- class Blik < Stripe::RequestParams
845
- end
832
+ class Blik < Stripe::RequestParams; end
846
833
 
847
834
  class Boleto < Stripe::RequestParams
848
835
  # The tax ID of the customer (CPF for individual consumers or CNPJ for businesses consumers)
@@ -892,11 +879,8 @@ module Stripe
892
879
  end
893
880
  end
894
881
 
895
- class Cashapp < Stripe::RequestParams
896
- end
897
-
898
- class CustomerBalance < Stripe::RequestParams
899
- end
882
+ class Cashapp < Stripe::RequestParams; end
883
+ class CustomerBalance < Stripe::RequestParams; end
900
884
 
901
885
  class Eps < Stripe::RequestParams
902
886
  # The customer's bank.
@@ -919,14 +903,9 @@ module Stripe
919
903
  end
920
904
  end
921
905
 
922
- class Giropay < Stripe::RequestParams
923
- end
924
-
925
- class Gopay < Stripe::RequestParams
926
- end
927
-
928
- class Grabpay < Stripe::RequestParams
929
- end
906
+ class Giropay < Stripe::RequestParams; end
907
+ class Gopay < Stripe::RequestParams; end
908
+ class Grabpay < Stripe::RequestParams; end
930
909
 
931
910
  class IdBankTransfer < Stripe::RequestParams
932
911
  # Bank where the account is held.
@@ -946,11 +925,8 @@ module Stripe
946
925
  end
947
926
  end
948
927
 
949
- class InteracPresent < Stripe::RequestParams
950
- end
951
-
952
- class KakaoPay < Stripe::RequestParams
953
- end
928
+ class InteracPresent < Stripe::RequestParams; end
929
+ class KakaoPay < Stripe::RequestParams; end
954
930
 
955
931
  class Klarna < Stripe::RequestParams
956
932
  class Dob < Stripe::RequestParams
@@ -975,23 +951,12 @@ module Stripe
975
951
  end
976
952
  end
977
953
 
978
- class Konbini < Stripe::RequestParams
979
- end
980
-
981
- class KrCard < Stripe::RequestParams
982
- end
983
-
984
- class Link < Stripe::RequestParams
985
- end
986
-
987
- class MbWay < Stripe::RequestParams
988
- end
989
-
990
- class Mobilepay < Stripe::RequestParams
991
- end
992
-
993
- class Multibanco < Stripe::RequestParams
994
- end
954
+ class Konbini < Stripe::RequestParams; end
955
+ class KrCard < Stripe::RequestParams; end
956
+ class Link < Stripe::RequestParams; end
957
+ class MbWay < Stripe::RequestParams; end
958
+ class Mobilepay < Stripe::RequestParams; end
959
+ class Multibanco < Stripe::RequestParams; end
995
960
 
996
961
  class NaverPay < Stripe::RequestParams
997
962
  # Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
@@ -1033,8 +998,7 @@ module Stripe
1033
998
  end
1034
999
  end
1035
1000
 
1036
- class Oxxo < Stripe::RequestParams
1037
- end
1001
+ class Oxxo < Stripe::RequestParams; end
1038
1002
 
1039
1003
  class P24 < Stripe::RequestParams
1040
1004
  # The customer's bank.
@@ -1045,17 +1009,10 @@ module Stripe
1045
1009
  end
1046
1010
  end
1047
1011
 
1048
- class PayByBank < Stripe::RequestParams
1049
- end
1050
-
1051
- class Payco < Stripe::RequestParams
1052
- end
1053
-
1054
- class Paynow < Stripe::RequestParams
1055
- end
1056
-
1057
- class Paypal < Stripe::RequestParams
1058
- end
1012
+ class PayByBank < Stripe::RequestParams; end
1013
+ class Payco < Stripe::RequestParams; end
1014
+ class Paynow < Stripe::RequestParams; end
1015
+ class Paypal < Stripe::RequestParams; end
1059
1016
 
1060
1017
  class Payto < Stripe::RequestParams
1061
1018
  # The account number for the bank account.
@@ -1072,14 +1029,9 @@ module Stripe
1072
1029
  end
1073
1030
  end
1074
1031
 
1075
- class Pix < Stripe::RequestParams
1076
- end
1077
-
1078
- class Promptpay < Stripe::RequestParams
1079
- end
1080
-
1081
- class Qris < Stripe::RequestParams
1082
- end
1032
+ class Pix < Stripe::RequestParams; end
1033
+ class Promptpay < Stripe::RequestParams; end
1034
+ class Qris < Stripe::RequestParams; end
1083
1035
 
1084
1036
  class RadarOptions < Stripe::RequestParams
1085
1037
  # 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.
@@ -1113,14 +1065,9 @@ module Stripe
1113
1065
  end
1114
1066
  end
1115
1067
 
1116
- class RevolutPay < Stripe::RequestParams
1117
- end
1118
-
1119
- class SamsungPay < Stripe::RequestParams
1120
- end
1121
-
1122
- class Satispay < Stripe::RequestParams
1123
- end
1068
+ class RevolutPay < Stripe::RequestParams; end
1069
+ class SamsungPay < Stripe::RequestParams; end
1070
+ class Satispay < Stripe::RequestParams; end
1124
1071
 
1125
1072
  class SepaDebit < Stripe::RequestParams
1126
1073
  # IBAN of the bank account.
@@ -1131,8 +1078,7 @@ module Stripe
1131
1078
  end
1132
1079
  end
1133
1080
 
1134
- class Shopeepay < Stripe::RequestParams
1135
- end
1081
+ class Shopeepay < Stripe::RequestParams; end
1136
1082
 
1137
1083
  class Sofort < Stripe::RequestParams
1138
1084
  # Two-letter ISO code representing the country the bank account is located in.
@@ -1155,11 +1101,8 @@ module Stripe
1155
1101
  end
1156
1102
  end
1157
1103
 
1158
- class Swish < Stripe::RequestParams
1159
- end
1160
-
1161
- class Twint < Stripe::RequestParams
1162
- end
1104
+ class Swish < Stripe::RequestParams; end
1105
+ class Twint < Stripe::RequestParams; end
1163
1106
 
1164
1107
  class UsBankAccount < Stripe::RequestParams
1165
1108
  # Account holder type: individual or company.
@@ -1188,11 +1131,8 @@ module Stripe
1188
1131
  end
1189
1132
  end
1190
1133
 
1191
- class WechatPay < Stripe::RequestParams
1192
- end
1193
-
1194
- class Zip < Stripe::RequestParams
1195
- end
1134
+ class WechatPay < Stripe::RequestParams; end
1135
+ class Zip < Stripe::RequestParams; end
1196
1136
  # If this is an `acss_debit` PaymentMethod, this hash contains details about the ACSS Debit payment method.
1197
1137
  attr_accessor :acss_debit
1198
1138
  # If this is an `affirm` PaymentMethod, this hash contains details about the Affirm payment method.
@@ -1530,11 +1470,8 @@ module Stripe
1530
1470
  end
1531
1471
  end
1532
1472
 
1533
- class Link < Stripe::RequestParams
1534
- end
1535
-
1536
- class PayByBank < Stripe::RequestParams
1537
- end
1473
+ class Link < Stripe::RequestParams; end
1474
+ class PayByBank < Stripe::RequestParams; end
1538
1475
 
1539
1476
  class Payto < Stripe::RequestParams
1540
1477
  # The account number for the bank account.
@@ -1766,16 +1703,16 @@ module Stripe
1766
1703
 
1767
1704
  # Attaches a PaymentMethod object to a Customer.
1768
1705
  #
1769
- # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
1770
- # or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
1706
+ # 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)
1707
+ # or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
1771
1708
  # These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
1772
1709
  # endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
1773
1710
  # future use, which makes later declines and payment friction more likely.
1774
- # See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
1711
+ # See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
1775
1712
  # future payments.
1776
1713
  #
1777
1714
  # To use this PaymentMethod as the default for invoice or subscription payments,
1778
- # set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
1715
+ # set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
1779
1716
  # on the Customer to the PaymentMethod's ID.
1780
1717
  def attach(params = {}, opts = {})
1781
1718
  request_stripe_object(
@@ -1788,16 +1725,16 @@ module Stripe
1788
1725
 
1789
1726
  # Attaches a PaymentMethod object to a Customer.
1790
1727
  #
1791
- # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
1792
- # or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
1728
+ # 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)
1729
+ # or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
1793
1730
  # These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
1794
1731
  # endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
1795
1732
  # future use, which makes later declines and payment friction more likely.
1796
- # See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
1733
+ # See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
1797
1734
  # future payments.
1798
1735
  #
1799
1736
  # To use this PaymentMethod as the default for invoice or subscription payments,
1800
- # set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
1737
+ # set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
1801
1738
  # on the Customer to the PaymentMethod's ID.
1802
1739
  def self.attach(payment_method, params = {}, opts = {})
1803
1740
  request_stripe_object(
@@ -1808,9 +1745,9 @@ module Stripe
1808
1745
  )
1809
1746
  end
1810
1747
 
1811
- # 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.
1748
+ # 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.
1812
1749
  #
1813
- # 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.
1750
+ # 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.
1814
1751
  def self.create(params = {}, opts = {})
1815
1752
  request_stripe_object(method: :post, path: "/v1/payment_methods", params: params, opts: opts)
1816
1753
  end
@@ -1835,7 +1772,7 @@ module Stripe
1835
1772
  )
1836
1773
  end
1837
1774
 
1838
- # 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.
1775
+ # 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.
1839
1776
  def self.list(params = {}, opts = {})
1840
1777
  request_stripe_object(method: :get, path: "/v1/payment_methods", params: params, opts: opts)
1841
1778
  end