stripe 17.8.0-beta.1 → 18.0.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 (208) hide show
  1. package/CHANGELOG.md +246 -1075
  2. package/OPENAPI_VERSION +1 -1
  3. package/README.md +0 -1
  4. package/VERSION +1 -1
  5. package/cjs/apiVersion.js +1 -1
  6. package/cjs/resources/FinancialConnections/Accounts.js +0 -5
  7. package/cjs/resources/{PaymentAttemptRecords.js → InvoicePayments.js} +4 -4
  8. package/cjs/resources/Invoices.js +0 -26
  9. package/cjs/resources/PaymentIntents.js +0 -8
  10. package/cjs/resources/Quotes.js +0 -32
  11. package/cjs/resources/SubscriptionItems.js +0 -9
  12. package/cjs/resources/SubscriptionSchedules.js +0 -4
  13. package/cjs/resources/Terminal/Readers.js +0 -12
  14. package/cjs/resources/TestHelpers/Terminal/Readers.js +0 -8
  15. package/cjs/resources.js +12 -48
  16. package/cjs/stripe.core.js +3 -14
  17. package/esm/apiVersion.js +1 -1
  18. package/esm/resources/FinancialConnections/Accounts.js +0 -5
  19. package/esm/resources/{PaymentAttemptRecords.js → InvoicePayments.js} +3 -3
  20. package/esm/resources/Invoices.js +0 -26
  21. package/esm/resources/PaymentIntents.js +0 -8
  22. package/esm/resources/Quotes.js +0 -32
  23. package/esm/resources/SubscriptionItems.js +0 -9
  24. package/esm/resources/SubscriptionSchedules.js +0 -4
  25. package/esm/resources/Terminal/Readers.js +0 -12
  26. package/esm/resources/TestHelpers/Terminal/Readers.js +0 -8
  27. package/esm/resources.js +1 -33
  28. package/esm/stripe.core.js +3 -14
  29. package/package.json +1 -1
  30. package/types/AccountLinksResource.d.ts +1 -5
  31. package/types/AccountSessions.d.ts +0 -45
  32. package/types/AccountSessionsResource.d.ts +0 -243
  33. package/types/Accounts.d.ts +48 -211
  34. package/types/AccountsResource.d.ts +86 -503
  35. package/types/ApplicationFees.d.ts +1 -1
  36. package/types/BalanceTransactions.d.ts +3 -1
  37. package/types/BalanceTransactionsResource.d.ts +1 -1
  38. package/types/BankAccounts.d.ts +9 -1
  39. package/types/Billing/CreditBalanceSummaryResource.d.ts +2 -2
  40. package/types/Billing/CreditGrants.d.ts +2 -2
  41. package/types/Billing/CreditGrantsResource.d.ts +2 -2
  42. package/types/Billing/Meters.d.ts +1 -1
  43. package/types/Billing/MetersResource.d.ts +2 -2
  44. package/types/Capabilities.d.ts +8 -0
  45. package/types/Cards.d.ts +1 -9
  46. package/types/Charges.d.ts +56 -153
  47. package/types/ChargesResource.d.ts +1 -1295
  48. package/types/Checkout/Sessions.d.ts +62 -336
  49. package/types/Checkout/SessionsResource.d.ts +69 -287
  50. package/types/ConfirmationTokens.d.ts +50 -99
  51. package/types/Coupons.d.ts +1 -1
  52. package/types/CouponsResource.d.ts +1 -1
  53. package/types/CreditNoteLineItems.d.ts +24 -22
  54. package/types/CreditNotes.d.ts +26 -23
  55. package/types/CreditNotesResource.d.ts +0 -15
  56. package/types/CustomerBalanceTransactions.d.ts +8 -1
  57. package/types/Customers.d.ts +3 -3
  58. package/types/CustomersResource.d.ts +3 -21
  59. package/types/EventTypes.d.ts +85 -545
  60. package/types/Events.d.ts +8 -93
  61. package/types/FinancialConnections/Accounts.d.ts +1 -29
  62. package/types/FinancialConnections/AccountsResource.d.ts +3 -35
  63. package/types/FinancialConnections/Sessions.d.ts +1 -49
  64. package/types/FinancialConnections/SessionsResource.d.ts +1 -38
  65. package/types/InvoiceItems.d.ts +60 -31
  66. package/types/InvoiceItemsResource.d.ts +26 -120
  67. package/types/InvoiceLineItems.d.ts +154 -91
  68. package/types/InvoicePayments.d.ts +2 -16
  69. package/types/InvoicePaymentsResource.d.ts +74 -0
  70. package/types/Invoices.d.ts +93 -214
  71. package/types/InvoicesResource.d.ts +307 -6599
  72. package/types/Issuing/Authorizations.d.ts +1 -1
  73. package/types/Issuing/AuthorizationsResource.d.ts +1 -1
  74. package/types/Issuing/CardholdersResource.d.ts +1 -2
  75. package/types/Issuing/Transactions.d.ts +0 -2
  76. package/types/Issuing/TransactionsResource.d.ts +0 -5
  77. package/types/LineItems.d.ts +0 -32
  78. package/types/Mandates.d.ts +8 -77
  79. package/types/PaymentIntents.d.ts +56 -648
  80. package/types/PaymentIntentsResource.d.ts +4120 -8122
  81. package/types/PaymentLinks.d.ts +49 -6
  82. package/types/PaymentLinksResource.d.ts +77 -12
  83. package/types/PaymentMethodConfigurations.d.ts +63 -135
  84. package/types/PaymentMethodConfigurationsResource.d.ts +116 -216
  85. package/types/PaymentMethodDomainsResource.d.ts +6 -6
  86. package/types/PaymentMethods.d.ts +50 -99
  87. package/types/PaymentMethodsResource.d.ts +53 -148
  88. package/types/Persons.d.ts +17 -9
  89. package/types/Plans.d.ts +0 -7
  90. package/types/PlansResource.d.ts +0 -7
  91. package/types/Prices.d.ts +0 -33
  92. package/types/PricesResource.d.ts +2 -35
  93. package/types/Products.d.ts +0 -39
  94. package/types/ProductsResource.d.ts +0 -36
  95. package/types/Quotes.d.ts +1 -591
  96. package/types/QuotesResource.d.ts +200 -2532
  97. package/types/Refunds.d.ts +18 -14
  98. package/types/Reviews.d.ts +3 -2
  99. package/types/SetupAttempts.d.ts +15 -38
  100. package/types/SetupIntents.d.ts +3 -111
  101. package/types/SetupIntentsResource.d.ts +155 -642
  102. package/types/Sources.d.ts +0 -29
  103. package/types/SubscriptionItems.d.ts +9 -34
  104. package/types/SubscriptionItemsResource.d.ts +2 -203
  105. package/types/SubscriptionSchedules.d.ts +0 -251
  106. package/types/SubscriptionSchedulesResource.d.ts +9 -1333
  107. package/types/Subscriptions.d.ts +4 -124
  108. package/types/SubscriptionsResource.d.ts +10 -455
  109. package/types/Tax/RegistrationsResource.d.ts +1 -1
  110. package/types/Terminal/Configurations.d.ts +86 -3
  111. package/types/Terminal/ConfigurationsResource.d.ts +192 -2
  112. package/types/Terminal/Readers.d.ts +0 -290
  113. package/types/Terminal/ReadersResource.d.ts +0 -215
  114. package/types/TestHelpers/ConfirmationTokensResource.d.ts +50 -103
  115. package/types/TestHelpers/Terminal/ReadersResource.d.ts +0 -53
  116. package/types/TestHelpers/Treasury/ReceivedCreditsResource.d.ts +0 -26
  117. package/types/TestHelpers/Treasury/ReceivedDebitsResource.d.ts +0 -26
  118. package/types/TokensResource.d.ts +6 -1
  119. package/types/Treasury/FinancialAccountFeatures.d.ts +0 -7
  120. package/types/Treasury/FinancialAccounts.d.ts +0 -5
  121. package/types/Treasury/FinancialAccountsResource.d.ts +1 -38
  122. package/types/Treasury/OutboundTransfers.d.ts +0 -26
  123. package/types/Treasury/OutboundTransfersResource.d.ts +0 -26
  124. package/types/Treasury/ReceivedCredits.d.ts +0 -26
  125. package/types/Treasury/ReceivedDebits.d.ts +0 -31
  126. package/types/V2/Core/EventDestinationsResource.d.ts +0 -5
  127. package/types/V2/Core/EventsResource.d.ts +0 -5
  128. package/types/V2/EventDestinations.d.ts +1 -1
  129. package/types/V2/Events.d.ts +1 -1
  130. package/types/WebhookEndpointsResource.d.ts +19 -71
  131. package/types/index.d.ts +2 -64
  132. package/types/lib.d.ts +1 -1
  133. package/types/test/typescriptTest.ts +3 -6
  134. package/cjs/resources/AccountNotices.js +0 -21
  135. package/cjs/resources/Capital/FinancingOffers.js +0 -21
  136. package/cjs/resources/Capital/FinancingSummary.js +0 -12
  137. package/cjs/resources/Capital/FinancingTransactions.js +0 -17
  138. package/cjs/resources/FinancialConnections/Institutions.js +0 -17
  139. package/cjs/resources/GiftCards/Cards.js +0 -23
  140. package/cjs/resources/GiftCards/Transactions.js +0 -33
  141. package/cjs/resources/Issuing/CreditUnderwritingRecords.js +0 -33
  142. package/cjs/resources/Issuing/DisputeSettlementDetails.js +0 -17
  143. package/cjs/resources/Issuing/FraudLiabilityDebits.js +0 -17
  144. package/cjs/resources/Margins.js +0 -22
  145. package/cjs/resources/Orders.js +0 -24
  146. package/cjs/resources/PaymentRecords.js +0 -29
  147. package/cjs/resources/Tax/Associations.js +0 -9
  148. package/cjs/resources/Tax/Forms.js +0 -20
  149. package/cjs/resources/Terminal/ReaderCollectedData.js +0 -12
  150. package/esm/resources/AccountNotices.js +0 -18
  151. package/esm/resources/Capital/FinancingOffers.js +0 -18
  152. package/esm/resources/Capital/FinancingSummary.js +0 -9
  153. package/esm/resources/Capital/FinancingTransactions.js +0 -14
  154. package/esm/resources/FinancialConnections/Institutions.js +0 -14
  155. package/esm/resources/GiftCards/Cards.js +0 -20
  156. package/esm/resources/GiftCards/Transactions.js +0 -30
  157. package/esm/resources/Issuing/CreditUnderwritingRecords.js +0 -30
  158. package/esm/resources/Issuing/DisputeSettlementDetails.js +0 -14
  159. package/esm/resources/Issuing/FraudLiabilityDebits.js +0 -14
  160. package/esm/resources/Margins.js +0 -19
  161. package/esm/resources/Orders.js +0 -21
  162. package/esm/resources/PaymentRecords.js +0 -26
  163. package/esm/resources/Tax/Associations.js +0 -6
  164. package/esm/resources/Tax/Forms.js +0 -17
  165. package/esm/resources/Terminal/ReaderCollectedData.js +0 -9
  166. package/types/AccountNotices.d.ts +0 -113
  167. package/types/AccountNoticesResource.d.ts +0 -98
  168. package/types/Billing/MeterErrorReports.d.ts +0 -106
  169. package/types/Capital/FinancingOffers.d.ts +0 -188
  170. package/types/Capital/FinancingOffersResource.d.ts +0 -97
  171. package/types/Capital/FinancingSummary.d.ts +0 -106
  172. package/types/Capital/FinancingSummaryResource.d.ts +0 -27
  173. package/types/Capital/FinancingTransactions.d.ts +0 -135
  174. package/types/Capital/FinancingTransactionsResource.d.ts +0 -68
  175. package/types/Deprecations.d.ts +0 -215
  176. package/types/FinancialConnections/AccountInferredBalances.d.ts +0 -38
  177. package/types/FinancialConnections/Institutions.d.ts +0 -93
  178. package/types/FinancialConnections/InstitutionsResource.d.ts +0 -47
  179. package/types/GiftCards/Cards.d.ts +0 -118
  180. package/types/GiftCards/CardsResource.d.ts +0 -159
  181. package/types/GiftCards/Transactions.d.ts +0 -129
  182. package/types/GiftCards/TransactionsResource.d.ts +0 -201
  183. package/types/Issuing/CreditUnderwritingRecords.d.ts +0 -451
  184. package/types/Issuing/CreditUnderwritingRecordsResource.d.ts +0 -1032
  185. package/types/Issuing/DisputeSettlementDetails.d.ts +0 -73
  186. package/types/Issuing/DisputeSettlementDetailsResource.d.ts +0 -52
  187. package/types/Issuing/FraudLiabilityDebits.d.ts +0 -52
  188. package/types/Issuing/FraudLiabilityDebitsResource.d.ts +0 -52
  189. package/types/Issuing/Settlements.d.ts +0 -103
  190. package/types/Margins.d.ts +0 -56
  191. package/types/MarginsResource.d.ts +0 -114
  192. package/types/Orders.d.ts +0 -1189
  193. package/types/OrdersResource.d.ts +0 -2981
  194. package/types/PaymentAttemptRecords.d.ts +0 -242
  195. package/types/PaymentAttemptRecordsResource.d.ts +0 -47
  196. package/types/PaymentRecords.d.ts +0 -242
  197. package/types/PaymentRecordsResource.d.ts +0 -455
  198. package/types/QuoteLines.d.ts +0 -634
  199. package/types/QuotePreviewInvoices.d.ts +0 -1658
  200. package/types/QuotePreviewSubscriptionSchedules.d.ts +0 -824
  201. package/types/Tax/Associations.d.ts +0 -126
  202. package/types/Tax/AssociationsResource.d.ts +0 -29
  203. package/types/Tax/Forms.d.ts +0 -220
  204. package/types/Tax/FormsResource.d.ts +0 -107
  205. package/types/Terminal/ReaderCollectedData.d.ts +0 -51
  206. package/types/Terminal/ReaderCollectedDataResource.d.ts +0 -29
  207. package/types/UsageRecordSummaries.d.ts +0 -56
  208. package/types/UsageRecords.d.ts +0 -45
@@ -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
- }