chargebee 2.35.1 → 2.36.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.
@@ -30,749 +30,180 @@ declare module 'chargebee' {
30
30
 
31
31
  email?:string;
32
32
 
33
- /**
34
- * @description Phone number of the customer
35
-
36
- */
37
-
38
33
  phone?:string;
39
34
 
40
- /**
41
- * @description Company name of the customer.
42
-
43
- */
44
-
45
35
  company?:string;
46
36
 
47
- /**
48
- * @description The VAT/tax registration number for the customer. For customers with [billing_address](customers#customer_billing_address) `country` as `XI` (which is **United Kingdom - Northern Ireland** ), the first two characters of the [full VAT
49
- number](https://en.wikipedia.org/wiki/VAT_identification_number) can be overridden by setting [vat_number_prefix](customers#customer_vat_number_prefix).
50
-
51
- */
52
-
53
37
  vat_number?:string;
54
38
 
55
- /**
56
- * @description When the customer has a [payment_method](customers#customer_payment_method) of `type` `card`, this attribute determines whether to automatically charge the card whenever an invoice [status](invoices#invoice_status) is `payment_due`.
57
- **Note**
58
-
59
- This setting can be [overridden](subscriptions#create_subscription_for_items_auto_collection) for individual subscriptions of the customer.
60
- \* on - Chargebee automatically charges the card for invoices that enter `payment_due` `status`. \* off - Automatic charging is disabled; manual payment is required for due invoices.
61
-
62
- */
63
-
64
39
  auto_collection:AutoCollection;
65
40
 
66
- /**
67
- * @description The preferred offline payment method for the customer. \* sepa_credit - SEPA Credit \* cash - Cash \* no_preference - No Preference \* bank_transfer - Bank Transfer \* check - Check \* boleto - Boleto \* ach_credit - ACH Credit
68
-
69
- */
70
-
71
41
  offline_payment_method?:OfflinePaymentMethod;
72
42
 
73
- /**
74
- * @description The number of days within which the customer has to make payment for the invoice.
75
-
76
- */
77
-
78
43
  net_term_days:number;
79
44
 
80
- /**
81
- * @description Returns the recent VAT number validation time.
82
-
83
- */
84
-
85
45
  vat_number_validated_time?:number;
86
46
 
87
- /**
88
- * @description Represents the VAT validation status. This is applicable if you have configured EU, UK or Australian taxes and the [VAT number validation](https://www.chargebee.com/docs/2.0/uk-vat.html#uk-vat-validation) is enabled. \* not_validated - This status is only applicable for countries in European Zone. This is applicable when both the customer's billing address and the organization's address should be of the same European Zone and EU tax should be configured with the "'Also validate VAT Number for Country of Business'" option in the disabled status. \* undetermined - When Chargebee is not able to validate the VAT number it is stored as 'undetermined'. This can occur due to reasons like service outage etc. VAT numbers with 'undetermined' status will be in queue for validation on daily basis. \* valid - If the given VAT number is valid. \* invalid - If the given VAT number is invalid.
89
-
90
- */
91
-
92
- vat_number_status?:'valid' | 'undetermined' | 'invalid' | 'not_validated';
93
-
94
- /**
95
- * @description Whether the customer can pay via Direct Debit
96
-
97
- */
47
+ vat_number_status?:'valid' | 'invalid' | 'not_validated' | 'undetermined';
98
48
 
99
49
  allow_direct_debit:boolean;
100
50
 
101
- /**
102
- * @description **Note**
103
-
104
- Applicable only when the customer's `billing_address.country` is New Zealand, Australia, or in the EU.
105
-
106
- When the customer uses a [card](https://apidocs.chargebee.com/docs/api/payment_sources#payment_source_type) [payment source](https://apidocs.chargebee.com/docs/api/customers#customer_primary_payment_source_id), this attribute specifies whether the country of the customer and the card issuer are the same.
107
-
108
- The following three location indicators are compared:
109
-
110
- * The card issuer's country.
111
- * The `billing_address.country`.
112
- * The country to which `created_from_ip` belongs.
113
- * When all three are the same, this attribute is set to true, otherwise it is set to false.
114
-
115
- When all three are the same, this attribute is set to `true`, otherwise it is set to `false`.
116
-
117
- */
118
-
119
51
  is_location_valid?:boolean;
120
52
 
121
- /**
122
- * @description Timestamp indicating when this customer resource is created.
123
-
124
- */
125
-
126
53
  created_at:number;
127
54
 
128
- /**
129
- * @description The IP address of the customer when this customer record was created. It's mainly used for [referral integrations](https://www.chargebee.com/docs/marketing-integration-index.html) and validating VAT if the customer is in the EU or UK.
130
-
131
- Depending on the method used to create the customer record, the field is set as follows:
132
-
133
- * **API** : When creating the `customer` resource through the API, you must include the customer's IP address in a [custom HTTP request header](https://apidocs.chargebee.com/docs/api/advanced-features#user_details) (`chargebee-request-origin-ip`) for Chargebee to capture it.
134
- * **Checkout** : For `customer` resources created through [Chargebee Checkout](https://www.chargebee.com/docs/2.0/hosted-checkout.html), Chargebee automatically captures the IP address of the customer.
135
- * **UI** : When [creating a `customer`](https://www.chargebee.com/docs/2.0/customers.html#creating-a-new-customer) resource via the Chargebee Billing UI, this field is not relevant and the value must be ignored.
136
-
137
- */
138
-
139
55
  created_from_ip?:string;
140
56
 
141
- /**
142
- * @description Indicates the exemption information. You can customize customer exemption based on specific Location, Tax level (Federal, State, County and Local), Category of Tax or specific Tax Name. This is applicable only if you use [Chargebee's AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.
143
- To know more about what values you need to provide, refer to this [Avalara's API document](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/sample-transactions/exemption/).
144
-
145
- */
146
-
147
57
  exemption_details?:any[];
148
58
 
149
- /**
150
- * @description Specifies if the customer is liable for tax \* taxable - Computes tax for the customer based on the [site configuration](https://www.chargebee.com/docs/tax.html). In some cases, depending on the region, shipping_address is needed. If not provided, then billing_address is used to compute tax. If that's not available either, the tax is taken as zero. \* exempt -
151
-
152
- * Customer is exempted from tax. When using Chargebee's native [Taxes](https://www.chargebee.com/docs/tax.html) feature or when using the [TaxJar integration](https://www.chargebee.com/docs/taxjar.html), no other action is needed.
153
- * However, when using our [Avalara integration](https://www.chargebee.com/docs/avalara.html), optionally, specify `entity_code` or `exempt_number` attributes if you use Chargebee's [AvaTax for Sales](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption) or specify `exemption_details` attribute if you use [Chargebee's AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. Tax may still be applied by Avalara for certain values of `entity_code`/`exempt_number`/`exemption_details` based on the state/region/province of the taxable address.
154
-
155
- */
156
-
157
59
  taxability?:Taxability;
158
60
 
159
- /**
160
- * @description The exemption category of the customer, for USA and Canada. Applicable if you use Chargebee's [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption). \* l - Other or custom \* m - Educational organization \* n - Local government \* h - Commercial agricultural production \* i - Industrial production/manufacturer \* j - Direct pay permit \* k - Direct mail \* p - Commercial aquaculture \* q - Commercial Fishery \* r - Non-resident \* d - Foreign diplomat \* e - Charitable or benevolent organization \* f - Religious organization \* g - Resale \* a - Federal government \* b - State government \* c - Tribe/Status Indian/Indian Band \* med2 - US Medical Device Excise Tax with taxable sales tax \* med1 - US Medical Device Excise Tax with exempt sales tax
161
-
162
- */
163
-
164
61
  entity_code?:EntityCode;
165
62
 
166
- /**
167
- * @description Any string value that will cause the sale to be exempted. Use this if your finance team manually verifies and tracks exemption certificates. Applicable if you use Chargebee's [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption).
168
-
169
- */
170
-
171
63
  exempt_number?:string;
172
64
 
173
- /**
174
- * @description Version number of this resource. The `resource_version` is updated with a new timestamp in milliseconds for every change made to the resource. This attribute will be present only if the resource has been updated after 2016-09-28.
175
-
176
- */
177
-
178
65
  resource_version?:number;
179
66
 
180
- /**
181
- * @description Timestamp indicating when this customer was last updated. This attribute will be present only if the resource has been updated after 2016-09-28.
182
-
183
- */
184
-
185
67
  updated_at?:number;
186
68
 
187
- /**
188
- * @description Determines which region-specific language Chargebee uses to communicate with the customer. In the absence of the locale attribute, Chargebee will use your site's default language for customer communication.
189
-
190
- */
191
-
192
69
  locale?:string;
193
70
 
194
- /**
195
- * @description **Note**
196
-
197
- Applicable only when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.html) with support for customer-specific billing date is enabled and `billing_date_mode` is `manually_set`.
198
- Specifies the day of the month for subscription renewals on month-based or year-based plans. Month-based and year-based plans are `item_price` resources where the `item_type` is set to `plan` and `period_unit` is set to `month` and `year` respectively.
199
- **Example**
200
-
201
- * **Month-based subscriptions** : If `billing_date` is set to `15`, month-based renewals occur on the 15th of the month. It's important to note that if the value is set to `31`, renewals align with the last day of the month. Additionally, in February, a `billing_date` of `29`, `30`, or `31` aligns renewals for the last day of February.
202
- * **Year-based subscriptions** : A `billing_date` of `15` and a `billing_month` of `7` schedules the renewal on the 15th of July.
203
-
204
- */
205
-
206
71
  billing_date?:number;
207
72
 
208
- /**
209
- * @description **Note**
210
-
211
- Applicable only when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.htm) with support for customer-specific billing date is enabled and `billing_date_mode` is `manually_set`.
212
- Specifies the renewal month for subscriptions on year-based plans. Year-based plans are `item_price` resources where `item_type` is set to `plan` and `period_unit` is set to `year`.
213
- **Example**
214
-
215
- The renewal date is 15th July when `billing_date` is `15` and `billing_month` is `7`.
216
-
217
- */
218
-
219
73
  billing_month?:number;
220
74
 
221
- /**
222
- * @description **Note**
223
-
224
- Applicable only when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.html) with support for customer-specific billing date is enabled and `billing_date_mode` is `manually_set`.
225
- Indicates whether this customer's `billing_date` and `billing_month` values can be changed via the [Change billing date API](customers#change_billing_date). \* manually_set - `billing_date` and `billing_month` can be adjusted via API. \* using_defaults - `billing_date` and `billing_month` are fixed as per Chargebee [site settings](https://www.chargebee.com/docs/2.0/calendar-billing-config.html#configuring-calendar-billing_configuring-site-wide-billing) and not modifiable via API.
226
-
227
- */
228
-
229
75
  billing_date_mode?:BillingDateMode;
230
76
 
231
- /**
232
- * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. When set, renewals of all the weekly subscriptions of this customer will be aligned to this week day. \* saturday - Saturday \* monday - Monday \* friday - Friday \* sunday - Sunday \* wednesday - Wednesday \* thursday - Thursday \* tuesday - Tuesday
233
-
234
- */
235
-
236
77
  billing_day_of_week?:'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
237
78
 
238
- /**
239
- * @description Indicates whether this customer's *billing_day_of_week* value is derived as per configurations or its specifically set (overriden). When specifically set, the *billing_day_of_week* will not be reset even when all of the weekly subscriptions are cancelled. \* using_defaults - Billing date is set based on defaults configured. \* manually_set - Billing date is specifically set (default configuration is overridden)
240
-
241
- */
242
-
243
79
  billing_day_of_week_mode?:BillingDayOfWeekMode;
244
80
 
245
- /**
246
- * @description Indicates whether this customer's personal information has been cleared \* cleared - Cleared \* scheduled_for_clear - Scheduled For Clear \* active - Active
247
-
248
- */
249
-
250
81
  pii_cleared?:'active' | 'scheduled_for_clear' | 'cleared';
251
82
 
252
- /**
253
- * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver=2#subscription_auto_close_invoices) which takes precedence.
254
-
255
- */
256
-
257
83
  auto_close_invoices?:boolean;
258
84
 
259
- /**
260
- * @description The subscription channel this object originated from and is maintained in. \* play_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.
261
-
262
- In-App Subscriptions is currently in early access. Contact [eap@chargebee.com](mailto:eap@chargebee.com) for more information.
263
- \* web - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI. \* app_store - The object data is synchronized with data from [in-app subscription(s)](https://apidocs.chargebee.com/docs/api/in_app_subscriptions) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed.
264
-
265
- */
266
-
267
85
  channel?:Channel;
268
86
 
269
- /**
270
- * @description This attribute represents the identifier of the most recent version of the [customers](/docs/api/customers) resource. When interacting with our API, the `active_id` ensures you're always referencing the current and most up-to-date version of the [customers](/docs/api/customers) resource. This mechanism is in place to maintain consistent external references and data integrity across business entity changes and updates. `active_id` is present on the resource after the resource is transferred to the destination business entity and it will refer to the most recent version of the resource. Learn more about the [customer transfer feature](https://www.chargebee.com/docs/2.0/mbe-customer-transfer-overview.html) and [setup](https://www.chargebee.com/docs/2.0/mbe-getting-started-with-customer-transfer.html).
271
- **Note:**
272
-
273
- * If `active_id` and `id` of the customer are the same, then it is the most recent version of the resource.
274
- * If `active_id` and `id` of the customer are different, then it is a transferred resource.
275
- * If `active_id` is not present, then the resource is not transferred and there are no business entity-related changes.
276
-
277
- */
278
-
279
87
  active_id?:string;
280
88
 
281
- /**
282
- * @description Indicates whether or not the customer has been identified as fraudulent. \* suspicious - The customer has been identified as potentially fraudulent by the gateway \* safe - The customer has been marked as safe \* fraudulent - The customer has been marked as fraudulent
283
-
284
- */
89
+ card_status?:'no_card' | 'valid' | 'expiring' | 'expired' | 'pending_verification' | 'invalid';
285
90
 
286
91
  fraud_flag?:'safe' | 'suspicious' | 'fraudulent';
287
92
 
288
- /**
289
- * @description The [identifier](payment_sources#payment_source_id) of the customer's [primary payment source](https://www.chargebee.com/docs/2.0/payment-method-overview.html#primary-and-backup-payment-methods)
290
-
291
- */
292
-
293
93
  primary_payment_source_id?:string;
294
94
 
295
- /**
296
- * @description The [identifier](payment_sources#payment_source_id) of the customer's [backup payment source](https://www.chargebee.com/docs/2.0/payment-method-overview.html#primary-and-backup-payment-methods).
297
-
298
- */
299
-
300
95
  backup_payment_source_id?:string;
301
96
 
302
- /**
303
- * @description A note for the customer that appears on all their invoice PDFs. This is one of [several notes](https://apidocs.chargebee.com/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
304
-
305
- */
97
+ billing_address?:Customer.BillingAddress;
306
98
 
307
- invoice_notes?:string;
99
+ referral_urls?:Customer.ReferralUrl[];
308
100
 
309
- /**
310
- * @description The unique ID of the [business entity](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver=2#mbe) of this subscription. This is always the same as the [business entity](/docs/api/subscriptions?prod_cat_ver=2#subscription_customer_id) of the customer.
311
-
312
- */
101
+ contacts?:Customer.Contact[];
313
102
 
314
- business_entity_id?:string;
103
+ payment_method?:Customer.PaymentMethod;
315
104
 
316
- /**
317
- * @description **Note**
318
-
319
- Applicable only when the [Multi-Currency](https://www.chargebee.com/docs/2.0/multi-currency-pricing.html) feature is enabled.
320
- Specifies the customer's preferred currency in [ISO 4217](https://www.chargebee.com/docs/supported-currencies.html) format.
321
-
322
- */
105
+ invoice_notes?:string;
323
106
 
324
- preferred_currency_code?:string;
107
+ business_entity_id?:string;
325
108
 
326
- /**
327
- * @description The balance of [promotional credits](promotional_credits) available to the customer.
328
-
329
- */
109
+ preferred_currency_code?:string;
330
110
 
331
111
  promotional_credits:number;
332
112
 
333
- /**
334
- * @description Total unbilled charges for this customer
335
-
336
- */
337
-
338
113
  unbilled_charges:number;
339
114
 
340
- /**
341
- * @description Refundable credits balance of this customer
342
-
343
- */
344
-
345
115
  refundable_credits:number;
346
116
 
347
- /**
348
- * @description Total unused payments associated with the customer
349
-
350
- */
351
-
352
117
  excess_payments:number;
353
118
 
354
- /**
355
- * @description Determines whether the customer is e-invoiced. When set to `true` or not set to any value, the customer is e-invoiced so long as e-invoicing is enabled for their country (`billing_address.country`). When set to `false`, the customer is not e-invoiced even if e-invoicing is enabled for their country.
356
- **Tip:**
357
-
358
-
359
- It is possible to set a value for this flag even when E-Invoicing is disabled. However, it comes into effect only when E-Invoicing is enabled.
360
-
361
- */
119
+ balances?:Customer.CustomerBalance[];
362
120
 
363
- is_einvoice_enabled?:boolean;
121
+ entity_identifiers?:Customer.EntityIdentifier[];
364
122
 
365
- /**
366
- * @description Determines whether to send e-invoice manually or automatic. \* automatic - Use this value to send e-invoice every time an invoice or credit note is created. \* manual - When manual is selected the automatic e-invoice sending is disabled. Use this value to send e-invoice manually through UI or API. \* site_default - The default value of the site which can be overridden at the customer level.
367
-
368
- */
123
+ tax_providers_fields?:Customer.TaxProvidersField[];
124
+
125
+ is_einvoice_enabled?:boolean;
369
126
 
370
127
  einvoicing_method?:EinvoicingMethod;
371
128
 
372
- /**
373
- * @description Indicates that this resource has been deleted.
374
-
375
- */
129
+ meta_data?:object;
376
130
 
377
131
  deleted:boolean;
378
132
 
379
- /**
380
- * @description Confirms that a customer is registered under GST. If set to `true` then the [Reverse Charge Mechanism](https://www.chargebee.com/docs/australian-gst.html#reverse-charge-mechanism) is applicable. This field is applicable only when Australian GST is configured for your site.
381
-
382
- */
383
-
384
133
  registered_for_gst?:boolean;
385
134
 
386
- /**
387
- * @description Indicates whether invoices raised on the same day for the `customer` are consolidated. When present, this value overrides the default configuration at the [site-level](https://www.chargebee.com/docs/consolidated-invoicing.html#configuring-consolidated-invoicing). This attribute is applicable only when [Consolidated Invoicing](https://www.chargebee.com/docs/consolidated-invoicing.html) is enabled.
388
- **Note:**
389
-
390
-
391
- Any invoices raised when a subscription activates from `in_trial` or `future` `status`, are not consolidated by default. [Contact Support](https://chargebee.freshdesk.com/support/home) to enable consolidation for such invoices.
392
-
393
- */
394
-
395
135
  consolidated_invoicing?:boolean;
396
136
 
397
- /**
398
- * @description **Note**
399
-
400
- Applicable only when the [Chargebee's AvaTax for Communications integration](https://www.chargebee.com/docs/avatax-for-communication.html) is enabled.
401
- Indicates the [Avalara customer type](https://developer.avalara.com/communications-integration/design-considerations/customer-type/). \* industrial - The customer is an industrial business. \* residential - The customer is an individual user. \* senior_citizen - The customer is an individual that meets the jurisdiction requirements to be considered a senior citizen and qualifies for tax breaks. \* business - The customer represents a business.
402
-
403
- */
404
-
405
137
  customer_type?:CustomerType;
406
138
 
407
- /**
408
- * @description Confirms that a customer is a valid business without an EU/UK VAT number.
409
-
410
- */
411
-
412
139
  business_customer_without_vat_number?:boolean;
413
140
 
414
- /**
415
- * @description **Note**
416
-
417
- Applicable only when the [Chargebee's AvaTax for Communications integration](https://www.chargebee.com/docs/avatax-for-communication.html) is enabled.
418
- The [Avalara client profile ID](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/client-profiles/) assigned to the customer.
419
-
420
- */
421
-
422
141
  client_profile_id?:string;
423
142
 
424
- /**
425
- * @description Indicates whether the site-default settings are being used for controlling access to the customer's information.
426
- The level of access is for data falling into two categories:
427
-
428
- * **Self-Serve Portal data:** subscriptions and invoices of the customer.
429
- * **Email Notifications:** subscription-, invoice- and payment-related notifications for the customer.
430
-
431
- */
143
+ relationship?:Customer.Relationship;
432
144
 
433
145
  use_default_hierarchy_settings?:boolean;
434
146
 
435
- /**
436
- * @description An overridden value for the first two characters of the [full VAT
437
- number](https://en.wikipedia.org/wiki/VAT_identification_number). Only applicable specifically for customers with [billing_address](customers#customer_billing_address) `country` as `XI` (which is **United Kingdom - Northern Ireland** ).
438
-
439
- When you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or have [manually
440
- enabled](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, you have the option of setting [billing_address](customers#customer_billing_address) `country` as `XI`. That's the code for **United Kingdom - Northern
441
- Ireland** . The first two characters of the VAT number in such a case is `XI` by default. However, if the VAT number was registered in UK, the value should be `GB`. Set `vat_number_prefix` to `GB` for such cases.
442
-
443
- */
147
+ parent_account_access?:Customer.ParentAccountAccess;
444
148
 
445
- vat_number_prefix?:string;
149
+ child_account_access?:Customer.ChildAccountAccess;
446
150
 
447
- /**
448
- * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, `DE:VAT` is used for a German business entity while `DE:LWID45` is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under `billing_address.country`. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).
449
- **Tip:**
450
-
451
-
452
- If there are additional entity identifiers for the customer not associated with the `vat_number`, they can be provided as the `entity_identifiers[]` array.
453
-
454
- */
151
+ vat_number_prefix?:string;
455
152
 
456
153
  entity_identifier_scheme?:string;
457
154
 
458
- /**
459
- * @description The standard used for specifying the `entity_identifier_scheme`. Currently only `iso6523-actorid-upis` is supported and is used by default when not provided.
460
- **Tip:**
461
-
462
-
463
- If there are additional entity identifiers for the customer not associated with the `vat_number`, they can be provided as the `entity_identifiers[]` array.
464
-
465
- */
466
-
467
155
  entity_identifier_standard?:string;
468
-
469
- /**
470
- * @description Billing address for a customer.
471
-
472
- */
473
-
474
- billing_address?:Customer.BillingAddress;
475
-
476
- /**
477
- * @description List of referral urls for the customer (if applicable)
478
-
479
- */
480
-
481
- referral_urls?:Customer.ReferralUrl[];
482
-
483
- /**
484
- * @description contacts
485
-
486
- */
487
-
488
- contacts?:Customer.Contact[];
489
-
490
- /**
491
- * @description Primary Payment Source of the customer.
492
-
493
- */
494
-
495
- payment_method?:Customer.PaymentMethod;
496
-
497
- /**
498
- * @description The list of balances for this customer
499
-
500
- */
501
-
502
- balances?:Customer.CustomerBalance[];
503
-
504
- /**
505
- * @description Each element of the `entity_identifiers[]` array identifies a specific customer entity with the e-invoicing system. If the customer has only one entity identifier whose `value` is the `vat_number`, then this array is not needed as the `scheme` can be provided via `entity_identifier_scheme`. This array holds any additional entity identifiers that the customer may have.
506
-
507
- */
508
-
509
- entity_identifiers?:Customer.EntityIdentifier[];
510
-
511
- tax_providers_fields?:Customer.TaxProvidersField[];
512
-
513
- /**
514
- * @description The [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html) relationship that the customer is part of.
515
-
516
- */
517
-
518
- relationship?:Customer.Relationship;
519
-
520
- /**
521
- * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this attribute defines the level of access that the parent account has to the customer's information.
522
- **Note:** the 'parent' is the customer whose id is [payment_owner_id](customers#customer_relationship_payment_owner_id). However, if the `payment_owner_id` is the customer itself, then the parent is [parent_id](customers#customer_relationship_parent_id).
523
-
524
- */
525
-
526
- parent_account_access?:Customer.ParentAccountAccess;
527
-
528
- /**
529
- * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this attribute defines the level of access that the customer has to its own information.
530
-
531
- */
532
-
533
- child_account_access?:Customer.ChildAccountAccess;
534
156
  }
