stripe 17.6.0-beta.3 → 17.6.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 (167) hide show
  1. package/CHANGELOG.md +124 -1040
  2. package/README.md +0 -1
  3. package/VERSION +1 -1
  4. package/cjs/resources/FinancialConnections/Accounts.js +0 -5
  5. package/cjs/resources/Invoices.js +0 -17
  6. package/cjs/resources/PaymentIntents.js +0 -8
  7. package/cjs/resources/Quotes.js +0 -32
  8. package/cjs/resources/SubscriptionSchedules.js +0 -4
  9. package/cjs/resources/Terminal/Readers.js +0 -12
  10. package/cjs/resources.js +10 -48
  11. package/cjs/stripe.core.js +1 -1
  12. package/esm/resources/FinancialConnections/Accounts.js +0 -5
  13. package/esm/resources/Invoices.js +0 -17
  14. package/esm/resources/PaymentIntents.js +0 -8
  15. package/esm/resources/Quotes.js +0 -32
  16. package/esm/resources/SubscriptionSchedules.js +0 -4
  17. package/esm/resources/Terminal/Readers.js +0 -12
  18. package/esm/resources.js +0 -33
  19. package/esm/stripe.core.js +1 -1
  20. package/package.json +1 -1
  21. package/types/AccountLinksResource.d.ts +1 -5
  22. package/types/AccountSessions.d.ts +0 -45
  23. package/types/AccountSessionsResource.d.ts +0 -222
  24. package/types/Accounts.d.ts +1 -190
  25. package/types/AccountsResource.d.ts +0 -520
  26. package/types/Cards.d.ts +0 -5
  27. package/types/Charges.d.ts +3 -141
  28. package/types/ChargesResource.d.ts +0 -1294
  29. package/types/Checkout/Sessions.d.ts +4 -340
  30. package/types/Checkout/SessionsResource.d.ts +5 -445
  31. package/types/ConfirmationTokens.d.ts +1 -100
  32. package/types/Coupons.d.ts +1 -1
  33. package/types/CouponsResource.d.ts +1 -1
  34. package/types/CreditNotes.d.ts +0 -21
  35. package/types/CreditNotesResource.d.ts +0 -51
  36. package/types/CustomersResource.d.ts +0 -7
  37. package/types/EventTypes.d.ts +0 -596
  38. package/types/Events.d.ts +0 -93
  39. package/types/FinancialConnections/Accounts.d.ts +1 -29
  40. package/types/FinancialConnections/AccountsResource.d.ts +3 -35
  41. package/types/FinancialConnections/Sessions.d.ts +1 -49
  42. package/types/FinancialConnections/SessionsResource.d.ts +1 -38
  43. package/types/InvoiceItems.d.ts +0 -5
  44. package/types/InvoiceItemsResource.d.ts +0 -98
  45. package/types/InvoiceLineItems.d.ts +1 -28
  46. package/types/Invoices.d.ts +2 -137
  47. package/types/InvoicesResource.d.ts +1882 -5567
  48. package/types/Issuing/Authorizations.d.ts +0 -1
  49. package/types/Issuing/CardholdersResource.d.ts +1 -2
  50. package/types/Issuing/Transactions.d.ts +0 -2
  51. package/types/Issuing/TransactionsResource.d.ts +0 -5
  52. package/types/LineItems.d.ts +0 -32
  53. package/types/Mandates.d.ts +0 -77
  54. package/types/PaymentIntents.d.ts +1 -644
  55. package/types/PaymentIntentsResource.d.ts +3734 -8021
  56. package/types/PaymentLinks.d.ts +0 -6
  57. package/types/PaymentLinksResource.d.ts +0 -12
  58. package/types/PaymentMethodConfigurations.d.ts +0 -180
  59. package/types/PaymentMethodConfigurationsResource.d.ts +0 -250
  60. package/types/PaymentMethods.d.ts +1 -100
  61. package/types/PaymentMethodsResource.d.ts +0 -133
  62. package/types/Prices.d.ts +0 -22
  63. package/types/PricesResource.d.ts +0 -22
  64. package/types/Products.d.ts +0 -39
  65. package/types/ProductsResource.d.ts +0 -36
  66. package/types/Quotes.d.ts +1 -591
  67. package/types/QuotesResource.d.ts +199 -2531
  68. package/types/Refunds.d.ts +2 -16
  69. package/types/SetupAttempts.d.ts +0 -38
  70. package/types/SetupIntents.d.ts +1 -111
  71. package/types/SetupIntentsResource.d.ts +3 -645
  72. package/types/Sources.d.ts +0 -29
  73. package/types/SubscriptionItems.d.ts +0 -21
  74. package/types/SubscriptionItemsResource.d.ts +0 -109
  75. package/types/SubscriptionSchedules.d.ts +0 -200
  76. package/types/SubscriptionSchedulesResource.d.ts +13 -1231
  77. package/types/Subscriptions.d.ts +1 -91
  78. package/types/SubscriptionsResource.d.ts +2 -369
  79. package/types/Terminal/Readers.d.ts +0 -290
  80. package/types/Terminal/ReadersResource.d.ts +0 -215
  81. package/types/TestHelpers/ConfirmationTokensResource.d.ts +0 -104
  82. package/types/TestHelpers/Treasury/ReceivedCreditsResource.d.ts +0 -26
  83. package/types/TestHelpers/Treasury/ReceivedDebitsResource.d.ts +0 -26
  84. package/types/Treasury/FinancialAccountFeatures.d.ts +0 -7
  85. package/types/Treasury/FinancialAccounts.d.ts +0 -5
  86. package/types/Treasury/FinancialAccountsResource.d.ts +0 -37
  87. package/types/Treasury/OutboundTransfers.d.ts +0 -26
  88. package/types/Treasury/OutboundTransfersResource.d.ts +0 -26
  89. package/types/Treasury/ReceivedCredits.d.ts +0 -26
  90. package/types/Treasury/ReceivedDebits.d.ts +0 -31
  91. package/types/WebhookEndpointsResource.d.ts +0 -70
  92. package/types/index.d.ts +0 -62
  93. package/cjs/resources/AccountNotices.js +0 -21
  94. package/cjs/resources/Capital/FinancingOffers.js +0 -21
  95. package/cjs/resources/Capital/FinancingSummary.js +0 -12
  96. package/cjs/resources/Capital/FinancingTransactions.js +0 -17
  97. package/cjs/resources/FinancialConnections/Institutions.js +0 -17
  98. package/cjs/resources/GiftCards/Cards.js +0 -23
  99. package/cjs/resources/GiftCards/Transactions.js +0 -33
  100. package/cjs/resources/Issuing/CreditUnderwritingRecords.js +0 -33
  101. package/cjs/resources/Issuing/DisputeSettlementDetails.js +0 -17
  102. package/cjs/resources/Issuing/FraudLiabilityDebits.js +0 -17
  103. package/cjs/resources/Margins.js +0 -22
  104. package/cjs/resources/Orders.js +0 -24
  105. package/cjs/resources/PaymentAttemptRecords.js +0 -17
  106. package/cjs/resources/PaymentRecords.js +0 -29
  107. package/cjs/resources/Tax/Associations.js +0 -9
  108. package/cjs/resources/Tax/Forms.js +0 -20
  109. package/cjs/resources/Terminal/ReaderCollectedData.js +0 -12
  110. package/esm/resources/AccountNotices.js +0 -18
  111. package/esm/resources/Capital/FinancingOffers.js +0 -18
  112. package/esm/resources/Capital/FinancingSummary.js +0 -9
  113. package/esm/resources/Capital/FinancingTransactions.js +0 -14
  114. package/esm/resources/FinancialConnections/Institutions.js +0 -14
  115. package/esm/resources/GiftCards/Cards.js +0 -20
  116. package/esm/resources/GiftCards/Transactions.js +0 -30
  117. package/esm/resources/Issuing/CreditUnderwritingRecords.js +0 -30
  118. package/esm/resources/Issuing/DisputeSettlementDetails.js +0 -14
  119. package/esm/resources/Issuing/FraudLiabilityDebits.js +0 -14
  120. package/esm/resources/Margins.js +0 -19
  121. package/esm/resources/Orders.js +0 -21
  122. package/esm/resources/PaymentAttemptRecords.js +0 -14
  123. package/esm/resources/PaymentRecords.js +0 -26
  124. package/esm/resources/Tax/Associations.js +0 -6
  125. package/esm/resources/Tax/Forms.js +0 -17
  126. package/esm/resources/Terminal/ReaderCollectedData.js +0 -9
  127. package/types/AccountNotices.d.ts +0 -113
  128. package/types/AccountNoticesResource.d.ts +0 -98
  129. package/types/Billing/MeterErrorReports.d.ts +0 -106
  130. package/types/Capital/FinancingOffers.d.ts +0 -188
  131. package/types/Capital/FinancingOffersResource.d.ts +0 -97
  132. package/types/Capital/FinancingSummary.d.ts +0 -106
  133. package/types/Capital/FinancingSummaryResource.d.ts +0 -27
  134. package/types/Capital/FinancingTransactions.d.ts +0 -135
  135. package/types/Capital/FinancingTransactionsResource.d.ts +0 -68
  136. package/types/FinancialConnections/AccountInferredBalances.d.ts +0 -38
  137. package/types/FinancialConnections/Institutions.d.ts +0 -93
  138. package/types/FinancialConnections/InstitutionsResource.d.ts +0 -47
  139. package/types/GiftCards/Cards.d.ts +0 -118
  140. package/types/GiftCards/CardsResource.d.ts +0 -159
  141. package/types/GiftCards/Transactions.d.ts +0 -129
  142. package/types/GiftCards/TransactionsResource.d.ts +0 -201
  143. package/types/InvoicePayments.d.ts +0 -113
  144. package/types/Issuing/CreditUnderwritingRecords.d.ts +0 -451
  145. package/types/Issuing/CreditUnderwritingRecordsResource.d.ts +0 -1032
  146. package/types/Issuing/DisputeSettlementDetails.d.ts +0 -73
  147. package/types/Issuing/DisputeSettlementDetailsResource.d.ts +0 -52
  148. package/types/Issuing/FraudLiabilityDebits.d.ts +0 -52
  149. package/types/Issuing/FraudLiabilityDebitsResource.d.ts +0 -52
  150. package/types/Issuing/Settlements.d.ts +0 -103
  151. package/types/Margins.d.ts +0 -56
  152. package/types/MarginsResource.d.ts +0 -114
  153. package/types/Orders.d.ts +0 -1179
  154. package/types/OrdersResource.d.ts +0 -2961
  155. package/types/PaymentAttemptRecords.d.ts +0 -242
  156. package/types/PaymentAttemptRecordsResource.d.ts +0 -47
  157. package/types/PaymentRecords.d.ts +0 -242
  158. package/types/PaymentRecordsResource.d.ts +0 -455
  159. package/types/QuoteLines.d.ts +0 -634
  160. package/types/QuotePreviewInvoices.d.ts +0 -1658
  161. package/types/QuotePreviewSubscriptionSchedules.d.ts +0 -824
  162. package/types/Tax/Associations.d.ts +0 -126
  163. package/types/Tax/AssociationsResource.d.ts +0 -29
  164. package/types/Tax/Forms.d.ts +0 -220
  165. package/types/Tax/FormsResource.d.ts +0 -107
  166. package/types/Terminal/ReaderCollectedData.d.ts +0 -51
  167. package/types/Terminal/ReaderCollectedDataResource.d.ts +0 -29
