chargebee 2.26.1 → 2.28.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/CHANGELOG.md +40 -0
- package/lib/chargebee.js +1 -1
- package/lib/resources/api_endpoints.js +8 -1
- package/package.json +1 -1
- package/types/resources/Address.d.ts +0 -10
- package/types/resources/AttachedItem.d.ts +0 -20
- package/types/resources/Card.d.ts +0 -110
- package/types/resources/Comment.d.ts +0 -17
- package/types/resources/Coupon.d.ts +0 -37
- package/types/resources/CouponCode.d.ts +0 -10
- package/types/resources/CouponSet.d.ts +0 -30
- package/types/resources/CreditNote.d.ts +0 -102
- package/types/resources/Customer.d.ts +0 -313
- package/types/resources/DifferentialPrice.d.ts +0 -20
- package/types/resources/Estimate.d.ts +0 -160
- package/types/resources/Event.d.ts +0 -7
- package/types/resources/Export.d.ts +0 -81
- package/types/resources/Feature.d.ts +0 -69
- package/types/resources/Gift.d.ts +0 -55
- package/types/resources/HostedPage.d.ts +0 -166
- package/types/resources/InAppSubscription.d.ts +0 -267
- package/types/resources/Invoice.d.ts +0 -350
- package/types/resources/Item.d.ts +0 -20
- package/types/resources/ItemEntitlement.d.ts +0 -10
- package/types/resources/ItemFamily.d.ts +0 -20
- package/types/resources/ItemPrice.d.ts +0 -20
- package/types/resources/NonSubscription.d.ts +0 -5
- package/types/resources/Order.d.ts +0 -52
- package/types/resources/PaymentIntent.d.ts +0 -25
- package/types/resources/PaymentSource.d.ts +0 -275
- package/types/resources/PaymentVoucher.d.ts +0 -10
- package/types/resources/PortalSession.d.ts +0 -33
- package/types/resources/PromotionalCredit.d.ts +0 -51
- package/types/resources/Purchase.d.ts +0 -68
- package/types/resources/Quote.d.ts +0 -165
- package/types/resources/ResourceMigration.d.ts +0 -5
- package/types/resources/Subscription.d.ts +103 -1001
- package/types/resources/TimeMachine.d.ts +0 -17
- package/types/resources/Token.d.ts +0 -15
- package/types/resources/Transaction.d.ts +0 -30
- package/types/resources/UnbilledCharge.d.ts +0 -46
- package/types/resources/Usage.d.ts +0 -22
- package/types/resources/VirtualBankAccount.d.ts +0 -35
|
@@ -247,27 +247,6 @@ In the response,
|
|
|
247
247
|
advance_invoice_estimate(subscription_id:string, input?:AdvanceInvoiceEstimateInputParam):ChargebeeRequest<AdvanceInvoiceEstimateResponse>;
|
|
248
248
|
}
|
|
249
249
|
export interface RenewalEstimateResponse {
|
|
250
|
-
/**
|
|
251
|
-
* @description This returns an estimate of the amount that will be charged when the subscription is billed next. The estimate is calculated based on the current recurring items of the subscription - plan, addons, and coupons.
|
|
252
|
-
|
|
253
|
-
In the response,
|
|
254
|
-
|
|
255
|
-
* **estimate.subscription_estimate** has the current subscription details like its status, next billing date, and so on.
|
|
256
|
-
* **estimate.invoice_estimate** has details of the invoice that will be generated at the next billing date.
|
|
257
|
-
|
|
258
|
-
The generated invoice estimate will include all the balances - [Promotional Credits](https://www.chargebee.com/docs/promotional-credits.html), Refundable Credits, and Excess Payments - if any. If you don't want these balances to be included you can specify 'false' for the parameter *use_existing_balances*.
|
|
259
|
-
|
|
260
|
-
To exclude the [delayed charges](https://www.chargebee.com/docs/charges.html) from the invoice estimate, specify 'false' for the parameter *include_delayed_charges*.
|
|
261
|
-
|
|
262
|
-
**Note:**
|
|
263
|
-
|
|
264
|
-
* This API will not generate a renewal invoice if an [advance invoice](https://www.chargebee.com/docs/advance-invoices.html) is already present for the subscription.
|
|
265
|
-
* For 'Non Renewing' subscriptions, only the [delayed charges](https://www.chargebee.com/docs/charges.html) will be included in the invoice estimate.
|
|
266
|
-
* This API is not supported for 'Cancelled' subscriptions.
|
|
267
|
-
* Only the subscription's charges will be included. If you have enabled the Consolidated invoicing feature, use the *Upcoming Invoices* estimate available for the Customer object to get the actual estimate invoice for the customer.
|
|
268
|
-
|
|
269
|
-
*/
|
|
270
|
-
|
|
271
250
|
estimate:Estimate;
|
|
272
251
|
}
|
|
273
252
|
export interface RenewalEstimateInputParam {
|
|
@@ -365,26 +344,6 @@ In the response,
|
|
|
365
344
|
ignore_scheduled_changes?:boolean;
|
|
366
345
|
}
|
|
367
346
|
export interface CreateSubItemEstimateResponse {
|
|
368
|
-
/**
|
|
369
|
-
* @description Generates an estimate for creating a subscription when the customer does not exist in Chargebee. This estimate API can be called when the customer has not yet signed up and you want to preview how a new subscription would look like for them.
|
|
370
|
-
|
|
371
|
-
**Note:** Estimate operations do not make any changes in Chargebee; hence this API does not create an actual `customer` or `subscription` record.
|
|
372
|
-
**See also**
|
|
373
|
-
|
|
374
|
-
* [Estimate a purchase](https://apidocs.chargebee.com/docs/api/purchases#estimates_for_purchase): an operation that estimates a `purchase` representing multiple subscriptions bought together by a customer.
|
|
375
|
-
|
|
376
|
-
The response contains one or more of the following objects:
|
|
377
|
-
|
|
378
|
-
* `subscription_estimate`: The subscription details like the status of the subscription (such as `in_trial` or `active`), next billing date, and so on.
|
|
379
|
-
* `invoice_estimate`:The details of the immediate invoice, if there is one. If the subscription is created in `trial`/`future` states, `invoice_estimate` is unavailable as no immediate invoice is generated.
|
|
380
|
-
* `next_invoice_estimate`:This is returned when an immediate invoice is not generated. It contains the details of the invoice that will be generated on the next billing date of the subscription.
|
|
381
|
-
* `unbilled_charge_estimates`: This contains the details of charges that have not been invoiced. This is returned only if the `invoice_immediately` parameter is set to `false`.
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
*/
|
|
387
|
-
|
|
388
347
|
estimate:Estimate;
|
|
389
348
|
}
|
|
390
349
|
export interface CreateSubItemEstimateInputParam {
|
|
@@ -503,11 +462,6 @@ The response contains one or more of the following objects:
|
|
|
503
462
|
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}[];
|
|
504
463
|
}
|
|
505
464
|
export interface CancelSubscriptionForItemsResponse {
|
|
506
|
-
/**
|
|
507
|
-
* @description This creates an estimate for canceling a subscription without actually canceling it. Estimate details include canceling date, unbilled charge options, refund credit handling, the amount to be credited after cancellation, and so on.
|
|
508
|
-
|
|
509
|
-
*/
|
|
510
|
-
|
|
511
465
|
estimate:Estimate;
|
|
512
466
|
}
|
|
513
467
|
export interface CancelSubscriptionForItemsInputParam {
|
|
@@ -604,22 +558,6 @@ The response contains one or more of the following objects:
|
|
|
604
558
|
subscription_items?:{item_price_id?:string,quantity?:number,quantity_in_decimal?:string,service_period_days?:number,unit_price?:number,unit_price_in_decimal?:string}[];
|
|
605
559
|
}
|
|
606
560
|
export interface ResumeSubscriptionResponse {
|
|
607
|
-
/**
|
|
608
|
-
* @description Generates an estimate for the 'resume subscription' operation. This is similar to the [Resume a subscription](/docs/api/subscriptions#resume_a_subscription) API, but the subscription will not be resumed. Only an estimate for this operation is created.
|
|
609
|
-
|
|
610
|
-
In the response,
|
|
611
|
-
|
|
612
|
-
* **estimate.subscription_estimate** has the subscription details.
|
|
613
|
-
* **estimate.invoice_estimate** has details of the invoice that will be generated immediately. This will not be present if no immediate invoice is generated for this operation. This will happen for in-term resumption^++^.
|
|
614
|
-
|
|
615
|
-
**^++^What is an "in-term resumption"?**
|
|
616
|
-
An "in-term resumption" is when the resumption happens within the billing term of the subscription.
|
|
617
|
-
* **estimate.next_invoice_estimate** has details of the invoice that will be generated during the next billing date of this subscription. This will be present only if no immediate invoice is generated during this operation (scenario mentioned above) and this subscription has next billing.
|
|
618
|
-
|
|
619
|
-
The generated invoice_estimate/next_invoice_estimate will include all the balances - [Promotional Credits](https://www.chargebee.com/docs/promotional-credits.html), Refundable Credits, and Excess Payments - if any.
|
|
620
|
-
|
|
621
|
-
*/
|
|
622
|
-
|
|
623
561
|
estimate:Estimate;
|
|
624
562
|
}
|
|
625
563
|
export interface ResumeSubscriptionInputParam {
|
|
@@ -646,11 +584,6 @@ In the response,
|
|
|
646
584
|
subscription?:{resume_date?:number};
|
|
647
585
|
}
|
|
648
586
|
export interface CreateInvoiceForItemsResponse {
|
|
649
|
-
/**
|
|
650
|
-
* @description This endpoint creates an invoice estimate for non-recurring items.
|
|
651
|
-
|
|
652
|
-
*/
|
|
653
|
-
|
|
654
587
|
estimate:Estimate;
|
|
655
588
|
}
|
|
656
589
|
export interface CreateInvoiceForItemsInputParam {
|
|
@@ -761,11 +694,6 @@ In the response,
|
|
|
761
694
|
discounts?:{amount?:number,apply_on:ApplyOn,item_price_id?:string,percentage?:number}[];
|
|
762
695
|
}
|
|
763
696
|
export interface GiftSubscriptionForItemsResponse {
|
|
764
|
-
/**
|
|
765
|
-
* @description This endpoint generates an estimate for a subscription that is intended to be a gift. The estimate provides details about the gift sender, gift recipient, address details of the recipient, and the type and details of subscription items included in the gift.
|
|
766
|
-
|
|
767
|
-
*/
|
|
768
|
-
|
|
769
697
|
estimate:Estimate;
|
|
770
698
|
}
|
|
771
699
|
export interface GiftSubscriptionForItemsInputParam {
|
|
@@ -820,23 +748,6 @@ In the response,
|
|
|
820
748
|
subscription_items?:{item_price_id?:string,quantity?:number,quantity_in_decimal?:string}[];
|
|
821
749
|
}
|
|
822
750
|
export interface UpdateSubscriptionForItemsResponse {
|
|
823
|
-
/**
|
|
824
|
-
* @description Returns an estimate for updating a subscription.
|
|
825
|
-
|
|
826
|
-
In the response,
|
|
827
|
-
|
|
828
|
-
* [subscription_estimate](/docs/api/estimates#subscription_estimate_attributes): The details of the changed subscription such as `status`, next billing date, and so on.
|
|
829
|
-
* [invoice_estimate](/docs/api/estimates#invoice_estimate_attributes):The details of the immediate invoice, if it is generated. An immediate invoice is not generated when:
|
|
830
|
-
* `end_of_term` parameter is true
|
|
831
|
-
* `prorate` parameter is `false`
|
|
832
|
-
* No changes are made to the plan item prices or addon item prices in `subscription_items`.
|
|
833
|
-
* For changes such as [quantity downgrades](https://www.chargebee.com/docs/proration.html#proration-mechanism_plan-quantity-downgrade-paid-invoice).
|
|
834
|
-
* [next_invoice_estimate](/docs/api/estimates#next_invoice_estimate_attributes):The details of the invoice to be generated later (if any) on the occasion that no immediate invoice has been generated.
|
|
835
|
-
* [credit_note_estimates](/docs/api/estimates#credit_note_estimate_attributes):The list of credit notes (if any) generated during this operation.
|
|
836
|
-
* [unbilled_charge_estimates](/docs/api/estimates#unbilled_charge_estimate_attributes): The details of charges that have not been invoiced. This is returned only if the `invoice_immediately` parameter is set to `false`.
|
|
837
|
-
|
|
838
|
-
*/
|
|
839
|
-
|
|
840
751
|
estimate:Estimate;
|
|
841
752
|
}
|
|
842
753
|
export interface UpdateSubscriptionForItemsInputParam {
|
|
@@ -1030,42 +941,10 @@ An immediate previous change was made
|
|
|
1030
941
|
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}[];
|
|
1031
942
|
}
|
|
1032
943
|
export interface UpcomingInvoicesEstimateResponse {
|
|
1033
|
-
/**
|
|
1034
|
-
* @description Estimate of the upcoming scheduled invoices (subscription activations, renewals etc) of a customer. For now preview of the invoices generated on the immediate upcoming date is supported. Say a customer has couple of subscription renewals scheduled on *Jan,10th* and another subscription renewal scheduled on *Jan,15th* . This API gives the preview of all the invoices scheduled to be generated on *Jan,10th* (immediate upcoming date).
|
|
1035
|
-
|
|
1036
|
-
In the response:
|
|
1037
|
-
|
|
1038
|
-
* **estimate.invoice_estimates\[\]** has details of the invoices scheduled to be generated.
|
|
1039
|
-
|
|
1040
|
-
**Note:** If *consolidated invoicing* is enabled you may use this API to test whether upcoming renewals are consolidated.
|
|
1041
|
-
|
|
1042
|
-
*/
|
|
1043
|
-
|
|
1044
944
|
estimate:Estimate;
|
|
1045
945
|
}
|
|
1046
946
|
|
|
1047
947
|
export interface RegenerateInvoiceEstimateResponse {
|
|
1048
|
-
/**
|
|
1049
|
-
* @description Regenerates the invoice for the current term of the subscription. The subscription must have `status` as `active` or `non_renewing`. This operation is not allowed when any of the following conditions hold true for the subscription:
|
|
1050
|
-
|
|
1051
|
-
* An invoice exists for the current term and its `status` is not `voided`.
|
|
1052
|
-
* There are [unbilled charges](https://www.chargebee.com/docs/unbilled-charges.html) for the current term.
|
|
1053
|
-
* The subscription has an [advance invoice](https://www.chargebee.com/docs/advance-invoices.html).
|
|
1054
|
-
|
|
1055
|
-
|
|
1056
|
-
|
|
1057
|
-
#### Response
|
|
1058
|
-
|
|
1059
|
-
Returns an `estimate` object with one of the following components depending on the value of `invoice_immediately`.
|
|
1060
|
-
|
|
1061
|
-
* If the value is `true`: an `invoice_estimate` object that corresponds to the regenerated invoice.
|
|
1062
|
-
* If the value is `false`: a list of `unbilled_charge_estimate` objects corresponding to all the unbilled charges created for the current term of the subscription.
|
|
1063
|
-
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1067
|
-
*/
|
|
1068
|
-
|
|
1069
948
|
estimate:Estimate;
|
|
1070
949
|
}
|
|
1071
950
|
export interface RegenerateInvoiceEstimateInputParam {
|
|
@@ -1099,14 +978,6 @@ Returns an `estimate` object with one of the following components depe
|
|
|
1099
978
|
invoice_immediately?:boolean;
|
|
1100
979
|
}
|
|
1101
980
|
export interface CreateSubItemForCustomerEstimateResponse {
|
|
1102
|
-
/**
|
|
1103
|
-
* @description Generates an estimate without creating a subscription. This endpoint can be called when you want to preview details of a new subscription before actually creating one.
|
|
1104
|
-
**See also**
|
|
1105
|
-
|
|
1106
|
-
* [Estimate a purchase](https://apidocs.chargebee.com/docs/api/purchases#estimates_for_purchase): an operation that estimates a `purchase` representing multiple subscriptions bought together by a customer.
|
|
1107
|
-
|
|
1108
|
-
*/
|
|
1109
|
-
|
|
1110
981
|
estimate:Estimate;
|
|
1111
982
|
}
|
|
1112
983
|
export interface CreateSubItemForCustomerEstimateInputParam {
|
|
@@ -1211,21 +1082,6 @@ Returns an `estimate` object with one of the following components depe
|
|
|
1211
1082
|
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}[];
|
|
1212
1083
|
}
|
|
1213
1084
|
export interface ChangeTermEndResponse {
|
|
1214
|
-
/**
|
|
1215
|
-
* @description Generates an estimate for the 'change term end' operation. This is similar to the [Change term end](/docs/api/subscriptions#change_term_end) API but the subscription's term end will not be changed, only an estimate for this operation is created. This is applicable only for subscriptions in 'in-trial', 'active' and 'non-renewing' states.
|
|
1216
|
-
|
|
1217
|
-
In the response,
|
|
1218
|
-
|
|
1219
|
-
* **estimate.subscription_estimate** has the subscription details like the status of the subscription (in_trial, active, etc.), next billing date, and so on.
|
|
1220
|
-
* **estimate.invoice_estimate** has details of the invoice that will be generated immediately. This will not be present if no immediate invoice is generated for this operation. This will happen when
|
|
1221
|
-
* *prorate* parameter is false, or
|
|
1222
|
-
* *invoice_immediately* parameter is false, or
|
|
1223
|
-
* subscription is in *in-trial* state
|
|
1224
|
-
* **estimate.credit_note_estimates\[\]** has details of the credit-notes that will get generated during this operation. This list will be empty if no credit-note gets generated during this operation.
|
|
1225
|
-
* **estimate.unbilled_charge_estimates\[\]** has details of the unbilled charges. This is returned only if *invoice_immediately* is set as false.
|
|
1226
|
-
|
|
1227
|
-
*/
|
|
1228
|
-
|
|
1229
1085
|
estimate:Estimate;
|
|
1230
1086
|
}
|
|
1231
1087
|
export interface ChangeTermEndInputParam {
|
|
@@ -1253,17 +1109,6 @@ In the response,
|
|
|
1253
1109
|
invoice_immediately?:boolean;
|
|
1254
1110
|
}
|
|
1255
1111
|
export interface PauseSubscriptionResponse {
|
|
1256
|
-
/**
|
|
1257
|
-
* @description This API provides an estimate of the details pertaining to the [pause_subscription](/docs/api/subscriptions#pause_a_subscription) operation. It returns attributes such as [pause_date](/docs/api/estimates#estimate_subscription_estimate_pause_date) and [resume_date](/docs/api/estimates#estimate_subscription_estimate_resume_date). This is similar to the [Pause a subscription](/docs/api/subscriptions#pause_a_subscription) API with the exception that the subscription is not paused. Only an estimate for this operation is created.
|
|
1258
|
-
|
|
1259
|
-
In the response,
|
|
1260
|
-
|
|
1261
|
-
* **estimate.subscription_estimate** has the subscription details.
|
|
1262
|
-
* **estimate.invoice_estimate** has details of the invoice that are generated immediately. This is not present if no immediate invoices are generated for this operation.
|
|
1263
|
-
* **estimate.credit_note_estimates\[\]** has details of the credit notes that are generated during this operation. This list is empty if no credit notes are generated.
|
|
1264
|
-
|
|
1265
|
-
*/
|
|
1266
|
-
|
|
1267
1112
|
estimate:Estimate;
|
|
1268
1113
|
}
|
|
1269
1114
|
export interface PauseSubscriptionInputParam {
|
|
@@ -1305,11 +1150,6 @@ If `no_action` is chosen, charges are added to the resumption invoice.
|
|
|
1305
1150
|
subscription?:{pause_date?:number,resume_date?:number,skip_billing_cycles?:number};
|
|
1306
1151
|
}
|
|
1307
1152
|
export interface AdvanceInvoiceEstimateResponse {
|
|
1308
|
-
/**
|
|
1309
|
-
* @description This API is used to generate an invoice estimate for preview. Estimate details include the number of billing cycles to be invoiced in advance, the number of billing cycles in one interval, advance invoicing schedules, and so on.
|
|
1310
|
-
|
|
1311
|
-
*/
|
|
1312
|
-
|
|
1313
1153
|
estimate:Estimate;
|
|
1314
1154
|
}
|
|
1315
1155
|
export interface AdvanceInvoiceEstimateInputParam {
|
|
@@ -160,13 +160,6 @@ declare module 'chargebee' {
|
|
|
160
160
|
sort_by?:{asc?:'occurred_at',desc?:'occurred_at'};
|
|
161
161
|
}
|
|
162
162
|
export interface RetrieveResponse {
|
|
163
|
-
/**
|
|
164
|
-
* @description Retrieves a specific event identified by a unique event identifier.
|
|
165
|
-
|
|
166
|
-
**Note:** Only events that are less than 90 days old will be retrieved.
|
|
167
|
-
|
|
168
|
-
*/
|
|
169
|
-
|
|
170
163
|
event:Event;
|
|
171
164
|
}
|
|
172
165
|
|
|
@@ -158,11 +158,6 @@ declare module 'chargebee' {
|
|
|
158
158
|
subscriptions(input?:SubscriptionsInputParam):ChargebeeRequest<SubscriptionsResponse>;
|
|
159
159
|
}
|
|
160
160
|
export interface CustomersResponse {
|
|
161
|
-
/**
|
|
162
|
-
* @description This API triggers export of customer data. The exported zip file contains CSV files with customer-related data.
|
|
163
|
-
|
|
164
|
-
*/
|
|
165
|
-
|
|
166
161
|
export:Export;
|
|
167
162
|
}
|
|
168
163
|
export interface CustomersInputParam {
|
|
@@ -200,11 +195,6 @@ The ID of the business entity created for the site. For Product Catalog 1.0, all
|
|
|
200
195
|
relationship?:{invoice_owner_id?:{is?:string,is_not?:string,starts_with?:string},parent_id?:{is?:string,is_not?:string,starts_with?:string},payment_owner_id?:{is?:string,is_not?:string,starts_with?:string}};
|
|
201
196
|
}
|
|
202
197
|
export interface AttachedItemsResponse {
|
|
203
|
-
/**
|
|
204
|
-
* @description This API triggers export of attached item data. The exported zip file contains CSV files with attached item-related data.
|
|
205
|
-
|
|
206
|
-
*/
|
|
207
|
-
|
|
208
198
|
export:Export;
|
|
209
199
|
}
|
|
210
200
|
export interface AttachedItemsInputParam {
|
|
@@ -228,11 +218,6 @@ To filter based on the type of of the attached item. Possible values are : `
|
|
|
228
218
|
attached_item?:{charge_on_event?:{in?:string,is?:'subscription_creation' | 'subscription_activation' | 'subscription_trial_start' | 'contract_termination' | 'plan_activation' | 'on_demand',is_not?:'subscription_creation' | 'subscription_activation' | 'subscription_trial_start' | 'contract_termination' | 'plan_activation' | 'on_demand',not_in?:string},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},item_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},parent_item_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},type?:{in?:string,is?:'optional' | 'mandatory' | 'recommended',is_not?:'optional' | 'mandatory' | 'recommended',not_in?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
229
219
|
}
|
|
230
220
|
export interface TransactionsResponse {
|
|
231
|
-
/**
|
|
232
|
-
* @description This API triggers export of transaction data. The exported zip file contains CSV files with transaction-related data.
|
|
233
|
-
|
|
234
|
-
*/
|
|
235
|
-
|
|
236
221
|
export:Export;
|
|
237
222
|
}
|
|
238
223
|
export interface TransactionsInputParam {
|
|
@@ -245,11 +230,6 @@ To filter based on the type of of the attached item. Possible values are : `
|
|
|
245
230
|
transaction?:{amount?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},amount_capturable?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},customer_id?:{in?:string,is?:string,is_not?:string,is_present?:'true' | 'false',not_in?:string,starts_with?:string},date?:{after?:string,before?:string,between?:string,on?:string},gateway?:{in?:string,is?:'bluepay' | 'beanstream' | 'elavon' | 'orbital' | 'hdfc' | 'nmi' | 'moneris' | 'metrics_global' | 'pin' | 'stripe' | 'quickbooks' | 'razorpay' | 'eway_rapid' | 'balanced_payments' | 'ecentric' | 'wepay' | 'chargebee_payments' | 'bank_of_america' | 'braintree' | 'first_data_global' | 'paypal_express_checkout' | 'ingenico_direct' | 'moneris_us' | 'exact' | 'migs' | 'checkout_com' | 'not_applicable' | 'paypal_pro' | 'ogone' | 'eway' | 'gocardless' | 'global_payments' | 'paymill' | 'adyen' | 'paypal' | 'chargebee' | 'authorize_net' | 'tco' | 'bluesnap' | 'windcave' | 'paypal_payflow_pro' | 'amazon_payments' | 'mollie' | 'cybersource' | 'wirecard' | 'sage_pay' | 'vantiv' | 'worldpay',is_not?:'bluepay' | 'beanstream' | 'elavon' | 'orbital' | 'hdfc' | 'nmi' | 'moneris' | 'metrics_global' | 'pin' | 'stripe' | 'quickbooks' | 'razorpay' | 'eway_rapid' | 'balanced_payments' | 'ecentric' | 'wepay' | 'chargebee_payments' | 'bank_of_america' | 'braintree' | 'first_data_global' | 'paypal_express_checkout' | 'ingenico_direct' | 'moneris_us' | 'exact' | 'migs' | 'checkout_com' | 'not_applicable' | 'paypal_pro' | 'ogone' | 'eway' | 'gocardless' | 'global_payments' | 'paymill' | 'adyen' | 'paypal' | 'chargebee' | 'authorize_net' | 'tco' | 'bluesnap' | 'windcave' | 'paypal_payflow_pro' | 'amazon_payments' | 'mollie' | 'cybersource' | 'wirecard' | 'sage_pay' | 'vantiv' | 'worldpay',not_in?:string},gateway_account_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},id_at_gateway?:{is?:string,is_not?:string,starts_with?:string},payment_method?:{in?:string,is?:'other' | 'netbanking_emandates' | 'ach_credit' | 'dotpay' | 'boleto' | 'direct_debit' | 'chargeback' | 'wechat_pay' | 'cash' | 'giropay' | 'bank_transfer' | 'alipay' | 'ideal' | 'google_pay' | 'custom' | 'unionpay' | 'check' | 'sofort' | 'amazon_payments' | 'upi' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'sepa_credit' | 'card',is_not?:'other' | 'netbanking_emandates' | 'ach_credit' | 'dotpay' | 'boleto' | 'direct_debit' | 'chargeback' | 'wechat_pay' | 'cash' | 'giropay' | 'bank_transfer' | 'alipay' | 'ideal' | 'google_pay' | 'custom' | 'unionpay' | 'check' | 'sofort' | 'amazon_payments' | 'upi' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'sepa_credit' | 'card',not_in?:string},payment_source_id?:{in?:string,is?:string,is_not?:string,is_present?:'true' | 'false',not_in?:string,starts_with?:string},reference_number?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string},status?:{in?:string,is?:'in_progress' | 'success' | 'failure' | 'voided' | 'timeout' | 'needs_attention',is_not?:'in_progress' | 'success' | 'failure' | 'voided' | 'timeout' | 'needs_attention',not_in?:string},subscription_id?:{in?:string,is?:string,is_not?:string,is_present?:'true' | 'false',not_in?:string,starts_with?:string},type?:{in?:string,is?:'authorization' | 'payment_reversal' | 'payment' | 'refund',is_not?:'authorization' | 'payment_reversal' | 'payment' | 'refund',not_in?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
246
231
|
}
|
|
247
232
|
export interface DifferentialPricesResponse {
|
|
248
|
-
/**
|
|
249
|
-
* @description This API triggers export of differential price data. The exported zip file contains CSV files with differential price-related data.
|
|
250
|
-
|
|
251
|
-
*/
|
|
252
|
-
|
|
253
233
|
export:Export;
|
|
254
234
|
}
|
|
255
235
|
export interface DifferentialPricesInputParam {
|
|
@@ -273,11 +253,6 @@ Item Id of Addon / Charge item price for which differential pricing is applied t
|
|
|
273
253
|
differential_price?:{id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},item_price_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},parent_item_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string}};
|
|
274
254
|
}
|
|
275
255
|
export interface ItemFamiliesResponse {
|
|
276
|
-
/**
|
|
277
|
-
* @description This API triggers export of item family data. The exported zip file contains CSV files with item family-related data.
|
|
278
|
-
|
|
279
|
-
*/
|
|
280
|
-
|
|
281
256
|
export:Export;
|
|
282
257
|
}
|
|
283
258
|
export interface ItemFamiliesInputParam {
|
|
@@ -290,11 +265,6 @@ Item Id of Addon / Charge item price for which differential pricing is applied t
|
|
|
290
265
|
item_family?:{id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},name?:{is?:string,is_not?:string,starts_with?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
291
266
|
}
|
|
292
267
|
export interface InvoicesResponse {
|
|
293
|
-
/**
|
|
294
|
-
* @description This API triggers export of invoice data. The exported zip file contains CSV files with invoice-related data.
|
|
295
|
-
|
|
296
|
-
*/
|
|
297
|
-
|
|
298
268
|
export:Export;
|
|
299
269
|
}
|
|
300
270
|
export interface InvoicesInputParam {
|
|
@@ -318,22 +288,10 @@ Payment owner of an invoice.
|
|
|
318
288
|
invoice?:{amount_adjusted?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},amount_due?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},amount_paid?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},channel?:{in?:string,is?:'app_store' | 'web' | 'play_store',is_not?:'app_store' | 'web' | 'play_store',not_in?:string},credits_applied?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},customer_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},date?:{after?:string,before?:string,between?:string,on?:string},dunning_status?:{in?:string,is?:'in_progress' | 'stopped' | 'success' | 'exhausted',is_not?:'in_progress' | 'stopped' | 'success' | 'exhausted',is_present?:'true' | 'false',not_in?:string},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},paid_at?:{after?:string,before?:string,between?:string,on?:string},price_type?:{in?:string,is?:'tax_exclusive' | 'tax_inclusive',is_not?:'tax_exclusive' | 'tax_inclusive',not_in?:string},recurring?:{is?:'true' | 'false'},status?:{in?:string,is?:'pending' | 'paid' | 'voided' | 'not_paid' | 'posted' | 'payment_due',is_not?:'pending' | 'paid' | 'voided' | 'not_paid' | 'posted' | 'payment_due',not_in?:string},subscription_id?:{in?:string,is?:string,is_not?:string,is_present?:'true' | 'false',not_in?:string,starts_with?:string},total?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
319
289
|
}
|
|
320
290
|
export interface RetrieveResponse {
|
|
321
|
-
/**
|
|
322
|
-
* @description This API gets the status of the export job initiated by the Exports API. If the export job is completed, the downloads resource will also be obtained in the API response. The returned URL in the downloads resource is secure and can be downloaded. The URL expires after 4 hours. Please note that this is a public URL, and can be downloaded by anyone with whom it's shared.
|
|
323
|
-
|
|
324
|
-
**Note:** In case the export is in Failed or In-process state, then the downloads resource will not be available.
|
|
325
|
-
|
|
326
|
-
*/
|
|
327
|
-
|
|
328
291
|
export:Export;
|
|
329
292
|
}
|
|
330
293
|
|
|
331
294
|
export interface ItemsResponse {
|
|
332
|
-
/**
|
|
333
|
-
* @description This API triggers export of item data. The exported zip file contains CSV files with item-related data.
|
|
334
|
-
|
|
335
|
-
*/
|
|
336
|
-
|
|
337
295
|
export:Export;
|
|
338
296
|
}
|
|
339
297
|
export interface ItemsInputParam {
|
|
@@ -346,13 +304,6 @@ Payment owner of an invoice.
|
|
|
346
304
|
item?:{channel?:{in?:string,is?:'app_store' | 'web' | 'play_store',is_not?:'app_store' | 'web' | 'play_store',not_in?:string},enabled_for_checkout?:{is?:'true' | 'false'},enabled_in_portal?:{is?:'true' | 'false'},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},is_giftable?:{is?:'true' | 'false'},item_applicability?:{in?:string,is?:'all' | 'restricted',is_not?:'all' | 'restricted',not_in?:string},item_family_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},metered?:{is?:'true' | 'false'},name?:{is?:string,is_not?:string,starts_with?:string},status?:{in?:string,is?:'archived' | 'deleted' | 'active',is_not?:'archived' | 'deleted' | 'active',not_in?:string},type?:{in?:string,is?:'charge' | 'addon' | 'plan',is_not?:'charge' | 'addon' | 'plan',not_in?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string},usage_calculation?:{in?:string,is?:'max_usage' | 'sum_of_usages' | 'last_usage',is_not?:'max_usage' | 'sum_of_usages' | 'last_usage',not_in?:string}};
|
|
347
305
|
}
|
|
348
306
|
export interface DeferredRevenueResponse {
|
|
349
|
-
/**
|
|
350
|
-
* @description This API triggers export for the Deferred Revenue Report.
|
|
351
|
-
|
|
352
|
-
**Note:** This API call is asynchronous. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. In case you are using any of the client libraries, use the **wait for export completion** function provided as an instance method in the library. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **waitForExportCompletion()** on the returned **Export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **waitForExportCompletion()** on the returned **Export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **WaitForExportCompletion** on the returned **Export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which wait until the export status changes.
|
|
353
|
-
|
|
354
|
-
*/
|
|
355
|
-
|
|
356
307
|
export:Export;
|
|
357
308
|
}
|
|
358
309
|
export interface DeferredRevenueInputParam {
|
|
@@ -490,13 +441,6 @@ The ID of the business entity created for the site. For Product Catalog 1.0, all
|
|
|
490
441
|
relationship?:{invoice_owner_id?:{is?:string,is_not?:string,starts_with?:string},parent_id?:{is?:string,is_not?:string,starts_with?:string},payment_owner_id?:{is?:string,is_not?:string,starts_with?:string}};
|
|
491
442
|
}
|
|
492
443
|
export interface RevenueRecognitionResponse {
|
|
493
|
-
/**
|
|
494
|
-
* @description This API triggers export for the revenue recognition report.
|
|
495
|
-
|
|
496
|
-
**Note:** This API call is asynchronous. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. In case you are using any of the client libraries, use the **wait for export completion** function provided as an instance method in the library. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **waitForExportCompletion()** on the returned **Export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **waitForExportCompletion()** on the returned **Export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **WaitForExportCompletion** on the returned **Export** resource which will wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which wait until the export status changes. You need to check if this operation has completed by checking if the export status is **completed** . You can do this by retrieving the export in a loop with a minimum delay of 10 secs between two retrieve requests. Use the method **wait_for_export_completion** on the returned **export** resource which wait until the export status changes.
|
|
497
|
-
|
|
498
|
-
*/
|
|
499
|
-
|
|
500
444
|
export:Export;
|
|
501
445
|
}
|
|
502
446
|
export interface RevenueRecognitionInputParam {
|
|
@@ -634,11 +578,6 @@ The ID of the business entity created for the site. For Product Catalog 1.0, all
|
|
|
634
578
|
relationship?:{invoice_owner_id?:{is?:string,is_not?:string,starts_with?:string},parent_id?:{is?:string,is_not?:string,starts_with?:string},payment_owner_id?:{is?:string,is_not?:string,starts_with?:string}};
|
|
635
579
|
}
|
|
636
580
|
export interface CreditNotesResponse {
|
|
637
|
-
/**
|
|
638
|
-
* @description This API triggers export of credit note data. The exported zip file contains CSV files with credit note-related data.
|
|
639
|
-
|
|
640
|
-
*/
|
|
641
|
-
|
|
642
581
|
export:Export;
|
|
643
582
|
}
|
|
644
583
|
export interface CreditNotesInputParam {
|
|
@@ -651,11 +590,6 @@ The ID of the business entity created for the site. For Product Catalog 1.0, all
|
|
|
651
590
|
credit_note?:{amount_allocated?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},amount_available?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},amount_refunded?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},channel?:{in?:string,is?:'app_store' | 'web' | 'play_store',is_not?:'app_store' | 'web' | 'play_store',not_in?:string},create_reason_code?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},customer_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},date?:{after?:string,before?:string,between?:string,on?:string},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},price_type?:{in?:string,is?:'tax_exclusive' | 'tax_inclusive',is_not?:'tax_exclusive' | 'tax_inclusive',not_in?:string},reason_code?:{in?:string,is?:'other' | 'product_unsatisfactory' | 'subscription_pause' | 'order_cancellation' | 'service_unsatisfactory' | 'subscription_cancellation' | 'chargeback' | 'order_change' | 'write_off' | 'waiver' | 'subscription_change' | 'fraudulent',is_not?:'other' | 'product_unsatisfactory' | 'subscription_pause' | 'order_cancellation' | 'service_unsatisfactory' | 'subscription_cancellation' | 'chargeback' | 'order_change' | 'write_off' | 'waiver' | 'subscription_change' | 'fraudulent',not_in?:string},reference_invoice_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},status?:{in?:string,is?:'refund_due' | 'adjusted' | 'refunded' | 'voided',is_not?:'refund_due' | 'adjusted' | 'refunded' | 'voided',not_in?:string},subscription_id?:{in?:string,is?:string,is_not?:string,is_present?:'true' | 'false',not_in?:string,starts_with?:string},total?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},type?:{in?:string,is?:'adjustment' | 'refundable',is_not?:'adjustment' | 'refundable',not_in?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string},voided_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
652
591
|
}
|
|
653
592
|
export interface CouponsResponse {
|
|
654
|
-
/**
|
|
655
|
-
* @description This API triggers export of coupon data. The exported zip file contains CSV files with coupon-related data.
|
|
656
|
-
|
|
657
|
-
*/
|
|
658
|
-
|
|
659
593
|
export:Export;
|
|
660
594
|
}
|
|
661
595
|
export interface CouponsInputParam {
|
|
@@ -679,11 +613,6 @@ The currency code ([ISO 4217 format](https://www.chargebee.com/docs/supported-cu
|
|
|
679
613
|
coupon?:{apply_on?:{in?:string,is?:'invoice_amount' | 'each_specified_item',is_not?:'invoice_amount' | 'each_specified_item',not_in?:string},created_at?:{after?:string,before?:string,between?:string,on?:string},discount_type?:{in?:string,is?:'fixed_amount' | 'percentage',is_not?:'fixed_amount' | 'percentage',not_in?:string},duration_type?:{in?:string,is?:'limited_period' | 'one_time' | 'forever',is_not?:'limited_period' | 'one_time' | 'forever',not_in?:string},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},name?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},status?:{in?:string,is?:'archived' | 'expired' | 'deleted' | 'active',is_not?:'archived' | 'expired' | 'deleted' | 'active',not_in?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
680
614
|
}
|
|
681
615
|
export interface OrdersResponse {
|
|
682
|
-
/**
|
|
683
|
-
* @description This API triggers export of order data. The exported zip file contains CSV files with order-related data.
|
|
684
|
-
|
|
685
|
-
*/
|
|
686
|
-
|
|
687
616
|
export:Export;
|
|
688
617
|
}
|
|
689
618
|
export interface OrdersInputParam {
|
|
@@ -707,11 +636,6 @@ Total amount charged for the order.
|
|
|
707
636
|
order?:{amount_paid?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},cancelled_at?:{after?:string,before?:string,between?:string,on?:string},customer_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},delivered_at?:{after?:string,before?:string,between?:string,on?:string},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},is_resent?:{is?:'true' | 'false'},order_date?:{after?:string,before?:string,between?:string,on?:string},original_order_id?:{is?:string,is_not?:string,starts_with?:string},price_type?:{in?:string,is?:'tax_exclusive' | 'tax_inclusive',is_not?:'tax_exclusive' | 'tax_inclusive',not_in?:string},refundable_credits?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},refundable_credits_issued?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},resent_status?:{in?:string,is?:'fully_resent' | 'partially_resent',is_not?:'fully_resent' | 'partially_resent',not_in?:string},shipped_at?:{after?:string,before?:string,between?:string,on?:string},shipping_date?:{after?:string,before?:string,between?:string,on?:string},status?:{in?:string,is?:'new' | 'partially_delivered' | 'queued' | 'delivered' | 'on_hold' | 'shipped' | 'processing' | 'cancelled' | 'voided' | 'complete' | 'awaiting_shipment' | 'returned',is_not?:'new' | 'partially_delivered' | 'queued' | 'delivered' | 'on_hold' | 'shipped' | 'processing' | 'cancelled' | 'voided' | 'complete' | 'awaiting_shipment' | 'returned',not_in?:string},subscription_id?:{in?:string,is?:string,is_not?:string,is_present?:'true' | 'false',not_in?:string,starts_with?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
708
637
|
}
|
|
709
638
|
export interface ItemPricesResponse {
|
|
710
|
-
/**
|
|
711
|
-
* @description This API triggers export of item price data. The exported zip file contains CSV files with item price-related data.
|
|
712
|
-
|
|
713
|
-
*/
|
|
714
|
-
|
|
715
639
|
export:Export;
|
|
716
640
|
}
|
|
717
641
|
export interface ItemPricesInputParam {
|
|
@@ -757,11 +681,6 @@ Filter item prices based on their `currency_code`.
|
|
|
757
681
|
item_price?:{channel?:{in?:string,is?:'app_store' | 'web' | 'play_store',is_not?:'app_store' | 'web' | 'play_store',not_in?:string},id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},item_id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},name?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string},period?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},period_unit?:{in?:string,is?:'week' | 'month' | 'year' | 'day',is_not?:'week' | 'month' | 'year' | 'day',not_in?:string},pricing_model?:{in?:string,is?:'volume' | 'per_unit' | 'tiered' | 'flat_fee' | 'stairstep',is_not?:'volume' | 'per_unit' | 'tiered' | 'flat_fee' | 'stairstep',not_in?:string},status?:{in?:string,is?:'archived' | 'deleted' | 'active',is_not?:'archived' | 'deleted' | 'active',not_in?:string},trial_period?:{between?:string,gt?:string,gte?:string,is?:string,is_not?:string,lt?:string,lte?:string},trial_period_unit?:{in?:string,is?:'month' | 'day',is_not?:'month' | 'day',not_in?:string},updated_at?:{after?:string,before?:string,between?:string,on?:string}};
|
|
758
682
|
}
|
|
759
683
|
export interface SubscriptionsResponse {
|
|
760
|
-
/**
|
|
761
|
-
* @description This API triggers export of subscription data. The exported zip file contains CSV files with subscription-related data.
|
|
762
|
-
|
|
763
|
-
*/
|
|
764
|
-
|
|
765
684
|
export:Export;
|
|
766
685
|
}
|
|
767
686
|
export interface SubscriptionsInputParam {
|
|
@@ -227,11 +227,6 @@ However, changing `levels[]` to the state shown below is not permissib
|
|
|
227
227
|
type?:{in?:string,is?:'quantity' | 'custom' | 'range' | 'switch',is_not?:'quantity' | 'custom' | 'range' | 'switch',not_in?:string};
|
|
228
228
|
}
|
|
229
229
|
export interface CreateResponse {
|
|
230
|
-
/**
|
|
231
|
-
* @description Creates a new feature and optionally defines the <item_entitlements> for it.
|
|
232
|
-
|
|
233
|
-
*/
|
|
234
|
-
|
|
235
230
|
feature:Feature;
|
|
236
231
|
}
|
|
237
232
|
export interface CreateInputParam {
|
|
@@ -287,63 +282,14 @@ However, changing `levels[]` to the state shown below is not permissib
|
|
|
287
282
|
levels?:{is_unlimited?:boolean,level?:number,name?:string,value?:string}[];
|
|
288
283
|
}
|
|
289
284
|
export interface DeleteResponse {
|
|
290
|
-
/**
|
|
291
|
-
* @description Deletes a feature. Any item entitlements and subscription entitlements defined for the feature are also removed. This action is not permissible when the `status` of the feature is `active`.
|
|
292
|
-
|
|
293
|
-
*/
|
|
294
|
-
|
|
295
285
|
feature:Feature;
|
|
296
286
|
}
|
|
297
287
|
|
|
298
288
|
export interface RetrieveResponse {
|
|
299
|
-
/**
|
|
300
|
-
* @description Retrieve a specific feature using its id.
|
|
301
|
-
|
|
302
|
-
*/
|
|
303
|
-
|
|
304
289
|
feature:Feature;
|
|
305
290
|
}
|
|
306
291
|
|
|
307
292
|
export interface UpdateResponse {
|
|
308
|
-
/**
|
|
309
|
-
* @description Updates a specific feature.
|
|
310
|
-
**Note**
|
|
311
|
-
|
|
312
|
-
The list of objects `levels[]` provided as part of this operation fully replaces the existing list of objects [levels[]](features#feature_levels) of the feature.
|
|
313
|
-
|
|
314
|
-
### Considerations when modifying `levels` {#considerations}
|
|
315
|
-
|
|
316
|
-
This section describes validations that are performed by Chargebee when modifying the `levels` list of objects for the feature, using this operation.
|
|
317
|
-
|
|
318
|
-
#### Adding `levels` {#adding}
|
|
319
|
-
|
|
320
|
-
Adding a new object to the `levels[]` list is allowed if and only if the feature [type](features#feature_type) is `quantity` or `custom`
|
|
321
|
-
|
|
322
|
-
#### Removing `levels` {#removing}
|
|
323
|
-
|
|
324
|
-
Removing an existing object in the `levels[]` list is not allowed if the `value` for that object is currently mapped to one or more [item_entitlement](item_entitlements)s or [subscription_entitlement](subscription_entitlements)s.
|
|
325
|
-
|
|
326
|
-
#### Reordering `levels` {#reorder}
|
|
327
|
-
|
|
328
|
-
**Note**
|
|
329
|
-
|
|
330
|
-
The validation described in this section is only applicable for features of `type` `custom`
|
|
331
|
-
|
|
332
|
-
If any of `levels[].value` are currently mapped to `item_entitlement`s or `subscription_entitlement`s, then the relative order of the corresponding `levels[].level` must be preserved when invoking this operation.
|
|
333
|
-
|
|
334
|
-
For example, consider that the `levels[]` list is currently in the state shown below. (For brevity, only the `value` and `level` key are shown here and the JSONs have been compacted.)
|
|
335
|
-
` {"levels":[{"value":"email-basic","level":0},{"value":"email-rise","level":1},{"value":"email-advanced","level":2},{"value":"email-pro","level":3},{"value":"email-scale","level":4}]} `
|
|
336
|
-
|
|
337
|
-
Now consider that `email-rise`, `email-advanced`, and `email-pro` have already been mapped to `item_entitlement`s or `subscription_entitlement`s. As seen in the above object, the relative order of `levels[].level` is such that `email-rise` \< `email-advanced` \< `email-pro`.
|
|
338
|
-
|
|
339
|
-
Invoking this API to change `levels[]` to the state below is allowed since the relative order of `level` corresponding to `email-rise`, `email-advanced`, and `email-pro` has been preserved.
|
|
340
|
-
` {"levels":[{"value":"email-basic","level":0},{"value":"email-rise","level":1},{"value":"email-scale","level":2},{"value":"email-advanced","level":3},{"value":"email-pro","level":4}]} `
|
|
341
|
-
|
|
342
|
-
However, changing `levels[]` to the state shown below is not permissible because the `level` of `email-advanced` is provided as greater than the `level` of `email-pro`, thereby disrupting the original order.
|
|
343
|
-
` {"levels":[{"value":"email-basic","level":0},{"value":"email-rise","level":1},{"value":"email-pro","level":2},{"value":"email-advanced","level":3},{"value":"email-scale","level":4}]} `
|
|
344
|
-
|
|
345
|
-
*/
|
|
346
|
-
|
|
347
293
|
feature:Feature;
|
|
348
294
|
}
|
|
349
295
|
export interface UpdateInputParam {
|
|
@@ -385,29 +331,14 @@ However, changing `levels[]` to the state shown below is not permissib
|
|
|
385
331
|
levels?:{is_unlimited?:boolean,level?:number,name?:string,value?:string}[];
|
|
386
332
|
}
|
|
387
333
|
export interface ArchiveResponse {
|
|
388
|
-
/**
|
|
389
|
-
* @description Archives an `active` feature so that no **new** [item](item_entitlements) or [subscription entitlements](subscription_entitlements) can be created towards the feature. Any pre-existing item or subscription entitlements from the time that the feature was `active` remain effective. This operation changes the [status](features#feature_status) of the feature to `archived`. The feature `status` must be `active` when calling this endpoint.
|
|
390
|
-
|
|
391
|
-
*/
|
|
392
|
-
|
|
393
334
|
feature:Feature;
|
|
394
335
|
}
|
|
395
336
|
|
|
396
337
|
export interface ActivateResponse {
|
|
397
|
-
/**
|
|
398
|
-
* @description Activates a `draft` feature so that any [item](item_entitlements) or [subscription entitlements](subscription_entitlements) defined towards it take effect immediately. This operation changes the [status](features#feature_status) of the feature to `active`. The feature `status` must be `draft` when calling this endpoint.
|
|
399
|
-
|
|
400
|
-
*/
|
|
401
|
-
|
|
402
338
|
feature:Feature;
|
|
403
339
|
}
|
|
404
340
|
|
|
405
341
|
export interface ReactivateResponse {
|
|
406
|
-
/**
|
|
407
|
-
* @description Reactivates an archived feature so that **new** [item](item_entitlements) or [subscription entitlements](subscription_entitlements) can be created towards the feature. This operation changes the [status](features#feature_status) of the feature to `active`. The feature `status` must be `archived` when calling this endpoint.
|
|
408
|
-
|
|
409
|
-
*/
|
|
410
|
-
|
|
411
342
|
feature:Feature;
|
|
412
343
|
}
|
|
413
344
|
|