chargebee 2.28.0 → 2.30.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 (54) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.yml +81 -0
  2. package/.github/ISSUE_TEMPLATE/config.yml +6 -0
  3. package/.github/ISSUE_TEMPLATE/feature_request.yml +34 -0
  4. package/.github/PULL_REQUEST_TEMPLATE.md +8 -0
  5. package/.github/workflows/greeting.yml +47 -0
  6. package/CHANGELOG.md +59 -0
  7. package/SECURITY.md +8 -0
  8. package/lib/chargebee.js +1 -1
  9. package/lib/resources/api_endpoints.js +0 -14
  10. package/package.json +1 -1
  11. package/types/core.d.ts +4 -4
  12. package/types/resources/AttachedItem.d.ts +88 -88
  13. package/types/resources/Card.d.ts +68 -68
  14. package/types/resources/Comment.d.ts +50 -44
  15. package/types/resources/Coupon.d.ts +242 -207
  16. package/types/resources/CouponSet.d.ts +72 -68
  17. package/types/resources/CreditNote.d.ts +612 -236
  18. package/types/resources/Customer.d.ts +655 -513
  19. package/types/resources/DifferentialPrice.d.ts +99 -74
  20. package/types/resources/EntitlementOverride.d.ts +27 -12
  21. package/types/resources/Estimate.d.ts +450 -450
  22. package/types/resources/Event.d.ts +30 -12
  23. package/types/resources/Export.d.ts +200 -200
  24. package/types/resources/Feature.d.ts +66 -35
  25. package/types/resources/Gift.d.ts +54 -44
  26. package/types/resources/HostedPage.d.ts +381 -381
  27. package/types/resources/InAppSubscription.d.ts +94 -90
  28. package/types/resources/Invoice.d.ts +1242 -660
  29. package/types/resources/Item.d.ts +148 -142
  30. package/types/resources/ItemEntitlement.d.ts +36 -36
  31. package/types/resources/ItemFamily.d.ts +45 -45
  32. package/types/resources/ItemPrice.d.ts +317 -273
  33. package/types/resources/PaymentIntent.d.ts +60 -60
  34. package/types/resources/PaymentReferenceNumber.d.ts +1 -1
  35. package/types/resources/PaymentVoucher.d.ts +74 -59
  36. package/types/resources/PortalSession.d.ts +45 -20
  37. package/types/resources/PromotionalCredit.d.ts +68 -68
  38. package/types/resources/Purchase.d.ts +3 -3
  39. package/types/resources/Quote.d.ts +655 -366
  40. package/types/resources/QuoteLineGroup.d.ts +245 -0
  41. package/types/resources/QuotedCharge.d.ts +170 -0
  42. package/types/resources/QuotedSubscription.d.ts +219 -0
  43. package/types/resources/SiteMigrationDetail.d.ts +7 -7
  44. package/types/resources/Subscription.d.ts +1219 -932
  45. package/types/resources/SubscriptionEntitlement.d.ts +33 -12
  46. package/types/resources/ThirdPartyPaymentMethod.d.ts +1 -1
  47. package/types/resources/TimeMachine.d.ts +15 -15
  48. package/types/resources/Token.d.ts +0 -116
  49. package/types/resources/Transaction.d.ts +229 -112
  50. package/types/resources/UnbilledCharge.d.ts +112 -67
  51. package/types/resources/Usage.d.ts +46 -47
  52. package/types/resources/VirtualBankAccount.d.ts +66 -66
  53. package/types/resources/Media.d.ts +0 -33
  54. package/types/resources/NonSubscription.d.ts +0 -65