@@ -1,73 +0,0 @@
1
- // File generated from our OpenAPI spec
2
-
3
- declare module 'stripe' {
4
- namespace Stripe {
5
- namespace Issuing {
6
- /**
7
- * Represents a record from the card network of a money movement or change in state for an Issuing dispute. These records are included in the settlement reports that we receive from networks and expose to users as Settlement objects.
8
- */
9
- interface DisputeSettlementDetail {
10
- /**
11
- * Unique identifier for the object.
12
- */
13
- id: string;
14
-
15
- /**
16
- * String representing the object's type. Objects of the same type share the same value.
17
- */
18
- object: 'issuing.dispute_settlement_detail';
19
-
20
- /**
21
- * Disputed amount in the card's currency and in the smallest currency unit. Usually the amount of the transaction, but can differ (usually because of currency fluctuation).
22
- */
23
- amount: number;
24
-
25
- /**
26
- * The card used to make the original transaction.
27
- */
28
- card: string;
29
-
30
- /**
31
- * Time at which the object was created. Measured in seconds since the Unix epoch.
32
- */
33
- created: number;
34
-
35
- /**
36
- * The currency the original transaction was made in. 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).
37
- */
38
- currency: string;
39
-
40
- /**
41
- * The ID of the linked dispute.
42
- */
43
- dispute: string;
44
-
45
- /**
46
- * The type of event corresponding to this dispute settlement detail, representing the stage in the dispute network lifecycle.
47
- */
48
- event_type: DisputeSettlementDetail.EventType;
49
-
50
- /**
51
- * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
52
- */
53
- livemode: boolean;
54
-
55
- /**
56
- * The card network for this dispute settlement detail. One of ["visa", "mastercard", "maestro"]
57
- */
58
- network: DisputeSettlementDetail.Network;
59
-
60
- /**
61
- * The ID of the linked card network settlement.
62
- */
63
- settlement: string | null;
64
- }
65
-
66
- namespace DisputeSettlementDetail {
67
- type EventType = 'filing' | 'loss' | 'representment' | 'win';
68
-
69
- type Network = 'maestro' | 'mastercard' | 'visa';
70
- }
71
- }
72
- }
73
- }
@@ -1,52 +0,0 @@
1
- // File generated from our OpenAPI spec
2
-
3
- declare module 'stripe' {
4
- namespace Stripe {
5
- namespace Issuing {
6
- interface DisputeSettlementDetailRetrieveParams {
7
- /**
8
- * Specifies which fields in the response should be expanded.
9
- */
10
- expand?: Array<string>;
11
- }
12
-
13
- interface DisputeSettlementDetailListParams extends PaginationParams {
14
- /**
15
- * Specifies which fields in the response should be expanded.
16
- */
17
- expand?: Array<string>;
18
-
19
- /**
20
- * Select the Issuing dispute settlement details for the given settlement.
21
- */
22
- settlement?: string;
23
- }
24
-
25
- class DisputeSettlementDetailsResource {
26
- /**
27
- * Retrieves an Issuing DisputeSettlementDetail object.
28
- */
29
- retrieve(
30
- id: string,
31
- params?: DisputeSettlementDetailRetrieveParams,
32
- options?: RequestOptions
33
- ): Promise<Stripe.Response<Stripe.Issuing.DisputeSettlementDetail>>;
34
- retrieve(
35
- id: string,
36
- options?: RequestOptions
37
- ): Promise<Stripe.Response<Stripe.Issuing.DisputeSettlementDetail>>;
38
-
39
- /**
40
- * Returns a list of Issuing DisputeSettlementDetail objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
41
- */
42
- list(
43
- params?: DisputeSettlementDetailListParams,
44
- options?: RequestOptions
45
- ): ApiListPromise<Stripe.Issuing.DisputeSettlementDetail>;
46
- list(
47
- options?: RequestOptions
48
- ): ApiListPromise<Stripe.Issuing.DisputeSettlementDetail>;
49
- }
50
- }
51
- }
52
- }
@@ -1,52 +0,0 @@
1
- // File generated from our OpenAPI spec
2
-
3
- declare module 'stripe' {
4
- namespace Stripe {
5
- namespace Issuing {
6
- /**
7
- * A fraud liability debit occurs when Stripe debits a platform's account for fraud losses on Issuing transactions.
8
- */
9
- interface FraudLiabilityDebit {
10
- /**
11
- * Unique identifier for the object.
12
- */
13
- id: string;
14
-
15
- /**
16
- * String representing the object's type. Objects of the same type share the same value.
17
- */
18
- object: 'issuing.fraud_liability_debit';
19
-
20
- /**
21
- * Debited amount. This is equal to the disputed amount and is given in the card's currency and in the smallest currency unit.
22
- */
23
- amount: number;
24
-
25
- /**
26
- * ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this debit.
27
- */
28
- balance_transaction: string | Stripe.BalanceTransaction | null;
29
-
30
- /**
31
- * Time at which the object was created. Measured in seconds since the Unix epoch.
32
- */
33
- created: number;
34
-
35
- /**
36
- * The currency of the debit. 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).
37
- */
38
- currency: string;
39
-
40
- /**
41
- * The ID of the linked dispute.
42
- */
43
- dispute: string;
44
-
45
- /**
46
- * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
47
- */
48
- livemode: boolean;
49
- }
50
- }
51
- }
52
- }
@@ -1,52 +0,0 @@
1
- // File generated from our OpenAPI spec
2
-
3
- declare module 'stripe' {
4
- namespace Stripe {
5
- namespace Issuing {
6
- interface FraudLiabilityDebitRetrieveParams {
7
- /**
8
- * Specifies which fields in the response should be expanded.
9
- */
10
- expand?: Array<string>;
11
- }
12
-
13
- interface FraudLiabilityDebitListParams extends PaginationParams {
14
- /**
15
- * Only return Issuing Fraud Liability Debits that were created during the given date interval.
16
- */
17
- created?: Stripe.RangeQueryParam | number;
18
-
19
- /**
20
- * Specifies which fields in the response should be expanded.
21
- */
22
- expand?: Array<string>;
23
- }
24
-
25
- class FraudLiabilityDebitsResource {
26
- /**
27
- * Retrieves an Issuing FraudLiabilityDebit object.
28
- */
29
- retrieve(
30
- id: string,
31
- params?: FraudLiabilityDebitRetrieveParams,
32
- options?: RequestOptions
33
- ): Promise<Stripe.Response<Stripe.Issuing.FraudLiabilityDebit>>;
34
- retrieve(
35
- id: string,
36
- options?: RequestOptions
37
- ): Promise<Stripe.Response<Stripe.Issuing.FraudLiabilityDebit>>;
38
-
39
- /**
40
- * Returns a list of Issuing FraudLiabilityDebit objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
41
- */
42
- list(
43
- params?: FraudLiabilityDebitListParams,
44
- options?: RequestOptions
45
- ): ApiListPromise<Stripe.Issuing.FraudLiabilityDebit>;
46
- list(
47
- options?: RequestOptions
48
- ): ApiListPromise<Stripe.Issuing.FraudLiabilityDebit>;
49
- }
50
- }
51
- }
52
- }
@@ -1,103 +0,0 @@
1
- // File generated from our OpenAPI spec
2
-
3
- declare module 'stripe' {
4
- namespace Stripe {
5
- namespace Issuing {
6
- /**
7
- * When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object.
8
- */
9
- interface Settlement {
10
- /**
11
- * Unique identifier for the object.
12
- */
13
- id: string;
14
-
15
- /**
16
- * String representing the object's type. Objects of the same type share the same value.
17
- */
18
- object: 'issuing.settlement';
19
-
20
- /**
21
- * The Bank Identification Number reflecting this settlement record.
22
- */
23
- bin: string;
24
-
25
- /**
26
- * The date that the transactions are cleared and posted to user's accounts.
27
- */
28
- clearing_date: number;
29
-
30
- /**
31
- * Time at which the object was created. Measured in seconds since the Unix epoch.
32
- */
33
- created: number;
34
-
35
- /**
36
- * 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).
37
- */
38
- currency: string;
39
-
40
- /**
41
- * The total interchange received as reimbursement for the transactions.
42
- */
43
- interchange_fees: number;
44
-
45
- /**
46
- * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
47
- */
48
- livemode: boolean;
49
-
50
- /**
51
- * 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.
52
- */
53
- metadata: Stripe.Metadata;
54
-
55
- /**
56
- * The total net amount required to settle with the network.
57
- */
58
- net_total: number;
59
-
60
- /**
61
- * The card network for this settlement report. One of ["visa", "maestro"]
62
- */
63
- network: Settlement.Network;
64
-
65
- /**
66
- * The total amount of fees owed to the network.
67
- */
68
- network_fees: number;
69
-
70
- /**
71
- * The Settlement Identification Number assigned by the network.
72
- */
73
- network_settlement_identifier: string;
74
-
75
- /**
76
- * One of `international` or `uk_national_net`.
77
- */
78
- settlement_service: string;
79
-
80
- /**
81
- * The current processing status of this settlement.
82
- */
83
- status: Settlement.Status;
84
-
85
- /**
86
- * The total number of transactions reflected in this settlement.
87
- */
88
- transaction_count: number;
89
-
90
- /**
91
- * The total transaction amount reflected in this settlement.
92
- */
93
- transaction_volume: number;
94
- }
95
-
96
- namespace Settlement {
97
- type Network = 'maestro' | 'visa';
98
-
99
- type Status = 'complete' | 'pending';
100
- }
101
- }
102
- }
103
- }
@@ -1,56 +0,0 @@
1
- // File generated from our OpenAPI spec
2
-
3
- declare module 'stripe' {
4
- namespace Stripe {
5
- /**
6
- * A (partner) margin represents a specific discount distributed in partner reseller programs to business partners who
7
- * resell products and services and earn a discount (margin) for doing so.
8
- */
9
- interface Margin {
10
- /**
11
- * Unique identifier for the object.
12
- */
13
- id: string;
14
-
15
- /**
16
- * String representing the object's type. Objects of the same type share the same value.
17
- */
18
- object: 'margin';
19
-
20
- /**
21
- * Whether the margin can be applied to invoices, invoice items, or invoice line items. Defaults to `true`.
22
- */
23
- active: boolean;
24
-
25
- /**
26
- * Time at which the object was created. Measured in seconds since the Unix epoch.
27
- */
28
- created: number;
29
-
30
- /**
31
- * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
32
- */
33
- livemode: boolean;
34
-
35
- /**
36
- * 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.
37
- */
38
- metadata: Stripe.Metadata | null;
39
-
40
- /**
41
- * Name of the margin that's displayed on, for example, invoices.
42
- */
43
- name: string | null;
44
-
45
- /**
46
- * Percent that will be taken off the subtotal before tax (after all other discounts and promotions) of any invoice to which the margin is applied.
47
- */
48
- percent_off: number;
49
-
50
- /**
51
- * Time at which the object was last updated. Measured in seconds since the Unix epoch.
52
- */
53
- updated: number;
54
- }
55
- }
56
- }
@@ -1,114 +0,0 @@
1
- // File generated from our OpenAPI spec
2
-
3
- declare module 'stripe' {
4
- namespace Stripe {
5
- interface MarginCreateParams {
6
- /**
7
- * Percent that will be taken off the subtotal before tax (after all other discounts and promotions) of any invoice to which the margin is applied.
8
- */
9
- percent_off: number;
10
-
11
- /**
12
- * Whether the margin can be applied to invoices, invoice items, or invoice line items or not. Defaults to `true`.
13
- */
14
- active?: boolean;
15
-
16
- /**
17
- * Specifies which fields in the response should be expanded.
18
- */
19
- expand?: Array<string>;
20
-
21
- /**
22
- * 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`.
23
- */
24
- metadata?: Stripe.MetadataParam;
25
-
26
- /**
27
- * Name of the margin, which is displayed to customers, such as on invoices.
28
- */
29
- name?: string;
30
- }
31
-
32
- interface MarginRetrieveParams {
33
- /**
34
- * Specifies which fields in the response should be expanded.
35
- */
36
- expand?: Array<string>;
37
- }
38
-
39
- interface MarginUpdateParams {
40
- /**
41
- * Whether the margin can be applied to invoices, invoice items, or invoice line items or not.
42
- */
43
- active?: boolean;
44
-
45
- /**
46
- * Specifies which fields in the response should be expanded.
47
- */
48
- expand?: Array<string>;
49
-
50
- /**
51
- * 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`.
52
- */
53
- metadata?: Stripe.MetadataParam;
54
-
55
- /**
56
- * Name of the margin, which is displayed to customers, such as on invoices.
57
- */
58
- name?: string;
59
- }
60
-
61
- interface MarginListParams extends PaginationParams {
62
- /**
63
- * Only return margins that are active or inactive. For example, pass `true` to only list active margins.
64
- */
65
- active?: boolean;
66
-
67
- /**
68
- * Specifies which fields in the response should be expanded.
69
- */
70
- expand?: Array<string>;
71
- }
72
-
73
- class MarginsResource {
74
- /**
75
- * Create a margin object to be used with invoices, invoice items, and invoice line items for a customer to represent a partner discount. A margin has a percent_off which is the percent that will be taken off the subtotal after all items and other discounts and promotions) of any invoices for a customer. Calculation of prorations do not include any partner margins applied on the original invoice item.
76
- */
77
- create(
78
- params: MarginCreateParams,
79
- options?: RequestOptions
80
- ): Promise<Stripe.Response<Stripe.Margin>>;
81
-
82
- /**
83
- * Retrieve a margin object with the given ID.
84
- */
85
- retrieve(
86
- id: string,
87
- params?: MarginRetrieveParams,
88
- options?: RequestOptions
89
- ): Promise<Stripe.Response<Stripe.Margin>>;
90
- retrieve(
91
- id: string,
92
- options?: RequestOptions
93
- ): Promise<Stripe.Response<Stripe.Margin>>;
94
-
95
- /**
96
- * Update the specified margin object. Certain fields of the margin object are not editable.
97
- */
98
- update(
99
- id: string,
100
- params?: MarginUpdateParams,
101
- options?: RequestOptions
102
- ): Promise<Stripe.Response<Stripe.Margin>>;
103
-
104
- /**
105
- * Retrieve a list of your margins.
106
- */
107
- list(
108
- params?: MarginListParams,
109
- options?: RequestOptions
110
- ): ApiListPromise<Stripe.Margin>;
111
- list(options?: RequestOptions): ApiListPromise<Stripe.Margin>;
112
- }
113
- }
114
- }