535
157
  export namespace Customer {
536
158
  export class CustomerResource {
537
- /**
538
- * @description **Note:** This operation optionally supports 3DS verification flow. To achieve the same, create the [Payment Intent](/docs/api/3ds_card_payments?prod_cat_ver=1) and pass it as input parameter to this API.
539
-
540
- Creates a customer. You can create a customer and then create subscriptions for the customer when required. When creating a customer, you can pass along the billing address and card details.
541
-
542
- Passing raw card data via API involves PCI liability at your end due to the sensitivity of the data. Instead, you can use one of the following integration options as applicable:
543
-
544
- Here's some resources you can use to collect card information within your checkout form based on the payment gateway you use:
545
-
546
- * [Stripe.js](https://stripe.com/docs/js) for Stripe users.
547
- * [Braintree.js](https://developer.paypal.com/braintree/docs/guides/client-sdk/setup/javascript/v2) for Braintree users.
548
- * [Accept.js](https://developer.authorize.net/api/reference/features/acceptjs.html), if you use [Authorize.Net](https://www.authorize.net/).
549
- * If you are using the Adyen gateway, you will have to use the Adyen's [Client-Side Encryption](https://docs.adyen.com/online-payments/classic-integrations/api-integration-ecommerce/cse-integration-ecommerce) to encrypt sensitive cardholder data. Once the cardholder data is encrypted, pass the value in `adyen.encrypted.data`as temp token in this API.
550
- * You can also use our [Hosted Pages](https://www.chargebee.com/docs/1.0/hosted_pages.html) based integration.
551
-
552
- When billing address is not passed (say, for customers making offline payments), you can always provide it later using the [Update billing info for a customer API](/docs/api/customers#update_billing_info_for_a_customer).
553
-
554
- **Note:**When an invoice is generated for a customer, the billing address provided for the customer is stored with the invoice. If the First Name, Last Name, and Company fields of the billing address do not contain any information, they're picked up from the customer details.
555
-
556
- */
557
-
558
159
  create(input?:CreateInputParam):ChargebeeRequest<CreateResponse>;
559
160
 
560
- /**
561
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
562
-
563
- */
564
-
565
161
  list(input?:ListInputParam):ChargebeeRequest<ListResponse>;
566
162
 
567
- /**
568
- * @description Retrieves the details of the desired customer. You can use the unique identifier for a particular customer to retrieve the desired details.
569
-
570
- */
571
-
572
163
  retrieve(customer_id:string):ChargebeeRequest<RetrieveResponse>;
573
164
 
574
- /**
575
- * @description Updates the customer resource. However, this method cannot be used for updating the &#x27;Billing Info&#x27; - the Billing Address and &#x27;vat_number&#x27; attributes - of the customer. To update the same, use our [Update Billing Info](/docs/api/customers#update_billing_info_for_a_customer) API.
576
-
577
- */
578
-
579
165
  update(customer_id:string, input?:UpdateInputParam):ChargebeeRequest<UpdateResponse>;
580
166
 
581
- /**
582
- * @description We recently released [Payment Sources](/docs/api/payment_sources), which comes with additional options and improvements to the [Card APIs](/docs/api/cards). For this operation, use the [Create using temporary token](/docs/api/payment_sources#create_using_temporary_token) API or [Create using permanent token](/docs/api/payment_sources#create_using_permanent_token) API under Payment Sources to update payment method for the customer.
583
-
584
- Updates payment method details for a customer.
585
-
586
- **Note:** If you wish to pass the card number, CVV, or the single-use card tokens provided by gateways like Stripe, then use the [Update card for a customer](cards#update_card_for_a_customer) API under Cards resource. This API is not supported for Chargebee Test Gateway, it is provided to help you understand the billing workflow in Chargebee.
587
-
588
- **PayPal Express Checkout**
589
- You can use this API if you are directly integrating PayPal Express Checkout in your website instead of using Chargebee&#x27;s hosted pages. When your customer updates his payment method using PayPal Express Checkout, you will be provided with the *Billing Agreement ID* by PayPal. You can update the payment method for that customer in Chargebee by passing &#x60;type&#x60; as &#x60;paypal_express_checkout&#x60; and &#x60;reference_id&#x60; with the *Billing Agreement ID*.
590
-
591
- **Login and Pay with Amazon**
592
- You can use this API if you are directly integrating *Login and Pay with Amazon* in your website instead of using Chargebee&#x27;s hosted pages. When your customer updates Amazon as a payment method, you will be provided with the *Billing Agreement ID* by Amazon. You can update the payment method for that customer in Chargebee by passing &#x60;type&#x60; as &#x60;amazon_payments&#x60; and &#x60;reference_id&#x60; with the *Billing Agreement ID*.
593
-
594
- **Card Payments**
595
- When the card details of your customer are stored in the vault of gateways such as Stripe or Braintree, you can use this API to update the *reference id* provided by them in Chargebee. To use this API, pass
596
-
597
- * &#x60;type&#x60; as &#x60;card&#x60;.
598
- * &#x60;gateway&#x60; with the gateway associated with the card. If the gateway is not specified, the default gateway will be used.
599
- * &#x60;reference_id&#x60; with the identifier provided by the gateway/Spreedly to reference that specific card.
600
-
601
- **Reference id format for Card Payments**
602
- The format of reference_id will differ based on where the card is stored.
603
- **Stripe:** In case of Stripe, the reference_id consists of combination of Stripe Customer ID and Stripe Card ID separated by forward slash (e.g. *cus_63MnDn0t6kfDW7/card_6WjCF20vT9WN1G*). If you are passing Stripe Customer ID alone, then Chargebee will store the card marked as active for that customer in Stripe.
604
-
605
- **Braintree:** In case of Braintree, the reference_id consists of combination of Braintree Customer ID and Braintree Payment Method Token separated by forward slash
606
- (e.g. *cus_63MnDn0t6kfDW7/card_6WjCF20vT9WN1G* ). If you are passing Braintree Customer ID alone, then Chargebee will store the card marked as default for that customer in Braintree.
607
-
608
- **Spreedly Card vault:** If the card details are stored in Spreedly vault, then you need to provide the Spreedly token as &#x60;reference_id&#x60;.
609
-
610
- **Direct Debit Payments**
611
- When the bank account details of your customer are stored in the gateway vault, you can use this API to update the reference id provided by them in Chargebee. To use this API, pass
612
-
613
- * &#x60;type&#x60; as &#x60;direct_debit&#x60;.
614
- * &#x60;gateway&#x60; with the gateway where the bank account details are stored (e.g. *authorize_net*). If the gateway is not specified, the gateway supporting the direct debit will be used.
615
- * &#x60;reference_id&#x60; with the identifier provided by the gateway to reference the customer&#x27;s bank account details.
616
- * &#x60;tmp_token&#x60; with the single use token provided by the gateway ( Should be passed only if reference_id is not passed ).
617
-
618
- **Reference id format for Direct Debit Payments**
619
- The format of reference_id will differ based on where the bank account is stored.
620
- **Stripe:** In case of Stripe, the reference_id consists of combination of Stripe Customer ID and Stripe Bank Account ID separated by forward slash
621
- (e.g. *cus_8suoHaLQH4G5AW/ba_18b8z2KmcbENlhgU03RznRYW*). If you are passing Stripe Customer ID alone, then Chargebee will store the first bank account details present in payment profile list of that customer in Stripe.
622
-
623
- **Authorize.Net:** The reference_id consists of combination of Authorize.Net&#x27;s Customer Profile ID and Payment Profile ID separated by forward slash (e.g. *2384383/34834382*). If you are passing Authorize.Net&#x27;s Customer Profile ID alone, then Chargebee will store the first bank account details present in payment profile list of that customer in Authorize.Net.
624
-
625
- **GoCardless:** The reference_id is the GoCardless Customer Mandate ID (e.g. *MD0077Z99TTQXK*).
626
-
627
- **Note:** While using this API to update payment method details, [Card Verification](https://www.chargebee.com/docs/cards.html#card-verification) will not happen even if it is enabled for that particular gateway.
628
-
629
- */
630
-
631
- update_payment_method(customer_id:string, input?:UpdatePaymentMethodInputParam):ChargebeeRequest<UpdatePaymentMethodResponse>;
167
+ update_payment_method(customer_id:string, input:UpdatePaymentMethodInputParam):ChargebeeRequest<UpdatePaymentMethodResponse>;
632
168
 
633
- /**
634
- * @description This method is used for updating the &#x60;billing_address&#x60; and &#x60;vat_number&#x60; attributes of the &#x60;customer&#x60;. For updating the other customer attributes use [Update Customer API](customers#update_a_customer).
635
-
636
- During this operation, if &#x60;billing_address&#x60; and &#x60;vat_number&#x60; are not already present, they&#x27;re added. Whereas if present, the existing values are replaced with the new values passed. The only exception here is for &#x60;entity_identifiers[i]&#x60; when &#x60;entity_identifiers[operation][i]&#x60; is passed as &#x60;delete&#x60;.
637
-
638
- **Note:**When an invoice is generated for a customer, the billing address provided for the customer will be stored with the invoice. If the First Name, Last Name, and Company fields do not contain any information under Billing Info, the same will be picked from Customer Details if the same is available there.Please ensure that the VAT number is provided whenever the billing address is updated, as failing to do so will override any existing VAT numbers if new values are not provided.
639
-
640
- */
641
-
642
169
  update_billing_info(customer_id:string, input?:UpdateBillingInfoInputParam):ChargebeeRequest<UpdateBillingInfoResponse>;
643
170
 
644
- /**
645
- * @description This API retrieves all the contacts for a customer.
646
-
647
- */
648
-
649
171
  contacts_for_customer(customer_id:string, input?:ContactsForCustomerInputParam):ChargebeeRequest<ContactsForCustomerResponse>;
650
172
 
651
- /**
652
- * @description Assign Primary or Backup payment role or unassign role for the payment source based on the preference for the payment collection.
653
-
654
- */
655
-
656
173
  assign_payment_role(customer_id:string, input:AssignPaymentRoleInputParam):ChargebeeRequest<AssignPaymentRoleResponse>;
657
174
 
658
- /**
659
- * @description Adds the required contact to a customer. You can give the First Name, Last Name, Email ID and more details as input parameters to add them under the desired customer.
660
-
661
- */
662
-
663
- add_contact(customer_id:string, input?:AddContactInputParam):ChargebeeRequest<AddContactResponse>;
175
+ add_contact(customer_id:string, input:AddContactInputParam):ChargebeeRequest<AddContactResponse>;
664
176
 
665
- /**
666
- * @description Updates the details of a contact for a customer. You can give the field data to be updated as input parameters along with the Contact ID to update it.
667
-
668
- */
669
-
670
- update_contact(customer_id:string, input?:UpdateContactInputParam):ChargebeeRequest<UpdateContactResponse>;
177
+ update_contact(customer_id:string, input:UpdateContactInputParam):ChargebeeRequest<UpdateContactResponse>;
671
178
 
672
- /**
673
- * @description Deletes a particular contact for a customer. You can delete a contact by giving the Contact ID as the input parameter.
674
-
675
- */
676
-
677
- delete_contact(customer_id:string, input?:DeleteContactInputParam):ChargebeeRequest<DeleteContactResponse>;
179
+ delete_contact(customer_id:string, input:DeleteContactInputParam):ChargebeeRequest<DeleteContactResponse>;
180
+
181
+ add_promotional_credits(customer_id:string, input:AddPromotionalCreditsInputParam):ChargebeeRequest<AddPromotionalCreditsResponse>;
182
+
183
+ deduct_promotional_credits(customer_id:string, input:DeductPromotionalCreditsInputParam):ChargebeeRequest<DeductPromotionalCreditsResponse>;
184
+
185
+ set_promotional_credits(customer_id:string, input:SetPromotionalCreditsInputParam):ChargebeeRequest<SetPromotionalCreditsResponse>;
678
186
 
679
- /**
680
- * @description Use this API to record any [excess payments](//www.chargebee.com/docs/customers.html#excess-payments) made by the customer, such as advance payments. Such payments will be automatically applied to the future invoices. It can also be [manually applied](//www.chargebee.com/docs/invoice-operations.html#apply-excess-payments) to the existing *Not Paid* or *Payment Due* invoices.
681
-
682
- */
683
-
684
187
  record_excess_payment(customer_id:string, input:RecordExcessPaymentInputParam):ChargebeeRequest<RecordExcessPaymentResponse>;
685
188
 
686
- /**
687
- * @description **Note:** This operation optionally supports 3DS verification flow. To achieve the same, create the [Payment Intent](/docs/api/#3ds_card_payments) and pass it as input parameter to this API.
688
-
689
- This API can be used to collect the payments for customer&#x27;s **payment_due** and **not_paid** invoices. You can either choose to collect the payment from an existing payment source or a new payment source. You can choose to either retain or discard the new payment source, which is being used for payment. If the amount collected exceeds the invoice amount, the surplus will be counted in as excess payments.
690
-
691
- */
692
-
693
- collect_payment(customer_id:string, input?:CollectPaymentInputParam):ChargebeeRequest<CollectPaymentResponse>;
189
+ collect_payment(customer_id:string, input:CollectPaymentInputParam):ChargebeeRequest<CollectPaymentResponse>;
694
190
 
695
- /**
696
- * @description Deletes a particular customer identified by the a unique identifier.
697
-
698
- */
699
-
700
191
  delete(customer_id:string, input?:DeleteInputParam):ChargebeeRequest<DeleteResponse>;
701
192
 
702
- /**
703
- * @description This API copies a customer object from one site to another. The destination site (the site to which the customer is copied) is specified by the path parameter &#x60;{site}&#x60;; whereas, the source site (the site from which the customer is copied) is specified by the query parameter &#x60;from_site&#x60;.
704
-
705
- */
706
-
707
193
  move(input:MoveInputParam):ChargebeeRequest<MoveResponse>;
708
194
 
709
- /**
710
- * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. Changes the customer&#x27;s *billing_date* and/or *billing_day_of_week*.
711
-
712
- */
713
-
714
195
  change_billing_date(customer_id:string, input?:ChangeBillingDateInputParam):ChargebeeRequest<ChangeBillingDateResponse>;
715
196
 
716
- /**
717
- * @description This API moves a customer&#x27;s payment methods, subscriptions, invoices, credit notes, transactions, unbilled charges, and orders to another customer. Events and email logs will not be moved. The API execution is asynchronous.
718
- **Note**
719
-
720
- * Moving virtual bank accounts from one customer to another is not supported in this API.
721
- * Merging customers from different [business entities](/docs/api?prod_cat_ver&#x3D;2#mbe) is not permitted.
722
-
723
- */
724
-
725
197
  merge(input:MergeInputParam):ChargebeeRequest<MergeResponse>;
726
198
 
727
- /**
728
- * @description Clear personal details of a customer using this API.
729
-
730
- */
731
-
732
199
  clear_personal_data(customer_id:string):ChargebeeRequest<ClearPersonalDataResponse>;
733
200
 
734
- /**
735
- * @description Establish a [hierarchical relationship](https://www.chargebee.com/docs/account-hierarchy.html) between customers. The path parameter &#x60;customer_id&#x60; identifies the child in this relationship.
736
- **Prerequisite**
737
-
738
- Both parent and child customers must be part of the same [business entity](advanced-features#mbe).
739
- **Note**
740
-
741
- * A customer can have a maximum of 250 direct children.
742
- * The hierarchy allows a maximum of 5 levels from the root node to the lowest child node.
743
- **Note**
744
-
745
- For the &#x60;use_default_hierarchy_settings&#x60;, &#x60;parent_account_access&#x60;, and &#x60;child_account_access&#x60; parameters below, the term &quot;parent&quot; usually refers to the customer with the ID [payment_owner_id](customers#link_a_customer_payment_owner_id). However, if the &#x60;payment_owner_id&#x60; is the same as the child&#x27;s ID (&#x60;{customer_id}&#x60;), the &quot;parent&quot; is identified by [parent_id](customers#link_a_customer_parent_id).
746
-
747
- */
748
-
749
201
  relationships(customer_id:string, input?:RelationshipsInputParam):ChargebeeRequest<RelationshipsResponse>;
750
202
 
751
- /**
752
- * @description When a customer belongs to an [account hierarchy](https://www.chargebee.com/docs/2.0/account-hierarchy.html), this operation detaches the customer from its parent. The hierarchy, if any, beneath the customer remains unchanged.
753
-
754
- */
755
-
756
203
  delete_relationship(customer_id:string):ChargebeeRequest<DeleteRelationshipResponse>;
757
204
 
758
- /**
759
- * @description Retrieves the full or partial [account hierarchy](/docs/api/hierarchies) for a customer.
760
-
761
- */
762
-
763
205
  hierarchy(customer_id:string, input:HierarchyInputParam):ChargebeeRequest<HierarchyResponse>;
764
206
 
765
- /**
766
- * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this operation updates the access privileges that both the customer and its parent have to the customer&#x27;s data.
767
- **Terminology**
768
-
769
- The term &quot;parent&quot; usually refers to the customer with the ID [payment_owner_id](customers#customer_relationship_payment_owner_id). However, if the &#x60;payment_owner_id&#x60; is the same as the child&#x27;s ID (given by the path parameter), the &quot;parent&quot; is identified by [parent_id](customers#customer_relationship_parent_id).
770
- **Tip**
771
-
772
- You cannot use this endpoint to change the &#x60;parent_id&#x60;, &#x60;invoice_owner_id&#x60; or &#x60;payment_owner_id&#x60; for the customer. To change them, [unlink the customer](customers#delink_a_customer) and then call [Link a customer](customers?prod_cat_ver&#x3D;2#link_a_customer) with the updated values.
773
-
774
- */
775
-
776
207
  update_hierarchy_settings(customer_id:string, input?:UpdateHierarchySettingsInputParam):ChargebeeRequest<UpdateHierarchySettingsResponse>;
777
208
  }
778
209
  export interface CreateResponse {
@@ -782,463 +213,228 @@ You cannot use this endpoint to change the &#x60;parent_id&#x60;, &#x60;invoice_
782
213
  }
783
214
  export interface CreateInputParam {
784
215
  [key : string] : any;
785
- /**
786
- * @description Id for the new customer. If not given, this will be auto-generated.
787
-
788
- */
216
+ card?:null.null;
789
217
 
790
- id?:string;
218
+ bank_account?:null.null;
791
219
 
792
- /**
793
- * @description First name of the customer.
794
-
795
- */
220
+ payment_method?:null.null;
796
221
 
797
- first_name?:string;
222
+ payment_intent?:null.null;
798
223
 
799
- /**
800
- * @description Last name of the customer.
801
-
802
- */
224
+ billing_address?:null.null;
803
225
 
804
- last_name?:string;
226
+ entity_identifiers?:{id?:string,scheme?:string,standard?:string,value?:string}[];
805
227
 
806
- /**
807
- * @description Email of the customer. Configured email notifications will be sent to this email.
808
-
809
- */
228
+ tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
810
229
 
811
- email?:string;
230
+ id?:string;
812
231
 
813
- /**
814
- * @description The currency code (ISO 4217 format) of the customer. Applicable if Multicurrency is enabled.
815
-
816
- */
232
+ first_name?:string;
817
233
 
818
- preferred_currency_code?:string;
234
+ last_name?:string;
819
235
 
820
- /**
821
- * @description Phone number of the customer.
822
-
823
- */
236
+ email?:string;
824
237
 
825
- phone?:string;
238
+ preferred_currency_code?:string;
826
239
 
827
- /**
828
- * @description Company name of the customer.
829
-
830
- */
240
+ phone?:string;
831
241
 
832
242
  company?:string;
833
243
 
834
- /**
835
- * @description Whether payments needs to be collected automatically for this customer. \* on - Whenever an invoice is created, an automatic attempt to charge the customer&#x27;s payment method is made. \* off - Automatic collection of charges will not be made. All payments must be recorded offline.
836
-
837
- */
838
-
839
244
  auto_collection?:AutoCollection;
840
245
 
841
- /**
842
- * @description The number of days within which the customer has to make payment for the invoice. .
843
-
844
- */
845
-
846
246
  net_term_days?:number;
847
247
 
848
- /**
849
- * @description Whether the customer can pay via Direct Debit.
850
-
851
- */
852
-
853
248
  allow_direct_debit?:boolean;
854
249
 
855
- /**
856
- * @description The VAT/tax registration number for the customer. For customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ), the first two characters of the [full VAT
857
- number](https://en.wikipedia.org/wiki/VAT_identification_number) can be overridden by setting [vat_number_prefix](customers#customer_vat_number_prefix).
858
-
859
- */
860
-
861
250
  vat_number?:string;
862
251
 
863
- /**
864
- * @description An overridden value for the first two characters of the [full VAT
865
- number](https://en.wikipedia.org/wiki/VAT_identification_number). Only applicable specifically for customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ).
866
-
867
- When you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or have [manually
868
- enabled](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, you have the option of setting [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60;. That&#x27;s the code for **United Kingdom - Northern
869
- Ireland** . The first two characters of the VAT number in such a case is &#x60;XI&#x60; by default. However, if the VAT number was registered in UK, the value should be &#x60;GB&#x60;. Set &#x60;vat_number_prefix&#x60; to &#x60;GB&#x60; for such cases.
870
-
871
- */
872
-
873
252
  vat_number_prefix?:string;
874
253
 
875
- /**
876
- * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, &#x60;DE:VAT&#x60; is used for a German business entity while &#x60;DE:LWID45&#x60; is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under &#x60;billing_address.country&#x60;. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).
877
- **Tip:**
878
-
879
-
880
- If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
881
- .
882
-
883
- */
884
-
885
254
  entity_identifier_scheme?:string;
886
255
 
887
- /**
888
- * @description The standard used for specifying the &#x60;entity_identifier_scheme&#x60;. Currently only &#x60;iso6523-actorid-upis&#x60; is supported and is used by default when not provided.
889
- **Tip:**
890
-
891
-
892
- If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
893
- .
894
-
895
- */
896
-
897
256
  entity_identifier_standard?:string;
898
257
 
899
- /**
900
- * @description Confirms that a customer is registered under GST. If set to &#x60;true&#x60; then the [Reverse Charge Mechanism](https://www.chargebee.com/docs/australian-gst.html#reverse-charge-mechanism) is applicable. This field is applicable only when Australian GST is configured for your site.
901
-
902
- */
903
-
904
258
  registered_for_gst?:boolean;
905
259
 
906
- /**
907
- * @description Determines whether the customer is e-invoiced. When set to &#x60;true&#x60; or not set to any value, the customer is e-invoiced so long as e-invoicing is enabled for their country (&#x60;billing_address.country&#x60;). When set to &#x60;false&#x60;, the customer is not e-invoiced even if e-invoicing is enabled for their country.
908
- **Tip:**
909
-
910
-
911
- It is possible to set a value for this flag even when E-Invoicing is disabled. However, it comes into effect only when E-Invoicing is enabled.
912
- .
913
-
914
- */
915
-
916
260
  is_einvoice_enabled?:boolean;
917
261
 
918
- /**
919
- * @description Determines whether to send an e-invoice manually or automatic. \* automatic - Use this value to send e-invoice every time an invoice or credit note is created. \* manual - When manual is selected the automatic e-invoice sending is disabled. Use this value to send e-invoice manually through UI or API. \* site_default - The default value of the site which can be overridden at the customer level.
920
-
921
- */
922
-
923
262
  einvoicing_method?:EinvoicingMethod;
924
263
 
925
- /**
926
- * @description Specifies if the customer is liable for tax. \* taxable - Computes tax for the customer based on the [site configuration](https://www.chargebee.com/docs/tax.html). In some cases, depending on the region, shipping_address is needed. If not provided, then billing_address is used to compute tax. If that&#x27;s not available either, the tax is taken as zero. \* exempt -
927
-
928
- * Customer is exempted from tax. When using Chargebee&#x27;s native [Taxes](https://www.chargebee.com/docs/tax.html) feature or when using the [TaxJar integration](https://www.chargebee.com/docs/taxjar.html), no other action is needed.
929
- * However, when using our [Avalara integration](https://www.chargebee.com/docs/avalara.html), optionally, specify &#x60;entity_code&#x60; or &#x60;exempt_number&#x60; attributes if you use Chargebee&#x27;s [AvaTax for Sales](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption) or specify &#x60;exemption_details&#x60; attribute if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. Tax may still be applied by Avalara for certain values of &#x60;entity_code&#x60;/&#x60;exempt_number&#x60;/&#x60;exemption_details&#x60; based on the state/region/province of the taxable address.
930
-
931
- */
932
-
933
264
  taxability?:Taxability;
934
265
 
935
- /**
936
- * @description Indicates the exemption information. You can customize customer exemption based on specific Location, Tax level (Federal, State, County and Local), Category of Tax or specific Tax Name. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.
937
- To know more about what values you need to provide, refer to this [Avalara&#x27;s API document](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/sample-transactions/exemption/).
938
-
939
- */
940
-
941
266
  exemption_details?:any[];
942
267
 
943
- /**
944
- * @description Indicates the type of the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. \* industrial - When the purchase is made by an industrial business \* senior_citizen - When the purchase is made by a customer who meets the jurisdiction requirements to be considered a senior citizen and qualifies for senior citizen tax breaks \* business - When the purchase is made at a place of business \* residential - When the purchase is made by a customer for home use
945
-
946
- */
947
-
948
268
  customer_type?:CustomerType;
949
269
 
950
- /**
951
- * @description Indicates the Client profile id for the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.
952
-
953
- */
954
-
955
270
  client_profile_id?:string;
956
271
 
957
- /**
958
- * @description Indicates the exemption type of the customer. This is applicable only if you use Chargebee&#x27;s TaxJar integration. \* other - Other \* government - Government \* wholesale - Whole-sale
959
-
960
- */
961
-
962
272
  taxjar_exemption_category?:TaxjarExemptionCategory;
963
273
 
964
- /**
965
- * @description Confirms that a customer is a valid business without an EU/UK VAT number.
966
-
967
- */
968
-
969
274
  business_customer_without_vat_number?:boolean;
970
275
 
971
- /**
972
- * @description Determines which region-specific language Chargebee uses to communicate with the customer. In the absence of the locale attribute, Chargebee will use your site&#x27;s default language for customer communication.
973
-
974
- */
975
-
976
276
  locale?:string;
977
277
 
978
- /**
979
- * @description The exemption category of the customer, for USA and Canada. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption). \* l - Other or custom \* m - Educational organization \* n - Local government \* h - Commercial agricultural production \* i - Industrial production/manufacturer \* j - Direct pay permit \* k - Direct mail \* p - Commercial aquaculture \* q - Commercial Fishery \* r - Non-resident \* med2 - US Medical Device Excise Tax with taxable sales tax \* med1 - US Medical Device Excise Tax with exempt sales tax \* d - Foreign diplomat \* e - Charitable or benevolent organization \* f - Religious organization \* g - Resale \* a - Federal government \* b - State government \* c - Tribe/Status Indian/Indian Band
980
-
981
- */
982
-
983
278
  entity_code?:EntityCode;
984
279
 
985
- /**
986
- * @description Any string value that will cause the sale to be exempted. Use this if your finance team manually verifies and tracks exemption certificates. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption).
987
-
988
- */
989
-
990
280
  exempt_number?:string;
991
281
 
992
- /**
993
- * @description A collection of key-value pairs that provides extra information about the customer.
994
- **Note:** There&#x27;s a character limit of 65,535.
995
- [Learn more](advanced-features?prod_cat_ver&#x3D;2#metadata).
996
-
997
- */
998
-
999
282
  meta_data?:object;
1000
283
 
1001
- /**
1002
- * @description The preferred offline payment method for the customer. \* sepa_credit - SEPA Credit \* cash - Cash \* no_preference - No Preference \* bank_transfer - Bank Transfer \* boleto - Boleto \* check - Check \* ach_credit - ACH Credit
1003
-
1004
- */
1005
-
1006
284
  offline_payment_method?:OfflinePaymentMethod;
1007
285
 
1008
- /**
1009
- * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_auto_close_invoices) which takes precedence.
1010
-
1011
- */
1012
-
1013
- auto_close_invoices?:boolean;
1014
-
1015
- /**
1016
- * @description Indicates whether invoices raised on the same day for the &#x60;customer&#x60; are consolidated. When provided, this overrides the default configuration at the [site-level](https://www.chargebee.com/docs/consolidated-invoicing.html#configuring-consolidated-invoicing). This parameter can be provided only when [Consolidated Invoicing](https://www.chargebee.com/docs/consolidated-invoicing.html) is enabled.
1017
- **Note:**
1018
-
1019
- Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &#x60;future&#x60; &#x60;status&#x60;, are not consolidated by default. [Contact Support](https://chargebee.freshdesk.com/support/home) to enable consolidation for such invoices.
1020
- .
1021
-
1022
- */
1023
-
1024
- consolidated_invoicing?:boolean;
1025
-
1026
- /**
1027
- * @description The Chargebee payment token generated by Chargebee JS.
1028
-
1029
- */
1030
-
1031
- token_id?:string;
1032
-
1033
- /**
1034
- * @description The unique ID of the [business entity](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe) this customer should be [linked](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-linked-be) to. Applicable only when multiple business entities have been created for the site. When not provided, the customer is linked to the [default business entity](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-default-be) defined for the site.
1035
- **Note**
1036
-
1037
- An alternative way of passing this parameter is by means of a [custom HTTP header](https://apidocs.chargebee.com/docs/api/advanced-features?prod_cat_ver&#x3D;2#mbe-header-main).
1038
- .
1039
-
1040
- */
1041
-
1042
- business_entity_id?:string;
1043
-
1044
- /**
1045
- * @description A customer-facing note added to all invoices associated with this API resource. This note becomes one among [all the notes](/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
1046
-
1047
- */
1048
-
1049
- invoice_notes?:string;
1050
-
1051
- /**
1052
- * @description Parameters for card
1053
-
1054
- */
1055
-
1056
- card?:{additional_information?:object,billing_addr1?:string,billing_addr2?:string,billing_city?:string,billing_country?:string,billing_state?:string,billing_state_code?:string,billing_zip?:string,cvv?:string,expiry_month?:number,expiry_year?:number,first_name?:string,gateway_account_id?:string,last_name?:string,number?:string};
1057
-
1058
- /**
1059
- * @description Parameters for bank_account
1060
-
1061
- */
1062
-
1063
- bank_account?:{account_holder_type?:AccountHolderType,account_number?:string,account_type?:AccountType,bank_code?:string,bank_name?:string,billing_address?:object,company?:string,echeck_type?:EcheckType,email?:string,first_name?:string,gateway_account_id?:string,iban?:string,issuing_country?:string,last_name?:string,phone?:string,routing_number?:string,swedish_identity_number?:string};
1064
-
1065
- /**
1066
- * @description Parameters for payment_method
1067
-
1068
- */
1069
-
1070
- payment_method?:{additional_information?:object,gateway_account_id?:string,issuing_country?:string,reference_id?:string,tmp_token?:string,type?:Type};
1071
-
1072
- /**
1073
- * @description Parameters for payment_intent
1074
-
1075
- */
286
+ auto_close_invoices?:boolean;
1076
287
 
1077
- payment_intent?:{additional_information?:object,gateway_account_id?:string,gw_token?:string,id?:string,payment_method_type?:'giropay' | 'ideal' | 'sepa_instant_transfer' | 'google_pay' | 'netbanking_emandates' | 'klarna_pay_now' | 'dotpay' | 'boleto' | 'direct_debit' | 'faster_payments' | 'sofort' | 'upi' | 'venmo' | 'amazon_payments' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'pay_to' | 'card',reference_id?:string};
288
+ consolidated_invoicing?:boolean;
1078
289
 
1079
- /**
1080
- * @description Parameters for billing_address
1081
-
1082
- */
290
+ token_id?:string;
1083
291
 
1084
- 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};
292
+ business_entity_id?:string;
1085
293
 
1086
- /**
1087
- * @description Parameters for entity_identifiers
1088
-
1089
- */
294
+ created_from_ip?:string;
1090
295
 
1091
- entity_identifiers?:{id?:string,scheme?:string,standard?:string,value?:string}[];
296
+ invoice_notes?:string;
1092
297
  }