@@ -114,72 +114,71 @@ If multiple [business entities](/docs/api/advanced-features#mbe) are created for
114
114
  checkout_one_time_for_items(input?:CheckoutOneTimeForItemsInputParam):ChargebeeRequest<CheckoutOneTimeForItemsResponse>;
115
115
 
116
116
  /**
117
- * @description **Note:** If you&#x27;re using [In-App Checkout](https://www.chargebee.com/docs/2.0/checkout.html), use [Manage Payment Sources API](/docs/api/hosted_pages#manage_payment_sources) to request your customers to update their payment method details or change their payment method.
117
+ * @description Create a Chargebee hosted page to accept payment details from a customer and checkout a new subscription.
118
118
 
119
- Using this API, you can request your customers to update their payment method details or change their payment method. This is used in scenarios like customers updating their payment methods before the end of trial or customers switching among payment methods.
119
+ The following steps describe how best to use this API:
120
120
 
121
- When this API is invoked, it returns a hosted page URL. When the customers are directed to this URL, they will be able to change/update their payment methods.
121
+ 1. Call this endpoint, providing [item prices](./item_prices?prod_cat_ver&#x3D;2), [coupons](./coupons?prod_cat_ver&#x3D;2) and a host of other details such as billing and shipping addresses to be prefilled for the customer on the checkout page.
122
+ 2. Send the customer to the Checkout &#x60;url&#x60; received in the response.
123
+ 3. Once they complete checkout, a new subscription is automatically created and the customer is redirected to the &#x60;redirect_url&#x60; with the &#x60;id&#x60; and &#x60;state&#x60; attributes passed as query string parameters.
124
+ Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons. Chargebee recommends listening to appropriate webhooks such as [subscription_created](./events#subscription_created) or [invoice_generated](./events#invoice_generated) to verify a successful checkout.
125
+ 4. [Retrieve the hosted page](./hosted_pages?prod_cat_ver&#x3D;2#retrieve_a_hosted_page) at this stage to get the subscription and invoice details.
122
126
 
123
- Depending on the payment methods (Card, PayPal Express Checkout, Amazon Payments) that you offer your customers, they will find options to switch among the various methods of payment.
124
- **Note:**
125
127
 
126
- * If the card\[gateway\] parameter is passed, and the customer chooses Card as a payment method, then the card details are stored in the gateway which is passed. However, if the card\[gateway\] parameter is passed and the customer chooses PayPal Express Checkout/Amazon Payments as a payment method, the gateway passed will be ignored.
127
- * The option of embedding into an iframe is not supported for PayPal Express Checkout and Amazon Payments as customers are redirected to the respective website pages. Hence if you have PayPal Express Checkout/Amazon Payments configured and pass the parameter embed&#x3D;true, this will result in an unsuccessful API request. Also, if you have all the three payment methods (Card, Paypal Express Checkout and Amazon Payments) configured and pass the parameter embed&#x3D;true, the returned hosted page URL will show only Card Payment as a payment method.
128
128
 
129
- */
130
-
131
- update_payment_method(input?:UpdatePaymentMethodInputParam):ChargebeeRequest<UpdatePaymentMethodResponse>;
132
-
133
- /**
134
- * @description This API generates a hosted page URL to extend the billing cycle of a subscription.
129
+ #### Customer resource lookup and creation {#customer_lookup2}
135
130
 
136
- */
137
-
138
- extend_subscription(input?:ExtendSubscriptionInputParam):ChargebeeRequest<ExtendSubscriptionResponse>;
139
-
140
- /**
141
- * @description Use this API to notify Chargebee about important events that occur on your web pages, such as subscription cancellations. An event contains data about affected resources and additional details such as when the change occurred.
131
+ When the [customer[id]](/docs/api/hosted_pages#create_checkout_for_a_new_subscription_customer_id) parameter is provided and if a customer resource with the ID is found to be already created in Chargebee, the subscription is created under that customer resource. If not found, then a new customer resource is created with the ID provided and the subscription is created under it.
132
+
133
+ ##### Multiple business entities
134
+
135
+ If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) are created for the site, the customer resource lookup and creation happen within the [context](/docs/api/advanced-features#mbe-context) of the business entity [specified](/docs/api/advanced-features#mbe-header-main) in this API call. If no business entity is specified, the customer resource lookup is performed within the [site context](/docs/api/advanced-features#mbe-context), and if not found, the resource is created for the [default business entity](/docs/api/advanced-features#mbe-default-be) of the site.
142
136
 
143
137
  */
144
138
 
145
- events(input:EventsInputParam):ChargebeeRequest<EventsResponse>;
139
+ checkout_new_for_items(input?:CheckoutNewForItemsInputParam):ChargebeeRequest<CheckoutNewForItemsResponse>;
146
140
 
147
141
  /**
148
- * @description Creates a hosted page for a customer (called the gifter) to gift a subscription to another customer (called the receiver).
149
-
150
- #### Gifter customer resource lookup and creation {#gifter_lookup}
151
-
152
- When [gifter[customer_id]](/docs/api/hosted_pages#checkout_gift_subscription_for_items_gifter_customer_id) is provided, it is looked up in Chargebee when the gifter completes the hosted page checkout. If not found, a new customer resource is created with this ID.
153
-
154
- ##### Multiple business entities
142
+ * @description Create a Chargebee hosted page to accept payment details from a customer and checkout to update the subscription.
155
143
 
156
- If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) are created for the site, the lookup and creation of the gifter customer resource happen within the [context](/docs/api/advanced-features#mbe-context) of the business entity specified in this API call. If no business entity is [specified](/docs/api/advanced-features#mbe-header-main), the customer resource lookup is performed within the [site context](/docs/api/advanced-features#mbe-context), and if not found, the resource is created for the [default business entity](/docs/api/advanced-features#mbe-default-be) of the site.
144
+ The following steps describe how best to use this API:
157
145
 
158
- #### Gift receiver customer resource lookup and creation {#receiver_lookup}
146
+ 1. Provide [item prices](./item_prices?prod_cat_ver&#x3D;2), [coupons](./coupons?prod_cat_ver&#x3D;2) and a host of other details such as billing and shipping addresses to be prefilled for the customer on the checkout page.
147
+ 2. Send the customer to the Checkout &#x60;url&#x60; received in the response. They can now add a payment method or use an existing one, to complete the checkout.
148
+ 3. The subscription is updated and the customer is redirected to the &#x60;redirect_url&#x60; with the &#x60;id&#x60; and &#x60;state&#x60; attributes passed as query string parameters.
149
+ Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons. Chargebee recommends listening to appropriate webhooks such as [subscription_created](./events#subscription_created) or [invoice_generated](./events#invoice_generated) to verify a successful checkout.
150
+ 4. [Retrieve the hosted page](./hosted_pages?prod_cat_ver&#x3D;2#retrieve_a_hosted_page) at this stage to get the subscription and invoice details.
159
151
 
160
- Once the gifter checks out using the hosted page returned by this endpoint, Chargebee checks if a customer resource with the receiver&#x27;s email address exists. The first such customer record is considered the receiver&#x27;s customer resource. A new customer resource is created for the receiver if none are found.
161
152
 
162
- ##### Multiple business entities
163
153
 
164
- If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) are created for the site, the lookup and creation of the gift receiver&#x27;s customer resource happen within the [context](/docs/api/advanced-features#mbe-context) of the business entity of the gifter
165
154
 
166
155
  */
167
156
 
168
- checkout_gift_for_items(input?:CheckoutGiftForItemsInputParam):ChargebeeRequest<CheckoutGiftForItemsResponse>;
157
+ checkout_existing_for_items(input?:CheckoutExistingForItemsInputParam):ChargebeeRequest<CheckoutExistingForItemsResponse>;
169
158
 
170
159
  /**
171
- * @description This API retrieves the list of hosted page resources.
160
+ * @description **Note:** If you&#x27;re using [In-App Checkout](https://www.chargebee.com/docs/2.0/checkout.html), use [Manage Payment Sources API](/docs/api/hosted_pages#manage_payment_sources) to request your customers to update their payment method details or change their payment method.
161
+
162
+ Using this API, you can request your customers to update their payment method details or change their payment method. This is used in scenarios like customers updating their payment methods before the end of trial or customers switching among payment methods.
163
+
164
+ When this API is invoked, it returns a hosted page URL. When the customers are directed to this URL, they will be able to change/update their payment methods.
165
+
166
+ Depending on the payment methods (Card, PayPal Express Checkout, Amazon Payments) that you offer your customers, they will find options to switch among the various methods of payment.
167
+ **Note:**
168
+
169
+ * If the card\[gateway\] parameter is passed, and the customer chooses Card as a payment method, then the card details are stored in the gateway which is passed. However, if the card\[gateway\] parameter is passed and the customer chooses PayPal Express Checkout/Amazon Payments as a payment method, the gateway passed will be ignored.
170
+ * The option of embedding into an iframe is not supported for PayPal Express Checkout and Amazon Payments as customers are redirected to the respective website pages. Hence if you have PayPal Express Checkout/Amazon Payments configured and pass the parameter embed&#x3D;true, this will result in an unsuccessful API request. Also, if you have all the three payment methods (Card, Paypal Express Checkout and Amazon Payments) configured and pass the parameter embed&#x3D;true, the returned hosted page URL will show only Card Payment as a payment method.
172
171
 
173
172
  */
174
173
 
175
- list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
174
+ update_payment_method(input?:UpdatePaymentMethodInputParam):ChargebeeRequest<UpdatePaymentMethodResponse>;
176
175
 
177
176
  /**
178
- * @description Creates a &#x60;hosted_page&#x60; resource of type, &#x60;view_voucher&#x60;. When your end customers choose the Boleto payment method, you can generate a voucher for their pending invoice. Using this API, you can create a voucher_detail hosted page for your customers and email them a link to this hosted page. Your customers can review the voucher details on the page by clicking the link in the email.
177
+ * @description This API generates a hosted page URL to add new or update existing payment sources for the customer.
179
178
 
180
179
  */
181
180
 
182
- view_voucher(input?:ViewVoucherInputParam):ChargebeeRequest<ViewVoucherResponse>;
181
+ manage_payment_sources(input?:ManagePaymentSourcesInputParam):ChargebeeRequest<ManagePaymentSourcesResponse>;
183
182
 
184
183
  /**
185
184
  * @description This API generates a hosted page URL to collect due payments for the customer.
@@ -196,29 +195,34 @@ If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#
196
195
  accept_quote(input?:AcceptQuoteInputParam):ChargebeeRequest<AcceptQuoteResponse>;
197
196
 
198
197
  /**
199
- * @description Create a Chargebee hosted page to accept payment details from a customer and checkout a new subscription.
198
+ * @description This API generates a hosted page URL to extend the billing cycle of a subscription.
200
199
 
201
- The following steps describe how best to use this API:
200
+ */
201
+
202
+ extend_subscription(input?:ExtendSubscriptionInputParam):ChargebeeRequest<ExtendSubscriptionResponse>;
203
+
204
+ /**
205
+ * @description Creates a hosted page for a customer (called the gifter) to gift a subscription to another customer (called the receiver).
202
206
 
203
- 1. Call this endpoint, providing [item prices](./item_prices?prod_cat_ver&#x3D;2), [coupons](./coupons?prod_cat_ver&#x3D;2) and a host of other details such as billing and shipping addresses to be prefilled for the customer on the checkout page.
204
- 2. Send the customer to the Checkout &#x60;url&#x60; received in the response.
205
- 3. Once they complete checkout, a new subscription is automatically created and the customer is redirected to the &#x60;redirect_url&#x60; with the &#x60;id&#x60; and &#x60;state&#x60; attributes passed as query string parameters.
206
- Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons. Chargebee recommends listening to appropriate webhooks such as [subscription_created](./events#subscription_created) or [invoice_generated](./events#invoice_generated) to verify a successful checkout.
207
- 4. [Retrieve the hosted page](./hosted_pages?prod_cat_ver&#x3D;2#retrieve_a_hosted_page) at this stage to get the subscription and invoice details.
207
+ #### Gifter customer resource lookup and creation {#gifter_lookup}
208
208
 
209
+ When [gifter[customer_id]](/docs/api/hosted_pages#checkout_gift_subscription_for_items_gifter_customer_id) is provided, it is looked up in Chargebee when the gifter completes the hosted page checkout. If not found, a new customer resource is created with this ID.
209
210
 
211
+ ##### Multiple business entities
210
212
 
211
- #### Customer resource lookup and creation {#customer_lookup2}
213
+ If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) are created for the site, the lookup and creation of the gifter customer resource happen within the [context](/docs/api/advanced-features#mbe-context) of the business entity specified in this API call. If no business entity is [specified](/docs/api/advanced-features#mbe-header-main), the customer resource lookup is performed within the [site context](/docs/api/advanced-features#mbe-context), and if not found, the resource is created for the [default business entity](/docs/api/advanced-features#mbe-default-be) of the site.
212
214
 
213
- When the [customer[id]](/docs/api/hosted_pages#create_checkout_for_a_new_subscription_customer_id) parameter is provided and if a customer resource with the ID is found to be already created in Chargebee, the subscription is created under that customer resource. If not found, then a new customer resource is created with the ID provided and the subscription is created under it.
215
+ #### Gift receiver customer resource lookup and creation {#receiver_lookup}
216
+
217
+ Once the gifter checks out using the hosted page returned by this endpoint, Chargebee checks if a customer resource with the receiver&#x27;s email address exists. The first such customer record is considered the receiver&#x27;s customer resource. A new customer resource is created for the receiver if none are found.
214
218
 
215
219
  ##### Multiple business entities
216
220
 
217
- If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) are created for the site, the customer resource lookup and creation happen within the [context](/docs/api/advanced-features#mbe-context) of the business entity [specified](/docs/api/advanced-features#mbe-header-main) in this API call. If no business entity is specified, the customer resource lookup is performed within the [site context](/docs/api/advanced-features#mbe-context), and if not found, the resource is created for the [default business entity](/docs/api/advanced-features#mbe-default-be) of the site.
221
+ If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) are created for the site, the lookup and creation of the gift receiver&#x27;s customer resource happen within the [context](/docs/api/advanced-features#mbe-context) of the business entity of the gifter
218
222
 
219
223
  */
220
224
 
221
- checkout_new_for_items(input?:CheckoutNewForItemsInputParam):ChargebeeRequest<CheckoutNewForItemsResponse>;
225
+ checkout_gift_for_items(input?:CheckoutGiftForItemsInputParam):ChargebeeRequest<CheckoutGiftForItemsResponse>;
222
226
 
223
227
  /**
224
228
  * @description This API generates a hosted page URL to claim a gifted subscription.
@@ -228,30 +232,15 @@ If multiple [business entities](/docs/api/advanced-features?prod_cat_ver&#x3D;2#
228
232
  claim_gift(input?:ClaimGiftInputParam):ChargebeeRequest<ClaimGiftResponse>;
229
233
 
230
234
  /**
231
- * @description Create a Chargebee hosted page to accept payment details from a customer and checkout to update the subscription.
232
-
233
- The following steps describe how best to use this API:
234
-
235
- 1. Provide [item prices](./item_prices?prod_cat_ver&#x3D;2), [coupons](./coupons?prod_cat_ver&#x3D;2) and a host of other details such as billing and shipping addresses to be prefilled for the customer on the checkout page.
236
- 2. Send the customer to the Checkout &#x60;url&#x60; received in the response. They can now add a payment method or use an existing one, to complete the checkout.
237
- 3. The subscription is updated and the customer is redirected to the &#x60;redirect_url&#x60; with the &#x60;id&#x60; and &#x60;state&#x60; attributes passed as query string parameters.
238
- Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons. Chargebee recommends listening to appropriate webhooks such as [subscription_created](./events#subscription_created) or [invoice_generated](./events#invoice_generated) to verify a successful checkout.
239
- 4. [Retrieve the hosted page](./hosted_pages?prod_cat_ver&#x3D;2#retrieve_a_hosted_page) at this stage to get the subscription and invoice details.
240
-
241
-
235
+ * @description This is applicable only for Direct Debit via SEPA, Bacs, Bg Autogiro, BECS (for both Australia and New Zealand) and PAD. For Direct Debit, the customer needs to accept an agreement that allows the merchant to debit their bank account. This agreement PDF allows you to easily display scheme-rules compliant Direct Debit mandates to your customers.
242
236
 
237
+ This API retrieves the redirect link to the corresponding agreement for customers. The agreement PDF can be your &quot;Thank You&quot; page or sent by email to customers. Communicating this PDF to your customers is mandatory.
243
238
 
244
- */
245
-
246
- checkout_existing_for_items(input?:CheckoutExistingForItemsInputParam):ChargebeeRequest<CheckoutExistingForItemsResponse>;
247
-
248
- /**
249
- * @description Creates a &#x60;hosted_page&#x60; resource of &#x60;type&#x60; &#x60;pre_cancel&#x60;. Route canceling users to this page to provide them a retention experience and start saving revenue.
250
- The hosted page is created in accordance with the retention experience [configured in the Chargebee Retention app](https://help.brightback.com/article/239-steps-to-get-brightback-ready-to-launch-for-chargebee-billing-merchants), along with the data provided as input to this endpoint. Call the endpoint before your customer clicks the **Cancel** button, and when they do, route them to the [url](https://apidocs.chargebee.com/docs/api/hosted_pages#hosted_page_url) in the endpoint response.
239
+ Customer locale is used to generate the PDF in the required language. If a customer language is not supported, the PDF is generated in English. Checkout the [list of languages](https://developer.gocardless.com/api-reference/#mandate-pdfs-create-a-mandate-pdf) supported by GoCardless.
251
240
 
252
241
  */
253
242
 
254
- pre_cancel(input?:PreCancelInputParam):ChargebeeRequest<PreCancelResponse>;
243
+ retrieve_agreement_pdf(input:RetrieveAgreementPdfInputParam):ChargebeeRequest<RetrieveAgreementPdfResponse>;
255
244
 
256
245
  /**
257
246
  * @description When a hosted page is successfully completed by the user and processed by Chargebee, its [&#x60;state&#x60;](hosted_pages#hosted_page_state) is automatically changed to &#x60;succeeded&#x60;. Acknowledging a hosted page confirms that you have moved the customer details from Chargebee into your system and are ready to fulfill it. This API is used to acknowledge the hosted page in &#x60;succeeded&#x60; state and change its state to &#x60;acknowledged&#x60;.
@@ -262,17 +251,6 @@ The hosted page is created in accordance with the retention experience [configur
262
251
 
263
252
  acknowledge(hosted_page_id:string):ChargebeeRequest<AcknowledgeResponse>;
264
253
 
265
- /**
266
- * @description This is applicable only for Direct Debit via SEPA, Bacs, Bg Autogiro, BECS (for both Australia and New Zealand) and PAD. For Direct Debit, the customer needs to accept an agreement that allows the merchant to debit their bank account. This agreement PDF allows you to easily display scheme-rules compliant Direct Debit mandates to your customers.
267
-
268
- This API retrieves the redirect link to the corresponding agreement for customers. The agreement PDF can be your &quot;Thank You&quot; page or sent by email to customers. Communicating this PDF to your customers is mandatory.
269
-
270
- Customer locale is used to generate the PDF in the required language. If a customer language is not supported, the PDF is generated in English. Checkout the [list of languages](https://developer.gocardless.com/api-reference/#mandate-pdfs-create-a-mandate-pdf) supported by GoCardless.
271
-
272
- */
273
-
274
- retrieve_agreement_pdf(input:RetrieveAgreementPdfInputParam):ChargebeeRequest<RetrieveAgreementPdfResponse>;
275
-
276
254
  /**
277
255
  * @description When you retrieve a hosted page whose &#x60;status&#x60; is &#x60;successful&#x60;, the &#x60;content&#x60; attribute has the following objects based on the &#x60;type&#x60; of the hosted page.
278
256
 
@@ -290,11 +268,33 @@ Customer locale is used to generate the PDF in the required language. If a custo
290
268
  retrieve(hosted_page_id:string):ChargebeeRequest<RetrieveResponse>;
291
269
 
292
270
  /**
293
- * @description This API generates a hosted page URL to add new or update existing payment sources for the customer.
271
+ * @description This API retrieves the list of hosted page resources.
294
272
 
295
273
  */
296
274
 
297
- manage_payment_sources(input?:ManagePaymentSourcesInputParam):ChargebeeRequest<ManagePaymentSourcesResponse>;
275
+ list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
276
+
277
+ /**
278
+ * @description Creates a &#x60;hosted_page&#x60; resource of &#x60;type&#x60; &#x60;pre_cancel&#x60;. Route canceling users to this page to provide them a retention experience and start saving revenue.
279
+ The hosted page is created in accordance with the retention experience [configured in the Chargebee Retention app](https://help.brightback.com/article/239-steps-to-get-brightback-ready-to-launch-for-chargebee-billing-merchants), along with the data provided as input to this endpoint. Call the endpoint before your customer clicks the **Cancel** button, and when they do, route them to the [url](https://apidocs.chargebee.com/docs/api/hosted_pages#hosted_page_url) in the endpoint response.
280
+
281
+ */
282
+
283
+ pre_cancel(input?:PreCancelInputParam):ChargebeeRequest<PreCancelResponse>;
284
+
285
+ /**
286
+ * @description Use this API to notify Chargebee about important events that occur on your web pages, such as subscription cancellations. An event contains data about affected resources and additional details such as when the change occurred.
287
+
288
+ */
289
+
290
+ events(input:EventsInputParam):ChargebeeRequest<EventsResponse>;
291
+
292
+ /**
293
+ * @description Creates a &#x60;hosted_page&#x60; resource of type, &#x60;view_voucher&#x60;. When your end customers choose the Boleto payment method, you can generate a voucher for their pending invoice. Using this API, you can create a voucher_detail hosted page for your customers and email them a link to this hosted page. Your customers can review the voucher details on the page by clicking the link in the email.
294
+
295
+ */
296
+
297
+ view_voucher(input?:ViewVoucherInputParam):ChargebeeRequest<ViewVoucherResponse>;
298
298
  }
