@getivy/node-sdk 0.1.0-alpha.2

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 (249) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/LICENSE +201 -0
  3. package/README.md +303 -0
  4. package/_shims/MultipartBody.d.ts +9 -0
  5. package/_shims/MultipartBody.d.ts.map +1 -0
  6. package/_shims/MultipartBody.js +16 -0
  7. package/_shims/MultipartBody.js.map +1 -0
  8. package/_shims/MultipartBody.mjs +12 -0
  9. package/_shims/MultipartBody.mjs.map +1 -0
  10. package/_shims/README.md +46 -0
  11. package/_shims/auto/runtime-bun.d.ts +5 -0
  12. package/_shims/auto/runtime-bun.d.ts.map +1 -0
  13. package/_shims/auto/runtime-bun.js +21 -0
  14. package/_shims/auto/runtime-bun.js.map +1 -0
  15. package/_shims/auto/runtime-bun.mjs +2 -0
  16. package/_shims/auto/runtime-bun.mjs.map +1 -0
  17. package/_shims/auto/runtime-node.d.ts +5 -0
  18. package/_shims/auto/runtime-node.d.ts.map +1 -0
  19. package/_shims/auto/runtime-node.js +21 -0
  20. package/_shims/auto/runtime-node.js.map +1 -0
  21. package/_shims/auto/runtime-node.mjs +2 -0
  22. package/_shims/auto/runtime-node.mjs.map +1 -0
  23. package/_shims/auto/runtime.d.ts +5 -0
  24. package/_shims/auto/runtime.d.ts.map +1 -0
  25. package/_shims/auto/runtime.js +21 -0
  26. package/_shims/auto/runtime.js.map +1 -0
  27. package/_shims/auto/runtime.mjs +2 -0
  28. package/_shims/auto/runtime.mjs.map +1 -0
  29. package/_shims/auto/types-node.d.ts +5 -0
  30. package/_shims/auto/types-node.d.ts.map +1 -0
  31. package/_shims/auto/types-node.js +21 -0
  32. package/_shims/auto/types-node.js.map +1 -0
  33. package/_shims/auto/types-node.mjs +2 -0
  34. package/_shims/auto/types-node.mjs.map +1 -0
  35. package/_shims/auto/types.d.ts +101 -0
  36. package/_shims/auto/types.js +3 -0
  37. package/_shims/auto/types.mjs +3 -0
  38. package/_shims/bun-runtime.d.ts +6 -0
  39. package/_shims/bun-runtime.d.ts.map +1 -0
  40. package/_shims/bun-runtime.js +14 -0
  41. package/_shims/bun-runtime.js.map +1 -0
  42. package/_shims/bun-runtime.mjs +10 -0
  43. package/_shims/bun-runtime.mjs.map +1 -0
  44. package/_shims/index.d.ts +81 -0
  45. package/_shims/index.js +13 -0
  46. package/_shims/index.mjs +7 -0
  47. package/_shims/manual-types.d.ts +12 -0
  48. package/_shims/manual-types.js +3 -0
  49. package/_shims/manual-types.mjs +3 -0
  50. package/_shims/node-runtime.d.ts +3 -0
  51. package/_shims/node-runtime.d.ts.map +1 -0
  52. package/_shims/node-runtime.js +89 -0
  53. package/_shims/node-runtime.js.map +1 -0
  54. package/_shims/node-runtime.mjs +56 -0
  55. package/_shims/node-runtime.mjs.map +1 -0
  56. package/_shims/node-types.d.ts +42 -0
  57. package/_shims/node-types.js +3 -0
  58. package/_shims/node-types.mjs +3 -0
  59. package/_shims/registry.d.ts +37 -0
  60. package/_shims/registry.d.ts.map +1 -0
  61. package/_shims/registry.js +41 -0
  62. package/_shims/registry.js.map +1 -0
  63. package/_shims/registry.mjs +37 -0
  64. package/_shims/registry.mjs.map +1 -0
  65. package/_shims/web-runtime.d.ts +5 -0
  66. package/_shims/web-runtime.d.ts.map +1 -0
  67. package/_shims/web-runtime.js +78 -0
  68. package/_shims/web-runtime.js.map +1 -0
  69. package/_shims/web-runtime.mjs +71 -0
  70. package/_shims/web-runtime.mjs.map +1 -0
  71. package/_shims/web-types.d.ts +83 -0
  72. package/_shims/web-types.js +3 -0
  73. package/_shims/web-types.mjs +3 -0
  74. package/core.d.ts +241 -0
  75. package/core.d.ts.map +1 -0
  76. package/core.js +908 -0
  77. package/core.js.map +1 -0
  78. package/core.mjs +876 -0
  79. package/core.mjs.map +1 -0
  80. package/error.d.ts +47 -0
  81. package/error.d.ts.map +1 -0
  82. package/error.js +113 -0
  83. package/error.js.map +1 -0
  84. package/error.mjs +97 -0
  85. package/error.mjs.map +1 -0
  86. package/index.d.mts +157 -0
  87. package/index.d.ts +157 -0
  88. package/index.d.ts.map +1 -0
  89. package/index.js +164 -0
  90. package/index.js.map +1 -0
  91. package/index.mjs +121 -0
  92. package/index.mjs.map +1 -0
  93. package/package.json +103 -0
  94. package/resource.d.ts +6 -0
  95. package/resource.d.ts.map +1 -0
  96. package/resource.js +11 -0
  97. package/resource.js.map +1 -0
  98. package/resource.mjs +7 -0
  99. package/resource.mjs.map +1 -0
  100. package/resources/balance.d.ts +34 -0
  101. package/resources/balance.d.ts.map +1 -0
  102. package/resources/balance.js +16 -0
  103. package/resources/balance.js.map +1 -0
  104. package/resources/balance.mjs +12 -0
  105. package/resources/balance.mjs.map +1 -0
  106. package/resources/banks.d.ts +223 -0
  107. package/resources/banks.d.ts.map +1 -0
  108. package/resources/banks.js +30 -0
  109. package/resources/banks.js.map +1 -0
  110. package/resources/banks.mjs +26 -0
  111. package/resources/banks.mjs.map +1 -0
  112. package/resources/capabilities.d.ts +28 -0
  113. package/resources/capabilities.d.ts.map +1 -0
  114. package/resources/capabilities.js +16 -0
  115. package/resources/capabilities.js.map +1 -0
  116. package/resources/capabilities.mjs +12 -0
  117. package/resources/capabilities.mjs.map +1 -0
  118. package/resources/charges.d.ts +86 -0
  119. package/resources/charges.d.ts.map +1 -0
  120. package/resources/charges.js +15 -0
  121. package/resources/charges.js.map +1 -0
  122. package/resources/charges.mjs +11 -0
  123. package/resources/charges.mjs.map +1 -0
  124. package/resources/checkoutsession.d.ts +2370 -0
  125. package/resources/checkoutsession.d.ts.map +1 -0
  126. package/resources/checkoutsession.js +30 -0
  127. package/resources/checkoutsession.js.map +1 -0
  128. package/resources/checkoutsession.mjs +26 -0
  129. package/resources/checkoutsession.mjs.map +1 -0
  130. package/resources/customers.d.ts +37 -0
  131. package/resources/customers.d.ts.map +1 -0
  132. package/resources/customers.js +21 -0
  133. package/resources/customers.js.map +1 -0
  134. package/resources/customers.mjs +17 -0
  135. package/resources/customers.mjs.map +1 -0
  136. package/resources/index.d.ts +13 -0
  137. package/resources/index.d.ts.map +1 -0
  138. package/resources/index.js +29 -0
  139. package/resources/index.js.map +1 -0
  140. package/resources/index.mjs +14 -0
  141. package/resources/index.mjs.map +1 -0
  142. package/resources/mandates.d.ts +91 -0
  143. package/resources/mandates.d.ts.map +1 -0
  144. package/resources/mandates.js +27 -0
  145. package/resources/mandates.js.map +1 -0
  146. package/resources/mandates.mjs +23 -0
  147. package/resources/mandates.mjs.map +1 -0
  148. package/resources/orders.d.ts +1255 -0
  149. package/resources/orders.d.ts.map +1 -0
  150. package/resources/orders.js +23 -0
  151. package/resources/orders.js.map +1 -0
  152. package/resources/orders.mjs +19 -0
  153. package/resources/orders.mjs.map +1 -0
  154. package/resources/payouts.d.ts +224 -0
  155. package/resources/payouts.d.ts.map +1 -0
  156. package/resources/payouts.js +28 -0
  157. package/resources/payouts.js.map +1 -0
  158. package/resources/payouts.mjs +24 -0
  159. package/resources/payouts.mjs.map +1 -0
  160. package/resources/refunds.d.ts +138 -0
  161. package/resources/refunds.d.ts.map +1 -0
  162. package/resources/refunds.js +28 -0
  163. package/resources/refunds.js.map +1 -0
  164. package/resources/refunds.mjs +24 -0
  165. package/resources/refunds.mjs.map +1 -0
  166. package/resources/reports.d.ts +120 -0
  167. package/resources/reports.d.ts.map +1 -0
  168. package/resources/reports.js +31 -0
  169. package/resources/reports.js.map +1 -0
  170. package/resources/reports.mjs +27 -0
  171. package/resources/reports.mjs.map +1 -0
  172. package/resources/subaccounts.d.ts +49 -0
  173. package/resources/subaccounts.d.ts.map +1 -0
  174. package/resources/subaccounts.js +22 -0
  175. package/resources/subaccounts.js.map +1 -0
  176. package/resources/subaccounts.mjs +18 -0
  177. package/resources/subaccounts.mjs.map +1 -0
  178. package/shims/node.d.ts +30 -0
  179. package/shims/node.d.ts.map +1 -0
  180. package/shims/node.js +31 -0
  181. package/shims/node.js.map +1 -0
  182. package/shims/node.mjs +5 -0
  183. package/shims/node.mjs.map +1 -0
  184. package/shims/web.d.ts +26 -0
  185. package/shims/web.d.ts.map +1 -0
  186. package/shims/web.js +31 -0
  187. package/shims/web.js.map +1 -0
  188. package/shims/web.mjs +5 -0
  189. package/shims/web.mjs.map +1 -0
  190. package/src/_shims/MultipartBody.ts +9 -0
  191. package/src/_shims/README.md +46 -0
  192. package/src/_shims/auto/runtime-bun.ts +4 -0
  193. package/src/_shims/auto/runtime-node.ts +4 -0
  194. package/src/_shims/auto/runtime.ts +4 -0
  195. package/src/_shims/auto/types-node.ts +4 -0
  196. package/src/_shims/auto/types.d.ts +101 -0
  197. package/src/_shims/auto/types.js +3 -0
  198. package/src/_shims/auto/types.mjs +3 -0
  199. package/src/_shims/bun-runtime.ts +14 -0
  200. package/src/_shims/index.d.ts +81 -0
  201. package/src/_shims/index.js +13 -0
  202. package/src/_shims/index.mjs +7 -0
  203. package/src/_shims/manual-types.d.ts +12 -0
  204. package/src/_shims/manual-types.js +3 -0
  205. package/src/_shims/manual-types.mjs +3 -0
  206. package/src/_shims/node-runtime.ts +81 -0
  207. package/src/_shims/node-types.d.ts +42 -0
  208. package/src/_shims/node-types.js +3 -0
  209. package/src/_shims/node-types.mjs +3 -0
  210. package/src/_shims/registry.ts +67 -0
  211. package/src/_shims/web-runtime.ts +103 -0
  212. package/src/_shims/web-types.d.ts +83 -0
  213. package/src/_shims/web-types.js +3 -0
  214. package/src/_shims/web-types.mjs +3 -0
  215. package/src/core.ts +1200 -0
  216. package/src/error.ts +130 -0
  217. package/src/index.ts +393 -0
  218. package/src/lib/.keep +4 -0
  219. package/src/resource.ts +11 -0
  220. package/src/resources/balance.ts +49 -0
  221. package/src/resources/banks.ts +1536 -0
  222. package/src/resources/capabilities.ts +291 -0
  223. package/src/resources/charges.ts +108 -0
  224. package/src/resources/checkoutsession.ts +9254 -0
  225. package/src/resources/customers.ts +60 -0
  226. package/src/resources/index.ts +75 -0
  227. package/src/resources/mandates.ts +135 -0
  228. package/src/resources/orders.ts +3195 -0
  229. package/src/resources/payouts.ts +297 -0
  230. package/src/resources/refunds.ts +184 -0
  231. package/src/resources/reports.ts +172 -0
  232. package/src/resources/subaccounts.ts +73 -0
  233. package/src/shims/node.ts +50 -0
  234. package/src/shims/web.ts +50 -0
  235. package/src/tsconfig.json +11 -0
  236. package/src/uploads.ts +255 -0
  237. package/src/version.ts +1 -0
  238. package/uploads.d.ts +75 -0
  239. package/uploads.d.ts.map +1 -0
  240. package/uploads.js +171 -0
  241. package/uploads.js.map +1 -0
  242. package/uploads.mjs +158 -0
  243. package/uploads.mjs.map +1 -0
  244. package/version.d.ts +2 -0
  245. package/version.d.ts.map +1 -0
  246. package/version.js +5 -0
  247. package/version.js.map +1 -0
  248. package/version.mjs +2 -0
  249. package/version.mjs.map +1 -0