1093
298
  export interface ListResponse {
1094
- /**
1095
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
1096
-
1097
- */
1098
-
1099
299
  list:{customer:Customer,card?:Card}[];
1100
300
 
1101
- /**
1102
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
1103
-
1104
- */
1105
-
1106
301
  next_offset?:string;
1107
302
  }
1108
303
  export interface ListInputParam {
1109
304
  [key : string]: any;
1110
305
  /**
1111
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
306
+ * @description The number of resources to be returned.
1112
307
 
1113
308
  */
1114
309
 
1115
310
  limit?:number;
1116
311
 
1117
312
  /**
1118
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
313
+ * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
1119
314
 
1120
315
  */
1121
316
 
1122
317
  offset?:string;
1123
318
 
1124
319
  /**
1125
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
320
+ * @description Parameters for relationship
321
+
322
+ */
323
+
324
+ relationship?:{invoice_owner_id?:null.null,parent_id?:null.null,payment_owner_id?:null.null};
325
+
326
+ /**
327
+ * @description Indicates whether to include deleted objects in the list. The deleted objects have the attribute \&#x60;deleted\&#x60; as \&#x60;true\&#x60;.
1126
328
 
1127
329
  */
1128
330
 
1129
331
  include_deleted?:boolean;
1130
332
 
333
+ include_deprecated?:boolean;
334
+
1131
335
  /**
1132
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
336
+ * @description Identifier of the customer.
1133
337
 
1134
338
  */
1135
339
 
1136
340
  id?:{in?:string,is?:string,is_not?:string,not_in?:string,starts_with?:string};
1137
341
 
1138
342
  /**
1139
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
343
+ * @description First name of the customer
1140
344
 
1141
345
  */
1142
346
 
1143
347
  first_name?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
1144
348
 
1145
349
  /**
1146
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
350
+ * @description Last name of the customer
1147
351
 
1148
352
  */
1149
353
 
1150
354
  last_name?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
1151
355
 
1152
356
  /**
1153
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
357
+ * @description Email of the customer. Configured email notifications will be sent to this email.
1154
358
 
1155
359
  */
1156
360
 
1157
361
  email?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
1158
362
 
1159
363
  /**
1160
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
364
+ * @description Company name of the customer.
1161
365
 
1162
366
  */
1163
367
 
1164
368
  company?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
1165
369
 
1166
370
  /**
1167
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
371
+ * @description Phone number of the customer
1168
372
 
1169
373
  */
1170
374
 
1171
375
  phone?:{is?:string,is_not?:string,is_present?:'true' | 'false',starts_with?:string};
1172
376
 
1173
377
  /**
1174
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
378
+ * @description Whether payments needs to be collected automatically for this customer
1175
379
 
1176
380
  */
1177
381
 
1178
- auto_collection?:{in?:string,is?:'off' | 'on',is_not?:'off' | 'on',not_in?:string};
382
+ auto_collection?:{in?:string,is?:'on' | 'off',is_not?:'on' | 'off',not_in?:string};
1179
383
 
1180
384
  /**
1181
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
385
+ * @description Specifies if the customer is liable for tax
1182
386
 
1183
387
  */
1184
388
 
1185
389
  taxability?:{in?:string,is?:'taxable' | 'exempt',is_not?:'taxable' | 'exempt',not_in?:string};
1186
390
 
1187
391
  /**
1188
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
392
+ * @description Timestamp indicating when this customer resource is created.
1189
393
 
1190
394
  */
1191
395
 
1192
396
  created_at?:{after?:string,before?:string,between?:string,on?:string};
1193
397
 
1194
398
  /**
1195
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
399
+ * @description To filter based on &#x60;updated_at&#x60;. This attribute will be present only if the resource has been updated after 2016-09-28. It is advisable when using this filter, to pass the &#x60;sort_by&#x60; input parameter as &#x60;updated_at&#x60; for a faster response.
1196
400
 
1197
401
  */
1198
402
 
1199
403
  updated_at?:{after?:string,before?:string,between?:string,on?:string};
1200
404
 
1201
405
  /**
1202
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
406
+ * @description The unique ID of the [business entity](/docs/api?prod_cat_ver&#x3D;2#mbe) of this subscription. This is always the same as the [business entity](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_customer_id) of the customer.
407
+ The ID of the business entity created for the site. For Product Catalog 1.0, all the site data is tied to this business entity.
408
+ **Note**
409
+
410
+ [Multiple Business Entities](/docs/api?prod_cat_ver&#x3D;2#mbe) is a feature available only on Product Catalog 2.0.
1203
411
 
1204
412
  */
1205
413
 
1206
414
  business_entity_id?:{is?:string,is_not?:string,starts_with?:string};
1207
415
 
1208
416
  /**
1209
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
417
+ * @description The preferred offline payment method for the customer.
1210
418
 
1211
419
  */
1212
420
 
1213
- offline_payment_method?:{in?:string,is?:'eu_automated_bank_transfer' | 'bank_transfer' | 'mx_automated_bank_transfer' | 'custom' | 'ach_credit' | 'boleto' | 'check' | 'uk_automated_bank_transfer' | 'no_preference' | 'us_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'sepa_credit' | 'cash',is_not?:'eu_automated_bank_transfer' | 'bank_transfer' | 'mx_automated_bank_transfer' | 'custom' | 'ach_credit' | 'boleto' | 'check' | 'uk_automated_bank_transfer' | 'no_preference' | 'us_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'sepa_credit' | 'cash',not_in?:string};
421
+ offline_payment_method?:{in?:string,is?:'no_preference' | 'cash' | 'check' | 'bank_transfer' | 'ach_credit' | 'sepa_credit' | 'boleto' | 'us_automated_bank_transfer' | 'eu_automated_bank_transfer' | 'uk_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'mx_automated_bank_transfer' | 'custom',is_not?:'no_preference' | 'cash' | 'check' | 'bank_transfer' | 'ach_credit' | 'sepa_credit' | 'boleto' | 'us_automated_bank_transfer' | 'eu_automated_bank_transfer' | 'uk_automated_bank_transfer' | 'jp_automated_bank_transfer' | 'mx_automated_bank_transfer' | 'custom',not_in?:string};
1214
422
 
1215
423
  /**
1216
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
424
+ * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_auto_close_invoices) which takes precedence.
1217
425
 
1218
426
  */
1219
427
 
1220
428
  auto_close_invoices?:{is?:'true' | 'false'};
1221
429
 
1222
430
  /**
1223
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
1224
-
1225
- */
1226
-
1227
- channel?:{in?:string,is?:'app_store' | 'web' | 'play_store',is_not?:'app_store' | 'web' | 'play_store',not_in?:string};
1228
-
1229
- /**
1230
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
431
+ * @description The subscription channel this object originated from and is maintained in.
1231
432
 
1232
433
  */
1233
434
 
1234
- sort_by?:{asc?:'updated_at' | 'created_at',desc?:'updated_at' | 'created_at'};
435
+ channel?:{in?:string,is?:'web' | 'app_store' | 'play_store',is_not?:'web' | 'app_store' | 'play_store',not_in?:string};
1235
436
 
1236
- /**
1237
- * @description Retrieves a list of customers added to your Chargebee site. The list contains the necessary customer details such as First Name, Last Name and the Customer ID.
1238
-
1239
- */
1240
-
1241
- 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}};
437
+ sort_by?:{asc?:'created_at' | 'updated_at',desc?:'created_at' | 'updated_at'};
1242
438
  }
