stripe 17.4.0-beta.1 → 17.4.0-beta.3

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 (97) hide show
  1. package/CHANGELOG.md +78 -36
  2. package/VERSION +1 -1
  3. package/cjs/apiVersion.js +1 -1
  4. package/cjs/resources/Issuing/FraudLiabilityDebits.js +17 -0
  5. package/cjs/resources/PaymentAttemptRecords.js +17 -0
  6. package/cjs/resources/PaymentRecords.js +29 -0
  7. package/cjs/resources/TestHelpers/Issuing/Authorizations.js +4 -0
  8. package/cjs/resources.js +28 -6
  9. package/cjs/stripe.core.js +1 -1
  10. package/esm/apiVersion.js +1 -1
  11. package/esm/resources/Issuing/FraudLiabilityDebits.js +14 -0
  12. package/esm/resources/PaymentAttemptRecords.js +14 -0
  13. package/esm/resources/PaymentRecords.js +26 -0
  14. package/esm/resources/TestHelpers/Issuing/Authorizations.js +4 -0
  15. package/esm/resources.js +22 -1
  16. package/esm/stripe.core.js +1 -1
  17. package/package.json +1 -1
  18. package/types/AccountSessions.d.ts +5 -5
  19. package/types/AccountSessionsResource.d.ts +29 -6
  20. package/types/Accounts.d.ts +39 -5
  21. package/types/AccountsResource.d.ts +15 -0
  22. package/types/Billing/CreditBalanceSummaryResource.d.ts +1 -1
  23. package/types/Billing/CreditGrants.d.ts +5 -6
  24. package/types/Billing/CreditGrantsResource.d.ts +11 -11
  25. package/types/Billing/MeterEventsResource.d.ts +1 -1
  26. package/types/Capabilities.d.ts +1 -1
  27. package/types/Charges.d.ts +5 -5
  28. package/types/Checkout/Sessions.d.ts +60 -3
  29. package/types/Checkout/SessionsResource.d.ts +91 -5
  30. package/types/ConfirmationTokens.d.ts +4 -4
  31. package/types/CustomersResource.d.ts +4 -2
  32. package/types/Disputes.d.ts +1 -1
  33. package/types/EventTypes.d.ts +34 -0
  34. package/types/Events.d.ts +2 -0
  35. package/types/FileLinksResource.d.ts +1 -1
  36. package/types/Files.d.ts +1 -0
  37. package/types/FilesResource.d.ts +1 -0
  38. package/types/FundingInstructions.d.ts +49 -0
  39. package/types/Identity/VerificationReports.d.ts +1 -1
  40. package/types/Identity/VerificationSessions.d.ts +1 -1
  41. package/types/Identity/VerificationSessionsResource.d.ts +1 -1
  42. package/types/InvoicePayments.d.ts +10 -35
  43. package/types/Invoices.d.ts +9 -2
  44. package/types/InvoicesResource.d.ts +24 -11
  45. package/types/Issuing/Authorizations.d.ts +41 -1
  46. package/types/Issuing/Cardholders.d.ts +1 -1
  47. package/types/Issuing/Cards.d.ts +2 -2
  48. package/types/Issuing/FraudLiabilityDebits.d.ts +52 -0
  49. package/types/Issuing/FraudLiabilityDebitsResource.d.ts +52 -0
  50. package/types/Orders.d.ts +2 -1
  51. package/types/OrdersResource.d.ts +4 -2
  52. package/types/PaymentAttemptRecords.d.ts +242 -0
  53. package/types/PaymentAttemptRecordsResource.d.ts +47 -0
  54. package/types/PaymentIntents.d.ts +52 -2
  55. package/types/PaymentIntentsResource.d.ts +9 -6
  56. package/types/PaymentLinks.d.ts +1 -1
  57. package/types/PaymentLinksResource.d.ts +10 -3
  58. package/types/PaymentMethods.d.ts +4 -4
  59. package/types/PaymentRecords.d.ts +259 -0
  60. package/types/PaymentRecordsResource.d.ts +455 -0
  61. package/types/Payouts.d.ts +17 -0
  62. package/types/Persons.d.ts +5 -0
  63. package/types/QuoteLines.d.ts +1 -1
  64. package/types/QuotePreviewInvoices.d.ts +9 -2
  65. package/types/QuotePreviewSubscriptionSchedules.d.ts +1 -1
  66. package/types/Refunds.d.ts +10 -0
  67. package/types/SetupAttempts.d.ts +2 -2
  68. package/types/SetupIntents.d.ts +2 -1
  69. package/types/SetupIntentsResource.d.ts +7 -4
  70. package/types/SubscriptionSchedules.d.ts +1 -1
  71. package/types/SubscriptionSchedulesResource.d.ts +2 -2
  72. package/types/Subscriptions.d.ts +4 -2
  73. package/types/SubscriptionsResource.d.ts +6 -2
  74. package/types/Tax/CalculationLineItems.d.ts +1 -0
  75. package/types/Tax/Calculations.d.ts +4 -1
  76. package/types/Tax/CalculationsResource.d.ts +2 -1
  77. package/types/Tax/Transactions.d.ts +3 -1
  78. package/types/TaxIds.d.ts +2 -1
  79. package/types/TaxIdsResource.d.ts +2 -1
  80. package/types/TaxRates.d.ts +1 -0
  81. package/types/TaxRatesResource.d.ts +2 -0
  82. package/types/TestHelpers/Issuing/AuthorizationsResource.d.ts +37 -4
  83. package/types/TokensResource.d.ts +5 -0
  84. package/types/Treasury/InboundTransfers.d.ts +1 -1
  85. package/types/WebhookEndpointsResource.d.ts +6 -1
  86. package/types/index.d.ts +21 -4
  87. package/types/lib.d.ts +1 -1
  88. package/types/test/typescriptTest.ts +3 -3
  89. package/cjs/resources/V2/Billing.js +0 -18
  90. package/cjs/resources/V2/Core.js +0 -14
  91. package/cjs/resources/V2.js +0 -14
  92. package/esm/resources/V2/Billing.js +0 -15
  93. package/esm/resources/V2/Core.js +0 -11
  94. package/esm/resources/V2.js +0 -11
  95. package/types/V2/BillingResource.d.ts +0 -14
  96. package/types/V2/CoreResource.d.ts +0 -12
  97. package/types/V2Resource.d.ts +0 -10