@@ -0,0 +1,1255 @@
1
+ import { APIResource } from "../resource.js";
2
+ import * as Core from "../core.js";
3
+ export declare class Orders extends APIResource {
4
+ /**
5
+ * Retrieve details of an order. You can retrieve the order by passing either the
6
+ * internal Ivy order id or the `referenceId` you specified when creating a
7
+ * Checkout Session to the `id` field.
8
+ */
9
+ retrieve(body: OrderRetrieveParams, options?: Core.RequestOptions): Core.APIPromise<OrderRetrieveResponse>;
10
+ /**
11
+ * Update certain fields of the specified order.
12
+ */
13
+ update(body: OrderUpdateParams, options?: Core.RequestOptions): Core.APIPromise<OrderUpdateResponse>;
14
+ }
15
+ export interface OrderRetrieveResponse {
16
+ /**
17
+ * The Ivy unique identifier for the order.
18
+ */
19
+ id: string;
20
+ /**
21
+ * @deprecated The unique identifier for the merchantApp which initiated the order
22
+ * / payment attempt.
23
+ */
24
+ appId: string;
25
+ /**
26
+ * The Ivy fee for the payment.
27
+ */
28
+ applicationFeeAmount: number;
29
+ createdAt: string;
30
+ instantPaymentScheme: boolean;
31
+ /**
32
+ * @deprecated Deprecated in favor of `appId`.
33
+ */
34
+ merchantAppId: string;
35
+ /**
36
+ * The unique identifier for the merchant which initiated the order / payment
37
+ * attempt.
38
+ */
39
+ merchantId: string;
40
+ /**
41
+ * The price to be paid by the user. All amounts are in decimals, i.e. 10.23
42
+ * represents EUR 10.23. Any amount of decimal places can be provided on
43
+ * initialization, but the actual transfer amount is rounded to 2 decimal places,
44
+ * as this is the format accepted by most banks.
45
+ */
46
+ price: OrderRetrieveResponse.Price;
47
+ /**
48
+ * An internal reference id which will be stored with the checkout & corresponding
49
+ * order. Needs to be unique per shop per order and can be up to 200 characters.
50
+ */
51
+ referenceId: string;
52
+ /**
53
+ * The name of the merchant which initiated the order.
54
+ */
55
+ shopName: string;
56
+ /**
57
+ * The order status. This status symbolises the state of the user's payment
58
+ * attempt. See [the guide](https://docs.getivy.de/docs/payment-status) for more
59
+ * information.
60
+ */
61
+ status: 'failed' | 'canceled' | 'processing' | 'in_handshake' | 'waiting_for_payment' | 'paid' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'in_dispute' | 'disputed' | 'refused';
62
+ updatedAt: string;
63
+ /**
64
+ * The bank statement reference of the payment for the order. This is the reference
65
+ * that will be visible on the bank statement.
66
+ */
67
+ bankStatementReference?: string;
68
+ /**
69
+ * The billing address of the user. Required when handshake=true.
70
+ */
71
+ billingAddress?: OrderRetrieveResponse.BillingAddress;
72
+ /**
73
+ * The merchant category code or
74
+ * [MCC](https://en.wikipedia.org/wiki/Merchant_category_code).
75
+ */
76
+ category?: string;
77
+ /**
78
+ * @deprecated
79
+ */
80
+ climateActionMode?: OrderRetrieveResponse.ClimateActionMode;
81
+ /**
82
+ * @deprecated
83
+ */
84
+ co2Grams?: number;
85
+ /**
86
+ * The unique identifier of the customer who placed the order.
87
+ */
88
+ customerId?: string;
89
+ /**
90
+ * The customer facing id. This id is displayed to the user during the checkout and
91
+ * in the merchant dashboard.
92
+ */
93
+ displayId?: string;
94
+ /**
95
+ * False by default. If set to true, customers skip email input and jump directly
96
+ * to their bank login. For express Checkout Sessions this is always false.
97
+ */
98
+ guest?: boolean;
99
+ /**
100
+ * Only valid for sustainable incentive mode. The social / sustainable projects
101
+ * available to the user during Checkout.
102
+ */
103
+ impactOffsetProjects?: Array<string>;
104
+ /**
105
+ * The incentive mode of the checkout session. For any use-case apart from
106
+ * e-commerce, please use `white_label` as the value. If set to `white_label`, the
107
+ * checkout session will be white labeled. If set to `sustainable`, the checkout
108
+ * session will contain sustainable incentives for users.
109
+ */
110
+ incentiveMode?: 'white_label' | 'sustainable';
111
+ /**
112
+ * The line items of the Checkout.
113
+ */
114
+ lineItems?: Array<OrderRetrieveResponse.LineItem>;
115
+ mandate?: OrderRetrieveResponse.Mandate;
116
+ /**
117
+ * The destination bank account where the money will be sent to.
118
+ */
119
+ merchantFinancialAddress?: OrderRetrieveResponse.MerchantFinancialAddress;
120
+ /**
121
+ * Any data which will be stored and returned for this checkout session and
122
+ * corresponding order. See [here](https://docs.getivy.de/reference/metadata) for
123
+ * more info.
124
+ */
125
+ metadata?: Record<string, unknown>;
126
+ /**
127
+ * Only valid for sustainable incentive mode. The social / sustainability project
128
+ * chosen by the user during Checkout.
129
+ */
130
+ offsetProject?: string;
131
+ /**
132
+ * The source bank account where the money is send from.
133
+ */
134
+ payerFinancialAddress?: OrderRetrieveResponse.PayerFinancialAddress;
135
+ paymentMethodType?: 'sepa_debit' | 'customer_balance';
136
+ /**
137
+ * The payment mode of the order. Can be either 'settlement' or 'direct'.
138
+ */
139
+ paymentMode?: 'settlement' | 'direct';
140
+ /**
141
+ * @deprecated Deprecated in favor of `status`. Do not use this field to trigger
142
+ * actions in your system.
143
+ */
144
+ paymentStatus?: 'failed' | 'canceled' | 'processing' | 'requires_action' | 'succeeded' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'not_settled' | 'disputed';
145
+ /**
146
+ * The total amount in the currency of all successful refunds for this order
147
+ */
148
+ refundAmount?: number;
149
+ /**
150
+ * The list of refunds connected to this order.
151
+ */
152
+ refunds?: Array<OrderRetrieveResponse.Refund>;
153
+ /**
154
+ * The shipping address of the user. This is only collected in express Checkouts.
155
+ */
156
+ shippingAddress?: OrderRetrieveResponse.ShippingAddress;
157
+ /**
158
+ * The selected shipping method by the user. Can either be selected during an
159
+ * express Checkout Session or passed during Checkout Session creation.
160
+ */
161
+ shippingMethod?: OrderRetrieveResponse.ShippingMethod;
162
+ /**
163
+ * The logo of the shop provided as a URL.
164
+ */
165
+ shopLogo?: string;
166
+ /**
167
+ * The shopper object. Contains information collected from the user during the
168
+ * Checkout.
169
+ */
170
+ shopper?: OrderRetrieveResponse.Shopper;
171
+ /**
172
+ * @deprecated Deprecated in favor of `shopper.email`. The email of the user if
173
+ * collected in the Checkout.
174
+ */
175
+ shopperEmail?: string;
176
+ statusClassification?: OrderRetrieveResponse.StatusClassification;
177
+ /**
178
+ * List of status history items for the order, used for logging every update on
179
+ * status.
180
+ */
181
+ statusHistoryList?: Array<OrderRetrieveResponse.StatusHistoryList>;
182
+ /**
183
+ * The subaccount id of the order.
184
+ */
185
+ subaccountId?: string;
186
+ /**
187
+ * The legal name of the subaccount
188
+ */
189
+ subaccountLegalName?: string;
190
+ /**
191
+ * @deprecated
192
+ */
193
+ trees?: number;
194
+ }
195
+ export declare namespace OrderRetrieveResponse {
196
+ /**
197
+ * The price to be paid by the user. All amounts are in decimals, i.e. 10.23
198
+ * represents EUR 10.23. Any amount of decimal places can be provided on
199
+ * initialization, but the actual transfer amount is rounded to 2 decimal places,
200
+ * as this is the format accepted by most banks.
201
+ */
202
+ interface Price {
203
+ currency: 'EUR' | 'GBP' | 'PLN';
204
+ /**
205
+ * The total amount to be paid.
206
+ */
207
+ total: number;
208
+ /**
209
+ * The shipping amount.
210
+ */
211
+ shipping?: number;
212
+ /**
213
+ * The subtotal amount, i.e. the total amount without VAT and shipping.
214
+ */
215
+ subTotal?: number;
216
+ /**
217
+ * The total net amount, i.e. the total amount without VAT. This value is rounded
218
+ * to 2 decimal places for the actual transfer.
219
+ */
220
+ totalNet?: number;
221
+ /**
222
+ * The VAT amount.
223
+ */
224
+ vat?: number;
225
+ }
226
+ /**
227
+ * The billing address of the user. Required when handshake=true.
228
+ */
229
+ interface BillingAddress {
230
+ city: string;
231
+ /**
232
+ * The country code in
233
+ * [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
234
+ */
235
+ country: 'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IL' | 'IT' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' | 'BQ' | 'CW' | 'GG' | 'IM' | 'JE' | 'ME' | 'BL' | 'MF' | 'RS' | 'SX' | 'SS' | 'XK';
236
+ line1: string;
237
+ zipCode: string;
238
+ firstName?: string;
239
+ lastName?: string;
240
+ line2?: string;
241
+ region?: string;
242
+ }
243
+ /**
244
+ * @deprecated
245
+ */
246
+ interface ClimateActionMode {
247
+ amount: number;
248
+ type: 'transaction' | 'amount';
249
+ }
250
+ interface LineItem {
251
+ /**
252
+ * The total amount of all line items, i.e. single amount \* quantity. Given in
253
+ * decimals, i.e. 10.23 represents EUR 10.23.
254
+ */
255
+ amount: number;
256
+ /**
257
+ * The name of the line item.
258
+ */
259
+ name: string;
260
+ /**
261
+ * The quantity of the line item.
262
+ */
263
+ quantity: number;
264
+ /**
265
+ * The net amount of a single item.
266
+ */
267
+ singleNet: number;
268
+ /**
269
+ * The VAT amount of a single item.
270
+ */
271
+ singleVat: number;
272
+ /**
273
+ * The category as [MCC](https://en.wikipedia.org/wiki/Merchant_category_code) of
274
+ * the line item.
275
+ */
276
+ category?: string;
277
+ /**
278
+ * The
279
+ * [EAN](https://en.wikipedia.org/wiki/International_Article_Number#:~:text=The%20International%20Article%20Number%20(also,configuration%2C%20from%20a%20specific%20manufacturer.)
280
+ * of the line item.
281
+ */
282
+ EAN?: string;
283
+ /**
284
+ * The image of the line item as a URL.
285
+ */
286
+ image?: string;
287
+ /**
288
+ * The internal unique identifier of the line item.
289
+ */
290
+ referenceId?: string;
291
+ }
292
+ interface Mandate {
293
+ /**
294
+ * The name of the account holder who signs the mandate.
295
+ */
296
+ accountHolderName?: string;
297
+ /**
298
+ * Additional information to display to the user during the mandate setup. This
299
+ * information is not used to setup any recurrence on the mandate. It is only
300
+ * displayed to the user during checkout.
301
+ */
302
+ additionalDisplayInformation?: Mandate.AdditionalDisplayInformation;
303
+ /**
304
+ * Mandate creditor data
305
+ */
306
+ creditor?: Mandate.Creditor;
307
+ /**
308
+ * The reference of the mandate going to be setup
309
+ */
310
+ reference?: string;
311
+ /**
312
+ * The mandate referenceId. Set this to match incoming `mandate_setup_started`,
313
+ * `mandate_setup_succeeded` or `mandate_setup_failed` webhook events to your
314
+ * mandate setup request.
315
+ */
316
+ referenceId?: string;
317
+ /**
318
+ * If true, a ready to use mandate will be set up after the payment flow.
319
+ */
320
+ setup?: boolean;
321
+ /**
322
+ * The email of the user who signs the mandate.
323
+ */
324
+ userNotificationEmail?: string;
325
+ }
326
+ namespace Mandate {
327
+ /**
328
+ * Additional information to display to the user during the mandate setup. This
329
+ * information is not used to setup any recurrence on the mandate. It is only
330
+ * displayed to the user during checkout.
331
+ */
332
+ interface AdditionalDisplayInformation {
333
+ /**
334
+ * The intended cadence of charges used for displaying purpose only. On demand
335
+ * would be used for unscheduled charges.
336
+ */
337
+ cadence?: 'BI_WEEKLY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'ON_DEMAND';
338
+ price?: AdditionalDisplayInformation.Price;
339
+ }
340
+ namespace AdditionalDisplayInformation {
341
+ interface Price {
342
+ /**
343
+ * The amount displayed to the user as decimal e.g. 10.23 would be displayed as
344
+ * 10.23 EUR.
345
+ */
346
+ amount?: number;
347
+ currency?: 'EUR' | 'GBP' | 'PLN';
348
+ }
349
+ }
350
+ /**
351
+ * Mandate creditor data
352
+ */
353
+ interface Creditor {
354
+ id?: string;
355
+ name?: string;
356
+ }
357
+ }
358
+ /**
359
+ * The destination bank account where the money will be sent to.
360
+ */
361
+ interface MerchantFinancialAddress {
362
+ bankCode?: MerchantFinancialAddress.BankCode;
363
+ bban?: MerchantFinancialAddress.Bban;
364
+ iban?: MerchantFinancialAddress.Iban;
365
+ /**
366
+ * The payment reference for the order. This is the reference that will be visible
367
+ * on the bank statement.
368
+ */
369
+ paymentReference?: string;
370
+ sortCode?: MerchantFinancialAddress.SortCode;
371
+ /**
372
+ * The type of the financial address. The actual destination is determined by this
373
+ * field which can be either "iban", "sortCode", "bankCode", or "bban". The
374
+ * validation will fail if you set e.g. type="iban", but then not fill any values
375
+ * in the "iban" object.
376
+ *
377
+ * - iban: The IBAN of the account
378
+ * - sort_code: The sort code of the account
379
+ * - bank_code: The bank code of the account
380
+ * - bban: The BBAN of the account
381
+ */
382
+ type?: string;
383
+ }
384
+ namespace MerchantFinancialAddress {
385
+ interface BankCode {
386
+ /**
387
+ * The name of the account holder.
388
+ */
389
+ accountHolderName: string;
390
+ accountNumber: string;
391
+ code: string;
392
+ }
393
+ interface Bban {
394
+ /**
395
+ * The name of the account holder.
396
+ */
397
+ accountHolderName: string;
398
+ bban: string;
399
+ bic?: string;
400
+ }
401
+ interface Iban {
402
+ /**
403
+ * The name of the account holder.
404
+ */
405
+ accountHolderName: string;
406
+ iban: string;
407
+ bic?: string;
408
+ }
409
+ interface SortCode {
410
+ /**
411
+ * The name of the account holder.
412
+ */
413
+ accountHolderName: string;
414
+ accountNumber: string;
415
+ sortCode: string;
416
+ }
417
+ }
418
+ /**
419
+ * The source bank account where the money is send from.
420
+ */
421
+ interface PayerFinancialAddress {
422
+ /**
423
+ * The type of the financial address. The actual destination is determined by this
424
+ * field which can be either "iban", "sortCode", "bankCode", or "bban". The
425
+ * validation will fail if you set e.g. type="iban", but then not fill any values
426
+ * in the "iban" object.
427
+ *
428
+ * - iban: The IBAN of the account
429
+ * - sort_code: The sort code of the account
430
+ * - bank_code: The bank code of the account
431
+ * - bban: The BBAN of the account
432
+ */
433
+ type: string;
434
+ bankCode?: PayerFinancialAddress.BankCode;
435
+ bban?: PayerFinancialAddress.Bban;
436
+ iban?: PayerFinancialAddress.Iban;
437
+ sortCode?: PayerFinancialAddress.SortCode;
438
+ }
439
+ namespace PayerFinancialAddress {
440
+ interface BankCode {
441
+ accountNumber: string;
442
+ code: string;
443
+ /**
444
+ * The name of the account holder.
445
+ */
446
+ accountHolderName?: string;
447
+ }
448
+ interface Bban {
449
+ bban: string;
450
+ /**
451
+ * The name of the account holder.
452
+ */
453
+ accountHolderName?: string;
454
+ bic?: string;
455
+ }
456
+ interface Iban {
457
+ iban: string;
458
+ /**
459
+ * The name of the account holder.
460
+ */
461
+ accountHolderName?: string;
462
+ bic?: string;
463
+ }
464
+ interface SortCode {
465
+ accountNumber: string;
466
+ sortCode: string;
467
+ /**
468
+ * The name of the account holder.
469
+ */
470
+ accountHolderName?: string;
471
+ }
472
+ }
473
+ /**
474
+ * A Refund object. This corresponds to one Refund request.
475
+ */
476
+ interface Refund {
477
+ id: string;
478
+ amount: number;
479
+ createdAt: string;
480
+ referenceId: string;
481
+ /**
482
+ * The status of the refund. Always use the status of the order as your source of
483
+ * truth to trigger actions in your dashboard.
484
+ */
485
+ status: 'pending' | 'succeeded' | 'failed' | 'requires_action' | 'partially_refunded';
486
+ updatedAt: string;
487
+ description?: string;
488
+ }
489
+ /**
490
+ * The shipping address of the user. This is only collected in express Checkouts.
491
+ */
492
+ interface ShippingAddress {
493
+ city: string;
494
+ /**
495
+ * The country code in
496
+ * [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
497
+ */
498
+ country: 'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IL' | 'IT' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' | 'BQ' | 'CW' | 'GG' | 'IM' | 'JE' | 'ME' | 'BL' | 'MF' | 'RS' | 'SX' | 'SS' | 'XK';
499
+ line1: string;
500
+ zipCode: string;
501
+ firstName?: string;
502
+ lastName?: string;
503
+ line2?: string;
504
+ region?: string;
505
+ }
506
+ /**
507
+ * The selected shipping method by the user. Can either be selected during an
508
+ * express Checkout Session or passed during Checkout Session creation.
509
+ */
510
+ interface ShippingMethod {
511
+ /**
512
+ * The customer-facing name of the shipping method.
513
+ */
514
+ name: string;
515
+ /**
516
+ * The price of the shipping method in decimals, i.e. 10.23 represents EUR 10.23.
517
+ */
518
+ price: number;
519
+ /**
520
+ * The unique identifier of the shipping method within Ivy.
521
+ */
522
+ id?: string;
523
+ /**
524
+ * The list of countries where the shipping method is available.
525
+ */
526
+ countries?: Array<'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IL' | 'IT' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' | 'BQ' | 'CW' | 'GG' | 'IM' | 'JE' | 'ME' | 'BL' | 'MF' | 'RS' | 'SX' | 'SS' | 'XK'>;
527
+ /**
528
+ * The delivery estimate of the shipping method.
529
+ */
530
+ deliveryEstimate?: ShippingMethod.DeliveryEstimate;
531
+ /**
532
+ * The unique identifier within your system of the shipping method.
533
+ */
534
+ reference?: string;
535
+ /**
536
+ * @deprecated Deprecated in favor of deliveryEstimate
537
+ */
538
+ timeFrame?: string;
539
+ }
540
+ namespace ShippingMethod {
541
+ /**
542
+ * The delivery estimate of the shipping method.
543
+ */
544
+ interface DeliveryEstimate {
545
+ /**
546
+ * The maximum delivery time.
547
+ */
548
+ maximum?: DeliveryEstimate.Maximum;
549
+ /**
550
+ * The minimum delivery time.
551
+ */
552
+ minimum?: DeliveryEstimate.Minimum;
553
+ }
554
+ namespace DeliveryEstimate {
555
+ /**
556
+ * The maximum delivery time.
557
+ */
558
+ interface Maximum {
559
+ /**
560
+ * The unit of the time duration.
561
+ */
562
+ unit: 'hour' | 'day' | 'business_day' | 'week' | 'month';
563
+ /**
564
+ * The value of the time duration.
565
+ */
566
+ value: number;
567
+ }
568
+ /**
569
+ * The minimum delivery time.
570
+ */
571
+ interface Minimum {
572
+ /**
573
+ * The unit of the time duration.
574
+ */
575
+ unit: 'hour' | 'day' | 'business_day' | 'week' | 'month';
576
+ /**
577
+ * The value of the time duration.
578
+ */
579
+ value: number;
580
+ }
581
+ }
582
+ }
583
+ /**
584
+ * The shopper object. Contains information collected from the user during the
585
+ * Checkout.
586
+ */
587
+ interface Shopper {
588
+ email?: string;
589
+ phoneNumber?: string;
590
+ }
591
+ interface StatusClassification {
592
+ /**
593
+ * Populated with the primary payment initiation failure classsification if
594
+ * available.
595
+ */
596
+ primary?: string;
597
+ /**
598
+ * Populated with the secondary payment initiation failure classsification if
599
+ * available.
600
+ */
601
+ secondary?: string;
602
+ }
603
+ interface StatusHistoryList {
604
+ /**
605
+ * The order status. This status symbolises the state of the user's payment
606
+ * attempt. See [the guide](https://docs.getivy.de/docs/payment-status) for more
607
+ * information.
608
+ */
609
+ currentStatus: 'failed' | 'canceled' | 'processing' | 'in_handshake' | 'waiting_for_payment' | 'paid' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'in_dispute' | 'disputed' | 'refused';
610
+ reason: string;
611
+ updatedAt: string;
612
+ /**
613
+ * The order status. This status symbolises the state of the user's payment
614
+ * attempt. See [the guide](https://docs.getivy.de/docs/payment-status) for more
615
+ * information.
616
+ */
617
+ previousStatus?: 'failed' | 'canceled' | 'processing' | 'in_handshake' | 'waiting_for_payment' | 'paid' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'in_dispute' | 'disputed' | 'refused' | null;
618
+ }
619
+ }
620
+ export interface OrderUpdateResponse {
621
+ /**
622
+ * The Ivy unique identifier for the order.
623
+ */
624
+ id: string;
625
+ /**
626
+ * @deprecated The unique identifier for the merchantApp which initiated the order
627
+ * / payment attempt.
628
+ */
629
+ appId: string;
630
+ /**
631
+ * The Ivy fee for the payment.
632
+ */
633
+ applicationFeeAmount: number;
634
+ createdAt: string;
635
+ instantPaymentScheme: boolean;
636
+ /**
637
+ * @deprecated Deprecated in favor of `appId`.
638
+ */
639
+ merchantAppId: string;
640
+ /**
641
+ * The unique identifier for the merchant which initiated the order / payment
642
+ * attempt.
643
+ */
644
+ merchantId: string;
645
+ /**
646
+ * The price to be paid by the user. All amounts are in decimals, i.e. 10.23
647
+ * represents EUR 10.23. Any amount of decimal places can be provided on
648
+ * initialization, but the actual transfer amount is rounded to 2 decimal places,
649
+ * as this is the format accepted by most banks.
650
+ */
651
+ price: OrderUpdateResponse.Price;
652
+ /**
653
+ * An internal reference id which will be stored with the checkout & corresponding
654
+ * order. Needs to be unique per shop per order and can be up to 200 characters.
655
+ */
656
+ referenceId: string;
657
+ /**
658
+ * The name of the merchant which initiated the order.
659
+ */
660
+ shopName: string;
661
+ /**
662
+ * The order status. This status symbolises the state of the user's payment
663
+ * attempt. See [the guide](https://docs.getivy.de/docs/payment-status) for more
664
+ * information.
665
+ */
666
+ status: 'failed' | 'canceled' | 'processing' | 'in_handshake' | 'waiting_for_payment' | 'paid' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'in_dispute' | 'disputed' | 'refused';
667
+ updatedAt: string;
668
+ /**
669
+ * The bank statement reference of the payment for the order. This is the reference
670
+ * that will be visible on the bank statement.
671
+ */
672
+ bankStatementReference?: string;
673
+ /**
674
+ * The billing address of the user. Required when handshake=true.
675
+ */
676
+ billingAddress?: OrderUpdateResponse.BillingAddress;
677
+ /**
678
+ * The merchant category code or
679
+ * [MCC](https://en.wikipedia.org/wiki/Merchant_category_code).
680
+ */
681
+ category?: string;
682
+ /**
683
+ * @deprecated
684
+ */
685
+ climateActionMode?: OrderUpdateResponse.ClimateActionMode;
686
+ /**
687
+ * @deprecated
688
+ */
689
+ co2Grams?: number;
690
+ /**
691
+ * The unique identifier of the customer who placed the order.
692
+ */
693
+ customerId?: string;
694
+ /**
695
+ * The customer facing id. This id is displayed to the user during the checkout and
696
+ * in the merchant dashboard.
697
+ */
698
+ displayId?: string;
699
+ /**
700
+ * False by default. If set to true, customers skip email input and jump directly
701
+ * to their bank login. For express Checkout Sessions this is always false.
702
+ */
703
+ guest?: boolean;
704
+ /**
705
+ * Only valid for sustainable incentive mode. The social / sustainable projects
706
+ * available to the user during Checkout.
707
+ */
708
+ impactOffsetProjects?: Array<string>;
709
+ /**
710
+ * The incentive mode of the checkout session. For any use-case apart from
711
+ * e-commerce, please use `white_label` as the value. If set to `white_label`, the
712
+ * checkout session will be white labeled. If set to `sustainable`, the checkout
713
+ * session will contain sustainable incentives for users.
714
+ */
715
+ incentiveMode?: 'white_label' | 'sustainable';
716
+ /**
717
+ * The line items of the Checkout.
718
+ */
719
+ lineItems?: Array<OrderUpdateResponse.LineItem>;
720
+ mandate?: OrderUpdateResponse.Mandate;
721
+ /**
722
+ * The destination bank account where the money will be sent to.
723
+ */
724
+ merchantFinancialAddress?: OrderUpdateResponse.MerchantFinancialAddress;
725
+ /**
726
+ * Any data which will be stored and returned for this checkout session and
727
+ * corresponding order. See [here](https://docs.getivy.de/reference/metadata) for
728
+ * more info.
729
+ */
730
+ metadata?: Record<string, unknown>;
731
+ /**
732
+ * Only valid for sustainable incentive mode. The social / sustainability project
733
+ * chosen by the user during Checkout.
734
+ */
735
+ offsetProject?: string;
736
+ /**
737
+ * The source bank account where the money is send from.
738
+ */
739
+ payerFinancialAddress?: OrderUpdateResponse.PayerFinancialAddress;
740
+ paymentMethodType?: 'sepa_debit' | 'customer_balance';
741
+ /**
742
+ * The payment mode of the order. Can be either 'settlement' or 'direct'.
743
+ */
744
+ paymentMode?: 'settlement' | 'direct';
745
+ /**
746
+ * @deprecated Deprecated in favor of `status`. Do not use this field to trigger
747
+ * actions in your system.
748
+ */
749
+ paymentStatus?: 'failed' | 'canceled' | 'processing' | 'requires_action' | 'succeeded' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'not_settled' | 'disputed';
750
+ /**
751
+ * The total amount in the currency of all successful refunds for this order
752
+ */
753
+ refundAmount?: number;
754
+ /**
755
+ * The list of refunds connected to this order.
756
+ */
757
+ refunds?: Array<OrderUpdateResponse.Refund>;
758
+ /**
759
+ * The shipping address of the user. This is only collected in express Checkouts.
760
+ */
761
+ shippingAddress?: OrderUpdateResponse.ShippingAddress;
762
+ /**
763
+ * The selected shipping method by the user. Can either be selected during an
764
+ * express Checkout Session or passed during Checkout Session creation.
765
+ */
766
+ shippingMethod?: OrderUpdateResponse.ShippingMethod;
767
+ /**
768
+ * The logo of the shop provided as a URL.
769
+ */
770
+ shopLogo?: string;
771
+ /**
772
+ * The shopper object. Contains information collected from the user during the
773
+ * Checkout.
774
+ */
775
+ shopper?: OrderUpdateResponse.Shopper;
776
+ /**
777
+ * @deprecated Deprecated in favor of `shopper.email`. The email of the user if
778
+ * collected in the Checkout.
779
+ */
780
+ shopperEmail?: string;
781
+ statusClassification?: OrderUpdateResponse.StatusClassification;
782
+ /**
783
+ * List of status history items for the order, used for logging every update on
784
+ * status.
785
+ */
786
+ statusHistoryList?: Array<OrderUpdateResponse.StatusHistoryList>;
787
+ /**
788
+ * The subaccount id of the order.
789
+ */
790
+ subaccountId?: string;
791
+ /**
792
+ * The legal name of the subaccount
793
+ */
794
+ subaccountLegalName?: string;
795
+ /**
796
+ * @deprecated
797
+ */
798
+ trees?: number;
799
+ }
800
+ export declare namespace OrderUpdateResponse {
801
+ /**
802
+ * The price to be paid by the user. All amounts are in decimals, i.e. 10.23
803
+ * represents EUR 10.23. Any amount of decimal places can be provided on
804
+ * initialization, but the actual transfer amount is rounded to 2 decimal places,
805
+ * as this is the format accepted by most banks.
806
+ */
807
+ interface Price {
808
+ currency: 'EUR' | 'GBP' | 'PLN';
809
+ /**
810
+ * The total amount to be paid.
811
+ */
812
+ total: number;
813
+ /**
814
+ * The shipping amount.
815
+ */
816
+ shipping?: number;
817
+ /**
818
+ * The subtotal amount, i.e. the total amount without VAT and shipping.
819
+ */
820
+ subTotal?: number;
821
+ /**
822
+ * The total net amount, i.e. the total amount without VAT. This value is rounded
823
+ * to 2 decimal places for the actual transfer.
824
+ */
825
+ totalNet?: number;
826
+ /**
827
+ * The VAT amount.
828
+ */
829
+ vat?: number;
830
+ }
831
+ /**
832
+ * The billing address of the user. Required when handshake=true.
833
+ */
834
+ interface BillingAddress {
835
+ city: string;
836
+ /**
837
+ * The country code in
838
+ * [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
839
+ */
840
+ country: 'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IL' | 'IT' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' | 'BQ' | 'CW' | 'GG' | 'IM' | 'JE' | 'ME' | 'BL' | 'MF' | 'RS' | 'SX' | 'SS' | 'XK';
841
+ line1: string;
842
+ zipCode: string;
843
+ firstName?: string;
844
+ lastName?: string;
845
+ line2?: string;
846
+ region?: string;
847
+ }
848
+ /**
849
+ * @deprecated
850
+ */
851
+ interface ClimateActionMode {
852
+ amount: number;
853
+ type: 'transaction' | 'amount';
854
+ }
855
+ interface LineItem {
856
+ /**
857
+ * The total amount of all line items, i.e. single amount \* quantity. Given in
858
+ * decimals, i.e. 10.23 represents EUR 10.23.
859
+ */
860
+ amount: number;
861
+ /**
862
+ * The name of the line item.
863
+ */
864
+ name: string;
865
+ /**
866
+ * The quantity of the line item.
867
+ */
868
+ quantity: number;
869
+ /**
870
+ * The net amount of a single item.
871
+ */
872
+ singleNet: number;
873
+ /**
874
+ * The VAT amount of a single item.
875
+ */
876
+ singleVat: number;
877
+ /**
878
+ * The category as [MCC](https://en.wikipedia.org/wiki/Merchant_category_code) of
879
+ * the line item.
880
+ */
881
+ category?: string;
882
+ /**
883
+ * The
884
+ * [EAN](https://en.wikipedia.org/wiki/International_Article_Number#:~:text=The%20International%20Article%20Number%20(also,configuration%2C%20from%20a%20specific%20manufacturer.)
885
+ * of the line item.
886
+ */
887
+ EAN?: string;
888
+ /**
889
+ * The image of the line item as a URL.
890
+ */
891
+ image?: string;
892
+ /**
893
+ * The internal unique identifier of the line item.
894
+ */
895
+ referenceId?: string;
896
+ }
897
+ interface Mandate {
898
+ /**
899
+ * The name of the account holder who signs the mandate.
900
+ */
901
+ accountHolderName?: string;
902
+ /**
903
+ * Additional information to display to the user during the mandate setup. This
904
+ * information is not used to setup any recurrence on the mandate. It is only
905
+ * displayed to the user during checkout.
906
+ */
907
+ additionalDisplayInformation?: Mandate.AdditionalDisplayInformation;
908
+ /**
909
+ * Mandate creditor data
910
+ */
911
+ creditor?: Mandate.Creditor;
912
+ /**
913
+ * The reference of the mandate going to be setup
914
+ */
915
+ reference?: string;
916
+ /**
917
+ * The mandate referenceId. Set this to match incoming `mandate_setup_started`,
918
+ * `mandate_setup_succeeded` or `mandate_setup_failed` webhook events to your
919
+ * mandate setup request.
920
+ */
921
+ referenceId?: string;
922
+ /**
923
+ * If true, a ready to use mandate will be set up after the payment flow.
924
+ */
925
+ setup?: boolean;
926
+ /**
927
+ * The email of the user who signs the mandate.
928
+ */
929
+ userNotificationEmail?: string;
930
+ }
931
+ namespace Mandate {
932
+ /**
933
+ * Additional information to display to the user during the mandate setup. This
934
+ * information is not used to setup any recurrence on the mandate. It is only
935
+ * displayed to the user during checkout.
936
+ */
937
+ interface AdditionalDisplayInformation {
938
+ /**
939
+ * The intended cadence of charges used for displaying purpose only. On demand
940
+ * would be used for unscheduled charges.
941
+ */
942
+ cadence?: 'BI_WEEKLY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'SEMI_ANNUAL' | 'ANNUAL' | 'ON_DEMAND';
943
+ price?: AdditionalDisplayInformation.Price;
944
+ }
945
+ namespace AdditionalDisplayInformation {
946
+ interface Price {
947
+ /**
948
+ * The amount displayed to the user as decimal e.g. 10.23 would be displayed as
949
+ * 10.23 EUR.
950
+ */
951
+ amount?: number;
952
+ currency?: 'EUR' | 'GBP' | 'PLN';
953
+ }
954
+ }
955
+ /**
956
+ * Mandate creditor data
957
+ */
958
+ interface Creditor {
959
+ id?: string;
960
+ name?: string;
961
+ }
962
+ }
963
+ /**
964
+ * The destination bank account where the money will be sent to.
965
+ */
966
+ interface MerchantFinancialAddress {
967
+ bankCode?: MerchantFinancialAddress.BankCode;
968
+ bban?: MerchantFinancialAddress.Bban;
969
+ iban?: MerchantFinancialAddress.Iban;
970
+ /**
971
+ * The payment reference for the order. This is the reference that will be visible
972
+ * on the bank statement.
973
+ */
974
+ paymentReference?: string;
975
+ sortCode?: MerchantFinancialAddress.SortCode;
976
+ /**
977
+ * The type of the financial address. The actual destination is determined by this
978
+ * field which can be either "iban", "sortCode", "bankCode", or "bban". The
979
+ * validation will fail if you set e.g. type="iban", but then not fill any values
980
+ * in the "iban" object.
981
+ *
982
+ * - iban: The IBAN of the account
983
+ * - sort_code: The sort code of the account
984
+ * - bank_code: The bank code of the account
985
+ * - bban: The BBAN of the account
986
+ */
987
+ type?: string;
988
+ }
989
+ namespace MerchantFinancialAddress {
990
+ interface BankCode {
991
+ /**
992
+ * The name of the account holder.
993
+ */
994
+ accountHolderName: string;
995
+ accountNumber: string;
996
+ code: string;
997
+ }
998
+ interface Bban {
999
+ /**
1000
+ * The name of the account holder.
1001
+ */
1002
+ accountHolderName: string;
1003
+ bban: string;
1004
+ bic?: string;
1005
+ }
1006
+ interface Iban {
1007
+ /**
1008
+ * The name of the account holder.
1009
+ */
1010
+ accountHolderName: string;
1011
+ iban: string;
1012
+ bic?: string;
1013
+ }
1014
+ interface SortCode {
1015
+ /**
1016
+ * The name of the account holder.
1017
+ */
1018
+ accountHolderName: string;
1019
+ accountNumber: string;
1020
+ sortCode: string;
1021
+ }
1022
+ }
1023
+ /**
1024
+ * The source bank account where the money is send from.
1025
+ */
1026
+ interface PayerFinancialAddress {
1027
+ /**
1028
+ * The type of the financial address. The actual destination is determined by this
1029
+ * field which can be either "iban", "sortCode", "bankCode", or "bban". The
1030
+ * validation will fail if you set e.g. type="iban", but then not fill any values
1031
+ * in the "iban" object.
1032
+ *
1033
+ * - iban: The IBAN of the account
1034
+ * - sort_code: The sort code of the account
1035
+ * - bank_code: The bank code of the account
1036
+ * - bban: The BBAN of the account
1037
+ */
1038
+ type: string;
1039
+ bankCode?: PayerFinancialAddress.BankCode;
1040
+ bban?: PayerFinancialAddress.Bban;
1041
+ iban?: PayerFinancialAddress.Iban;
1042
+ sortCode?: PayerFinancialAddress.SortCode;
1043
+ }
1044
+ namespace PayerFinancialAddress {
1045
+ interface BankCode {
1046
+ accountNumber: string;
1047
+ code: string;
1048
+ /**
1049
+ * The name of the account holder.
1050
+ */
1051
+ accountHolderName?: string;
1052
+ }
1053
+ interface Bban {
1054
+ bban: string;
1055
+ /**
1056
+ * The name of the account holder.
1057
+ */
1058
+ accountHolderName?: string;
1059
+ bic?: string;
1060
+ }
1061
+ interface Iban {
1062
+ iban: string;
1063
+ /**
1064
+ * The name of the account holder.
1065
+ */
1066
+ accountHolderName?: string;
1067
+ bic?: string;
1068
+ }
1069
+ interface SortCode {
1070
+ accountNumber: string;
1071
+ sortCode: string;
1072
+ /**
1073
+ * The name of the account holder.
1074
+ */
1075
+ accountHolderName?: string;
1076
+ }
1077
+ }
1078
+ /**
1079
+ * A Refund object. This corresponds to one Refund request.
1080
+ */
1081
+ interface Refund {
1082
+ id: string;
1083
+ amount: number;
1084
+ createdAt: string;
1085
+ referenceId: string;
1086
+ /**
1087
+ * The status of the refund. Always use the status of the order as your source of
1088
+ * truth to trigger actions in your dashboard.
1089
+ */
1090
+ status: 'pending' | 'succeeded' | 'failed' | 'requires_action' | 'partially_refunded';
1091
+ updatedAt: string;
1092
+ description?: string;
1093
+ }
1094
+ /**
1095
+ * The shipping address of the user. This is only collected in express Checkouts.
1096
+ */
1097
+ interface ShippingAddress {
1098
+ city: string;
1099
+ /**
1100
+ * The country code in
1101
+ * [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
1102
+ */
1103
+ country: 'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IL' | 'IT' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' | 'BQ' | 'CW' | 'GG' | 'IM' | 'JE' | 'ME' | 'BL' | 'MF' | 'RS' | 'SX' | 'SS' | 'XK';
1104
+ line1: string;
1105
+ zipCode: string;
1106
+ firstName?: string;
1107
+ lastName?: string;
1108
+ line2?: string;
1109
+ region?: string;
1110
+ }
1111
+ /**
1112
+ * The selected shipping method by the user. Can either be selected during an
1113
+ * express Checkout Session or passed during Checkout Session creation.
1114
+ */
1115
+ interface ShippingMethod {
1116
+ /**
1117
+ * The customer-facing name of the shipping method.
1118
+ */
1119
+ name: string;
1120
+ /**
1121
+ * The price of the shipping method in decimals, i.e. 10.23 represents EUR 10.23.
1122
+ */
1123
+ price: number;
1124
+ /**
1125
+ * The unique identifier of the shipping method within Ivy.
1126
+ */
1127
+ id?: string;
1128
+ /**
1129
+ * The list of countries where the shipping method is available.
1130
+ */
1131
+ countries?: Array<'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IL' | 'IT' | 'JM' | 'JP' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'MK' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SH' | 'KN' | 'LC' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'SC' | 'SL' | 'SG' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' | 'BQ' | 'CW' | 'GG' | 'IM' | 'JE' | 'ME' | 'BL' | 'MF' | 'RS' | 'SX' | 'SS' | 'XK'>;
1132
+ /**
1133
+ * The delivery estimate of the shipping method.
1134
+ */
1135
+ deliveryEstimate?: ShippingMethod.DeliveryEstimate;
1136
+ /**
1137
+ * The unique identifier within your system of the shipping method.
1138
+ */
1139
+ reference?: string;
1140
+ /**
1141
+ * @deprecated Deprecated in favor of deliveryEstimate
1142
+ */
1143
+ timeFrame?: string;
1144
+ }
1145
+ namespace ShippingMethod {
1146
+ /**
1147
+ * The delivery estimate of the shipping method.
1148
+ */
1149
+ interface DeliveryEstimate {
1150
+ /**
1151
+ * The maximum delivery time.
1152
+ */
1153
+ maximum?: DeliveryEstimate.Maximum;
1154
+ /**
1155
+ * The minimum delivery time.
1156
+ */
1157
+ minimum?: DeliveryEstimate.Minimum;
1158
+ }
1159
+ namespace DeliveryEstimate {
1160
+ /**
1161
+ * The maximum delivery time.
1162
+ */
1163
+ interface Maximum {
1164
+ /**
1165
+ * The unit of the time duration.
1166
+ */
1167
+ unit: 'hour' | 'day' | 'business_day' | 'week' | 'month';
1168
+ /**
1169
+ * The value of the time duration.
1170
+ */
1171
+ value: number;
1172
+ }
1173
+ /**
1174
+ * The minimum delivery time.
1175
+ */
1176
+ interface Minimum {
1177
+ /**
1178
+ * The unit of the time duration.
1179
+ */
1180
+ unit: 'hour' | 'day' | 'business_day' | 'week' | 'month';
1181
+ /**
1182
+ * The value of the time duration.
1183
+ */
1184
+ value: number;
1185
+ }
1186
+ }
1187
+ }
1188
+ /**
1189
+ * The shopper object. Contains information collected from the user during the
1190
+ * Checkout.
1191
+ */
1192
+ interface Shopper {
1193
+ email?: string;
1194
+ phoneNumber?: string;
1195
+ }
1196
+ interface StatusClassification {
1197
+ /**
1198
+ * Populated with the primary payment initiation failure classsification if
1199
+ * available.
1200
+ */
1201
+ primary?: string;
1202
+ /**
1203
+ * Populated with the secondary payment initiation failure classsification if
1204
+ * available.
1205
+ */
1206
+ secondary?: string;
1207
+ }
1208
+ interface StatusHistoryList {
1209
+ /**
1210
+ * The order status. This status symbolises the state of the user's payment
1211
+ * attempt. See [the guide](https://docs.getivy.de/docs/payment-status) for more
1212
+ * information.
1213
+ */
1214
+ currentStatus: 'failed' | 'canceled' | 'processing' | 'in_handshake' | 'waiting_for_payment' | 'paid' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'in_dispute' | 'disputed' | 'refused';
1215
+ reason: string;
1216
+ updatedAt: string;
1217
+ /**
1218
+ * The order status. This status symbolises the state of the user's payment
1219
+ * attempt. See [the guide](https://docs.getivy.de/docs/payment-status) for more
1220
+ * information.
1221
+ */
1222
+ previousStatus?: 'failed' | 'canceled' | 'processing' | 'in_handshake' | 'waiting_for_payment' | 'paid' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'in_dispute' | 'disputed' | 'refused' | null;
1223
+ }
1224
+ }
1225
+ export interface OrderRetrieveParams {
1226
+ id: string;
1227
+ }
1228
+ export interface OrderUpdateParams {
1229
+ id: string;
1230
+ /**
1231
+ * The customer-facing id of the order. This id will also be shown next to the
1232
+ * orders in the Ivy Dashboard.
1233
+ */
1234
+ displayId?: string;
1235
+ /**
1236
+ * An internal reference id which will be stored with the checkout & corresponding
1237
+ * order. Needs to be unique per shop per order and can be up to 200 characters. We
1238
+ * recommend to use your internal order id here.
1239
+ */
1240
+ referenceId?: string;
1241
+ /**
1242
+ * The customer-facing name of the shop.
1243
+ */
1244
+ shopName?: string;
1245
+ /**
1246
+ * The order status. This status symbolises the state of the user's payment
1247
+ * attempt. See [the guide](https://docs.getivy.de/docs/payment-status) for more
1248
+ * information.
1249
+ */
1250
+ status?: 'failed' | 'canceled' | 'processing' | 'in_handshake' | 'waiting_for_payment' | 'paid' | 'in_refund' | 'refunded' | 'refund_failed' | 'partially_refunded' | 'in_dispute' | 'disputed' | 'refused';
1251
+ }
1252
+ export declare namespace Orders {
1253
+ export { type OrderRetrieveResponse as OrderRetrieveResponse, type OrderUpdateResponse as OrderUpdateResponse, type OrderRetrieveParams as OrderRetrieveParams, type OrderUpdateParams as OrderUpdateParams, };
1254
+ }
1255
+ //# sourceMappingURL=orders.d.ts.map