1243
439
  export interface RetrieveResponse {
1244
440
  customer:Customer;
@@ -1253,175 +449,52 @@ An alternative way of passing this parameter is by means of a [custom HTTP heade
1253
449
  }
1254
450
  export interface UpdateInputParam {
1255
451
  [key : string] : any;
1256
- /**
1257
- * @description First name of the customer.
1258
-
1259
- */
452
+ tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
1260
453
 
1261
454
  first_name?:string;
1262
455
 
1263
- /**
1264
- * @description Last name of the customer.
1265
-
1266
- */
1267
-
1268
456
  last_name?:string;
1269
457
 
1270
- /**
1271
- * @description Email of the customer. Configured email notifications will be sent to this email.
1272
-
1273
- */
1274
-
1275
458
  email?:string;
1276
459
 
1277
- /**
1278
- * @description The currency code (ISO 4217 format) of the customer. Applicable if Multicurrency is enabled.
1279
-
1280
- */
1281
-
1282
460
  preferred_currency_code?:string;
1283
461
 
1284
- /**
1285
- * @description Phone number of the customer.
1286
-
1287
- */
1288
-
1289
462
  phone?:string;
1290
463
 
1291
- /**
1292
- * @description Company name of the customer.
1293
-
1294
- */
1295
-
1296
464
  company?:string;
1297
465
 
1298
- /**
1299
- * @description Whether payments needs to be collected automatically for this customer. \* on - Whenever an invoice is created, an automatic attempt to charge the customer&#x27;s payment method is made. \* off - Automatic collection of charges will not be made. All payments must be recorded offline.
1300
-
1301
- */
1302
-
1303
466
  auto_collection?:AutoCollection;
1304
467
 
1305
- /**
1306
- * @description Whether the customer can pay via Direct Debit.
1307
-
1308
- */
1309
-
1310
468
  allow_direct_debit?:boolean;
1311
469
 
1312
- /**
1313
- * @description The number of days within which the customer has to make payment for the invoice. .
1314
-
1315
- */
1316
-
1317
470
  net_term_days?:number;
1318
471
 
1319
- /**
1320
- * @description Specifies if the customer is liable for tax. \* taxable - Computes tax for the customer based on the [site configuration](https://www.chargebee.com/docs/tax.html). In some cases, depending on the region, shipping_address is needed. If not provided, then billing_address is used to compute tax. If that&#x27;s not available either, the tax is taken as zero. \* exempt -
1321
-
1322
- * Customer is exempted from tax. When using Chargebee&#x27;s native [Taxes](https://www.chargebee.com/docs/tax.html) feature or when using the [TaxJar integration](https://www.chargebee.com/docs/taxjar.html), no other action is needed.
1323
- * However, when using our [Avalara integration](https://www.chargebee.com/docs/avalara.html), optionally, specify &#x60;entity_code&#x60; or &#x60;exempt_number&#x60; attributes if you use Chargebee&#x27;s [AvaTax for Sales](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption) or specify &#x60;exemption_details&#x60; attribute if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. Tax may still be applied by Avalara for certain values of &#x60;entity_code&#x60;/&#x60;exempt_number&#x60;/&#x60;exemption_details&#x60; based on the state/region/province of the taxable address.
1324
-
1325
- */
1326
-
1327
472
  taxability?:Taxability;
1328
473
 
1329
- /**
1330
- * @description Indicates the exemption information. You can customize customer exemption based on specific Location, Tax level (Federal, State, County and Local), Category of Tax or specific Tax Name. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.
1331
- To know more about what values you need to provide, refer to this [Avalara&#x27;s API document](https://developer.avalara.com/communications/dev-guide_rest_v2/customizing-transactions/sample-transactions/exemption/).
1332
-
1333
- */
1334
-
1335
474
  exemption_details?:any[];
1336
475
 
1337
- /**
1338
- * @description Indicates the type of the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration. \* senior_citizen - When the purchase is made by a customer who meets the jurisdiction requirements to be considered a senior citizen and qualifies for senior citizen tax breaks \* industrial - When the purchase is made by an industrial business \* business - When the purchase is made at a place of business \* residential - When the purchase is made by a customer for home use
1339
-
1340
- */
1341
-
1342
476
  customer_type?:CustomerType;
1343
477
 
1344
- /**
1345
- * @description Indicates the Client profile id for the customer. This is applicable only if you use [Chargebee&#x27;s AvaTax for Communications](https://www.chargebee.com/docs/avatax-for-communication.html) integration.
1346
-
1347
- */
1348
-
1349
478
  client_profile_id?:string;
1350
479
 
1351
- /**
1352
- * @description Indicates the exemption type of the customer. This is applicable only if you use Chargebee&#x27;s TaxJar integration. \* government - Government \* other - Other \* wholesale - Whole-sale
1353
-
1354
- */
1355
-
1356
480
  taxjar_exemption_category?:TaxjarExemptionCategory;
1357
481
 
1358
- /**
1359
- * @description Determines which region-specific language Chargebee uses to communicate with the customer. In the absence of the locale attribute, Chargebee will use your site&#x27;s default language for customer communication.
1360
-
1361
- */
1362
-
1363
482
  locale?:string;
1364
483
 
1365
- /**
1366
- * @description The exemption category of the customer, for USA and Canada. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption). \* med2 - US Medical Device Excise Tax with taxable sales tax \* med1 - US Medical Device Excise Tax with exempt sales tax \* d - Foreign diplomat \* e - Charitable or benevolent organization \* f - Religious organization \* g - Resale \* a - Federal government \* b - State government \* c - Tribe/Status Indian/Indian Band \* l - Other or custom \* m - Educational organization \* n - Local government \* h - Commercial agricultural production \* i - Industrial production/manufacturer \* j - Direct pay permit \* k - Direct mail \* p - Commercial aquaculture \* q - Commercial Fishery \* r - Non-resident
1367
-
1368
- */
1369
-
1370
484
  entity_code?:EntityCode;
1371
485
 
1372
- /**
1373
- * @description Any string value that will cause the sale to be exempted. Use this if your finance team manually verifies and tracks exemption certificates. Applicable if you use Chargebee&#x27;s [AvaTax for Sales integration](https://www.chargebee.com/docs/avalara.html#configuring-tax-exemption).
1374
-
1375
- */
1376
-
1377
486
  exempt_number?:string;
1378
487
 
1379
- /**
1380
- * @description The preferred offline payment method for the customer. \* bank_transfer - Bank Transfer \* boleto - Boleto \* sepa_credit - SEPA Credit \* cash - Cash \* check - Check \* no_preference - No Preference \* ach_credit - ACH Credit
1381
-
1382
- */
1383
-
1384
488
  offline_payment_method?:OfflinePaymentMethod;
1385
489
 
1386
- /**
1387
- * @description A customer-facing note added to all invoices associated with this API resource. This note becomes one among [all the notes](/docs/api/invoices#invoice_notes) displayed on the invoice PDF.
1388
-
1389
- */
1390
-
1391
490
  invoice_notes?:string;
1392
491
 
1393
- /**
1394
- * @description Override for this customer, the [site-level setting](https://www.chargebee.com/docs/2.0/metered_billing.html#configuring-metered-billing) for auto-closing invoices. Only applicable when auto-closing invoices has been enabled for the site. This attribute is also available at the [subscription level](/docs/api/subscriptions?prod_cat_ver&#x3D;2#subscription_auto_close_invoices) which takes precedence.
1395
-
1396
- */
1397
-
1398
492
  auto_close_invoices?:boolean;
1399
493
 
1400
- /**
1401
- * @description A collection of key-value pairs that provides extra information about the customer.
1402
- **Note:** There&#x27;s a character limit of 65,535.
1403
- [Learn more](advanced-features?prod_cat_ver&#x3D;2#metadata).
1404
-
1405
- */
1406
-
1407
494
  meta_data?:object;
1408
495
 
1409
- /**
1410
- * @description Indicates whether or not the customer has been identified as fraudulent. \* fraudulent - The customer has been marked as fraudulent \* suspicious - The customer has been identified as potentially fraudulent by the gateway \* safe - The customer has been marked as safe
1411
-
1412
- */
1413
-
1414
496
  fraud_flag?:'safe' | 'fraudulent';
1415
497
 
1416
- /**
1417
- * @description Indicates whether invoices raised on the same day for the &#x60;customer&#x60; are consolidated. When provided, this overrides the default configuration at the [site-level](https://www.chargebee.com/docs/consolidated-invoicing.html#configuring-consolidated-invoicing). This parameter can be provided only when [Consolidated Invoicing](https://www.chargebee.com/docs/consolidated-invoicing.html) is enabled.
1418
- **Note:**
1419
-
1420
- Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &#x60;future&#x60; &#x60;status&#x60;, are not consolidated by default. [Contact Support](https://chargebee.freshdesk.com/support/home) to enable consolidation for such invoices.
1421
- .
1422
-
1423
- */
1424
-
1425
498
  consolidated_invoicing?:boolean;
1426
499
  }
1427
500
  export interface UpdatePaymentMethodResponse {
@@ -1431,12 +504,7 @@ Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &
1431
504
  }
1432
505
  export interface UpdatePaymentMethodInputParam {
1433
506
 
1434
- /**
1435
- * @description Parameters for payment_method
1436
-
1437
- */
1438
-
1439
- payment_method:{additional_information?:object,gateway_account_id?:string,issuing_country?:string,reference_id?:string,tmp_token?:string,type:Type};
507
+ payment_method:null.null;
1440
508
  }
1441
509
  export interface UpdateBillingInfoResponse {
1442
510
  customer:Customer;
@@ -1445,123 +513,44 @@ Any invoices raised when a subscription activates from &#x60;in_trial&#x60; or &
1445
513
  }
1446
514
  export interface UpdateBillingInfoInputParam {
1447
515
 
1448
- /**
1449
- * @description The VAT/tax registration number for the customer. For customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ), the first two characters of the [full VAT
1450
- number](https://en.wikipedia.org/wiki/VAT_identification_number) can be overridden by setting [vat_number_prefix](customers#customer_vat_number_prefix).
1451
-
1452
- */
516
+ billing_address?:null.null;
1453
517
 
1454
- vat_number?:string;
518
+ entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
1455
519
 
1456
- /**
1457
- * @description An overridden value for the first two characters of the [full VAT
1458
- number](https://en.wikipedia.org/wiki/VAT_identification_number). Only applicable specifically for customers with [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60; (which is **United Kingdom - Northern Ireland** ).
1459
-
1460
- When you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or have [manually
1461
- enabled](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, you have the option of setting [billing_address](customers#customer_billing_address) &#x60;country&#x60; as &#x60;XI&#x60;. That&#x27;s the code for **United Kingdom - Northern
1462
- Ireland** . The first two characters of the VAT number in such a case is &#x60;XI&#x60; by default. However, if the VAT number was registered in UK, the value should be &#x60;GB&#x60;. Set &#x60;vat_number_prefix&#x60; to &#x60;GB&#x60; for such cases.
1463
-
1464
- */
520
+ tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
1465
521
 
1466
- vat_number_prefix?:string;
522
+ vat_number?:string;
1467
523
 
1468
- /**
1469
- * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, &#x60;DE:VAT&#x60; is used for a German business entity while &#x60;DE:LWID45&#x60; is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under &#x60;billing_address.country&#x60;. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).
1470
- **Tip:**
1471
-
1472
-
1473
- If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
1474
- .
1475
-
1476
- */
524
+ vat_number_prefix?:string;
1477
525
 
1478
526
  entity_identifier_scheme?:string;
1479
527
 
1480
- /**
1481
- * @description The standard used for specifying the &#x60;entity_identifier_scheme&#x60;. Currently only &#x60;iso6523-actorid-upis&#x60; is supported and is used by default when not provided.
1482
- **Tip:**
1483
-
1484
-
1485
- If there are additional entity identifiers for the customer not associated with the &#x60;vat_number&#x60;, they can be provided as the &#x60;entity_identifiers[]&#x60; array.
1486
- .
1487
-
1488
- */
1489
-
1490
528
  entity_identifier_standard?:string;
1491
529
 
1492
- /**
1493
- * @description Confirms that a customer is registered under GST. If set to &#x60;true&#x60; then the [Reverse Charge Mechanism](https://www.chargebee.com/docs/australian-gst.html#reverse-charge-mechanism) is applicable. This field is applicable only when Australian GST is configured for your site.
1494
-
1495
- */
1496
-
1497
530
  registered_for_gst?:boolean;
1498
531
 
1499
- /**
1500
- * @description Confirms that a customer is a valid business without an EU/UK VAT number.
1501
-
1502
- */
1503
-
1504
532
  business_customer_without_vat_number?:boolean;
1505
533
 
1506
- /**
1507
- * @description Determines whether the customer is e-invoiced. When set to &#x60;true&#x60; or not set to any value, the customer is e-invoiced so long as e-invoicing is enabled for their country (&#x60;billing_address.country&#x60;). When set to &#x60;false&#x60;, the customer is not e-invoiced even if e-invoicing is enabled for their country.
1508
- **Tip:**
1509
-
1510
-
1511
- It is possible to set a value for this flag even when E-Invoicing is disabled. However, it comes into effect only when E-Invoicing is enabled.
1512
- .
1513
-
1514
- */
1515
-
1516
534
  is_einvoice_enabled?:boolean;
1517
535
 
1518
- /**
1519
- * @description Determines whether to send einvoice manually or automatic. \* automatic - Use this value to send e-invoice every time an invoice or credit note is created. \* manual - When manual is selected the automatic e-invoice sending is disabled. Use this value to send e-invoice manually through UI or API. \* site_default - The default value of the site which can be overridden at the customer level.
1520
-
1521
- */
1522
-
1523
536
  einvoicing_method?:EinvoicingMethod;
1524
-
1525
- /**
1526
- * @description Parameters for billing_address
1527
-
1528
- */
1529
-
1530
- 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};
1531
-
1532
- /**
1533
- * @description Parameters for entity_identifiers
1534
-
1535
- */
1536
-
1537
- entity_identifiers?:{id?:string,operation?:Operation,scheme?:string,standard?:string,value?:string}[];
1538
537
  }