299
299
  export interface CheckoutOneTimeForItemsResponse {
300
300
  hosted_page:HostedPage;
@@ -446,10 +446,65 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
446
446
 
447
447
  entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
448
448
  }
449
- export interface UpdatePaymentMethodResponse {
449
+ export interface CheckoutNewForItemsResponse {
450
450
  hosted_page:HostedPage;
451
451
  }
452
- export interface UpdatePaymentMethodInputParam {
452
+ export interface CheckoutNewForItemsInputParam {
453
+
454
+ /**
455
+ * @description Specifies the checkout layout that overrides the default checkout layout configured in the Checkout \&amp; Self-Serve Portal settings. . \* in_app - Indicates in-app checkout version \* full_page - Indicates full page checkout version
456
+
457
+ */
458
+
459
+ layout?:Layout;
460
+
461
+ /**
462
+ * @description Sets the [context]() for this operation to the [business entity](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) specified. Applicable only when multiple business entities have been created for the site. When this parameter is provided, the operation is able to read/write data associated only to the business entity specified. When not provided, the operation can read/write data for the entire site.
463
+ **Note**
464
+
465
+ An alternative way of passing this parameter is by means of a [custom HTTP header](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-header-main).
466
+ **See also**
467
+
468
+ [Customer resource lookup and creation.](/docs/api/hosted_pages#customer_lookup2)
469
+
470
+ */
471
+
472
+ business_entity_id?:string;
473
+
474
+ /**
475
+ * @description The number of billing cycles the subscription runs before canceling. If not provided, then the billing cycles [set for the plan-item price](https://apidocs.chargebee.com/docs/api/item_prices?prod_cat_ver&#x3D;2#item_price_billing_cycles) is used.
476
+
477
+ */
478
+
479
+ billing_cycles?:number;
480
+
481
+ /**
482
+ * @description Item ids of [mandatorily attached addons](./attached_items?prod_cat_ver&#x3D;2) that are to be removed from the subscription.
483
+
484
+ */
485
+
486
+ mandatory_items_to_remove?:string[];
487
+
488
+ /**
489
+ * @description The number of subscription billing cycles (including the first one) to [invoice in advance](https://www.chargebee.com/docs/advance-invoices.html).
490
+
491
+ */
492
+
493
+ terms_to_charge?:number;
494
+
495
+ /**
496
+ * @description Override the [billing alignment mode](https://www.chargebee.com/docs/calendar-billing.html#alignment-of-billing-date) for Calendar Billing. Only applicable when using Calendar Billing. The default value is that which has been configured for the site. \* immediate - Subscription period will be aligned with the configured billing date immediately, with credits or charges raised accordingly.. \* delayed - Subscription period will be aligned with the configured billing date at the next renewal.
497
+
498
+ */
499
+
500
+ billing_alignment_mode?:BillingAlignmentMode;
501
+
502
+ /**
503
+ * @description List of coupons to be applied to this subscription. You can provide coupon ids or [coupon codes](https://apidocs.chargebee.com/docs/api/coupon_codes).
504
+
505
+ */
506
+
507
+ coupon_ids?:string[];
453
508
 
454
509
  /**
455
510
  * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
@@ -486,20 +541,25 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
486
541
  pass_thru_content?:string;
487
542
 
488
543
  /**
489
- * @description If true then iframe will communicate with the parent window. Applicable only for embedded(iframe) hosted pages. If you&#x27;re using iframe_messaging you need to implement onSuccess \&amp; onCancel callbacks.
544
+ * @description Allow the customer to select an offline payment method during checkout. The choice of payment methods can be configured via the Chargebee UI.
490
545
 
491
- **Note** : This parameter is not applicable for [in-app](https://www.chargebee.com/docs/checkout-v3.html) checkout.
546
+ */
547
+
548
+ allow_offline_payment_methods?:boolean;
549
+
550
+ /**
551
+ * @description Parameters for subscription
492
552
 
493
553
  */
494
554
 
495
- iframe_messaging?:boolean;
555
+ subscription?:object;
496
556
 
497
557
  /**
498
558
  * @description Parameters for customer
499
559
 
500
560
  */
501
561
 
502
- customer?:{id:string};
562
+ customer?:object;
503
563
 
504
564
  /**
505
565
  * @description Parameters for card
@@ -507,311 +567,253 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
507
567
  */
508
568
 
509
569
  card?:{gateway_account_id?:string};
510
- }
511
- export interface ExtendSubscriptionResponse {
512
- hosted_page:HostedPage;
513
- }
514
- export interface ExtendSubscriptionInputParam {
515
570
 
516
571
  /**
517
- * @description Expiry (in days) for the link generated. No expiry will be set if this is not specified.
572
+ * @description Parameters for billing_address
518
573
 
519
574
  */
520
575
 
521
- expiry?:number;
576
+ billing_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
522
577
 
523
578
  /**
524
- * @description Number of billing cycles to extend. If not specified, plan&#x27;s billing cycle will be used.
579
+ * @description Parameters for shipping_address
525
580
 
526
581
  */
527
582
 
528
- billing_cycle?:number;
583
+ shipping_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
529
584
 
530
585
  /**
531
- * @description Parameters for subscription
586
+ * @description Parameters for contract_term
532
587
 
533
588
  */
534
589
 
535
- subscription?:{id:string};
536
- }
537
- export interface EventsResponse {
538
- success:boolean;
539
- }
540
- export interface EventsInputParam {
590
+ contract_term?:{action_at_term_end?:'cancel' | 'renew' | 'evergreen',cancellation_cutoff_period?:number};
541
591
 
542
592
  /**
543
- * @description null
593
+ * @description Parameters for subscription_items
544
594
 
545
595
  */
546
596
 
547
- event_name:EventName;
597
+ subscription_items?:{billing_cycles?:number,charge_on_event?:ChargeOnEvent,charge_on_option?:ChargeOnOption,charge_once?:boolean,item_price_id:string,quantity?:number,quantity_in_decimal?:string,service_period_days?:number,trial_end?:number,unit_price?:number,unit_price_in_decimal?:string}[];
548
598
 
549
599
  /**
550
- * @description Timestamp indicating when this event had occurred. .
600
+ * @description Parameters for discounts
551
601
 
552
602
  */
553
603
 
554
- occurred_at?:number;
604
+ discounts?:{amount?:number,apply_on:ApplyOn,duration_type:DurationType,included_in_mrr?:boolean,item_price_id?:string,percentage?:number,period?:number,period_unit?:PeriodUnit}[];
555
605
 
556
606
  /**
557
- * @description The meta data description of the event in key-value pair. The value is a JSON object with the following keys and their values.
607
+ * @description Parameters for item_tiers
558
608
 
559
- * &#x60;subscription_id&#x60;: A unique and immutable identifier for the subscription.
560
- .
609
+ */
610
+
611
+ item_tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,item_price_id?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
612
+
613
+ /**
614
+ * @description Parameters for entity_identifiers
561
615
 
562
616
  */
563
617
 
564
- event_data:object;
618
+ entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
565
619
  }
566
- export interface CheckoutGiftForItemsResponse {
620
+ export interface CheckoutExistingForItemsResponse {
567
621
  hosted_page:HostedPage;
568
622
  }
569
- export interface CheckoutGiftForItemsInputParam {
623
+ export interface CheckoutExistingForItemsInputParam {
570
624
 
571
625
  /**
572
- * @description Sets the [context]() for this operation to the [business entity](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) specified. Applicable only when multiple business entities have been created for the site. When this parameter is provided, the operation is able to read/write data associated only to the business entity specified. When not provided, the operation can read/write data for the entire site.
573
- **Note**
574
-
575
- An alternative way of passing this parameter is by means of a [custom HTTP header](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-header-main).
576
- **See also**
577
-
578
- Gifter customer resource lookup and creation.
626
+ * @description Specifies the checkout layout that overrides the default checkout layout configured in the Checkout \&amp; Self-Serve Portal settings. . \* in_app - Indicates in-app checkout version \* full_page - Indicates full page checkout version
579
627
 
580
628
  */
581
629
 
582
- business_entity_id?:string;
630
+ layout?:Layout;
583
631
 
584
632
  /**
585
- * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
586
-
587
- **Note** :
588
-
589
- * Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons such as user closing the tab, or exiting the browser, and so on. If there is any synchronization that you are doing after the redirection, you will have to have a backup. Chargebee recommends listening to appropriate webhooks such as [&#x60;subscription_created&#x60;](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [&#x60;invoice_generated&#x60;](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
590
- * Redirect URL configured in Settings \&gt; Hosted Pages Settings would be overriden by this redirect URL.
591
- * *Eg :* *http://yoursite.com?id&#x3D;* *\&lt;hosted_page_id\&gt;\&amp;state&#x3D;succeeded*
592
- * This parameter is not applicable for iframe messaging.
633
+ * @description Item ids of [mandatorily attached addons](./attached_items?prod_cat_ver&#x3D;2) that are to be removed from the subscription.
593
634
 
594
635
  */
595
636
 
596
- redirect_url?:string;
637
+ mandatory_items_to_remove?:string[];
597
638
 
598
639
  /**
599
- * @description List of coupons to be applied to this subscription. You can provide coupon ids or [coupon codes](https://apidocs.chargebee.com/docs/api/coupon_codes).
640
+ * @description If &#x60;true&#x60; then the existing &#x60;subscription_items&#x60; list for the subscription is replaced by the one provided. If &#x60;false&#x60; then the provided &#x60;subscription_items&#x60; list gets added to the existing list.
600
641
 
601
642
  */
602
643
 
603
- coupon_ids?:string[];
644
+ replace_items_list?:boolean;
604
645
 
605
646
  /**
606
- * @description Parameters for gifter
647
+ * @description The document date displayed on the invoice PDF. The default value is the current date. Provide this value to backdate the invoice. Backdating an invoice is done for reasons such as booking revenue for a previous date or when the subscription is effective as of a past date. Moreover, if &#x60;create_pending_invoices&#x60; is set to &#x60;true&#x60;, and if the site is configured to set invoice dates to date of closing, then upon invoice closure, this date is changed to the invoice closing date. taxes and line_item_taxes are computed based on the tax configuration as of &#x60;invoice_date&#x60;. When passing this parameter, the following prerequisites must be met:
648
+
649
+ * &#x60;invoice_date&#x60; must be in the past.
650
+ * &#x60;invoice_date&#x60; is not more than one calendar month into the past. For example, if today is 13th January, then you cannot pass a value that is earlier than 13th December.
651
+ * It is not earlier than &#x60;changes_scheduled_at&#x60;, &#x60;reactivate_from&#x60;, or &#x60;trial_end&#x60;.
652
+ * &#x60;invoice_immediately&#x60; is &#x60;true&#x60;.
653
+ .
607
654
 
608
655
  */
609
656
 
610
- gifter?:{customer_id?:string,locale?:string};
657
+ invoice_date?:number;
611
658
 
612
659
  /**
613
- * @description Parameters for subscription_items
660
+ * @description Billing cycles set for plan-item price is used by default.
614
661
 
615
662
  */
616
663
 
617
- subscription_items?:{item_price_id?:string,quantity?:number,quantity_in_decimal?:string}[];
618
- }
619
- export interface ListResponse {
664
+ billing_cycles?:number;
665
+
620
666
  /**
621
- * @description This API retrieves the list of hosted page resources.
667
+ * @description The number of subscription billing cycles to [invoice in advance](https://www.chargebee.com/docs/advance-invoices.html). If a new term is started for the subscription due to this API call, then &#x60;terms_to_charge&#x60; is inclusive of this new term. See description for the &#x60;force_term_reset&#x60; parameter to learn more about when a subscription term is reset.
622
668
 
623
669
  */
624
670
 
625
- list:{hosted_page:HostedPage}[];
671
+ terms_to_charge?:number;
626
672
 
627
673
  /**
628
- * @description This API retrieves the list of hosted page resources.
674
+ * @description If the subscription &#x60;status&#x60; is &#x60;cancelled&#x60; and it is being reactivated via this operation, this is the date/time at which the subscription should be reactivated.
675
+ **Note:** It is recommended not to pass this parameter along with &#x60;changed_scheduled_at&#x60;. &#x60;reactivate_from&#x60; can be backdated (set to a value in the past). Use backdating when the subscription has been reactivated already but its billing has been delayed. Backdating is allowed only when the following prerequisites are met:
629
676
 
630
- */
631
-
632
- next_offset?:string;
633
- }
634
- export interface ListInputParam {
635
- [key : string]: any;
636
- /**
637
- * @description The number of resources to be returned.
677
+ * Backdating must be enabled for subscription reactivation operations.
678
+ * The current day of the month does not exceed the limit set in Chargebee for backdating subscription change. This limit is the day of the month by which the accounting for the previous month must be closed.
679
+ * The date is on or after the last date/time any of the product catalog items of the subscription were changed.
680
+ * The date is not more than duration X into the past where X is the billing period of the plan. For example, if the period of the plan in the subscription is 2 months and today is 14th April, &#x60;changes_scheduled_at&#x60; cannot be earlier than 14th February.
681
+ .
638
682
 
639
683
  */
640
-
641
- limit?:number;
642
684
 
643
- /**
644
- * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
645
-
646
- */
647
-
648
- offset?:string;
685
+ reactivate_from?:number;
649
686
 
650
687
  /**
651
- * @description Unique identifier generated for each hosted page requested.
688
+ * @description Override the [billing alignment mode](https://www.chargebee.com/docs/calendar-billing.html#alignment-of-billing-date) chosen for the site for calendar billing. Only applicable when using calendar billing. \* immediate - Subscription period will be aligned with the configured billing date immediately, with credits or charges raised accordingly.. \* delayed - Subscription period will be aligned with the configured billing date at the next renewal.
652
689
 
653
690
  */
654
-
655
- id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
656
691
 
657
- /**
658
- * @description Type of the requested hosted page.
659
-
660
- */
661
-
662
- type?:{in?:string,is?:'update_payment_method' | 'checkout_one_time' | 'manage_payment_sources' | 'checkout_new' | 'view_voucher' | 'collect_now' | 'checkout_existing' | 'extend_subscription' | 'pre_cancel',is_not?:'update_payment_method' | 'checkout_one_time' | 'manage_payment_sources' | 'checkout_new' | 'view_voucher' | 'collect_now' | 'checkout_existing' | 'extend_subscription' | 'pre_cancel',not_in?:string};
692
+ billing_alignment_mode?:BillingAlignmentMode;
663
693
 
664
694
  /**
665
- * @description Indicating the current state of the hosted page resource.
695
+ * @description List of coupons to be applied to this subscription. You can provide coupon ids or [coupon codes](https://apidocs.chargebee.com/docs/api/coupon_codes).
666
696
 
667
697
  */
668
-
669
- state?:{in?:string,is?:'requested' | 'acknowledged' | 'created' | 'cancelled' | 'succeeded',is_not?:'requested' | 'acknowledged' | 'created' | 'cancelled' | 'succeeded',not_in?:string};
670
698
 
671
- /**
672
- * @description Timestamp indicating when this hosted page was last updated.
673
-
674
- */
675
-
676
- updated_at?:{after?:string,before?:string,between?:string,on?:string};
677
- }
678
- export interface ViewVoucherResponse {
679
- hosted_page:HostedPage;
680
- }
681
- export interface ViewVoucherInputParam {
699
+ coupon_ids?:string[];
682
700
 
683
701
  /**
684
- * @description Parameters for payment_voucher
702
+ * @description Applicable only for &#x60;cancelled&#x60; subscriptions. When passed as &#x60;true&#x60;, the canceled subscription is activated; otherwise subscription changes are made without changing its &#x60;status&#x60;. If not passed, subscription will be activated only if &#x60;subscription_items&#x60; is passed.
685
703
 
686
704
  */
687
705
 
688
- payment_voucher?:{id:string};
706
+ reactivate?:boolean;
689
707
 
690
708
  /**
691
- * @description Parameters for customer
709
+ * @description Say the subscription has the renewal date as 28th of every month. When the plan-item price of the subscription is set to one that has the same billing period as the current plan-item price, the subscription change does not change the term. In other words, the subscription still renews on the 28th. Passing this parameter as &#x60;true&#x60; will have the subscription reset its term to the current date (provided &#x60;end_of_term&#x60; is false).
710
+ **Note**: When the new plan-item price has a billing period different from the current plan-item price of the subscription, the term is always reset, regardless of the value passed for this parameter.
692
711
 
693
712
  */
694
713
 
695
- customer?:{locale?:string};
696
- }
697
- export interface CollectNowResponse {
698
- hosted_page:HostedPage;
699
- }
700
- export interface CollectNowInputParam {
714
+ force_term_reset?:boolean;
701
715
 
702
716
  /**
703
- * @description Used to specify the destination URL to which a user is redirected after invoices are paid. The [transaction ID](/docs/api/transactions#transaction_id) of the transactions made through the Pay Now hosted page will be sent as return variables along with the URL.
717
+ * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
718
+
719
+ **Note** :
720
+
721
+ * Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons such as user closing the tab, or exiting the browser, and so on. If there is any synchronization that you are doing after the redirection, you will have to have a backup. Chargebee recommends listening to appropriate webhooks such as [&#x60;subscription_created&#x60;](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [&#x60;invoice_generated&#x60;](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
722
+ * Redirect URL configured in Settings \&gt; Hosted Pages Settings would be overriden by this redirect URL.
723
+ * *Eg :* *http://yoursite.com?id&#x3D;* *\&lt;hosted_page_id\&gt;\&amp;state&#x3D;succeeded*
724
+ * This parameter is not applicable for iframe messaging.
704
725
 
705
726
  */
706
727
 
707
728
  redirect_url?:string;
708
729
 
709
730
  /**
710
- * @description The currency code (ISO 4217 format) of the specified *credit amount*.
731
+ * @description The customers will be redirected to this URL upon canceling checkout. The hosted page id and state will be passed as parameters to this URL.
711
732
 
712
- */
713
-
714
- currency_code?:string;
715
-
716
- /**
717
- * @description Parameters for customer
733
+ **Note** :
734
+
735
+ * Cancel URL configured in Settings \&gt; Hosted Pages Settings would be overriden by this cancel URL.
736
+ *Eg : http://yoursite.com?id&#x3D;\&lt;hosted_page_id\&gt;\&amp;state&#x3D;cancelled*
737
+ * This parameter is not applicable for iframe messaging and [in-app](https://www.chargebee.com/docs/2.0/checkout.html) checkout.
718
738
 
719
739
  */
720
740
 
721
- customer?:{id:string};
741
+ cancel_url?:string;
722
742
 
723
743
  /**
724
- * @description Parameters for card
744
+ * @description You can pass through any content specific to the hosted page request and get it back after user had submitted the hosted page.
725
745
 
726
746
  */
727
747
 
728
- card?:{gateway_account_id?:string};
729
- }
730
- export interface AcceptQuoteResponse {
731
- hosted_page:HostedPage;
732
- }
733
- export interface AcceptQuoteInputParam {
748
+ pass_thru_content?:string;
734
749
 
735
750
  /**
736
- * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
737
-
738
- **Note** :
739
-
740
- * Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons such as user closing the tab, or exiting the browser, and so on. If there is any synchronization that you are doing after the redirection, you will have to have a backup. Chargebee recommends listening to appropriate webhooks such as [&#x60;subscription_created&#x60;](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [&#x60;invoice_generated&#x60;](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
741
- * Redirect URL configured in Settings \&gt; Hosted Pages Settings would be overriden by this redirect URL.
742
- * *Eg :* *http://yoursite.com?id&#x3D;* *\&lt;hosted_page_id\&gt;\&amp;state&#x3D;succeeded*
743
- * This parameter is not applicable for iframe messaging.
751
+ * @description Allow the customer to select an offline payment method during checkout. The choice of payment methods can be configured via the Chargebee UI.
744
752
 
745
753
  */
746
754
 
747
- redirect_url?:string;
755
+ allow_offline_payment_methods?:boolean;
748
756
 
749
757
  /**
750
- * @description Parameters for quote
758
+ * @description Parameters for subscription
751
759
 
752
760
  */
753
761
 
754
- quote?:{id:string};
755
- }
756
- export interface CheckoutNewForItemsResponse {
757
- hosted_page:HostedPage;
758
- }
759
- export interface CheckoutNewForItemsInputParam {
762
+ subscription?:object;
760
763
 
761
764
  /**
762
- * @description Specifies the checkout layout that overrides the default checkout layout configured in the Checkout \&amp; Self-Serve Portal settings. . \* in_app - Indicates in-app checkout version \* full_page - Indicates full page checkout version
765
+ * @description Parameters for customer
763
766
 
764
767
  */
765
768
 
766
- layout?:Layout;
769
+ customer?:object;
767
770
 
768
771
  /**
769
- * @description Sets the [context]() for this operation to the [business entity](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) specified. Applicable only when multiple business entities have been created for the site. When this parameter is provided, the operation is able to read/write data associated only to the business entity specified. When not provided, the operation can read/write data for the entire site.
770
- **Note**
771
-
772
- An alternative way of passing this parameter is by means of a [custom HTTP header](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-header-main).
773
- **See also**
774
-
775
- [Customer resource lookup and creation.](/docs/api/hosted_pages#customer_lookup2)
772
+ * @description Parameters for card
776
773
 
777
774
  */
778
775
 
779
- business_entity_id?:string;
776
+ card?:{gateway_account_id?:string};
780
777
 
781
778
  /**
782
- * @description The number of billing cycles the subscription runs before canceling. If not provided, then the billing cycles [set for the plan-item price](https://apidocs.chargebee.com/docs/api/item_prices?prod_cat_ver&#x3D;2#item_price_billing_cycles) is used.
779
+ * @description Parameters for contract_term
783
780
 
784
781
  */
785
782
 
786
- billing_cycles?:number;
783
+ contract_term?:{action_at_term_end?:'cancel' | 'renew' | 'evergreen',cancellation_cutoff_period?:number};
787
784
 
788
785
  /**
789
- * @description Item ids of [mandatorily attached addons](./attached_items?prod_cat_ver&#x3D;2) that are to be removed from the subscription.
786
+ * @description Parameters for subscription_items
790
787
 
791
788
  */
792
789
 
793
- mandatory_items_to_remove?:string[];
790
+ subscription_items?:{billing_cycles?:number,charge_on_event?:ChargeOnEvent,charge_on_option?:ChargeOnOption,charge_once?:boolean,item_price_id:string,quantity?:number,quantity_in_decimal?:string,service_period_days?:number,trial_end?:number,unit_price?:number,unit_price_in_decimal?:string}[];
794
791
 
795
792
  /**
796
- * @description The number of subscription billing cycles (including the first one) to [invoice in advance](https://www.chargebee.com/docs/advance-invoices.html).
793
+ * @description Parameters for discounts
797
794
 
798
795
  */
799
796
 
800
- terms_to_charge?:number;
797
+ discounts?:{amount?:number,apply_on:ApplyOn,duration_type:DurationType,id?:string,included_in_mrr?:boolean,item_price_id?:string,operation_type:OperationType,percentage?:number,period?:number,period_unit?:PeriodUnit}[];
801
798
 
802
799
  /**
803
- * @description Override the [billing alignment mode](https://www.chargebee.com/docs/calendar-billing.html#alignment-of-billing-date) for Calendar Billing. Only applicable when using Calendar Billing. The default value is that which has been configured for the site. \* immediate - Subscription period will be aligned with the configured billing date immediately, with credits or charges raised accordingly.. \* delayed - Subscription period will be aligned with the configured billing date at the next renewal.
800
+ * @description Parameters for item_tiers
804
801
 
805
802
  */
806
803
 
807
- billing_alignment_mode?:BillingAlignmentMode;
804
+ item_tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,item_price_id?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
808
805
 
809
806
  /**
810
- * @description List of coupons to be applied to this subscription. You can provide coupon ids or [coupon codes](https://apidocs.chargebee.com/docs/api/coupon_codes).
807
+ * @description Parameters for entity_identifiers
811
808
 
812
809
  */
813
810
 
814
- coupon_ids?:string[];
811
+ entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
812
+ }
813
+ export interface UpdatePaymentMethodResponse {
814
+ hosted_page:HostedPage;
815
+ }
816
+ export interface UpdatePaymentMethodInputParam {
815
817
 
816
818
  /**
817
819
  * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
@@ -848,25 +850,20 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
848
850
  pass_thru_content?:string;
849
851
 
850
852
  /**
851
- * @description Allow the customer to select an offline payment method during checkout. The choice of payment methods can be configured via the Chargebee UI.
853
+ * @description If true then iframe will communicate with the parent window. Applicable only for embedded(iframe) hosted pages. If you&#x27;re using iframe_messaging you need to implement onSuccess \&amp; onCancel callbacks.
852
854
 
853
- */
854
-
855
- allow_offline_payment_methods?:boolean;
856
-
857
- /**
858
- * @description Parameters for subscription
855
+ **Note** : This parameter is not applicable for [in-app](https://www.chargebee.com/docs/checkout-v3.html) checkout.
859
856
 
860
857
  */
861
858
 
862
- subscription?:object;
859
+ iframe_messaging?:boolean;
863
860
 
864
861
  /**
865
862
  * @description Parameters for customer
866
863
 
867
864
  */
868
865
 
869
- customer?:object;
866
+ customer?:{id:string};
870
867
 
871
868
  /**
872
869
  * @description Parameters for card
@@ -874,60 +871,70 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
874
871
  */
875
872
 
876
873
  card?:{gateway_account_id?:string};
874
+ }
875
+ export interface ManagePaymentSourcesResponse {
876
+ hosted_page:HostedPage;
877
+ }
878
+ export interface ManagePaymentSourcesInputParam {
877
879
 
878
880
  /**
879
- * @description Parameters for billing_address
881
+ * @description URL to redirect after payment method is added.
880
882
 
881
883
  */
882
884
 
883
- billing_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
885
+ redirect_url?:string;
884
886
 
885
887
  /**
886
- * @description Parameters for shipping_address
888
+ * @description Parameters for customer
887
889
 
888
890
  */
889
891
 
890
- shipping_address?:{city?:string,company?:string,country?:string,email?:string,first_name?:string,last_name?:string,line1?:string,line2?:string,line3?:string,phone?:string,state?:string,state_code?:string,validation_status?:ValidationStatus,zip?:string};
892
+ customer?:{id:string};
891
893
 
892
894
  /**
893
- * @description Parameters for contract_term
895
+ * @description Parameters for card
894
896
 
895
897
  */
896
898
 
897
- contract_term?:{action_at_term_end?:'cancel' | 'renew' | 'evergreen',cancellation_cutoff_period?:number};
899
+ card?:{gateway_account_id?:string};
900
+ }
901
+ export interface CollectNowResponse {
902
+ hosted_page:HostedPage;
903
+ }
904
+ export interface CollectNowInputParam {
898
905
 
899
906
  /**
900
- * @description Parameters for subscription_items
907
+ * @description Used to specify the destination URL to which a user is redirected after invoices are paid. The [transaction ID](/docs/api/transactions#transaction_id) of the transactions made through the Pay Now hosted page will be sent as return variables along with the URL.
901
908
 
902
909
  */
903
910
 
904
- subscription_items?:{billing_cycles?:number,charge_on_event?:ChargeOnEvent,charge_on_option?:ChargeOnOption,charge_once?:boolean,item_price_id:string,quantity?:number,quantity_in_decimal?:string,service_period_days?:number,trial_end?:number,unit_price?:number,unit_price_in_decimal?:string}[];
911
+ redirect_url?:string;
905
912
 
906
913
  /**
907
- * @description Parameters for discounts
914
+ * @description The currency code (ISO 4217 format) of the specified *credit amount*.
908
915
 
909
916
  */
910
917
 
911
- discounts?:{amount?:number,apply_on:ApplyOn,duration_type:DurationType,included_in_mrr?:boolean,item_price_id?:string,percentage?:number,period?:number,period_unit?:PeriodUnit}[];
918
+ currency_code?:string;
912
919
 
913
920
  /**
914
- * @description Parameters for item_tiers
921
+ * @description Parameters for customer
915
922
 
916
923
  */
917
924
 
918
- item_tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,item_price_id?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
925
+ customer?:{id:string};
919
926
 
920
927
  /**
921
- * @description Parameters for entity_identifiers
928
+ * @description Parameters for card
922
929
 
923
930
  */
924
931
 
925
- entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
932
+ card?:{gateway_account_id?:string};
926
933
  }
927
- export interface ClaimGiftResponse {
934
+ export interface AcceptQuoteResponse {
928
935
  hosted_page:HostedPage;
929
936
  }
930
- export interface ClaimGiftInputParam {
937
+ export interface AcceptQuoteInputParam {
931
938
 
932
939
  /**
933
940
  * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
@@ -944,92 +951,69 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
944
951
  redirect_url?:string;
945
952
 
946
953
  /**
947
- * @description Parameters for gift
948
-
949
- */
950
-
951
- gift?:{id:string};
952
-
953
- /**
954
- * @description Parameters for customer
954
+ * @description Parameters for quote
955
955
 
956
956
  */
957
957
 
958
- customer?:{locale?:string};
958
+ quote?:{id:string};
959
959
  }
960
- export interface CheckoutExistingForItemsResponse {
960
+ export interface ExtendSubscriptionResponse {
961
961
  hosted_page:HostedPage;
962
962
  }
963
- export interface CheckoutExistingForItemsInputParam {
963
+ export interface ExtendSubscriptionInputParam {
964
964
 
965
965
  /**
966
- * @description Specifies the checkout layout that overrides the default checkout layout configured in the Checkout \&amp; Self-Serve Portal settings. . \* in_app - Indicates in-app checkout version \* full_page - Indicates full page checkout version
966
+ * @description Expiry (in days) for the link generated. No expiry will be set if this is not specified.
967
967
 
968
968
  */
969
969
 
970
- layout?:Layout;
970
+ expiry?:number;
971
971
 
972
972
  /**
973
- * @description Item ids of [mandatorily attached addons](./attached_items?prod_cat_ver&#x3D;2) that are to be removed from the subscription.
973
+ * @description Number of billing cycles to extend. If not specified, plan&#x27;s billing cycle will be used.
974
974
 
975
975
  */
976
976
 
977
- mandatory_items_to_remove?:string[];
977
+ billing_cycle?:number;
978
978
 
979
979
  /**
980
- * @description If &#x60;true&#x60; then the existing &#x60;subscription_items&#x60; list for the subscription is replaced by the one provided. If &#x60;false&#x60; then the provided &#x60;subscription_items&#x60; list gets added to the existing list.
980
+ * @description Parameters for subscription
981
981
 
982
982
  */
983
983
 
984
- replace_items_list?:boolean;
984
+ subscription?:{id:string};
985
+ }
986
+ export interface CheckoutGiftForItemsResponse {
987
+ hosted_page:HostedPage;
988
+ }
989
+ export interface CheckoutGiftForItemsInputParam {
985
990
 
986
991
  /**
987
- * @description The document date displayed on the invoice PDF. The default value is the current date. Provide this value to backdate the invoice. Backdating an invoice is done for reasons such as booking revenue for a previous date or when the subscription is effective as of a past date. Moreover, if &#x60;create_pending_invoices&#x60; is set to &#x60;true&#x60;, and if the site is configured to set invoice dates to date of closing, then upon invoice closure, this date is changed to the invoice closing date. taxes and line_item_taxes are computed based on the tax configuration as of &#x60;invoice_date&#x60;. When passing this parameter, the following prerequisites must be met:
988
-
989
- * &#x60;invoice_date&#x60; must be in the past.
990
- * &#x60;invoice_date&#x60; is not more than one calendar month into the past. For example, if today is 13th January, then you cannot pass a value that is earlier than 13th December.
991
- * It is not earlier than &#x60;changes_scheduled_at&#x60;, &#x60;reactivate_from&#x60;, or &#x60;trial_end&#x60;.
992
- * &#x60;invoice_immediately&#x60; is &#x60;true&#x60;.
993
- .
992
+ * @description Sets the [context]() for this operation to the [business entity](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) specified. Applicable only when multiple business entities have been created for the site. When this parameter is provided, the operation is able to read/write data associated only to the business entity specified. When not provided, the operation can read/write data for the entire site.
993
+ **Note**
994
994
 
995
- */
996
-
997
- invoice_date?:number;
998
-
999
- /**
1000
- * @description Billing cycles set for plan-item price is used by default.
995
+ An alternative way of passing this parameter is by means of a [custom HTTP header](/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-header-main).
996
+ **See also**
1001
997
 
1002
- */
1003
-
1004
- billing_cycles?:number;
1005
-
1006
- /**
1007
- * @description The number of subscription billing cycles to [invoice in advance](https://www.chargebee.com/docs/advance-invoices.html). If a new term is started for the subscription due to this API call, then &#x60;terms_to_charge&#x60; is inclusive of this new term. See description for the &#x60;force_term_reset&#x60; parameter to learn more about when a subscription term is reset.
998
+ Gifter customer resource lookup and creation.
1008
999
 
1009
1000
  */
1010
1001
 
1011
- terms_to_charge?:number;
1002
+ business_entity_id?:string;
1012
1003
 
1013
1004
  /**
1014
- * @description If the subscription &#x60;status&#x60; is &#x60;cancelled&#x60; and it is being reactivated via this operation, this is the date/time at which the subscription should be reactivated.
1015
- **Note:** It is recommended not to pass this parameter along with &#x60;changed_scheduled_at&#x60;. &#x60;reactivate_from&#x60; can be backdated (set to a value in the past). Use backdating when the subscription has been reactivated already but its billing has been delayed. Backdating is allowed only when the following prerequisites are met:
1005
+ * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
1016
1006
 
1017
- * Backdating must be enabled for subscription reactivation operations.
1018
- * The current day of the month does not exceed the limit set in Chargebee for backdating subscription change. This limit is the day of the month by which the accounting for the previous month must be closed.
1019
- * The date is on or after the last date/time any of the product catalog items of the subscription were changed.
1020
- * The date is not more than duration X into the past where X is the billing period of the plan. For example, if the period of the plan in the subscription is 2 months and today is 14th April, &#x60;changes_scheduled_at&#x60; cannot be earlier than 14th February.
1021
- .
1007
+ **Note** :
1022
1008
 
1023
- */
1024
-
1025
- reactivate_from?:number;
1026
-
1027
- /**
1028
- * @description Override the [billing alignment mode](https://www.chargebee.com/docs/calendar-billing.html#alignment-of-billing-date) chosen for the site for calendar billing. Only applicable when using calendar billing. \* immediate - Subscription period will be aligned with the configured billing date immediately, with credits or charges raised accordingly.. \* delayed - Subscription period will be aligned with the configured billing date at the next renewal.
1009
+ * Although the customer will be redirected to the &#x60;redirect_url&#x60; after successful checkout, we do not recommend relying on it for completing critical post-checkout actions. This is because redirection may not happen due to unforeseen reasons such as user closing the tab, or exiting the browser, and so on. If there is any synchronization that you are doing after the redirection, you will have to have a backup. Chargebee recommends listening to appropriate webhooks such as [&#x60;subscription_created&#x60;](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [&#x60;invoice_generated&#x60;](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
1010
+ * Redirect URL configured in Settings \&gt; Hosted Pages Settings would be overriden by this redirect URL.
1011
+ * *Eg :* *http://yoursite.com?id&#x3D;* *\&lt;hosted_page_id\&gt;\&amp;state&#x3D;succeeded*
1012
+ * This parameter is not applicable for iframe messaging.
1029
1013
 
1030
1014
  */
1031
1015
 
1032
- billing_alignment_mode?:BillingAlignmentMode;
1016
+ redirect_url?:string;
1033
1017
 
1034
1018
  /**
1035
1019
  * @description List of coupons to be applied to this subscription. You can provide coupon ids or [coupon codes](https://apidocs.chargebee.com/docs/api/coupon_codes).
@@ -1039,19 +1023,23 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
1039
1023
  coupon_ids?:string[];
1040
1024
 
1041
1025
  /**
1042
- * @description Applicable only for &#x60;cancelled&#x60; subscriptions. When passed as &#x60;true&#x60;, the canceled subscription is activated; otherwise subscription changes are made without changing its &#x60;status&#x60;. If not passed, subscription will be activated only if &#x60;subscription_items&#x60; is passed.
1026
+ * @description Parameters for gifter
1043
1027
 
1044
1028
  */
1045
1029
 
1046
- reactivate?:boolean;
1030
+ gifter?:{customer_id?:string,locale?:string};
1047
1031
 
1048
1032
  /**
1049
- * @description Say the subscription has the renewal date as 28th of every month. When the plan-item price of the subscription is set to one that has the same billing period as the current plan-item price, the subscription change does not change the term. In other words, the subscription still renews on the 28th. Passing this parameter as &#x60;true&#x60; will have the subscription reset its term to the current date (provided &#x60;end_of_term&#x60; is false).
1050
- **Note**: When the new plan-item price has a billing period different from the current plan-item price of the subscription, the term is always reset, regardless of the value passed for this parameter.
1033
+ * @description Parameters for subscription_items
1051
1034
 
1052
1035
  */
1053
1036
 
1054
- force_term_reset?:boolean;
1037
+ subscription_items?:{item_price_id?:string,quantity?:number,quantity_in_decimal?:string}[];
1038
+ }
1039
+ export interface ClaimGiftResponse {
1040
+ hosted_page:HostedPage;
1041
+ }
1042
+ export interface ClaimGiftInputParam {
1055
1043
 
1056
1044
  /**
1057
1045
  * @description The customers will be redirected to this URL upon successful checkout. The hosted page id and state will be passed as parameters to this URL.
@@ -1068,87 +1056,97 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
1068
1056
  redirect_url?:string;
1069
1057
 
1070
1058
  /**
1071
- * @description The customers will be redirected to this URL upon canceling checkout. The hosted page id and state will be passed as parameters to this URL.
1072
-
1073
- **Note** :
1074
-
1075
- * Cancel URL configured in Settings \&gt; Hosted Pages Settings would be overriden by this cancel URL.
1076
- *Eg : http://yoursite.com?id&#x3D;\&lt;hosted_page_id\&gt;\&amp;state&#x3D;cancelled*
1077
- * This parameter is not applicable for iframe messaging and [in-app](https://www.chargebee.com/docs/2.0/checkout.html) checkout.
1059
+ * @description Parameters for gift
1078
1060
 
1079
1061
  */
1080
1062
 
1081
- cancel_url?:string;
1063
+ gift?:{id:string};
1082
1064
 
1083
1065
  /**
1084
- * @description You can pass through any content specific to the hosted page request and get it back after user had submitted the hosted page.
1066
+ * @description Parameters for customer
1085
1067
 
1086
1068
  */
1087
1069
 
1088
- pass_thru_content?:string;
1070
+ customer?:{locale?:string};
1071
+ }
1072
+ export interface RetrieveAgreementPdfResponse {
1073
+ hosted_page:HostedPage;
1074
+ }
1075
+ export interface RetrieveAgreementPdfInputParam {
1089
1076
 
1090
1077
  /**
1091
- * @description Allow the customer to select an offline payment method during checkout. The choice of payment methods can be configured via the Chargebee UI.
1078
+ * @description Payment source to be used for this payment.
1092
1079
 
1093
1080
  */
1094
1081
 
1095
- allow_offline_payment_methods?:boolean;
1096
-
1082
+ payment_source_id:string;
1083
+ }
1084
+ export interface AcknowledgeResponse {
1085
+ hosted_page:HostedPage;
1086
+ }
1087
+
1088
+ export interface RetrieveResponse {
1089
+ hosted_page:HostedPage;
1090
+ }
1091
+
1092
+ export interface ListResponse {
1097
1093
  /**
1098
- * @description Parameters for subscription
1094
+ * @description This API retrieves the list of hosted page resources.
1099
1095
 
1100
1096
  */
1101
1097
 
1102
- subscription?:object;
1098
+ list:{hosted_page:HostedPage}[];
1103
1099
 
1104
1100
  /**
1105
- * @description Parameters for customer
1101
+ * @description This API retrieves the list of hosted page resources.
1106
1102
 
1107
1103
  */
1108
1104
 
1109
- customer?:object;
1110
-
1105
+ next_offset?:string;
1106
+ }
1107
+ export interface ListInputParam {
1108
+ [key : string]: any;
1111
1109
  /**
1112
- * @description Parameters for card
1110
+ * @description This API retrieves the list of hosted page resources.
1113
1111
 
1114
1112
  */
1115
-
1116
- card?:{gateway_account_id?:string};
1113
+
1114
+ limit?:number;
1117
1115
 
1118
1116
  /**
1119
- * @description Parameters for contract_term
1117
+ * @description This API retrieves the list of hosted page resources.
1120
1118
 
1121
1119
  */
1122
-
1123
- contract_term?:{action_at_term_end?:'cancel' | 'renew' | 'evergreen',cancellation_cutoff_period?:number};
1120
+
1121
+ offset?:string;
1124
1122
 
1125
1123
  /**
1126
- * @description Parameters for subscription_items
1124
+ * @description This API retrieves the list of hosted page resources.
1127
1125
 
1128
1126
  */
1129
-
1130
- subscription_items?:{billing_cycles?:number,charge_on_event?:ChargeOnEvent,charge_on_option?:ChargeOnOption,charge_once?:boolean,item_price_id:string,quantity?:number,quantity_in_decimal?:string,service_period_days?:number,trial_end?:number,unit_price?:number,unit_price_in_decimal?:string}[];
1127
+
1128
+ id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
1131
1129
 
1132
1130
  /**
1133
- * @description Parameters for discounts
1131
+ * @description This API retrieves the list of hosted page resources.
1134
1132
 
1135
1133
  */
1136
-
1137
- discounts?:{amount?:number,apply_on:ApplyOn,duration_type:DurationType,id?:string,included_in_mrr?:boolean,item_price_id?:string,operation_type:OperationType,percentage?:number,period?:number,period_unit?:PeriodUnit}[];
1134
+
1135
+ type?:{in?:string,is?:'update_payment_method' | 'checkout_one_time' | 'manage_payment_sources' | 'checkout_new' | 'view_voucher' | 'collect_now' | 'checkout_existing' | 'extend_subscription' | 'pre_cancel',is_not?:'update_payment_method' | 'checkout_one_time' | 'manage_payment_sources' | 'checkout_new' | 'view_voucher' | 'collect_now' | 'checkout_existing' | 'extend_subscription' | 'pre_cancel',not_in?:string};
1138
1136
 
1139
1137
  /**
1140
- * @description Parameters for item_tiers
1138
+ * @description This API retrieves the list of hosted page resources.
1141
1139
 
1142
1140
  */
1143
-
1144
- item_tiers?:{ending_unit?:number,ending_unit_in_decimal?:string,item_price_id?:string,price?:number,price_in_decimal?:string,starting_unit?:number,starting_unit_in_decimal?:string}[];
1141
+
1142
+ state?:{in?:string,is?:'requested' | 'acknowledged' | 'created' | 'cancelled' | 'succeeded',is_not?:'requested' | 'acknowledged' | 'created' | 'cancelled' | 'succeeded',not_in?:string};
1145
1143
 
1146
1144
  /**
1147
- * @description Parameters for entity_identifiers
1145
+ * @description This API retrieves the list of hosted page resources.
1148
1146
 
1149
1147
  */
1150
-
1151
- entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
1148
+
1149
+ updated_at?:{after?:string,before?:string,between?:string,on?:string};
1152
1150
  }
1153
1151
  export interface PreCancelResponse {
1154
1152
  hosted_page:HostedPage;
@@ -1186,51 +1184,53 @@ Although only &#x60;pass_thru_content.custom&#x60; is sent to Chargebee Retentio
1186
1184
 
1187
1185
  subscription?:{id:string};
1188
1186
  }
1189
- export interface AcknowledgeResponse {
1190
- hosted_page:HostedPage;
1191
- }
1192
-
1193
- export interface RetrieveAgreementPdfResponse {
1194
- hosted_page:HostedPage;
1187
+ export interface EventsResponse {
1188
+ success:boolean;
1195
1189
  }
1196
- export interface RetrieveAgreementPdfInputParam {
1190
+ export interface EventsInputParam {
1197
1191
 
1198
1192
  /**
1199
- * @description Payment source to be used for this payment.
1193
+ * @description The event that need to passed to a different system. \* cancellation_page_loaded - Indicates native cancellation flow provided by the merchant is loaded rather than the retention flow.
1200
1194
 
1201
1195
  */
1202
1196
 
1203
- payment_source_id:string;
1204
- }
1205
- export interface RetrieveResponse {
1206
- hosted_page:HostedPage;
1207
- }
1208
-
1209
- export interface ManagePaymentSourcesResponse {
1210
- hosted_page:HostedPage;
1211
- }
1212
- export interface ManagePaymentSourcesInputParam {
1197
+ event_name:EventName;
1213
1198
 
1214
1199
  /**
1215
- * @description URL to redirect after payment method is added.
1200
+ * @description Timestamp indicating when this event had occurred. .
1216
1201
 
1217
1202
  */
1218
1203
 
1219
- redirect_url?:string;
1204
+ occurred_at?:number;
1220
1205
 
1221
1206
  /**
1222
- * @description Parameters for customer
1207
+ * @description The meta data description of the event in key-value pair. The value is a JSON object with the following keys and their values.
1208
+
1209
+ * &#x60;subscription_id&#x60;: A unique and immutable identifier for the subscription.
1210
+ .
1223
1211
 
1224
1212
  */
1225
1213
 
1226
- customer?:{id:string};
1214
+ event_data:object;
1215
+ }
1216
+ export interface ViewVoucherResponse {
1217
+ hosted_page:HostedPage;
1218
+ }
1219
+ export interface ViewVoucherInputParam {
1227
1220
 
1228
1221
  /**
1229
- * @description Parameters for card
1222
+ * @description Parameters for payment_voucher
1230
1223
 
1231
1224
  */
1232
1225
 
1233
- card?:{gateway_account_id?:string};
1226
+ payment_voucher?:{id:string};
1227
+
1228
+ /**
1229
+ * @description Parameters for customer
1230
+
1231
+ */
1232
+
1233
+ customer?:{locale?:string};
1234
1234
  }
1235
1235
 
1236
1236
  }