@@ -0,0 +1,455 @@
1
+ // File generated from our OpenAPI spec
2
+
3
+ declare module 'stripe' {
4
+ namespace Stripe {
5
+ interface PaymentRecordRetrieveParams {
6
+ /**
7
+ * Specifies which fields in the response should be expanded.
8
+ */
9
+ expand?: Array<string>;
10
+ }
11
+
12
+ interface PaymentRecordReportPaymentParams {
13
+ /**
14
+ * The amount you intend to collect for this payment.
15
+ */
16
+ amount_requested: PaymentRecordReportPaymentParams.AmountRequested;
17
+
18
+ /**
19
+ * When the reported payment was initiated. Measured in seconds since the Unix epoch.
20
+ */
21
+ initiated_at: number;
22
+
23
+ /**
24
+ * Information about the Payment Method debited for this payment.
25
+ */
26
+ payment_method_details: PaymentRecordReportPaymentParams.PaymentMethodDetails;
27
+
28
+ /**
29
+ * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
30
+ */
31
+ payment_reference: string;
32
+
33
+ /**
34
+ * Customer information for this payment.
35
+ */
36
+ customer_details?: PaymentRecordReportPaymentParams.CustomerDetails;
37
+
38
+ /**
39
+ * Indicates whether the customer was present in your checkout flow during this payment.
40
+ */
41
+ customer_presence?: PaymentRecordReportPaymentParams.CustomerPresence;
42
+
43
+ /**
44
+ * An arbitrary string attached to the object. Often useful for displaying to users.
45
+ */
46
+ description?: string;
47
+
48
+ /**
49
+ * Specifies which fields in the response should be expanded.
50
+ */
51
+ expand?: Array<string>;
52
+
53
+ /**
54
+ * Information about the payment attempt failure.
55
+ */
56
+ failed?: PaymentRecordReportPaymentParams.Failed;
57
+
58
+ /**
59
+ * Information about the payment attempt guarantee.
60
+ */
61
+ guaranteed?: PaymentRecordReportPaymentParams.Guaranteed;
62
+
63
+ /**
64
+ * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
65
+ */
66
+ metadata?: Stripe.MetadataParam;
67
+
68
+ /**
69
+ * The outcome of the reported payment.
70
+ */
71
+ outcome?: PaymentRecordReportPaymentParams.Outcome;
72
+
73
+ /**
74
+ * Shipping information for this payment.
75
+ */
76
+ shipping_details?: PaymentRecordReportPaymentParams.ShippingDetails;
77
+ }
78
+
79
+ namespace PaymentRecordReportPaymentParams {
80
+ interface AmountRequested {
81
+ /**
82
+ * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
83
+ */
84
+ currency: string;
85
+
86
+ /**
87
+ * A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) e.g., 100 cents for $1.00 or 100 for ¥100, a zero-decimal currency).
88
+ */
89
+ value: number;
90
+ }
91
+
92
+ interface CustomerDetails {
93
+ /**
94
+ * The customer who made the payment.
95
+ */
96
+ customer?: string;
97
+
98
+ /**
99
+ * The customer's phone number.
100
+ */
101
+ email?: string;
102
+
103
+ /**
104
+ * The customer's name.
105
+ */
106
+ name?: string;
107
+
108
+ /**
109
+ * The customer's phone number.
110
+ */
111
+ phone?: string;
112
+ }
113
+
114
+ type CustomerPresence = 'off_session' | 'on_session';
115
+
116
+ interface Failed {
117
+ /**
118
+ * When the reported payment failed. Measured in seconds since the Unix epoch.
119
+ */
120
+ failed_at: number;
121
+ }
122
+
123
+ interface Guaranteed {
124
+ /**
125
+ * When the reported payment was guaranteed. Measured in seconds since the Unix epoch.
126
+ */
127
+ guaranteed_at: number;
128
+ }
129
+
130
+ type Outcome = 'failed' | 'guaranteed';
131
+
132
+ interface PaymentMethodDetails {
133
+ /**
134
+ * The billing details associated with the method of payment.
135
+ */
136
+ billing_details?: PaymentMethodDetails.BillingDetails;
137
+
138
+ /**
139
+ * Information about the custom (user-defined) payment method used to make this payment.
140
+ */
141
+ custom?: PaymentMethodDetails.Custom;
142
+
143
+ /**
144
+ * ID of the Stripe Payment Method used to make this payment.
145
+ */
146
+ payment_method?: string;
147
+
148
+ /**
149
+ * The type of the payment method details. An additional hash is included on the payment_method_details with a name matching this value. It contains additional information specific to the type.
150
+ */
151
+ type?: 'custom';
152
+ }
153
+
154
+ namespace PaymentMethodDetails {
155
+ interface BillingDetails {
156
+ /**
157
+ * The billing address associated with the method of payment.
158
+ */
159
+ address?: Stripe.AddressParam;
160
+
161
+ /**
162
+ * The billing email associated with the method of payment.
163
+ */
164
+ email?: string;
165
+
166
+ /**
167
+ * The billing name associated with the method of payment.
168
+ */
169
+ name?: string;
170
+
171
+ /**
172
+ * The billing phone number associated with the method of payment.
173
+ */
174
+ phone?: string;
175
+ }
176
+
177
+ interface Custom {
178
+ /**
179
+ * Display name for the custom (user-defined) payment method type used to make this payment.
180
+ */
181
+ display_name?: string;
182
+
183
+ /**
184
+ * The custom payment method type associated with this payment.
185
+ */
186
+ type?: string;
187
+ }
188
+ }
189
+
190
+ interface ShippingDetails {
191
+ /**
192
+ * The physical shipping address.
193
+ */
194
+ address?: Stripe.AddressParam;
195
+
196
+ /**
197
+ * The shipping recipient's name.
198
+ */
199
+ name?: string;
200
+
201
+ /**
202
+ * The shipping recipient's phone number.
203
+ */
204
+ phone?: string;
205
+ }
206
+ }
207
+
208
+ interface PaymentRecordReportPaymentAttemptParams {
209
+ /**
210
+ * When the reported payment was initiated. Measured in seconds since the Unix epoch.
211
+ */
212
+ initiated_at: number;
213
+
214
+ /**
215
+ * An arbitrary string attached to the object. Often useful for displaying to users.
216
+ */
217
+ description?: string;
218
+
219
+ /**
220
+ * Specifies which fields in the response should be expanded.
221
+ */
222
+ expand?: Array<string>;
223
+
224
+ /**
225
+ * Information about the payment attempt failure.
226
+ */
227
+ failed?: PaymentRecordReportPaymentAttemptParams.Failed;
228
+
229
+ /**
230
+ * Information about the payment attempt guarantee.
231
+ */
232
+ guaranteed?: PaymentRecordReportPaymentAttemptParams.Guaranteed;
233
+
234
+ /**
235
+ * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
236
+ */
237
+ metadata?: Stripe.MetadataParam;
238
+
239
+ /**
240
+ * The outcome of the reported payment.
241
+ */
242
+ outcome?: PaymentRecordReportPaymentAttemptParams.Outcome;
243
+
244
+ /**
245
+ * Information about the Payment Method debited for this payment.
246
+ */
247
+ payment_method_details?: PaymentRecordReportPaymentAttemptParams.PaymentMethodDetails;
248
+
249
+ /**
250
+ * Shipping information for this payment.
251
+ */
252
+ shipping_details?: PaymentRecordReportPaymentAttemptParams.ShippingDetails;
253
+ }
254
+
255
+ namespace PaymentRecordReportPaymentAttemptParams {
256
+ interface Failed {
257
+ /**
258
+ * When the reported payment failed. Measured in seconds since the Unix epoch.
259
+ */
260
+ failed_at: number;
261
+ }
262
+
263
+ interface Guaranteed {
264
+ /**
265
+ * When the reported payment was guaranteed. Measured in seconds since the Unix epoch.
266
+ */
267
+ guaranteed_at: number;
268
+ }
269
+
270
+ type Outcome = 'failed' | 'guaranteed';
271
+
272
+ interface PaymentMethodDetails {
273
+ /**
274
+ * The billing details associated with the method of payment.
275
+ */
276
+ billing_details?: PaymentMethodDetails.BillingDetails;
277
+
278
+ /**
279
+ * Information about the custom (user-defined) payment method used to make this payment.
280
+ */
281
+ custom?: PaymentMethodDetails.Custom;
282
+
283
+ /**
284
+ * ID of the Stripe Payment Method used to make this payment.
285
+ */
286
+ payment_method?: string;
287
+
288
+ /**
289
+ * The type of the payment method details. An additional hash is included on the payment_method_details with a name matching this value. It contains additional information specific to the type.
290
+ */
291
+ type?: 'custom';
292
+ }
293
+
294
+ namespace PaymentMethodDetails {
295
+ interface BillingDetails {
296
+ /**
297
+ * The billing address associated with the method of payment.
298
+ */
299
+ address?: Stripe.AddressParam;
300
+
301
+ /**
302
+ * The billing email associated with the method of payment.
303
+ */
304
+ email?: string;
305
+
306
+ /**
307
+ * The billing name associated with the method of payment.
308
+ */
309
+ name?: string;
310
+
311
+ /**
312
+ * The billing phone number associated with the method of payment.
313
+ */
314
+ phone?: string;
315
+ }
316
+
317
+ interface Custom {
318
+ /**
319
+ * Display name for the custom (user-defined) payment method type used to make this payment.
320
+ */
321
+ display_name?: string;
322
+
323
+ /**
324
+ * The custom payment method type associated with this payment.
325
+ */
326
+ type?: string;
327
+ }
328
+ }
329
+
330
+ interface ShippingDetails {
331
+ /**
332
+ * The physical shipping address.
333
+ */
334
+ address?: Stripe.AddressParam;
335
+
336
+ /**
337
+ * The shipping recipient's name.
338
+ */
339
+ name?: string;
340
+
341
+ /**
342
+ * The shipping recipient's phone number.
343
+ */
344
+ phone?: string;
345
+ }
346
+ }
347
+
348
+ interface PaymentRecordReportPaymentAttemptCanceledParams {
349
+ /**
350
+ * When the reported payment was canceled. Measured in seconds since the Unix epoch.
351
+ */
352
+ canceled_at: number;
353
+
354
+ /**
355
+ * Specifies which fields in the response should be expanded.
356
+ */
357
+ expand?: Array<string>;
358
+
359
+ metadata?: Stripe.MetadataParam;
360
+ }
361
+
362
+ interface PaymentRecordReportPaymentAttemptFailedParams {
363
+ /**
364
+ * When the reported payment failed. Measured in seconds since the Unix epoch.
365
+ */
366
+ failed_at: number;
367
+
368
+ /**
369
+ * Specifies which fields in the response should be expanded.
370
+ */
371
+ expand?: Array<string>;
372
+
373
+ metadata?: Stripe.MetadataParam;
374
+ }
375
+
376
+ interface PaymentRecordReportPaymentAttemptGuaranteedParams {
377
+ /**
378
+ * When the reported payment was guaranteed. Measured in seconds since the Unix epoch.
379
+ */
380
+ guaranteed_at: number;
381
+
382
+ /**
383
+ * Specifies which fields in the response should be expanded.
384
+ */
385
+ expand?: Array<string>;
386
+
387
+ metadata?: Stripe.MetadataParam;
388
+ }
389
+
390
+ class PaymentRecordsResource {
391
+ /**
392
+ * Retrieves a Payment Record with the given ID
393
+ */
394
+ retrieve(
395
+ id: string,
396
+ params?: PaymentRecordRetrieveParams,
397
+ options?: RequestOptions
398
+ ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
399
+ retrieve(
400
+ id: string,
401
+ options?: RequestOptions
402
+ ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
403
+
404
+ /**
405
+ * Report a new Payment Record. You may report a Payment Record as it is
406
+ * initialized and later report updates through the other report_* methods, or report Payment
407
+ * Records in a terminal state directly, through this method.
408
+ */
409
+ reportPayment(
410
+ params: PaymentRecordReportPaymentParams,
411
+ options?: RequestOptions
412
+ ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
413
+
414
+ /**
415
+ * Report a new payment attempt on the specified Payment Record. A new payment
416
+ * attempt can only be specified if all other payment attempts are canceled or failed.
417
+ */
418
+ reportPaymentAttempt(
419
+ id: string,
420
+ params: PaymentRecordReportPaymentAttemptParams,
421
+ options?: RequestOptions
422
+ ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
423
+
424
+ /**
425
+ * Report that the most recent payment attempt on the specified Payment Record
426
+ * was canceled.
427
+ */
428
+ reportPaymentAttemptCanceled(
429
+ id: string,
430
+ params: PaymentRecordReportPaymentAttemptCanceledParams,
431
+ options?: RequestOptions
432
+ ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
433
+
434
+ /**
435
+ * Report that the most recent payment attempt on the specified Payment Record
436
+ * failed or errored.
437
+ */
438
+ reportPaymentAttemptFailed(
439
+ id: string,
440
+ params: PaymentRecordReportPaymentAttemptFailedParams,
441
+ options?: RequestOptions
442
+ ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
443
+
444
+ /**
445
+ * Report that the most recent payment attempt on the specified Payment Record
446
+ * was guaranteed.
447
+ */
448
+ reportPaymentAttemptGuaranteed(
449
+ id: string,
450
+ params: PaymentRecordReportPaymentAttemptGuaranteedParams,
451
+ options?: RequestOptions
452
+ ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
453
+ }
454
+ }
455
+ }
@@ -137,6 +137,11 @@ declare module 'stripe' {
137
137
  */
138
138
  status: string;
139
139
 
140
+ /**
141
+ * A value that generates from the beneficiary's bank that allows users to track payouts with their bank. Banks might call this a "reference number" or something similar.
142
+ */
143
+ trace_id?: Payout.TraceId | null;
144
+
140
145
  /**
141
146
  * Can be `bank_account` or `card`.
142
147
  */
@@ -149,6 +154,18 @@ declare module 'stripe' {
149
154
  | 'in_progress'
150
155
  | 'not_applicable';
151
156
 
157
+ interface TraceId {
158
+ /**
159
+ * Possible values are `pending`, `supported`, and `unsupported`. When `payout.status` is `pending` or `in_transit`, this will be `pending`. When the payout transitions to `paid`, `failed`, or `canceled`, this status will become `supported` or `unsupported` shortly after in most cases. In some cases, this may appear as `pending` for up to 10 days after `arrival_date` until transitioning to `supported` or `unsupported`.
160
+ */
161
+ status: string;
162
+
163
+ /**
164
+ * The trace ID value if `trace_id.status` is `supported`, otherwise `nil`.
165
+ */
166
+ value: string | null;
167
+ }
168
+
152
169
  type Type = 'bank_account' | 'card';
153
170
  }
154
171
  }
@@ -451,6 +451,11 @@ declare module 'stripe' {
451
451
  type PoliticalExposure = 'existing' | 'none';
452
452
 
453
453
  interface Relationship {
454
+ /**
455
+ * Whether the person is the authorizer of the account's representative.
456
+ */
457
+ authorizer: boolean | null;
458
+
454
459
  /**
455
460
  * Whether the person is a director of the account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
456
461
  */
@@ -531,7 +531,7 @@ declare module 'stripe' {
531
531
 
532
532
  interface SetPauseCollection {
533
533
  /**
534
- * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/billing/subscriptions/pause-payment).
534
+ * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment).
535
535
  */
536
536
  set?: SetPauseCollection.Set | null;
537
537
 
@@ -69,6 +69,11 @@ declare module 'stripe' {
69
69
  */
70
70
  amount_due: number;
71
71
 
72
+ /**
73
+ * Amount that was overpaid on the invoice. Overpayments are debited to the customer's credit balance.
74
+ */
75
+ amount_overpaid?: number;
76
+
72
77
  /**
73
78
  * The amount, in cents (or local equivalent), that was paid.
74
79
  */
@@ -603,7 +608,7 @@ declare module 'stripe' {
603
608
 
604
609
  interface CustomerTaxId {
605
610
  /**
606
- * The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, or `unknown`
611
+ * The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, or `unknown`
607
612
  */
608
613
  type: CustomerTaxId.Type;
609
614
 
@@ -661,6 +666,7 @@ declare module 'stripe' {
661
666
  | 'kr_brn'
662
667
  | 'kz_bin'
663
668
  | 'li_uid'
669
+ | 'li_vat'
664
670
  | 'ma_vat'
665
671
  | 'md_vat'
666
672
  | 'mx_rfc'
@@ -1248,6 +1254,7 @@ declare module 'stripe' {
1248
1254
  | 'boleto'
1249
1255
  | 'card'
1250
1256
  | 'cashapp'
1257
+ | 'custom'
1251
1258
  | 'customer_balance'
1252
1259
  | 'eps'
1253
1260
  | 'fpx'
@@ -1439,7 +1446,7 @@ declare module 'stripe' {
1439
1446
  metadata: Stripe.Metadata | null;
1440
1447
 
1441
1448
  /**
1442
- * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/billing/subscriptions/pause-payment).
1449
+ * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment).
1443
1450
  */
1444
1451
  pause_collection?: SubscriptionDetails.PauseCollection | null;
1445
1452
  }
@@ -408,7 +408,7 @@ declare module 'stripe' {
408
408
  on_behalf_of: string | Stripe.Account | null;
409
409
 
410
410
  /**
411
- * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/billing/subscriptions/pause-payment).
411
+ * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment).
412
412
  */
413
413
  pause_collection?: Phase.PauseCollection | null;
414
414
 
@@ -191,6 +191,11 @@ declare module 'stripe' {
191
191
  interface AuBankTransfer {}
192
192
 
193
193
  interface Blik {
194
+ /**
195
+ * For refunds declined by the network, a decline code provided by the network which indicates the reason the refund failed.
196
+ */
197
+ network_decline_code?: string | null;
198
+
194
199
  /**
195
200
  * The reference assigned to the refund.
196
201
  */
@@ -347,6 +352,11 @@ declare module 'stripe' {
347
352
  interface Sofort {}
348
353
 
349
354
  interface Swish {
355
+ /**
356
+ * For refunds declined by the network, a decline code provided by the network which indicates the reason the refund failed.
357
+ */
358
+ network_decline_code?: string | null;
359
+
350
360
  /**
351
361
  * The reference assigned to the refund.
352
362
  */
@@ -199,7 +199,7 @@ declare module 'stripe' {
199
199
 
200
200
  interface Card {
201
201
  /**
202
- * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
202
+ * Card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
203
203
  */
204
204
  brand: string | null;
205
205
 
@@ -256,7 +256,7 @@ declare module 'stripe' {
256
256
  last4: string | null;
257
257
 
258
258
  /**
259
- * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.
259
+ * Identifies which network this charge was processed on. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `interac`, `jcb`, `link`, `mastercard`, `unionpay`, `visa`, or `unknown`.
260
260
  */
261
261
  network: string | null;
262
262
 
@@ -130,7 +130,7 @@ declare module 'stripe' {
130
130
  payment_method: string | Stripe.PaymentMethod | null;
131
131
 
132
132
  /**
133
- * Information about the payment method configuration used for this Setup Intent.
133
+ * Information about the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) used for this Setup Intent.
134
134
  */
135
135
  payment_method_configuration_details: SetupIntent.PaymentMethodConfigurationDetails | null;
136
136
 
@@ -747,6 +747,7 @@ declare module 'stripe' {
747
747
  | 'girocard'
748
748
  | 'interac'
749
749
  | 'jcb'
750
+ | 'link'
750
751
  | 'mastercard'
751
752
  | 'unionpay'
752
753
  | 'unknown'
@@ -72,7 +72,7 @@ declare module 'stripe' {
72
72
  payment_method?: string;
73
73
 
74
74
  /**
75
- * The ID of the payment method configuration to use with this SetupIntent.
75
+ * The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this SetupIntent.
76
76
  */
77
77
  payment_method_configuration?: string;
78
78
 
@@ -88,7 +88,7 @@ declare module 'stripe' {
88
88
  payment_method_options?: SetupIntentCreateParams.PaymentMethodOptions;
89
89
 
90
90
  /**
91
- * The list of payment method types (for example, card) that this SetupIntent can use. If you don't provide this, it defaults to ["card"].
91
+ * The list of payment method types (for example, card) that this SetupIntent can use. If you don't provide this, Stripe will dynamically show relevant payment methods from your [payment method settings](https://dashboard.stripe.com/settings/payment_methods).
92
92
  */
93
93
  payment_method_types?: Array<string>;
94
94
 
@@ -1169,6 +1169,7 @@ declare module 'stripe' {
1169
1169
  | 'girocard'
1170
1170
  | 'interac'
1171
1171
  | 'jcb'
1172
+ | 'link'
1172
1173
  | 'mastercard'
1173
1174
  | 'unionpay'
1174
1175
  | 'unknown'
@@ -1557,7 +1558,7 @@ declare module 'stripe' {
1557
1558
  payment_method?: string;
1558
1559
 
1559
1560
  /**
1560
- * The ID of the payment method configuration to use with this SetupIntent.
1561
+ * The ID of the [payment method configuration](https://stripe.com/docs/api/payment_method_configurations) to use with this SetupIntent.
1561
1562
  */
1562
1563
  payment_method_configuration?: string;
1563
1564
 
@@ -1573,7 +1574,7 @@ declare module 'stripe' {
1573
1574
  payment_method_options?: SetupIntentUpdateParams.PaymentMethodOptions;
1574
1575
 
1575
1576
  /**
1576
- * The list of payment method types (for example, card) that this SetupIntent can set up. If you don't provide this array, it defaults to ["card"].
1577
+ * The list of payment method types (for example, card) that this SetupIntent can set up. If you don't provide this, Stripe will dynamically show relevant payment methods from your [payment method settings](https://dashboard.stripe.com/settings/payment_methods).
1577
1578
  */
1578
1579
  payment_method_types?: Array<string>;
1579
1580
  }
@@ -2567,6 +2568,7 @@ declare module 'stripe' {
2567
2568
  | 'girocard'
2568
2569
  | 'interac'
2569
2570
  | 'jcb'
2571
+ | 'link'
2570
2572
  | 'mastercard'
2571
2573
  | 'unionpay'
2572
2574
  | 'unknown'
@@ -4014,6 +4016,7 @@ declare module 'stripe' {
4014
4016
  | 'girocard'
4015
4017
  | 'interac'
4016
4018
  | 'jcb'
4019
+ | 'link'
4017
4020
  | 'mastercard'
4018
4021
  | 'unionpay'
4019
4022
  | 'unknown'