1539
538
  export interface ContactsForCustomerResponse {
1540
- /**
1541
- * @description This API retrieves all the contacts for a customer.
1542
-
1543
- */
1544
-
1545
539
  list:{contact:Contact}[];
1546
540
 
1547
- /**
1548
- * @description This API retrieves all the contacts for a customer.
1549
-
1550
- */
1551
-
1552
541
  next_offset?:string;
1553
542
  }
1554
543
  export interface ContactsForCustomerInputParam {
1555
544
  [key : string]: any;
1556
545
  /**
1557
- * @description This API retrieves all the contacts for a customer.
546
+ * @description The number of resources to be returned.
1558
547
 
1559
548
  */
1560
549
 
1561
550
  limit?:number;
1562
551
 
1563
552
  /**
1564
- * @description This API retrieves all the contacts for a customer.
553
+ * @description Determines your position in the list for pagination. To ensure that the next page is retrieved correctly, always set \&#x60;offset\&#x60; to the value of \&#x60;next_offset\&#x60; obtained in the previous iteration of the API call.
1565
554
 
1566
555
  */
1567
556
 
@@ -1574,18 +563,8 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
1574
563
  }
1575
564
  export interface AssignPaymentRoleInputParam {
1576
565
 
1577
- /**
1578
- * @description Payment source id this role will be assigned to.
1579
-
1580
- */
1581
-
1582
566
  payment_source_id:string;
1583
567
 
1584
- /**
1585
- * @description Indicates whether the payment source is Primary, Backup, or neither. \* backup - Backup \* none - None \* primary - Primary
1586
-
1587
- */
1588
-
1589
568
  role:Role;
1590
569
  }
