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.
- package/.github/ISSUE_TEMPLATE/bug_report.yml +81 -0
- package/.github/ISSUE_TEMPLATE/config.yml +6 -0
- package/.github/ISSUE_TEMPLATE/feature_request.yml +34 -0
- package/.github/PULL_REQUEST_TEMPLATE.md +8 -0
- package/.github/workflows/greeting.yml +47 -0
- package/CHANGELOG.md +59 -0
- package/SECURITY.md +8 -0
- package/lib/chargebee.js +1 -1
- package/lib/resources/api_endpoints.js +0 -14
- package/package.json +1 -1
- package/types/core.d.ts +4 -4
- package/types/resources/AttachedItem.d.ts +88 -88
- package/types/resources/Card.d.ts +68 -68
- package/types/resources/Comment.d.ts +50 -44
- package/types/resources/Coupon.d.ts +242 -207
- package/types/resources/CouponSet.d.ts +72 -68
- package/types/resources/CreditNote.d.ts +612 -236
- package/types/resources/Customer.d.ts +655 -513
- package/types/resources/DifferentialPrice.d.ts +99 -74
- package/types/resources/EntitlementOverride.d.ts +27 -12
- package/types/resources/Estimate.d.ts +450 -450
- package/types/resources/Event.d.ts +30 -12
- package/types/resources/Export.d.ts +200 -200
- package/types/resources/Feature.d.ts +66 -35
- package/types/resources/Gift.d.ts +54 -44
- package/types/resources/HostedPage.d.ts +381 -381
- package/types/resources/InAppSubscription.d.ts +94 -90
- package/types/resources/Invoice.d.ts +1242 -660
- package/types/resources/Item.d.ts +148 -142
- package/types/resources/ItemEntitlement.d.ts +36 -36
- package/types/resources/ItemFamily.d.ts +45 -45
- package/types/resources/ItemPrice.d.ts +317 -273
- package/types/resources/PaymentIntent.d.ts +60 -60
- package/types/resources/PaymentReferenceNumber.d.ts +1 -1
- package/types/resources/PaymentVoucher.d.ts +74 -59
- package/types/resources/PortalSession.d.ts +45 -20
- package/types/resources/PromotionalCredit.d.ts +68 -68
- package/types/resources/Purchase.d.ts +3 -3
- package/types/resources/Quote.d.ts +655 -366
- package/types/resources/QuoteLineGroup.d.ts +245 -0
- package/types/resources/QuotedCharge.d.ts +170 -0
- package/types/resources/QuotedSubscription.d.ts +219 -0
- package/types/resources/SiteMigrationDetail.d.ts +7 -7
- package/types/resources/Subscription.d.ts +1219 -932
- package/types/resources/SubscriptionEntitlement.d.ts +33 -12
- package/types/resources/ThirdPartyPaymentMethod.d.ts +1 -1
- package/types/resources/TimeMachine.d.ts +15 -15
- package/types/resources/Token.d.ts +0 -116
- package/types/resources/Transaction.d.ts +229 -112
- package/types/resources/UnbilledCharge.d.ts +112 -67
- package/types/resources/Usage.d.ts +46 -47
- package/types/resources/VirtualBankAccount.d.ts +66 -66
- package/types/resources/Media.d.ts +0 -33
- 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
|
|
117
|
+
* @description Create a Chargebee hosted page to accept payment details from a customer and checkout a new subscription.
|
|
118
118
|
|
|
119
|
-
|
|
119
|
+
The following steps describe how best to use this API:
|
|
120
120
|
|
|
121
|
-
|
|
121
|
+
1. Call this endpoint, providing [item prices](./item_prices?prod_cat_ver=2), [coupons](./coupons?prod_cat_ver=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 `url` received in the response.
|
|
123
|
+
3. Once they complete checkout, a new subscription is automatically created and the customer is redirected to the `redirect_url` with the `id` and `state` attributes passed as query string parameters.
|
|
124
|
+
Although the customer will be redirected to the `redirect_url` 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=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=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=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
|
-
|
|
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=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
|
-
|
|
139
|
+
checkout_new_for_items(input?:CheckoutNewForItemsInputParam):ChargebeeRequest<CheckoutNewForItemsResponse>;
|
|
146
140
|
|
|
147
141
|
/**
|
|
148
|
-
* @description
|
|
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
|
-
|
|
144
|
+
The following steps describe how best to use this API:
|
|
157
145
|
|
|
158
|
-
|
|
146
|
+
1. Provide [item prices](./item_prices?prod_cat_ver=2), [coupons](./coupons?prod_cat_ver=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 `url` 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 `redirect_url` with the `id` and `state` attributes passed as query string parameters.
|
|
149
|
+
Although the customer will be redirected to the `redirect_url` 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=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's email address exists. The first such customer record is considered the receiver'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=2#mbe) are created for the site, the lookup and creation of the gift receiver'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
|
-
|
|
157
|
+
checkout_existing_for_items(input?:CheckoutExistingForItemsInputParam):ChargebeeRequest<CheckoutExistingForItemsResponse>;
|
|
169
158
|
|
|
170
159
|
/**
|
|
171
|
-
* @description
|
|
160
|
+
* @description **Note:** If you'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=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=true, the returned hosted page URL will show only Card Payment as a payment method.
|
|
172
171
|
|
|
173
172
|
*/
|
|
174
173
|
|
|
175
|
-
|
|
174
|
+
update_payment_method(input?:UpdatePaymentMethodInputParam):ChargebeeRequest<UpdatePaymentMethodResponse>;
|
|
176
175
|
|
|
177
176
|
/**
|
|
178
|
-
* @description
|
|
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
|
-
|
|
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=2#
|
|
|
196
195
|
accept_quote(input?:AcceptQuoteInputParam):ChargebeeRequest<AcceptQuoteResponse>;
|
|
197
196
|
|
|
198
197
|
/**
|
|
199
|
-
* @description
|
|
198
|
+
* @description This API generates a hosted page URL to extend the billing cycle of a subscription.
|
|
200
199
|
|
|
201
|
-
|
|
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
|
-
|
|
204
|
-
2. Send the customer to the Checkout `url` received in the response.
|
|
205
|
-
3. Once they complete checkout, a new subscription is automatically created and the customer is redirected to the `redirect_url` with the `id` and `state` attributes passed as query string parameters.
|
|
206
|
-
Although the customer will be redirected to the `redirect_url` 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=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
|
-
|
|
213
|
+
If multiple [business entities](/docs/api/advanced-features?prod_cat_ver=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
|
-
|
|
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's email address exists. The first such customer record is considered the receiver'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=2#mbe) are created for the site, the
|
|
221
|
+
If multiple [business entities](/docs/api/advanced-features?prod_cat_ver=2#mbe) are created for the site, the lookup and creation of the gift receiver'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
|
-
|
|
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=2#
|
|
|
228
232
|
claim_gift(input?:ClaimGiftInputParam):ChargebeeRequest<ClaimGiftResponse>;
|
|
229
233
|
|
|
230
234
|
/**
|
|
231
|
-
* @description
|
|
232
|
-
|
|
233
|
-
The following steps describe how best to use this API:
|
|
234
|
-
|
|
235
|
-
1. Provide [item prices](./item_prices?prod_cat_ver=2), [coupons](./coupons?prod_cat_ver=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 `url` 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 `redirect_url` with the `id` and `state` attributes passed as query string parameters.
|
|
238
|
-
Although the customer will be redirected to the `redirect_url` 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=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 "Thank You" 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 `hosted_page` resource of `type` `pre_cancel`. 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
|
-
|
|
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 [`state`](hosted_pages#hosted_page_state) is automatically changed to `succeeded`. 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 `succeeded` state and change its state to `acknowledged`.
|
|
@@ -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 "Thank You" 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 `status` is `successful`, the `content` attribute has the following objects based on the `type` 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
|
|
271
|
+
* @description This API retrieves the list of hosted page resources.
|
|
294
272
|
|
|
295
273
|
*/
|
|
296
274
|
|
|
297
|
-
|
|
275
|
+
list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
|
|
276
|
+
|
|
277
|
+
/**
|
|
278
|
+
* @description Creates a `hosted_page` resource of `type` `pre_cancel`. 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 `hosted_page` resource of type, `view_voucher`. 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
|
|
449
|
+
export interface CheckoutNewForItemsResponse {
|
|
450
450
|
hosted_page:HostedPage;
|
|
451
451
|
}
|
|
452
|
-
export interface
|
|
452
|
+
export interface CheckoutNewForItemsInputParam {
|
|
453
|
+
|
|
454
|
+
/**
|
|
455
|
+
* @description Specifies the checkout layout that overrides the default checkout layout configured in the Checkout \& 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=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=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=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=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
|
|
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
|
-
|
|
546
|
+
*/
|
|
547
|
+
|
|
548
|
+
allow_offline_payment_methods?:boolean;
|
|
549
|
+
|
|
550
|
+
/**
|
|
551
|
+
* @description Parameters for subscription
|
|
492
552
|
|
|
493
553
|
*/
|
|
494
554
|
|
|
495
|
-
|
|
555
|
+
subscription?:object;
|
|
496
556
|
|
|
497
557
|
/**
|
|
498
558
|
* @description Parameters for customer
|
|
499
559
|
|
|
500
560
|
*/
|
|
501
561
|
|
|
502
|
-
customer?:
|
|
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
|
|
572
|
+
* @description Parameters for billing_address
|
|
518
573
|
|
|
519
574
|
*/
|
|
520
575
|
|
|
521
|
-
|
|
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
|
|
579
|
+
* @description Parameters for shipping_address
|
|
525
580
|
|
|
526
581
|
*/
|
|
527
582
|
|
|
528
|
-
|
|
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
|
|
586
|
+
* @description Parameters for contract_term
|
|
532
587
|
|
|
533
588
|
*/
|
|
534
589
|
|
|
535
|
-
|
|
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
|
|
593
|
+
* @description Parameters for subscription_items
|
|
544
594
|
|
|
545
595
|
*/
|
|
546
596
|
|
|
547
|
-
|
|
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
|
|
600
|
+
* @description Parameters for discounts
|
|
551
601
|
|
|
552
602
|
*/
|
|
553
603
|
|
|
554
|
-
|
|
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
|
|
607
|
+
* @description Parameters for item_tiers
|
|
558
608
|
|
|
559
|
-
|
|
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
|
-
|
|
618
|
+
entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
|
|
565
619
|
}
|
|
566
|
-
export interface
|
|
620
|
+
export interface CheckoutExistingForItemsResponse {
|
|
567
621
|
hosted_page:HostedPage;
|
|
568
622
|
}
|
|
569
|
-
export interface
|
|
623
|
+
export interface CheckoutExistingForItemsInputParam {
|
|
570
624
|
|
|
571
625
|
/**
|
|
572
|
-
* @description
|
|
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=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 \& 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
|
-
|
|
630
|
+
layout?:Layout;
|
|
583
631
|
|
|
584
632
|
/**
|
|
585
|
-
* @description
|
|
586
|
-
|
|
587
|
-
**Note** :
|
|
588
|
-
|
|
589
|
-
* Although the customer will be redirected to the `redirect_url` 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 [`subscription_created`](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [`invoice_generated`](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
|
|
590
|
-
* Redirect URL configured in Settings \> Hosted Pages Settings would be overriden by this redirect URL.
|
|
591
|
-
* *Eg :* *http://yoursite.com?id=* *\<hosted_page_id\>\&state=succeeded*
|
|
592
|
-
* This parameter is not applicable for iframe messaging.
|
|
633
|
+
* @description Item ids of [mandatorily attached addons](./attached_items?prod_cat_ver=2) that are to be removed from the subscription.
|
|
593
634
|
|
|
594
635
|
*/
|
|
595
636
|
|
|
596
|
-
|
|
637
|
+
mandatory_items_to_remove?:string[];
|
|
597
638
|
|
|
598
639
|
/**
|
|
599
|
-
* @description
|
|
640
|
+
* @description If `true` then the existing `subscription_items` list for the subscription is replaced by the one provided. If `false` then the provided `subscription_items` list gets added to the existing list.
|
|
600
641
|
|
|
601
642
|
*/
|
|
602
643
|
|
|
603
|
-
|
|
644
|
+
replace_items_list?:boolean;
|
|
604
645
|
|
|
605
646
|
/**
|
|
606
|
-
* @description
|
|
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 `create_pending_invoices` is set to `true`, 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 `invoice_date`. When passing this parameter, the following prerequisites must be met:
|
|
648
|
+
|
|
649
|
+
* `invoice_date` must be in the past.
|
|
650
|
+
* `invoice_date` 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 `changes_scheduled_at`, `reactivate_from`, or `trial_end`.
|
|
652
|
+
* `invoice_immediately` is `true`.
|
|
653
|
+
.
|
|
607
654
|
|
|
608
655
|
*/
|
|
609
656
|
|
|
610
|
-
|
|
657
|
+
invoice_date?:number;
|
|
611
658
|
|
|
612
659
|
/**
|
|
613
|
-
* @description
|
|
660
|
+
* @description Billing cycles set for plan-item price is used by default.
|
|
614
661
|
|
|
615
662
|
*/
|
|
616
663
|
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
export interface ListResponse {
|
|
664
|
+
billing_cycles?:number;
|
|
665
|
+
|
|
620
666
|
/**
|
|
621
|
-
* @description
|
|
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 `terms_to_charge` is inclusive of this new term. See description for the `force_term_reset` parameter to learn more about when a subscription term is reset.
|
|
622
668
|
|
|
623
669
|
*/
|
|
624
670
|
|
|
625
|
-
|
|
671
|
+
terms_to_charge?:number;
|
|
626
672
|
|
|
627
673
|
/**
|
|
628
|
-
* @description
|
|
674
|
+
* @description If the subscription `status` is `cancelled` 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 `changed_scheduled_at`. `reactivate_from` 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
|
-
|
|
633
|
-
|
|
634
|
-
|
|
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, `changes_scheduled_at` 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 \`offset\` to the value of \`next_offset\` 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
|
|
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
|
|
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
|
|
702
|
+
* @description Applicable only for `cancelled` subscriptions. When passed as `true`, the canceled subscription is activated; otherwise subscription changes are made without changing its `status`. If not passed, subscription will be activated only if `subscription_items` is passed.
|
|
685
703
|
|
|
686
704
|
*/
|
|
687
705
|
|
|
688
|
-
|
|
706
|
+
reactivate?:boolean;
|
|
689
707
|
|
|
690
708
|
/**
|
|
691
|
-
* @description
|
|
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 `true` will have the subscription reset its term to the current date (provided `end_of_term` 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
|
-
|
|
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
|
|
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 `redirect_url` 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 [`subscription_created`](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [`invoice_generated`](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
|
|
722
|
+
* Redirect URL configured in Settings \> Hosted Pages Settings would be overriden by this redirect URL.
|
|
723
|
+
* *Eg :* *http://yoursite.com?id=* *\<hosted_page_id\>\&state=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
|
|
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
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
* @description Parameters for customer
|
|
733
|
+
**Note** :
|
|
734
|
+
|
|
735
|
+
* Cancel URL configured in Settings \> Hosted Pages Settings would be overriden by this cancel URL.
|
|
736
|
+
*Eg : http://yoursite.com?id=\<hosted_page_id\>\&state=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
|
-
|
|
741
|
+
cancel_url?:string;
|
|
722
742
|
|
|
723
743
|
/**
|
|
724
|
-
* @description
|
|
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
|
-
|
|
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
|
|
737
|
-
|
|
738
|
-
**Note** :
|
|
739
|
-
|
|
740
|
-
* Although the customer will be redirected to the `redirect_url` 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 [`subscription_created`](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [`invoice_generated`](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
|
|
741
|
-
* Redirect URL configured in Settings \> Hosted Pages Settings would be overriden by this redirect URL.
|
|
742
|
-
* *Eg :* *http://yoursite.com?id=* *\<hosted_page_id\>\&state=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
|
-
|
|
755
|
+
allow_offline_payment_methods?:boolean;
|
|
748
756
|
|
|
749
757
|
/**
|
|
750
|
-
* @description Parameters for
|
|
758
|
+
* @description Parameters for subscription
|
|
751
759
|
|
|
752
760
|
*/
|
|
753
761
|
|
|
754
|
-
|
|
755
|
-
}
|
|
756
|
-
export interface CheckoutNewForItemsResponse {
|
|
757
|
-
hosted_page:HostedPage;
|
|
758
|
-
}
|
|
759
|
-
export interface CheckoutNewForItemsInputParam {
|
|
762
|
+
subscription?:object;
|
|
760
763
|
|
|
761
764
|
/**
|
|
762
|
-
* @description
|
|
765
|
+
* @description Parameters for customer
|
|
763
766
|
|
|
764
767
|
*/
|
|
765
768
|
|
|
766
|
-
|
|
769
|
+
customer?:object;
|
|
767
770
|
|
|
768
771
|
/**
|
|
769
|
-
* @description
|
|
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=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
|
-
|
|
776
|
+
card?:{gateway_account_id?:string};
|
|
780
777
|
|
|
781
778
|
/**
|
|
782
|
-
* @description
|
|
779
|
+
* @description Parameters for contract_term
|
|
783
780
|
|
|
784
781
|
*/
|
|
785
782
|
|
|
786
|
-
|
|
783
|
+
contract_term?:{action_at_term_end?:'cancel' | 'renew' | 'evergreen',cancellation_cutoff_period?:number};
|
|
787
784
|
|
|
788
785
|
/**
|
|
789
|
-
* @description
|
|
786
|
+
* @description Parameters for subscription_items
|
|
790
787
|
|
|
791
788
|
*/
|
|
792
789
|
|
|
793
|
-
|
|
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
|
|
793
|
+
* @description Parameters for discounts
|
|
797
794
|
|
|
798
795
|
*/
|
|
799
796
|
|
|
800
|
-
|
|
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
|
|
800
|
+
* @description Parameters for item_tiers
|
|
804
801
|
|
|
805
802
|
*/
|
|
806
803
|
|
|
807
|
-
|
|
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
|
|
807
|
+
* @description Parameters for entity_identifiers
|
|
811
808
|
|
|
812
809
|
*/
|
|
813
810
|
|
|
814
|
-
|
|
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
|
|
853
|
+
* @description If true then iframe will communicate with the parent window. Applicable only for embedded(iframe) hosted pages. If you're using iframe_messaging you need to implement onSuccess \& 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
|
-
|
|
859
|
+
iframe_messaging?:boolean;
|
|
863
860
|
|
|
864
861
|
/**
|
|
865
862
|
* @description Parameters for customer
|
|
866
863
|
|
|
867
864
|
*/
|
|
868
865
|
|
|
869
|
-
customer?:
|
|
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
|
|
881
|
+
* @description URL to redirect after payment method is added.
|
|
880
882
|
|
|
881
883
|
*/
|
|
882
884
|
|
|
883
|
-
|
|
885
|
+
redirect_url?:string;
|
|
884
886
|
|
|
885
887
|
/**
|
|
886
|
-
* @description Parameters for
|
|
888
|
+
* @description Parameters for customer
|
|
887
889
|
|
|
888
890
|
*/
|
|
889
891
|
|
|
890
|
-
|
|
892
|
+
customer?:{id:string};
|
|
891
893
|
|
|
892
894
|
/**
|
|
893
|
-
* @description Parameters for
|
|
895
|
+
* @description Parameters for card
|
|
894
896
|
|
|
895
897
|
*/
|
|
896
898
|
|
|
897
|
-
|
|
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
|
|
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
|
-
|
|
911
|
+
redirect_url?:string;
|
|
905
912
|
|
|
906
913
|
/**
|
|
907
|
-
* @description
|
|
914
|
+
* @description The currency code (ISO 4217 format) of the specified *credit amount*.
|
|
908
915
|
|
|
909
916
|
*/
|
|
910
917
|
|
|
911
|
-
|
|
918
|
+
currency_code?:string;
|
|
912
919
|
|
|
913
920
|
/**
|
|
914
|
-
* @description Parameters for
|
|
921
|
+
* @description Parameters for customer
|
|
915
922
|
|
|
916
923
|
*/
|
|
917
924
|
|
|
918
|
-
|
|
925
|
+
customer?:{id:string};
|
|
919
926
|
|
|
920
927
|
/**
|
|
921
|
-
* @description Parameters for
|
|
928
|
+
* @description Parameters for card
|
|
922
929
|
|
|
923
930
|
*/
|
|
924
931
|
|
|
925
|
-
|
|
932
|
+
card?:{gateway_account_id?:string};
|
|
926
933
|
}
|
|
927
|
-
export interface
|
|
934
|
+
export interface AcceptQuoteResponse {
|
|
928
935
|
hosted_page:HostedPage;
|
|
929
936
|
}
|
|
930
|
-
export interface
|
|
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
|
|
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
|
-
|
|
958
|
+
quote?:{id:string};
|
|
959
959
|
}
|
|
960
|
-
export interface
|
|
960
|
+
export interface ExtendSubscriptionResponse {
|
|
961
961
|
hosted_page:HostedPage;
|
|
962
962
|
}
|
|
963
|
-
export interface
|
|
963
|
+
export interface ExtendSubscriptionInputParam {
|
|
964
964
|
|
|
965
965
|
/**
|
|
966
|
-
* @description
|
|
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
|
-
|
|
970
|
+
expiry?:number;
|
|
971
971
|
|
|
972
972
|
/**
|
|
973
|
-
* @description
|
|
973
|
+
* @description Number of billing cycles to extend. If not specified, plan's billing cycle will be used.
|
|
974
974
|
|
|
975
975
|
*/
|
|
976
976
|
|
|
977
|
-
|
|
977
|
+
billing_cycle?:number;
|
|
978
978
|
|
|
979
979
|
/**
|
|
980
|
-
* @description
|
|
980
|
+
* @description Parameters for subscription
|
|
981
981
|
|
|
982
982
|
*/
|
|
983
983
|
|
|
984
|
-
|
|
984
|
+
subscription?:{id:string};
|
|
985
|
+
}
|
|
986
|
+
export interface CheckoutGiftForItemsResponse {
|
|
987
|
+
hosted_page:HostedPage;
|
|
988
|
+
}
|
|
989
|
+
export interface CheckoutGiftForItemsInputParam {
|
|
985
990
|
|
|
986
991
|
/**
|
|
987
|
-
* @description
|
|
988
|
-
|
|
989
|
-
* `invoice_date` must be in the past.
|
|
990
|
-
* `invoice_date` 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 `changes_scheduled_at`, `reactivate_from`, or `trial_end`.
|
|
992
|
-
* `invoice_immediately` is `true`.
|
|
993
|
-
.
|
|
992
|
+
* @description Sets the [context]() for this operation to the [business entity](/docs/api/advanced-features?prod_cat_ver=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=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 `terms_to_charge` is inclusive of this new term. See description for the `force_term_reset` 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
|
-
|
|
1002
|
+
business_entity_id?:string;
|
|
1012
1003
|
|
|
1013
1004
|
/**
|
|
1014
|
-
* @description
|
|
1015
|
-
**Note:** It is recommended not to pass this parameter along with `changed_scheduled_at`. `reactivate_from` 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
|
-
|
|
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, `changes_scheduled_at` cannot be earlier than 14th February.
|
|
1021
|
-
.
|
|
1007
|
+
**Note** :
|
|
1022
1008
|
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
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 `redirect_url` 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 [`subscription_created`](https://apidocs.chargebee.com/docs/api/events#subscription_created) or [`invoice_generated`](https://apidocs.chargebee.com/docs/api/events#invoice_generated)to verify a successful checkout.
|
|
1010
|
+
* Redirect URL configured in Settings \> Hosted Pages Settings would be overriden by this redirect URL.
|
|
1011
|
+
* *Eg :* *http://yoursite.com?id=* *\<hosted_page_id\>\&state=succeeded*
|
|
1012
|
+
* This parameter is not applicable for iframe messaging.
|
|
1029
1013
|
|
|
1030
1014
|
*/
|
|
1031
1015
|
|
|
1032
|
-
|
|
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
|
|
1026
|
+
* @description Parameters for gifter
|
|
1043
1027
|
|
|
1044
1028
|
*/
|
|
1045
1029
|
|
|
1046
|
-
|
|
1030
|
+
gifter?:{customer_id?:string,locale?:string};
|
|
1047
1031
|
|
|
1048
1032
|
/**
|
|
1049
|
-
* @description
|
|
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
|
-
|
|
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
|
|
1072
|
-
|
|
1073
|
-
**Note** :
|
|
1074
|
-
|
|
1075
|
-
* Cancel URL configured in Settings \> Hosted Pages Settings would be overriden by this cancel URL.
|
|
1076
|
-
*Eg : http://yoursite.com?id=\<hosted_page_id\>\&state=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
|
-
|
|
1063
|
+
gift?:{id:string};
|
|
1082
1064
|
|
|
1083
1065
|
/**
|
|
1084
|
-
* @description
|
|
1066
|
+
* @description Parameters for customer
|
|
1085
1067
|
|
|
1086
1068
|
*/
|
|
1087
1069
|
|
|
1088
|
-
|
|
1070
|
+
customer?:{locale?:string};
|
|
1071
|
+
}
|
|
1072
|
+
export interface RetrieveAgreementPdfResponse {
|
|
1073
|
+
hosted_page:HostedPage;
|
|
1074
|
+
}
|
|
1075
|
+
export interface RetrieveAgreementPdfInputParam {
|
|
1089
1076
|
|
|
1090
1077
|
/**
|
|
1091
|
-
* @description
|
|
1078
|
+
* @description Payment source to be used for this payment.
|
|
1092
1079
|
|
|
1093
1080
|
*/
|
|
1094
1081
|
|
|
1095
|
-
|
|
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
|
|
1094
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1099
1095
|
|
|
1100
1096
|
*/
|
|
1101
1097
|
|
|
1102
|
-
|
|
1098
|
+
list:{hosted_page:HostedPage}[];
|
|
1103
1099
|
|
|
1104
1100
|
/**
|
|
1105
|
-
* @description
|
|
1101
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1106
1102
|
|
|
1107
1103
|
*/
|
|
1108
1104
|
|
|
1109
|
-
|
|
1110
|
-
|
|
1105
|
+
next_offset?:string;
|
|
1106
|
+
}
|
|
1107
|
+
export interface ListInputParam {
|
|
1108
|
+
[key : string]: any;
|
|
1111
1109
|
/**
|
|
1112
|
-
* @description
|
|
1110
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1113
1111
|
|
|
1114
1112
|
*/
|
|
1115
|
-
|
|
1116
|
-
|
|
1113
|
+
|
|
1114
|
+
limit?:number;
|
|
1117
1115
|
|
|
1118
1116
|
/**
|
|
1119
|
-
* @description
|
|
1117
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1120
1118
|
|
|
1121
1119
|
*/
|
|
1122
|
-
|
|
1123
|
-
|
|
1120
|
+
|
|
1121
|
+
offset?:string;
|
|
1124
1122
|
|
|
1125
1123
|
/**
|
|
1126
|
-
* @description
|
|
1124
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1127
1125
|
|
|
1128
1126
|
*/
|
|
1129
|
-
|
|
1130
|
-
|
|
1127
|
+
|
|
1128
|
+
id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
|
|
1131
1129
|
|
|
1132
1130
|
/**
|
|
1133
|
-
* @description
|
|
1131
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1134
1132
|
|
|
1135
1133
|
*/
|
|
1136
|
-
|
|
1137
|
-
|
|
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
|
|
1138
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1141
1139
|
|
|
1142
1140
|
*/
|
|
1143
|
-
|
|
1144
|
-
|
|
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
|
|
1145
|
+
* @description This API retrieves the list of hosted page resources.
|
|
1148
1146
|
|
|
1149
1147
|
*/
|
|
1150
|
-
|
|
1151
|
-
|
|
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 `pass_thru_content.custom` is sent to Chargebee Retentio
|
|
|
1186
1184
|
|
|
1187
1185
|
subscription?:{id:string};
|
|
1188
1186
|
}
|
|
1189
|
-
export interface
|
|
1190
|
-
|
|
1191
|
-
}
|
|
1192
|
-
|
|
1193
|
-
export interface RetrieveAgreementPdfResponse {
|
|
1194
|
-
hosted_page:HostedPage;
|
|
1187
|
+
export interface EventsResponse {
|
|
1188
|
+
success:boolean;
|
|
1195
1189
|
}
|
|
1196
|
-
export interface
|
|
1190
|
+
export interface EventsInputParam {
|
|
1197
1191
|
|
|
1198
1192
|
/**
|
|
1199
|
-
* @description
|
|
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
|
-
|
|
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
|
|
1200
|
+
* @description Timestamp indicating when this event had occurred. .
|
|
1216
1201
|
|
|
1217
1202
|
*/
|
|
1218
1203
|
|
|
1219
|
-
|
|
1204
|
+
occurred_at?:number;
|
|
1220
1205
|
|
|
1221
1206
|
/**
|
|
1222
|
-
* @description
|
|
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
|
+
* `subscription_id`: A unique and immutable identifier for the subscription.
|
|
1210
|
+
.
|
|
1223
1211
|
|
|
1224
1212
|
*/
|
|
1225
1213
|
|
|
1226
|
-
|
|
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
|
|
1222
|
+
* @description Parameters for payment_voucher
|
|
1230
1223
|
|
|
1231
1224
|
*/
|
|
1232
1225
|
|
|
1233
|
-
|
|
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
|
}
|