1591
570
  export interface AddContactResponse {
@@ -1595,12 +574,7 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
1595
574
  }
1596
575
  export interface AddContactInputParam {
1597
576
 
1598
- /**
1599
- * @description Parameters for contact
1600
-
1601
- */
1602
-
1603
- contact?:{email:string,enabled?:boolean,first_name?:string,id?:string,label?:string,last_name?:string,phone?:string,send_account_email?:boolean,send_billing_email?:boolean};
577
+ contact:null.null;
1604
578
  }
1605
579
  export interface UpdateContactResponse {
1606
580
  customer:Customer;
@@ -1609,12 +583,7 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
1609
583
  }
1610
584
  export interface UpdateContactInputParam {
1611
585
 
1612
- /**
1613
- * @description Parameters for contact
1614
-
1615
- */
1616
-
1617
- contact?:{email?:string,enabled?:boolean,first_name?:string,id:string,label?:string,last_name?:string,phone?:string,send_account_email?:boolean,send_billing_email?:boolean};
586
+ contact:null.null;
1618
587
  }
1619
588
  export interface DeleteContactResponse {
1620
589
  customer:Customer;
@@ -1623,110 +592,90 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
1623
592
  }
1624
593
  export interface DeleteContactInputParam {
1625
594
 
1626
- /**
1627
- * @description Parameters for contact
1628
-
1629
- */
1630
-
1631
- contact?:{id:string};
595
+ contact:null.null;
1632
596
  }
1633
- export interface RecordExcessPaymentResponse {
597
+ export interface AddPromotionalCreditsResponse {
1634
598
  customer:Customer;
1635
-
1636
- transaction:Transaction;
1637
599
  }
1638
- export interface RecordExcessPaymentInputParam {
600
+ export interface AddPromotionalCreditsInputParam {
1639
601
 
1640
- /**
1641
- * @description Remarks, if any, on the payment.
1642
-
1643
- */
602
+ amount:number;
1644
603
 
1645
- comment?:string;
604
+ currency_code?:string;
1646
605
 
1647
- /**
1648
- * @description Parameters for transaction
1649
-
1650
- */
606
+ description:string;
607
+
608
+ credit_type?:CreditType;
1651
609
 
1652
- transaction:{amount:number,currency_code?:string,custom_payment_method_id?:string,date:number,payment_method:PaymentMethod,reference_number?:string};
610
+ reference?:string;
1653
611
  }
1654
- export interface CollectPaymentResponse {
612
+ export interface DeductPromotionalCreditsResponse {
1655
613
  customer:Customer;
1656
-
1657
- transaction:Transaction;
1658
614
  }
1659
- export interface CollectPaymentInputParam {
615
+ export interface DeductPromotionalCreditsInputParam {
1660
616
 
1661
- /**
1662
- * @description Amount to be collected. If this parameter is not passed then the invoice(s) amount to collect will be collected.
1663
-
1664
- */
617
+ amount:number;
1665
618
 
1666
- amount?:number;
619
+ currency_code?:string;
1667
620
 
1668
- /**
1669
- * @description Payment source used for the payment.
1670
-
1671
- */
621
+ description:string;
1672
622
 
1673
- payment_source_id?:string;
623
+ credit_type?:CreditType;
1674
624
 
1675
- /**
1676
- * @description Token generated by Chargebee JS representing payment method details.
1677
-
1678
- */
625
+ reference?:string;
626
+ }
627
+ export interface SetPromotionalCreditsResponse {
628
+ customer:Customer;
629
+ }
630
+ export interface SetPromotionalCreditsInputParam {
1679
631
 
1680
- token_id?:string;
632
+ amount:number;
633
+
634
+ currency_code?:string;
635
+
636
+ description:string;
637
+
638
+ credit_type?:CreditType;
639
+
640
+ reference?:string;
641
+ }
642
+ export interface RecordExcessPaymentResponse {
643
+ customer:Customer;
1681
644
 
1682
- /**
1683
- * @description Indicates whether the primary payment source should be replaced with this payment source. In case of Create Subscription for Customer endpoint, the default value is True. Otherwise, the default value is False.
1684
-
1685
- */
645
+ transaction:Transaction;
646
+ }
647
+ export interface RecordExcessPaymentInputParam {
1686
648
 
1687
- replace_primary_payment_source?:boolean;
649
+ transaction:null.null;
1688
650
 
1689
- /**
1690
- * @description Indicates whether the payment source should be retained for the customer.
1691
-
1692
- */
651
+ comment?:string;
652
+ }
653
+ export interface CollectPaymentResponse {
654
+ customer:Customer;
1693
655
 
1694
- retain_payment_source?:boolean;
656
+ transaction:Transaction;
657
+ }
658
+ export interface CollectPaymentInputParam {
1695
659
 
1696
- /**
1697
- * @description The type of initiator to be used for the payment request triggered by this operation. \* customer - Pass this value to indicate that the request is initiated by the customer \* merchant - Pass this value to indicate that the request is initiated by the merchant
1698
-
1699
- */
660
+ payment_method?:null.null;
1700
661
 
1701
- payment_initiator?:PaymentInitiator;
662
+ card?:null.null;
1702
663
 
1703
- /**
1704
- * @description Parameters for payment_method
1705
-
1706
- */
664
+ payment_intent?:null.null;
1707
665
 
1708
- payment_method?:{additional_information?:object,gateway_account_id?:string,reference_id?:string,tmp_token?:string,type?:Type};
666
+ invoice_allocations:{allocation_amount?:number,invoice_id:string}[];
1709
667
 
1710
- /**
1711
- * @description Parameters for card
1712
-
1713
- */
668
+ amount?:number;
1714
669
 
1715
- card?:{additional_information?:object,billing_addr1?:string,billing_addr2?:string,billing_city?:string,billing_country?:string,billing_state?:string,billing_state_code?:string,billing_zip?:string,cvv?:string,expiry_month?:number,expiry_year?:number,first_name?:string,gateway_account_id?:string,last_name?:string,number?:string};
670
+ payment_source_id?:string;
1716
671
 
1717
- /**
1718
- * @description Parameters for payment_intent
1719
-
1720
- */
672
+ token_id?:string;
1721
673
 
1722
- payment_intent?:{additional_information?:object,gateway_account_id?:string,gw_token?:string,id?:string,payment_method_type?:'giropay' | 'ideal' | 'sepa_instant_transfer' | 'google_pay' | 'netbanking_emandates' | 'klarna_pay_now' | 'dotpay' | 'boleto' | 'direct_debit' | 'faster_payments' | 'sofort' | 'upi' | 'venmo' | 'amazon_payments' | 'apple_pay' | 'bancontact' | 'paypal_express_checkout' | 'pay_to' | 'card',reference_id?:string};
674
+ replace_primary_payment_source?:boolean;
1723
675
 
1724
- /**
1725
- * @description Parameters for invoice_allocations
1726
-
1727
- */
676
+ retain_payment_source?:boolean;
1728
677
 
1729
- invoice_allocations?:{allocation_amount?:number,invoice_id:string}[];
678
+ payment_initiator?:PaymentInitiator;
1730
679
  }
1731
680
  export interface DeleteResponse {
1732
681
  customer:Customer;
@@ -1735,11 +684,6 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
1735
684
  }
1736
685
  export interface DeleteInputParam {
1737
686
 
1738
- /**
1739
- * @description Deletes the Payment Method from the gateway/vault.
1740
-
1741
- */
1742
-
1743
687
  delete_payment_method?:boolean;
1744
688
  }
1745
689
  export interface MoveResponse {
@@ -1747,18 +691,10 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
1747
691
  }
1748
692
  export interface MoveInputParam {
1749
693
 
1750
- /**
1751
- * @description Id of the customer to be copied.
1752
-
1753
- */
694
+ tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
1754
695
 
1755
696
  id_at_from_site:string;
1756
697
 
1757
- /**
1758
- * @description Name of the site from which this customer need to be copied.
1759
-
1760
- */
1761
-
1762
698
  from_site:string;
1763
699
  }
1764
700
  export interface ChangeBillingDateResponse {
@@ -1766,43 +702,13 @@ It is possible to set a value for this flag even when E-Invoicing is disabled. H
1766
702
  }
1767
703
  export interface ChangeBillingDateInputParam {
1768
704
 
1769
- /**
1770
- * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. When set, renewals of all the monthly and yearly subscriptions of this customer will be aligned to this date.
1771
-
1772
- */
1773
-
1774
705
  billing_date?:number;
1775
706
 
1776
- /**
1777
- * @description &#x60;billing_month&#x60;, together with &#x60;billing_date&#x60;, specify, for this customer, the day of the year when the renewals of all the year-based subscriptions take place.
1778
-
1779
- For example, the renewals happen on 15th July when &#x60;billing_month&#x60; is &#x60;7&#x60; and &#x60;billing_date&#x60; is &#x60;15&#x60;.
1780
- **Note**
1781
-
1782
- Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billing.html) (with customer-specific billing date support) is enabled and &#x60;billing_date_mode&#x60; is &#x60;manually_set&#x60;.
1783
-
1784
- */
1785
-
1786
707
  billing_month?:number;
1787
708
 
1788
- /**
1789
- * @description Indicates whether this customer&#x27;s *billing_date* value is derived as per configurations or its specifically set (overriden). When specifically set, the *billing_date* will not be reset even when all of the monthly/yearly subscriptions are cancelled. \* manually_set - Billing date is specifically set (default configuration is overridden) \* using_defaults - Billing date is set based on defaults configured.
1790
-
1791
- */
1792
-
1793
709
  billing_date_mode?:BillingDateMode;
1794
710
 
1795
- /**
1796
- * @description Applicable when *calendar billing* (with customer specific billing date support) is enabled. When set, renewals of all the weekly subscriptions of this customer will be aligned to this week day. \* sunday - Sunday \* wednesday - Wednesday \* tuesday - Tuesday \* monday - Monday \* saturday - Saturday \* friday - Friday \* thursday - Thursday
1797
-
1798
- */
1799
-
1800
- billing_day_of_week?:'sunday' | 'saturday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'monday';
1801
-
1802
- /**
1803
- * @description Indicates whether this customer&#x27;s *billing_day_of_week* value is derived as per configurations or its specifically set (overriden). When specifically set, the *billing_day_of_week* will not be reset even when all of the weekly subscriptions are cancelled. \* manually_set - Billing date is specifically set (default configuration is overridden) \* using_defaults - Billing date is set based on defaults configured.
1804
-
1805
- */
711
+ billing_day_of_week?:'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
1806
712
 
1807
713
  billing_day_of_week_mode?:BillingDayOfWeekMode;
1808
714
  }
@@ -1811,18 +717,10 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
1811
717
  }
1812
718
  export interface MergeInputParam {
1813
719
 
1814
- /**
1815
- * @description From customer id.
1816
-
1817
- */
720
+ tax_providers_fields?:{field_id?:string,field_value?:string,provider_name?:string}[];
1818
721
 
1819
722
  from_customer_id:string;
1820
723
 
1821
- /**
1822
- * @description To customer id.
1823
-
1824
- */
1825
-
1826
724
  to_customer_id:string;
1827
725
  }
1828
726
  export interface ClearPersonalDataResponse {
@@ -1834,50 +732,17 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
1834
732
  }
1835
733
  export interface RelationshipsInputParam {
1836
734
 
1837
- /**
1838
- * @description ID of the customer intended to be set as the immediate parent of the customer identified by &#x60;customer_id&#x60;.
1839
-
1840
- */
735
+ parent_account_access?:null.null;
1841
736
 
1842
- parent_id?:string;
737
+ child_account_access?:null.null;
1843
738
 
1844
- /**
1845
- * @description The &#x60;id&#x60; of the customer responsible for paying the invoices for the customer identified by &#x60;customer_id&#x60;. This ID must match either &#x60;customer_id&#x60; or &#x60;invoice_owner_id&#x60;.
1846
-
1847
- */
739
+ parent_id?:string;
1848
740
 
1849
741
  payment_owner_id?:string;
1850
742
 
1851
- /**
1852
- * @description The &#x60;id&#x60; of the customer who receives the invoice for charges incurred by the customer identified by &#x60;customer_id&#x60;. This ID must match either &#x60;customer_id&#x60; or one of its ancestors.
1853
-
1854
- */
1855
-
1856
743
  invoice_owner_id?:string;
1857
744
 
1858
- /**
1859
- * @description Decides if Chargebee should apply settings from the [Chargebee Billing UI](https://www.chargebee.com/docs/2.0/account-hierarchy.html#advanced-mode) or from this API request.
1860
-
1861
- * If set to &#x60;true&#x60;: Chargebee uses settings configured in the Chargebee Billing UI.
1862
- * If set to &#x60;false&#x60;: Settings provided in the &#x60;parent_account_access&#x60; and &#x60;child_account_access&#x60; parameters are applied.
1863
-
1864
- */
1865
-
1866
745
  use_default_hierarchy_settings?:boolean;
1867
-
1868
- /**
1869
- * @description Settings for the parent account&#x27;s access.
1870
-
1871
- */
1872
-
1873
- parent_account_access?:{portal_download_child_invoices?:'no' | 'yes' | 'view_only',portal_edit_child_subscriptions?:'no' | 'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
1874
-
1875
- /**
1876
- * @description Settings for the child account&#x27;s access.
1877
-
1878
- */
1879
-
1880
- child_account_access?:{portal_download_invoices?:'no' | 'yes' | 'view_only',portal_edit_subscriptions?:'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
1881
746
  }
1882
747
  export interface DeleteRelationshipResponse {
1883
748
  customer:Customer;
@@ -1888,11 +753,6 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
1888
753
  }
1889
754
  export interface HierarchyInputParam {
1890
755
 
1891
- /**
1892
- * @description Retrieves the full or partial [account hierarchy](/docs/api/hierarchies) for a customer.
1893
-
1894
- */
1895
-
1896
756
  hierarchy_operation_type:'complete_hierarchy' | 'subordinates' | 'path_to_root';
1897
757
  }
1898
758
  export interface UpdateHierarchySettingsResponse {
@@ -1900,369 +760,108 @@ Applicable when [Calendar Billing](https://www.chargebee.com/docs/calendar-billi
1900
760
  }
1901
761
  export interface UpdateHierarchySettingsInputParam {
1902
762
 
1903
- /**
1904
- * @description Decides if Chargebee should apply settings from the [Chargebee Billing UI](https://www.chargebee.com/docs/2.0/account-hierarchy.html#advanced-mode) or from this API request.
1905
-
1906
- * If set to &#x60;true&#x60;: Chargebee removes existing settings stored in the &#x60;parent_account_access&#x60; and &#x60;child_account_access&#x60; attributes of the customer. The settings configured in the Chargebee Billing UI apply for the customer.
1907
- * If set to &#x60;false&#x60;: Chargebee replaces existing settings stored in the &#x60;parent_account_access&#x60; and &#x60;child_account_access&#x60; parameters with those passed in this API call. If any of those parameters are not passed, they remain unchanged for the customer.
1908
-
1909
- */
1910
-
1911
- use_default_hierarchy_settings?:boolean;
1912
-
1913
- /**
1914
- * @description Parameters for parent_account_access
1915
-
1916
- */
1917
-
1918
- parent_account_access?:{portal_download_child_invoices?:'no' | 'yes' | 'view_only',portal_edit_child_subscriptions?:'no' | 'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
763
+ parent_account_access?:null.null;
1919
764
 
1920
- /**
1921
- * @description When the customer is part of an [account hierarchy](https://www.chargebee.com/docs/account-hierarchy.html), this attribute defines the level of access that the customer has to its own information.
1922
-
1923
- */
765
+ child_account_access?:null.null;
1924
766
 
1925
- child_account_access?:{portal_download_invoices?:'no' | 'yes' | 'view_only',portal_edit_subscriptions?:'yes' | 'view_only',send_invoice_emails?:boolean,send_payment_emails?:boolean,send_subscription_emails?:boolean};
767
+ use_default_hierarchy_settings?:boolean;
1926
768
  }
1927
769
  export interface BillingAddress {
1928
- /**
1929
- * @description The first name of the billing contact.
1930
-
1931
- */
1932
-
1933
770
  first_name?:string;
1934
771
 
1935
- /**
1936
- * @description The last name of the billing contact.
1937
-
1938
- */
1939
-
1940
772
  last_name?:string;
1941
773
 
1942
- /**
1943
- * @description The email address.
1944
-
1945
- */
1946
-
1947
774
  email?:string;
1948
775
 
1949
- /**
1950
- * @description The company name.
1951
-
1952
- */
1953
-
1954
776
  company?:string;
1955
777
 
1956
- /**
1957
- * @description The phone number.
1958
-
1959
- */
1960
-
1961
778
  phone?:string;
1962
779
 
1963
- /**
1964
- * @description Address line 1
1965
-
1966
- */
1967
-
1968
780
  line1?:string;
1969
781
 
1970
- /**
1971
- * @description Address line 2
1972
-
1973
- */
1974
-
1975
782
  line2?:string;
1976
783
 
1977
- /**
1978
- * @description Address line 3
1979
-
1980
- */
1981
-
1982
784
  line3?:string;
1983
785
 
1984
- /**
1985
- * @description The name of the city.
1986
-
1987
- */
1988
-
1989
786
  city?:string;
1990
787
 
1991
- /**
1992
- * @description The [ISO 3166-2 state/province code](https://www.iso.org/obp/ui/#search) without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set &#x60;state_code&#x60; as &#x60;AZ&#x60; (not &#x60;US-AZ&#x60;). For Tamil Nadu (India), set as &#x60;TN&#x60; (not &#x60;IN-TN&#x60;). For British Columbia (Canada), set as &#x60;BC&#x60; (not &#x60;CA-BC&#x60;).
1993
-
1994
- */
1995
-
1996
788
  state_code?:string;
1997
789
 
1998
- /**
1999
- * @description State or Province
2000
-
2001
- */
2002
-
2003
790
  state?:string;
2004
791
 
2005
- /**
2006
- * @description The billing address country of the customer. Must be one of [ISO 3166 alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html).
2007
-
2008
- **Note** : If you enter an invalid country code, the system will return an error.
2009
-
2010
- **Brexit**
2011
-
2012
-
2013
- If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or later, or have [manually enable](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, then &#x60;XI&#x60; (the code for **United Kingdom -- Northern Ireland**) is available as an option.
2014
-
2015
- */
2016
-
2017
792
  country?:string;
2018
793
 
2019
- /**
2020
- * @description Zip or postal code. The number of characters is validated according to the rules [specified here](https://chromium-i18n.appspot.com/ssl-address).
2021
-
2022
- */
2023
-
2024
794
  zip?:string;
2025
795
 
2026
- /**
2027
- * @description The address verification status. \* valid - Address was validated successfully. \* partially_valid - The address is valid for taxability but has not been validated for shipping. \* invalid - Address is invalid. \* not_validated - Address is not yet validated.
2028
-
2029
- */
2030
-
2031
796
  validation_status?:ValidationStatus;
2032
797
  }
2033
798
  export interface ReferralUrl {
2034
- /**
2035
- * @description External customer id in the referral system
2036
-
2037
- */
2038
-
2039
799
  external_customer_id?:string;
2040
800
 
2041
- /**
2042
- * @description Referral sharing url for the customer
2043
-
2044
- */
2045
-
2046
801
  referral_sharing_url:string;
2047
802
 
2048
- /**
2049
- * @description The referral url creation time
2050
-
2051
- */
2052
-
2053
803
  created_at:number;
2054
804
 
2055
- /**
2056
- * @description The referral url updation time
2057
-
2058
- */
2059
-
2060
805
  updated_at:number;
2061
806
 
2062
- /**
2063
- * @description Referral campaign id
2064
-
2065
- */
2066
-
2067
807
  referral_campaign_id:string;
2068
808
 
2069
- /**
2070
- * @description Referral account id
2071
-
2072
- */
2073
-
2074
809
  referral_account_id:string;
2075
810
 
2076
- /**
2077
- * @description Referral external campaign id
2078
-
2079
- */
2080
-
2081
811
  referral_external_campaign_id?:string;
2082
812
 
2083
- /**
2084
- * @description Url for the referral system account \* referral_saasquatch - Referral Saasquatch \* friendbuy - Friendbuy \* referral_candy - Referral Candy
2085
-
2086
- */
2087
-
2088
- referral_system:'referral_candy' | 'friendbuy' | 'referral_saasquatch';
813
+ referral_system:'referral_candy' | 'referral_saasquatch' | 'friendbuy';
2089
814
  }
2090
815
  export interface Contact {
2091
- /**
2092
- * @description Unique reference ID provided for the contact.
2093
-
2094
- */
2095
-
2096
816
  id:string;
2097
817
 
2098
- /**
2099
- * @description First name of the contact.
2100
-
2101
- */
2102
-
2103
818
  first_name?:string;
2104
819
 
2105
- /**
2106
- * @description Last name of the contact.
2107
-
2108
- */
2109
-
2110
820
  last_name?:string;
2111
821
 
2112
- /**
2113
- * @description Email of the contact.
2114
-
2115
- */
2116
-
2117
822
  email:string;
2118
823
 
2119
- /**
2120
- * @description Phone number of the contact.
2121
-
2122
- */
2123
-
2124
824
  phone?:string;
2125
825
 
2126
- /**
2127
- * @description Label/Tag provided for contact.
2128
-
2129
- */
2130
-
2131
826
  label?:string;
2132
827
 
2133
- /**
2134
- * @description Contact enabled / disabled
2135
-
2136
- */
2137
-
2138
828
  enabled:boolean;
2139
829
 
2140
- /**
2141
- * @description Whether Account Emails option is enabled for the contact.
2142
-
2143
- */
2144
-
2145
830
  send_account_email:boolean;
2146
831
 
2147
- /**
2148
- * @description Whether Billing Emails option is enabled for the contact.
2149
-
2150
- */
2151
-
2152
832
  send_billing_email:boolean;
2153
833
  }
2154
834
  export interface PaymentMethod {
2155
- /**
2156
- * @description Type of payment source \* google_pay - Payments made via Google Pay. \* sofort - Payments made via Sofort. \* netbanking_emandates - Netbanking (eMandates) Payments. \* apple_pay - Payments made via Apple Pay. \* unionpay - Payments made via UnionPay. \* giropay - Payments made via giropay. \* direct_debit - Represents bank account for which the direct debit or ACH agreement/mandate is created. \* bancontact - Payments made via Bancontact Card. \* upi - UPI Payments. \* alipay - Payments made via Alipay. \* pay_to - Payments made via PayTo \* wechat_pay - Payments made via WeChat Pay. \* sepa_instant_transfer - Payments made via Sepa Instant Transfer \* dotpay - Payments made via Dotpay. \* paypal_express_checkout - Payments made via PayPal Express Checkout. \* ideal - Payments made via iDEAL. \* generic - Payments made via Generic Payment Method. \* faster_payments - Payments made via Faster Payments \* venmo - Payments made via Venmo \* amazon_payments - Payments made via Amazon Payments. \* card - Card based payment including credit cards and debit cards. Details about the card can be obtained from the card resource.
2157
-
2158
- */
2159
-
2160
835
  type:Type;
2161
836
 
2162
- /**
2163
- * @description Name of the gateway the payment method is associated with. \* ecentric - Ecentric provides a seamless payment processing service in South Africa specializing on omnichannel capabilities. \* paypal_payflow_pro - PayPal Payflow Pro is a payment gateway. \* sage_pay - Sage Pay is a payment gateway. \* wepay - WePay is a payment gateway. \* wirecard - WireCard Account is a payment service provider. \* migs - MasterCard Internet Gateway Service payment gateway. \* ebanx - EBANX is a payment gateway, enabling businesses to accept diverse local payment methods from various countries for increased market reach and conversion. \* beanstream - Bambora(formerly known as Beanstream) is a payment gateway. \* adyen - Adyen is a payment gateway. \* razorpay - Razorpay is a fast growing payment service provider in India working with all leading banks and support for major local payment methods including Netbanking, UPI etc. \* braintree - Braintree is a payment gateway. \* nmi - NMI is a payment gateway. \* chargebee_payments - Chargebee Payments gateway \* bluepay - BluePay is a payment gateway. \* paypal - PayPal Commerce is a payment gateway. \* bank_of_america - Bank of America is a payment gateway. \* paypal_pro - PayPal Pro Account is a payment gateway. \* eway_rapid - eWAY Rapid is a payment gateway. \* windcave - Windcave provides an end to end payment processing solution in ANZ and other leading global markets. \* moneris_us - Moneris USA is a payment gateway. \* exact - Exact Payments is a payment gateway. \* paypal_express_checkout - PayPal Express Checkout is a payment gateway. \* tco - 2Checkout is a payment gateway. \* pay_com - Pay.com provides payment services focused on simplicity and hassle-free operations for businesses of all sizes. \* chargebee - Chargebee test gateway. \* stripe - Stripe is a payment gateway. \* eway - eWAY Account is a payment gateway. \* authorize_net - Authorize.net is a payment gateway \* moneris - Moneris is a payment gateway. \* worldpay - WorldPay is a payment gateway \* pin - Pin is a payment gateway \* gocardless - GoCardless is a payment service provider. \* elavon - Elavon Virtual Merchant is a payment solution. \* cybersource - CyberSource is a payment gateway. \* vantiv - Vantiv is a payment gateway. \* amazon_payments - Amazon Payments is a payment service provider. \* global_payments - Global Payments is a payment service provider. \* first_data_global - First Data Global Gateway Virtual Terminal Account \* orbital - Chase Paymentech(Orbital) is a payment gateway. \* checkout_com - Checkout.com is a payment gateway. \* quickbooks - Intuit QuickBooks Payments gateway \* mollie - Mollie is a payment gateway. \* bluesnap - BlueSnap is a payment gateway. \* paymill - PAYMILL is a payment gateway. \* ogone - Ingenico ePayments (formerly known as Ogone) is a payment gateway. \* not_applicable - Indicates that payment gateway is not applicable for this resource. \* hdfc - HDFC Account is a payment gateway. \* balanced_payments - Balanced is a payment gateway \* ingenico_direct - Worldline Online Payments is a payment gateway. \* metrics_global - Metrics global is a leading payment service provider providing unified payment services in the US.
2164
-
2165
- */
2166
-
2167
837
  gateway:Gateway;
2168
838
 
2169
- /**
2170
- * @description The gateway account this payment method is stored with.
2171
-
2172
- */
2173
-
2174
839
  gateway_account_id?:string;
2175
840
 
2176
- /**
2177
- * @description Current status of the payment source. \* expired - A payment source that has expired \* invalid - The billing agreement cannot be used. It might become valid again either automatically or due to customer action. \* valid - A payment source that is valid and active. \* pending_verification - The payment source needs to be verified \* expiring - A payment source that is expiring (like card&#x27;s status based on its expiry date).
2178
-
2179
- */
2180
-
2181
841
  status:'valid' | 'expiring' | 'expired' | 'invalid' | 'pending_verification';
2182
842
 
2183
- /**
2184
- * @description The reference id. In the case of Amazon and PayPal this will be the &#x27;billing agreement id&#x27;. For GoCardless direct debit this will be &#x27;mandate id&#x27;. In the case of card payments this will be the identifier provided by the gateway/card vault for the specific payment method resource.
2185
- **Note:** This is not the one time temporary token provided by gateways like Stripe.
2186
-
2187
- */
2188
-
2189
843
  reference_id:string;
2190
844
  }
2191
- export interface CustomerBalance {
2192
- /**
2193
- * @description Promotional credits balance of this customer.
2194
-
2195
- */
2196
-
845
+ export interface Balance {
2197
846
  promotional_credits:number;
2198
847
 
2199
- /**
2200
- * @description Total unused payments associated with the customer.
2201
-
2202
- */
2203
-
2204
848
  excess_payments:number;
2205
849
 
2206
- /**
2207
- * @description Refundable credits balance of this customer
2208
-
2209
- */
2210
-
2211
850
  refundable_credits:number;
2212
851
 
2213
- /**
2214
- * @description Total unbilled charges for this customer.
2215
-
2216
- */
2217
-
2218
852
  unbilled_charges:number;
2219
853
 
2220
- /**
2221
- * @description The currency code (ISO 4217 format) for balance
2222
-
2223
- */
2224
-
2225
854
  currency_code:string;
855
+
856
+ balance_currency_code:string;
2226
857
  }
2227
858
  export interface EntityIdentifier {
2228
- /**
2229
- * @description The unique id for the &#x60;entity_identifier&#x60; in Chargebee. When not provided, it is autogenerated.
2230
-
2231
- */
2232
-
2233
859
  id:string;
2234
860
 
2235
- /**
2236
- * @description The value of the &#x60;entity_identifier&#x60;. This identifies the customer entity on the Peppol network. For example: &#x60;10101010-STO-10&#x60;.
2237
- **Tip:**
2238
-
2239
-
2240
- If there is only one entity identifier for the customer and the value is the same as &#x60;vat_number&#x60;, then there is no need to provide the &#x60;entity_identifiers[]&#x60; array. See [description for &#x60;entity_identifiers[]&#x60;](customers#customer_entity_identifiers).
2241
-
2242
- */
2243
-
2244
861
  value?:string;
2245
862
 
2246
- /**
2247
- * @description The Peppol BIS scheme associated with the [vat_number](customers#customer_vat_number) of the customer. This helps identify the specific type of customer entity. For example, &#x60;DE:VAT&#x60; is used for a German business entity while &#x60;DE:LWID45&#x60; is used for a German government entity. The value must be from the list of possible values and must correspond to the country provided under &#x60;billing_address.country&#x60;. See [list of possible values](https://www.chargebee.com/docs/e-invoicing.html#supported-countries).
2248
- **Tip:**
2249
-
2250
-
2251
- If there is only one entity identifier for the customer and the value is the same as &#x60;vat_number&#x60;, then there is no need to provide the &#x60;entity_identifiers[]&#x60; array. See [description for &#x60;entity_identifiers[]&#x60;](customers#customer_entity_identifiers).
2252
-
2253
- */
2254
-
2255
863
  scheme:string;
2256
864
 
2257
- /**
2258
- * @description The standard used for specifying the &#x60;entity_identifier&#x60; &#x60;scheme&#x60;. Currently, only &#x60;iso6523-actorid-upis&#x60; is supported and is used by default when not provided.
2259
- **Tip:**
2260
-
2261
-
2262
- If there is only one entity identifier for the customer and the value is the same as &#x60;vat_number&#x60;, then there is no need to provide the &#x60;entity_identifiers[]&#x60; array. See [description for &#x60;entity_identifiers[]&#x60;](customers#customer_entity_identifiers).
2263
-
2264
- */
2265
-
2266
865
  standard?:string;
2267
866
  }
2268
867
  export interface TaxProvidersField {
@@ -2273,97 +872,32 @@ If there is only one entity identifier for the customer and the value is the sam
2273
872
  field_value:string;
2274
873
  }
2275
874
  export interface Relationship {
2276
- /**
2277
- * @description The &#x60;id&#x60; of the immediate parent of this customer under account hierarchy. If the customer is the root of the hierarchy, this attribute isn&#x27;t returned.
2278
-
2279
- */
2280
-
2281
875
  parent_id?:string;
2282
876
 
2283
- /**
2284
- * @description The &#x60;id&#x60; of the customer responsible for paying the invoices for this customer. This ID must match either this customer&#x27;s ID or the &#x60;invoice_owner_id&#x60;.
2285
-
2286
- */
2287
-
2288
877
  payment_owner_id:string;
2289
878
 
2290
- /**
2291
- * @description The &#x60;id&#x60; of the customer who receives the invoice for charges incurred by the customer. This ID must match either this customer or one of its ancestors.
2292
-
2293
- */
2294
-
2295
879
  invoice_owner_id:string;
2296
880
  }
2297
881
  export interface ParentAccountAccess {
2298
- /**
2299
- * @description Determines the parent&#x27;s access to the child&#x27;s subscriptions in the Self-Serve Portal. \* no - The parent can&#x27;t view or edit the child&#x27;s subscriptions. \* view_only - The parent can only view the child&#x27;s subscriptions. \* yes - The parent can view and edit the child&#x27;s subscriptions.
2300
-
2301
- */
2302
-
2303
- portal_edit_child_subscriptions?:'no' | 'yes' | 'view_only';
2304
-
2305
- /**
2306
- * @description Determines the parent&#x27;s access to the child&#x27;s invoices in the Self-Serve Portal. \* no - The parent can&#x27;t view or download the child&#x27;s invoices. \* yes - The parent can both view and download the child&#x27;s invoices. \* view_only - The parent can view but not download the child&#x27;s invoices.
2307
-
2308
- */
882
+ portal_edit_child_subscriptions?:'yes' | 'view_only' | 'no';
2309
883
 
2310
- portal_download_child_invoices?:'no' | 'yes' | 'view_only';
2311
-
2312
- /**
2313
- * @description Determines whether the parent receives email notifications for the child&#x27;s subscriptions.
2314
-
2315
- */
884
+ portal_download_child_invoices?:'yes' | 'view_only' | 'no';
2316
885
 
2317
886
  send_subscription_emails:boolean;
2318
887
 
2319
- /**
2320
- * @description Determines whether the parent receives email notifications for the child&#x27;s invoices.
2321
-
2322
- */
2323
-
2324
888
  send_invoice_emails:boolean;
2325
889
 
2326
- /**
2327
- * @description Determines whether, the parent receives email notifications for payment-related activities on the child&#x27;s invoices.
2328
-
2329
- */
2330
-
2331
890
  send_payment_emails:boolean;
2332
891
  }
2333
892
  export interface ChildAccountAccess {
2334
- /**
2335
- * @description Determines the child&#x27;s access to its own subscriptions in the Self-Serve Portal. \* yes - The child account can view and edit its subscriptions. \* view_only - The child account can only view its subscriptions.
2336
-
2337
- */
2338
-
2339
893
  portal_edit_subscriptions?:'yes' | 'view_only';
2340
894
 
2341
- /**
2342
- * @description Determines the child&#x27;s access to its own invoices in the Self-Serve Portal. \* view_only - The child account can view but not download its invoices. \* yes - The child account can both view and download its invoices. \* no - The child account cannot view or download its own invoices.
2343
-
2344
- */
2345
-
2346
- portal_download_invoices?:'no' | 'yes' | 'view_only';
2347
-
2348
- /**
2349
- * @description Determines whether the child account receives email notifications for its subscriptions.
2350
-
2351
- */
895
+ portal_download_invoices?:'yes' | 'view_only' | 'no';
2352
896
 
2353
897
  send_subscription_emails:boolean;
2354
898
 
2355
- /**
2356
- * @description Determines whether the child account receives email notifications for its invoices.
2357
-
2358
- */
2359
-
2360
899
  send_invoice_emails:boolean;
2361
900
 
2362
- /**
2363
- * @description Determines whether the child account receives email notifications for payment-related activities for its invoices.
2364
-
2365
- */
2366
-
2367
901
  send_payment_emails:boolean;
2368
902
  }
2369
903
  }