@gofynd/fdk-client-javascript 1.4.8-beta.2 → 1.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/README.md +26 -1
  2. package/package.json +2 -2
  3. package/sdk/application/ApplicationClient.d.ts +8 -0
  4. package/sdk/application/ApplicationClient.js +14 -0
  5. package/sdk/application/Cart/CartApplicationClient.d.ts +20 -20
  6. package/sdk/application/Cart/CartApplicationClient.js +20 -20
  7. package/sdk/application/Cart/CartApplicationModel.d.ts +2446 -664
  8. package/sdk/application/Cart/CartApplicationModel.js +783 -552
  9. package/sdk/application/Cart/CartApplicationValidator.d.ts +268 -194
  10. package/sdk/application/Cart/CartApplicationValidator.js +100 -114
  11. package/sdk/application/Catalog/CatalogApplicationClient.d.ts +53 -53
  12. package/sdk/application/Catalog/CatalogApplicationClient.js +53 -53
  13. package/sdk/application/Catalog/CatalogApplicationModel.d.ts +2012 -503
  14. package/sdk/application/Catalog/CatalogApplicationModel.js +603 -453
  15. package/sdk/application/Catalog/CatalogApplicationValidator.d.ts +64 -64
  16. package/sdk/application/Catalog/CatalogApplicationValidator.js +32 -32
  17. package/sdk/application/Common/CommonApplicationClient.d.ts +2 -2
  18. package/sdk/application/Common/CommonApplicationClient.js +2 -2
  19. package/sdk/application/Common/CommonApplicationModel.d.ts +170 -90
  20. package/sdk/application/Common/CommonApplicationModel.js +59 -58
  21. package/sdk/application/Common/CommonApplicationValidator.d.ts +8 -5
  22. package/sdk/application/Common/CommonApplicationValidator.js +3 -3
  23. package/sdk/application/Communication/CommunicationApplicationClient.d.ts +2 -2
  24. package/sdk/application/Communication/CommunicationApplicationClient.js +2 -2
  25. package/sdk/application/Communication/CommunicationApplicationModel.d.ts +170 -35
  26. package/sdk/application/Communication/CommunicationApplicationModel.js +54 -33
  27. package/sdk/application/Configuration/ConfigurationApplicationClient.d.ts +15 -15
  28. package/sdk/application/Configuration/ConfigurationApplicationClient.js +15 -15
  29. package/sdk/application/Configuration/ConfigurationApplicationModel.d.ts +624 -443
  30. package/sdk/application/Configuration/ConfigurationApplicationModel.js +259 -248
  31. package/sdk/application/Configuration/ConfigurationApplicationValidator.d.ts +32 -24
  32. package/sdk/application/Configuration/ConfigurationApplicationValidator.js +14 -13
  33. package/sdk/application/Content/ContentApplicationClient.d.ts +16 -16
  34. package/sdk/application/Content/ContentApplicationClient.js +16 -16
  35. package/sdk/application/Content/ContentApplicationModel.d.ts +1206 -281
  36. package/sdk/application/Content/ContentApplicationModel.js +342 -276
  37. package/sdk/application/Content/ContentApplicationValidator.d.ts +28 -17
  38. package/sdk/application/Content/ContentApplicationValidator.js +11 -10
  39. package/sdk/application/FileStorage/FileStorageApplicationClient.d.ts +3 -3
  40. package/sdk/application/FileStorage/FileStorageApplicationClient.js +3 -3
  41. package/sdk/application/FileStorage/FileStorageApplicationModel.d.ts +146 -37
  42. package/sdk/application/FileStorage/FileStorageApplicationModel.js +38 -36
  43. package/sdk/application/Lead/LeadApplicationClient.d.ts +3 -3
  44. package/sdk/application/Lead/LeadApplicationClient.js +3 -3
  45. package/sdk/application/Lead/LeadApplicationModel.d.ts +195 -134
  46. package/sdk/application/Lead/LeadApplicationModel.js +110 -67
  47. package/sdk/application/Lead/LeadApplicationValidator.d.ts +8 -8
  48. package/sdk/application/Lead/LeadApplicationValidator.js +4 -4
  49. package/sdk/application/Logistic/LogisticApplicationClient.d.ts +10 -10
  50. package/sdk/application/Logistic/LogisticApplicationClient.js +10 -10
  51. package/sdk/application/Logistic/LogisticApplicationModel.d.ts +1039 -221
  52. package/sdk/application/Logistic/LogisticApplicationModel.js +342 -199
  53. package/sdk/application/Logistic/LogisticApplicationValidator.d.ts +76 -82
  54. package/sdk/application/Logistic/LogisticApplicationValidator.js +38 -41
  55. package/sdk/application/Order/OrderApplicationClient.d.ts +10 -10
  56. package/sdk/application/Order/OrderApplicationClient.js +10 -10
  57. package/sdk/application/Order/OrderApplicationModel.d.ts +1401 -324
  58. package/sdk/application/Order/OrderApplicationModel.js +392 -316
  59. package/sdk/application/Order/OrderApplicationValidator.d.ts +32 -30
  60. package/sdk/application/Order/OrderApplicationValidator.js +15 -14
  61. package/sdk/application/Payment/PaymentApplicationClient.d.ts +43 -43
  62. package/sdk/application/Payment/PaymentApplicationClient.js +43 -43
  63. package/sdk/application/Payment/PaymentApplicationModel.d.ts +1111 -1022
  64. package/sdk/application/Payment/PaymentApplicationModel.js +537 -521
  65. package/sdk/application/Payment/PaymentApplicationValidator.d.ts +82 -49
  66. package/sdk/application/Payment/PaymentApplicationValidator.js +30 -30
  67. package/sdk/application/Rewards/RewardsApplicationModel.d.ts +28 -7
  68. package/sdk/application/Rewards/RewardsApplicationModel.js +7 -7
  69. package/sdk/application/Share/ShareApplicationModel.d.ts +178 -38
  70. package/sdk/application/Share/ShareApplicationModel.js +53 -37
  71. package/sdk/application/Share/ShareApplicationValidator.d.ts +4 -2
  72. package/sdk/application/Share/ShareApplicationValidator.js +2 -1
  73. package/sdk/application/Theme/ThemeApplicationClient.d.ts +4 -4
  74. package/sdk/application/Theme/ThemeApplicationClient.js +14 -8
  75. package/sdk/application/Theme/ThemeApplicationModel.d.ts +528 -287
  76. package/sdk/application/Theme/ThemeApplicationModel.js +208 -172
  77. package/sdk/application/Theme/ThemeApplicationValidator.d.ts +17 -12
  78. package/sdk/application/Theme/ThemeApplicationValidator.js +8 -6
  79. package/sdk/application/User/UserApplicationClient.d.ts +36 -36
  80. package/sdk/application/User/UserApplicationClient.js +36 -36
  81. package/sdk/application/User/UserApplicationModel.d.ts +1062 -255
  82. package/sdk/application/User/UserApplicationModel.js +298 -244
  83. package/sdk/application/User/UserApplicationValidator.d.ts +80 -80
  84. package/sdk/application/User/UserApplicationValidator.js +40 -40
  85. package/sdk/application/Webhook/WebhookApplicationClient.d.ts +1 -1
  86. package/sdk/application/Webhook/WebhookApplicationClient.js +1 -1
  87. package/sdk/application/Webhook/WebhookApplicationModel.d.ts +20 -5
  88. package/sdk/application/Webhook/WebhookApplicationModel.js +5 -5
  89. package/sdk/common/Clickstream.js +95 -15
  90. package/sdk/common/Constant.d.ts +9 -0
  91. package/sdk/common/Constant.js +11 -0
  92. package/sdk/common/Utility.js +19 -0
  93. package/sdk/common/utils.js +8 -1
  94. package/sdk/partner/Lead/LeadPartnerModel.d.ts +28 -7
  95. package/sdk/partner/Lead/LeadPartnerModel.js +7 -7
  96. package/sdk/partner/Logistics/LogisticsPartnerModel.d.ts +75 -8
  97. package/sdk/partner/Logistics/LogisticsPartnerModel.js +59 -7
  98. package/sdk/partner/Logistics/LogisticsPartnerValidator.js +2 -2
  99. package/sdk/partner/PartnerClient.d.ts +8 -0
  100. package/sdk/partner/PartnerClient.js +14 -0
  101. package/sdk/partner/Theme/ThemePartnerClient.d.ts +20 -0
  102. package/sdk/partner/Theme/ThemePartnerClient.js +158 -0
  103. package/sdk/partner/Theme/ThemePartnerModel.d.ts +45 -6
  104. package/sdk/partner/Theme/ThemePartnerModel.js +33 -4
  105. package/sdk/partner/Theme/ThemePartnerValidator.d.ts +2 -0
  106. package/sdk/partner/Theme/ThemePartnerValidator.js +14 -0
  107. package/sdk/partner/Webhook/WebhookPartnerModel.d.ts +28 -7
  108. package/sdk/partner/Webhook/WebhookPartnerModel.js +7 -7
  109. package/sdk/platform/Analytics/AnalyticsPlatformModel.d.ts +28 -7
  110. package/sdk/platform/Analytics/AnalyticsPlatformModel.js +7 -7
  111. package/sdk/platform/Billing/BillingPlatformClient.d.ts +21 -10
  112. package/sdk/platform/Billing/BillingPlatformClient.js +167 -83
  113. package/sdk/platform/Billing/BillingPlatformModel.d.ts +2849 -565
  114. package/sdk/platform/Billing/BillingPlatformModel.js +935 -556
  115. package/sdk/platform/Billing/BillingPlatformValidator.d.ts +30 -14
  116. package/sdk/platform/Billing/BillingPlatformValidator.js +31 -16
  117. package/sdk/platform/Cart/CartPlatformModel.d.ts +28 -7
  118. package/sdk/platform/Cart/CartPlatformModel.js +8 -8
  119. package/sdk/platform/Catalog/CatalogPlatformApplicationClient.d.ts +1 -1
  120. package/sdk/platform/Catalog/CatalogPlatformApplicationClient.js +20 -0
  121. package/sdk/platform/Catalog/CatalogPlatformApplicationValidator.d.ts +37 -0
  122. package/sdk/platform/Catalog/CatalogPlatformApplicationValidator.js +16 -0
  123. package/sdk/platform/Catalog/CatalogPlatformClient.d.ts +12 -2
  124. package/sdk/platform/Catalog/CatalogPlatformClient.js +41 -1
  125. package/sdk/platform/Catalog/CatalogPlatformModel.d.ts +46 -12
  126. package/sdk/platform/Catalog/CatalogPlatformModel.js +14 -11
  127. package/sdk/platform/Catalog/CatalogPlatformValidator.d.ts +40 -0
  128. package/sdk/platform/Catalog/CatalogPlatformValidator.js +17 -0
  129. package/sdk/platform/Communication/CommunicationPlatformModel.d.ts +28 -7
  130. package/sdk/platform/Communication/CommunicationPlatformModel.js +7 -7
  131. package/sdk/platform/CompanyProfile/CompanyProfilePlatformModel.d.ts +28 -7
  132. package/sdk/platform/CompanyProfile/CompanyProfilePlatformModel.js +7 -7
  133. package/sdk/platform/Configuration/ConfigurationPlatformClient.d.ts +0 -97
  134. package/sdk/platform/Configuration/ConfigurationPlatformClient.js +77 -782
  135. package/sdk/platform/Configuration/ConfigurationPlatformModel.d.ts +24 -701
  136. package/sdk/platform/Configuration/ConfigurationPlatformModel.js +7 -539
  137. package/sdk/platform/Configuration/ConfigurationPlatformValidator.d.ts +1 -183
  138. package/sdk/platform/Configuration/ConfigurationPlatformValidator.js +0 -134
  139. package/sdk/platform/Content/ContentPlatformApplicationClient.d.ts +0 -10
  140. package/sdk/platform/Content/ContentPlatformApplicationClient.js +0 -79
  141. package/sdk/platform/Content/ContentPlatformApplicationValidator.d.ts +1 -15
  142. package/sdk/platform/Content/ContentPlatformApplicationValidator.js +0 -13
  143. package/sdk/platform/Content/ContentPlatformModel.d.ts +60 -17
  144. package/sdk/platform/Content/ContentPlatformModel.js +30 -15
  145. package/sdk/platform/Discount/DiscountPlatformModel.d.ts +28 -7
  146. package/sdk/platform/Discount/DiscountPlatformModel.js +7 -7
  147. package/sdk/platform/FileStorage/FileStoragePlatformModel.d.ts +127 -25
  148. package/sdk/platform/FileStorage/FileStoragePlatformModel.js +37 -25
  149. package/sdk/platform/Finance/FinancePlatformClient.d.ts +30 -30
  150. package/sdk/platform/Finance/FinancePlatformClient.js +30 -30
  151. package/sdk/platform/Finance/FinancePlatformModel.d.ts +1601 -348
  152. package/sdk/platform/Finance/FinancePlatformModel.js +488 -352
  153. package/sdk/platform/Lead/LeadPlatformModel.d.ts +28 -7
  154. package/sdk/platform/Lead/LeadPlatformModel.js +7 -7
  155. package/sdk/platform/Order/OrderPlatformClient.d.ts +22 -0
  156. package/sdk/platform/Order/OrderPlatformClient.js +165 -0
  157. package/sdk/platform/Order/OrderPlatformModel.d.ts +631 -39
  158. package/sdk/platform/Order/OrderPlatformModel.js +367 -41
  159. package/sdk/platform/Order/OrderPlatformValidator.d.ts +32 -1
  160. package/sdk/platform/Order/OrderPlatformValidator.js +28 -0
  161. package/sdk/platform/Payment/PaymentPlatformModel.d.ts +30 -9
  162. package/sdk/platform/Payment/PaymentPlatformModel.js +9 -9
  163. package/sdk/platform/PlatformClient.d.ts +8 -0
  164. package/sdk/platform/PlatformClient.js +14 -0
  165. package/sdk/platform/Rewards/RewardsPlatformModel.d.ts +28 -7
  166. package/sdk/platform/Rewards/RewardsPlatformModel.js +7 -7
  167. package/sdk/platform/Serviceability/ServiceabilityPlatformApplicationClient.d.ts +12 -9
  168. package/sdk/platform/Serviceability/ServiceabilityPlatformApplicationClient.js +12 -9
  169. package/sdk/platform/Serviceability/ServiceabilityPlatformClient.d.ts +1 -1
  170. package/sdk/platform/Serviceability/ServiceabilityPlatformClient.js +4 -4
  171. package/sdk/platform/Serviceability/ServiceabilityPlatformModel.d.ts +139 -22
  172. package/sdk/platform/Serviceability/ServiceabilityPlatformModel.js +98 -21
  173. package/sdk/platform/Serviceability/ServiceabilityPlatformValidator.d.ts +4 -4
  174. package/sdk/platform/Serviceability/ServiceabilityPlatformValidator.js +4 -4
  175. package/sdk/platform/Share/SharePlatformModel.d.ts +28 -7
  176. package/sdk/platform/Share/SharePlatformModel.js +7 -7
  177. package/sdk/platform/Theme/ThemePlatformModel.d.ts +18 -5
  178. package/sdk/platform/Theme/ThemePlatformModel.js +7 -4
  179. package/sdk/platform/User/UserPlatformModel.d.ts +18 -20
  180. package/sdk/platform/User/UserPlatformModel.js +9 -11
  181. package/sdk/platform/Webhook/WebhookPlatformModel.d.ts +54 -33
  182. package/sdk/platform/Webhook/WebhookPlatformModel.js +33 -33
  183. package/sdk/public/Billing/BillingPublicClient.d.ts +11 -0
  184. package/sdk/public/Billing/BillingPublicClient.js +80 -0
  185. package/sdk/public/Billing/BillingPublicModel.d.ts +584 -99
  186. package/sdk/public/Billing/BillingPublicModel.js +252 -87
  187. package/sdk/public/Billing/BillingPublicValidator.d.ts +10 -1
  188. package/sdk/public/Billing/BillingPublicValidator.js +12 -0
  189. package/sdk/public/PublicClient.d.ts +0 -2
  190. package/sdk/public/PublicClient.js +0 -4
  191. package/sdk/public/index.d.ts +0 -1
  192. package/sdk/public/index.js +0 -2
  193. package/sdk/public/Inventory/InventoryPublicClient.d.ts +0 -87
  194. package/sdk/public/Inventory/InventoryPublicClient.js +0 -529
  195. package/sdk/public/Inventory/InventoryPublicModel.d.ts +0 -393
  196. package/sdk/public/Inventory/InventoryPublicModel.js +0 -448
  197. package/sdk/public/Inventory/InventoryPublicValidator.d.ts +0 -91
  198. package/sdk/public/Inventory/InventoryPublicValidator.js +0 -85
@@ -1,23 +1,23 @@
1
1
  export = BillingPlatformModel;
2
2
  /**
3
3
  * @typedef CompanyInfo
4
- * @property {string} [company_name]
5
- * @property {string} [gstin]
6
- * @property {string} [address]
4
+ * @property {string} [company_name] - Name of the company
5
+ * @property {string} [gstin] - Goods and Services Tax Identification Number
6
+ * @property {string} [address] - Main address of the company
7
7
  * @property {AddressDetails} [address_details]
8
- * @property {string} [pan]
9
- * @property {string} [phone]
10
- * @property {string} [email]
11
- * @property {string} [cin]
8
+ * @property {string} [pan] - Permanent Account Number of the company
9
+ * @property {string} [phone] - Contact phone number for the company
10
+ * @property {string} [email] - Contact email address for the company
11
+ * @property {string} [cin] - Corporate Identification Number
12
12
  */
13
13
  /**
14
14
  * @typedef AddressDetails
15
- * @property {string} [address_line_1]
16
- * @property {string} [address_line_2]
17
- * @property {string} [city]
18
- * @property {string} [pincode]
19
- * @property {string} [state]
20
- * @property {string} [country]
15
+ * @property {string} [address_line_1] - First line of the address
16
+ * @property {string} [address_line_2] - Second line of the address (optional)
17
+ * @property {string} [city] - Company city
18
+ * @property {string} [pincode] - Company pincode
19
+ * @property {string} [state] - Company state
20
+ * @property {string} [country] - Company country
21
21
  */
22
22
  /**
23
23
  * @typedef InvoiceData
@@ -27,76 +27,84 @@ export = BillingPlatformModel;
27
27
  */
28
28
  /**
29
29
  * @typedef InvoiceDetailsData
30
- * @property {number} [attemp]
31
- * @property {Object} [documents]
32
- * @property {Object} [payment]
30
+ * @property {number} [attemp] - Number of attempts made to collect the invoice payment
31
+ * @property {Object} [documents] - Documents associated with the invoice
32
+ * @property {Object} [payment] - Payment details related to the invoice
33
33
  * @property {Period} [period]
34
34
  * @property {Client} [client]
35
- * @property {Object} [discount]
36
- * @property {Object} [taxation]
37
- * @property {string} [_id]
38
- * @property {boolean} [auto_advance]
39
- * @property {string} [collection_method]
40
- * @property {string} [subscriber_id]
41
- * @property {string} [currency]
42
- * @property {string} [invoice_url]
43
- * @property {string} [number]
44
- * @property {boolean} [paid]
45
- * @property {Object} [pg_data]
46
- * @property {string} [receipt_number]
47
- * @property {string} [statement_descriptor]
48
- * @property {string} [current_status]
49
- * @property {StatusTrail[]} [status_trail]
50
- * @property {number} [subtotal]
51
- * @property {number} [total]
52
- * @property {number} [old_settlement]
53
- * @property {number} [credit_balance]
54
- * @property {string} [subscription]
55
- * @property {number} [attempt]
56
- * @property {string} [next_action_time]
57
- * @property {number} [credit_note_amount]
58
- * @property {string} [created_at]
59
- * @property {string} [modified_at]
35
+ * @property {Object} [discount] - Discount applied to the invoice
36
+ * @property {Object} [taxation] - Taxation applied to the invoice
37
+ * @property {string} [_id] - Unique identifier for the invoice
38
+ * @property {boolean} [auto_advance] - Indicates if the invoice will
39
+ * automatically advance to the next stage of collection
40
+ * @property {string} [collection_method] - Method of collection (e.g.,
41
+ * charge_automatically, send_invoice)
42
+ * @property {string} [subscriber_id] - Identifier for the subscriber associated
43
+ * with the invoice
44
+ * @property {string} [currency] - Currency in which the invoice is issued
45
+ * @property {string} [invoice_url] - URL to view the invoice pdf
46
+ * @property {string} [number] - Invoice number
47
+ * @property {boolean} [paid] - Indicates if the invoice has been paid
48
+ * @property {Object} [pg_data] - Payment gateway data related to the invoice
49
+ * @property {string} [receipt_number] - Receipt number for the invoice payment
50
+ * @property {string} [statement_descriptor] - Statement descriptor for the invoice
51
+ * @property {string} [current_status] - Current status of the invoice (e.g., paid, open)
52
+ * @property {StatusTrail[]} [status_trail] - Trail of status changes for the invoice
53
+ * @property {number} [subtotal] - Subtotal amount of the invoice
54
+ * @property {number} [total] - Total amount of the invoice
55
+ * @property {number} [old_settlement] - Previous settlement amount (if any)
56
+ * @property {number} [credit_balance] - Credit balance applied to the invoice
57
+ * @property {string} [subscription] - Subscription associated with the invoice
58
+ * @property {number} [attempt] - Number of attempts made to pay the invoice
59
+ * @property {string} [next_action_time] - Timestamp for the next action on the invoice
60
+ * @property {number} [credit_note_amount] - Amount of credit notes applied to the invoice
61
+ * @property {string} [created_at] - Timestamp when the invoice was created
62
+ * @property {string} [modified_at] - Timestamp when the invoice was last modified
63
+ * @property {string} [invoice_type] - Type of invoice (e.g., subscription, extension)
60
64
  */
61
65
  /**
62
66
  * @typedef Client
63
- * @property {string} [name]
64
- * @property {string} [email]
65
- * @property {string} [phone]
66
- * @property {string[]} [address_lines]
67
+ * @property {string} [name] - Name of the client
68
+ * @property {string} [email] - Email address of the client
69
+ * @property {string} [phone] - Phone number of the client
70
+ * @property {string[]} [address_lines] - List of address lines for the client's address
67
71
  */
68
72
  /**
69
73
  * @typedef Period
70
- * @property {string} [start]
71
- * @property {string} [end]
74
+ * @property {string} [start] - Start date of the period
75
+ * @property {string} [end] - End date of the period
72
76
  */
73
77
  /**
74
78
  * @typedef StatusTrail
75
- * @property {string} [value]
76
- * @property {string} [timestamp]
77
- * @property {string} [_id]
79
+ * @property {string} [value] - The status value of the invoice at a particular
80
+ * timestamp (e.g., open, paid, payment_due)
81
+ * @property {string} [timestamp] - The date and time when the status was
82
+ * recorded, in ISO 8601 format
83
+ * @property {string} [_id] - Unique identifier for the status trail entry
78
84
  */
79
85
  /**
80
86
  * @typedef PaymentCollectRes
81
- * @property {string} [transaction_id]
82
- * @property {string} [current_status]
87
+ * @property {string} [transaction_id] - Unique identifier for the transaction
88
+ * @property {string} [current_status] - Current status of the payment
89
+ * collection (e.g., pending, completed, failed)
83
90
  */
84
91
  /**
85
92
  * @typedef SubscriptionChargeRes
86
- * @property {string} [_id]
87
- * @property {string} [product_suit_id]
88
- * @property {string} [entity_id]
89
- * @property {string} [entity_type]
90
- * @property {string} [name]
91
- * @property {string} [status]
92
- * @property {number} [trial_days]
93
- * @property {string} [activated_on]
94
- * @property {string} [cancelled_on]
95
- * @property {boolean} [is_test]
96
- * @property {string} [created_at]
97
- * @property {string} [modified_at]
98
- * @property {string} [company_id]
99
- * @property {Object[]} [line_items]
93
+ * @property {string} [_id] - Unique identifier for the subscription charge
94
+ * @property {string} [product_suit_id] - ID of the product suit associated with
95
+ * the charge
96
+ * @property {string} [entity_id] - Unique identifier for the entity
97
+ * @property {string} [entity_type] - Type of entity (e.g., subscription, extension)
98
+ * @property {string} [name] - Name of the subscription charge
99
+ * @property {string} [status] - Current status of the subscription charge
100
+ * @property {number} [trial_days] - Number of trial days provided
101
+ * @property {string} [activated_on] - Date when the charge was activated
102
+ * @property {string} [cancelled_on] - Date when the charge was cancelled
103
+ * @property {boolean} [is_test] - Indicates if the charge is for testing purposes
104
+ * @property {string} [created_at] - Timestamp when the charge was created
105
+ * @property {string} [modified_at] - Timestamp when the charge was last modified
106
+ * @property {string} [company_id] - Company id
107
+ * @property {Object[]} [line_items] - List of line items associated with the charge
100
108
  */
101
109
  /**
102
110
  * @typedef PostDowngradeRes
@@ -105,32 +113,43 @@ export = BillingPlatformModel;
105
113
  */
106
114
  /**
107
115
  * @typedef DowngradeRes
108
- * @property {string} [_id]
109
- * @property {string} [status]
110
- * @property {string} [subscriber_id]
111
- * @property {boolean} [activated]
112
- * @property {string} [created_at]
113
- * @property {string} [modified_at]
114
- * @property {string} [plan_id]
115
- * @property {string} [reason]
116
- * @property {string} [request_user_id]
117
- * @property {string} [subscription_id]
116
+ * @property {string} [_id] - Unique identifier for the downgrade request
117
+ * @property {string} [status] - Current status of the downgrade request (e.g.,
118
+ * pending, completed)
119
+ * @property {string} [subscriber_id] - Unique identifier for the subscriber
120
+ * making the downgrade request
121
+ * @property {boolean} [activated] - Indicates if the downgrade has been activated
122
+ * @property {string} [created_at] - Timestamp when the downgrade request was created
123
+ * @property {string} [modified_at] - Timestamp when the downgrade request was
124
+ * last modified
125
+ * @property {string} [plan_id] - ID of the plan to which the subscriber is downgrading
126
+ * @property {string} [reason] - Reason provided for the downgrade request
127
+ * @property {string} [request_user_id] - ID of the user who initiated the
128
+ * downgrade request
129
+ * @property {string} [subscription_id] - ID of the subscription associated with
130
+ * the downgrade request
118
131
  */
119
132
  /**
120
133
  * @typedef PaymentStatusData
121
- * @property {string} [_id]
122
- * @property {string} [journey]
123
- * @property {Object[]} [webhook_response]
124
- * @property {string} [aggregator_status]
125
- * @property {string} [current_status]
126
- * @property {string} [created_at]
127
- * @property {string} [modified_at]
128
- * @property {number} [__v]
129
- * @property {string} [aggregator_order_id]
134
+ * @property {string} [_id] - Unique identifier for the payment status data
135
+ * @property {string} [journey] - Payment journey status, such as 'forward' or 'backward'
136
+ * @property {Object[]} [webhook_response] - List of responses received from
137
+ * webhooks related to the payment
138
+ * @property {string} [aggregator_status] - Status of the payment as provided by
139
+ * the aggregator (e.g., succeeded, failed)
140
+ * @property {string} [current_status] - Current status of the payment (e.g.,
141
+ * paid, pending)
142
+ * @property {string} [created_at] - Timestamp when the payment status data was created
143
+ * @property {string} [modified_at] - Timestamp when the payment status data was
144
+ * last modified
145
+ * @property {number} [__v] - Version key for the payment status data (typically
146
+ * used for versioning in databases)
147
+ * @property {string} [aggregator_order_id] - Unique identifier for the order
148
+ * provided by the payment aggregator
130
149
  */
131
150
  /**
132
151
  * @typedef PaymentStatusResponse
133
- * @property {string} [status]
152
+ * @property {string} [status] - The status of the payment.
134
153
  * @property {PaymentStatusData} [data]
135
154
  */
136
155
  /**
@@ -145,84 +164,104 @@ export = BillingPlatformModel;
145
164
  */
146
165
  /**
147
166
  * @typedef InternalServerError
148
- * @property {string} [message] - Internal server Server error
167
+ * @property {string} [message] - Internal server error
149
168
  * @property {string} [code] - Error code
150
169
  */
151
170
  /**
152
171
  * @typedef CheckValidityResponse
153
- * @property {boolean} [is_valid]
154
- * @property {number} [discount_amount]
172
+ * @property {boolean} [is_valid] - Indicates whether the request is valid.
173
+ * @property {number} [discount_amount] - The amount of discount applicable.
155
174
  */
156
175
  /**
157
176
  * @typedef PlanRecurring
158
- * @property {string} [interval]
177
+ * @property {string} [interval] - The interval at which the plan recurs.
159
178
  * @property {number} [interval_count]
160
179
  */
161
180
  /**
162
181
  * @typedef PlanMeta
163
- * @property {string} [seller_status]
164
- * @property {string} [company]
165
- * @property {string} [plan_platform_display_name]
182
+ * @property {string} [seller_status] - Status of the seller associated with the plan.
183
+ * @property {string} [company] - Name of the company offering the plan.
184
+ * @property {string} [plan_platform_display_name] - Display name for platform slug.
185
+ * @property {string[]} [tags] - Tags associated with the plan for
186
+ * categorization or identification.
187
+ */
188
+ /**
189
+ * @typedef CountryRes
190
+ * @property {string} [name] - Name of the country.
191
+ * @property {string} [code] - Country code.
166
192
  */
167
193
  /**
168
194
  * @typedef Plan
169
- * @property {Object[]} [fee_components]
195
+ * @property {Object[]} [fee_components] - List of fee components associated
196
+ * with the plan. Each component may be represented as a string or an object.
170
197
  * @property {PlanRecurring} [recurring]
171
- * @property {boolean} [is_trial_plan]
172
- * @property {string} [plan_group]
173
- * @property {string[]} [tag_lines]
174
- * @property {string} [currency]
175
- * @property {boolean} [is_active]
176
- * @property {boolean} [is_visible]
177
- * @property {number} [trial_period]
178
- * @property {string[]} [addons]
179
- * @property {string[]} [tags]
180
- * @property {string} [type]
181
- * @property {string} [country]
182
- * @property {string} [_id]
183
- * @property {string} [name]
184
- * @property {string} [description]
185
- * @property {number} [amount]
186
- * @property {string} [product_suite_id]
187
- * @property {string} [created_at]
188
- * @property {string} [modified_at]
198
+ * @property {boolean} [is_trial_plan] - Indicates whether the plan is a trial plan.
199
+ * @property {string} [plan_group] - Group or category of the plan.
200
+ * @property {string[]} [tag_lines] - List of tag lines or descriptions
201
+ * associated with the plan.
202
+ * @property {string} [currency] - Currency code used for the plan's pricing.
203
+ * @property {string} [approved_by] - Identifier of the user or system that
204
+ * approved the plan.
205
+ * @property {boolean} [is_active] - Indicates if the plan is currently active.
206
+ * @property {boolean} [is_visible] - Indicates if the plan is visible to users.
207
+ * @property {number} [trial_period] - Number of days for the trial period, if applicable.
208
+ * @property {string[]} [addons] - List of add-ons available for the plan.
209
+ * @property {string[]} [tags] - List of tags associated with the plan.
210
+ * @property {string} [type] - Type of the plan (e.g., public, private).
211
+ * @property {CountryRes} [country]
212
+ * @property {string} [_id] - Unique identifier for the plan.
213
+ * @property {string} [name] - Name of the plan.
214
+ * @property {string} [description] - Description of the plan.
215
+ * @property {number} [amount] - Amount to be charged for the plan.
216
+ * @property {string} [product_suite_id] - Identifier of the product suite to
217
+ * which the plan belongs.
218
+ * @property {string} [created_at] - Timestamp when the plan was created.
219
+ * @property {string} [modified_at] - Timestamp when the plan was last modified.
189
220
  * @property {Taxation} [taxation]
190
221
  * @property {OneTimeFees} [one_time_fees]
191
222
  * @property {CreditLine} [credit_line]
192
- * @property {string} [current_status]
193
- * @property {string} [channel_type]
194
- * @property {Object[]} [company_ids]
195
- * @property {string} [platform]
196
- * @property {string} [activated_on]
223
+ * @property {string} [current_status] - Current status of the plan (e.g.,
224
+ * active, inactive).
225
+ * @property {string} [channel_type] - Type of channel where the plan is offered
226
+ * (e.g., ecomm, retail).
227
+ * @property {string[]} [company_ids] - List of company IDs associated with the
228
+ * plan. Can be null.
229
+ * @property {string} [platform] - Platform where the plan is available (e.g.,
230
+ * web, mobile). Can be null.
231
+ * @property {string} [activated_on] - Timestamp when the plan was activated.
197
232
  * @property {PlanMeta} [meta]
198
- * @property {string} [created_by]
233
+ * @property {string} [created_by] - Identifier of the user who created the plan.
199
234
  */
200
235
  /**
201
236
  * @typedef SubscriptionTrialPeriod
202
- * @property {string} [start_date]
203
- * @property {string} [end_date]
237
+ * @property {string} [start_date] - The start date and time of the trial period.
238
+ * @property {string} [end_date] - The end date and time of the trial period.
204
239
  */
205
240
  /**
206
241
  * @typedef EntityChargePrice
207
- * @property {number} [amount] - Amount for price. Minimum value 1
208
- * @property {string} [currency_code]
242
+ * @property {number} [amount] - The amount for the price. The minimum value is 1.
243
+ * @property {string} [currency_code] - The currency code for the price
209
244
  */
210
245
  /**
211
246
  * @typedef OneTimeChargeItem
212
- * @property {string} [name]
213
- * @property {string} [term]
214
- * @property {string} [pricing_type]
247
+ * @property {string} [name] - The name of the one-time charge item.
248
+ * @property {string} [term] - The term or description of the charge.
249
+ * @property {string} [pricing_type] - The type of pricing for the charge item.
215
250
  * @property {EntityChargePrice} [price]
216
- * @property {number} [capped_amount]
217
- * @property {boolean} [is_test]
218
- * @property {Object} [metadata]
251
+ * @property {number} [capped_amount] - The maximum amount that can be charged
252
+ * for this item, if applicable.
253
+ * @property {boolean} [is_test] - Indicates whether the charge item is for
254
+ * testing purposes.
255
+ * @property {Object} [metadata] - Additional metadata associated with the charge item.
219
256
  */
220
257
  /**
221
258
  * @typedef CreateOneTimeCharge
222
- * @property {string} [name]
259
+ * @property {string} [name] - The name of the one-time charge to be created.
223
260
  * @property {OneTimeChargeItem} [charge]
224
- * @property {boolean} [is_test]
225
- * @property {string} [return_url]
261
+ * @property {boolean} [is_test] - Indicates whether the charge creation is for
262
+ * testing purposes.
263
+ * @property {string} [return_url] - URL to which the user will be redirected
264
+ * after creating the charge.
226
265
  */
227
266
  /**
228
267
  * @typedef ChargeRecurring
@@ -231,56 +270,72 @@ export = BillingPlatformModel;
231
270
  */
232
271
  /**
233
272
  * @typedef ChargeDetails
234
- * @property {string} [_id]
235
- * @property {string} [entity_type]
236
- * @property {string} [entity_id]
237
- * @property {string} [name]
238
- * @property {string} [term]
239
- * @property {string} [charge_type]
240
- * @property {string} [pricing_type]
273
+ * @property {string} [_id] - Unique identifier for the charge.
274
+ * @property {string} [entity_type] - The type of entity associated with the
275
+ * charge (e.g., 'extension', 'subscription').
276
+ * @property {string} [entity_id] - Unique identifier for the entity associated
277
+ * with the charge.
278
+ * @property {string} [name] - The name of the charge.
279
+ * @property {string} [term] - Description of the charge term.
280
+ * @property {string} [charge_type] - The type of charge (e.g., 'standalone',
281
+ * 'recurring').
282
+ * @property {string} [pricing_type] - The pricing model for the charge (e.g.,
283
+ * 'one_time', 'recurring').
241
284
  * @property {EntityChargePrice} [price]
242
285
  * @property {ChargeRecurring} [recurring]
243
- * @property {string} [status]
244
- * @property {number} [capped_amount]
245
- * @property {string} [activated_on]
246
- * @property {string} [cancelled_on]
247
- * @property {string} [billing_date]
286
+ * @property {string} [status] - Current status of the charge.
287
+ * @property {number} [capped_amount] - Maximum amount that can be charged, if applicable.
288
+ * @property {string} [activated_on] - Date and time when the charge was activated.
289
+ * @property {string} [cancelled_on] - Date and time when the charge was cancelled.
290
+ * @property {string} [billing_date] - Date and time when the charge was billed.
248
291
  * @property {SubscriptionTrialPeriod} [current_period]
249
- * @property {string} [modified_at]
250
- * @property {string} [created_at]
251
- * @property {boolean} [is_test]
252
- * @property {string} [company_id]
253
- * @property {Object} [meta]
254
- * @property {number} [__v]
292
+ * @property {string} [modified_at] - Date and time when the charge details were
293
+ * last modified.
294
+ * @property {string} [created_at] - Date and time when the charge was created.
295
+ * @property {boolean} [is_test] - Indicates whether the charge is for testing purposes.
296
+ * @property {string} [company_id] - Company id.
297
+ * @property {Object} [meta] - Additional metadata associated with the charge.
298
+ * @property {number} [__v] - Internal version key for the charge record.
255
299
  */
256
300
  /**
257
301
  * @typedef OneTimeChargeEntity
258
- * @property {string} [term]
259
- * @property {string} [charge_type]
260
- * @property {number} [capped_amount]
261
- * @property {string} [billing_date]
262
- * @property {string} [created_at]
263
- * @property {string} [modified_at]
264
- * @property {number} [__v]
265
- * @property {string} [_id]
266
- * @property {string} [name]
267
- * @property {string} [status]
268
- * @property {string} [activated_on]
269
- * @property {string} [cancelled_on]
270
- * @property {Object} [metadata]
271
- * @property {string} [return_url]
272
- * @property {boolean} [is_test]
273
- * @property {string} [pricing_type]
274
- * @property {string} [subscriber_id]
275
- * @property {string} [entity_type]
276
- * @property {string} [entity_id]
277
- * @property {Object} [meta]
302
+ * @property {string} [term] - Description of the charge term or usage.
303
+ * @property {string} [charge_type] - Type of the charge (e.g., 'subscription',
304
+ * 'extension').
305
+ * @property {number} [capped_amount] - Maximum amount that can be charged. If
306
+ * no cap, the value should be 0.
307
+ * @property {string} [billing_date] - Date when the charge was billed. Null if
308
+ * not yet billed.
309
+ * @property {string} [created_at] - Date and time when the charge entity was created.
310
+ * @property {string} [modified_at] - Date and time when the charge entity was
311
+ * last modified.
312
+ * @property {number} [__v] - Internal version key for the charge record.
313
+ * @property {string} [_id] - Unique identifier for the charge entity.
314
+ * @property {string} [name] - The name of the one-time charge.
315
+ * @property {string} [status] - Current status of the charge (e.g., 'pending',
316
+ * 'completed').
317
+ * @property {string} [activated_on] - Date and time when the charge was
318
+ * activated. Null if not yet activated.
319
+ * @property {string} [cancelled_on] - Date and time when the charge was
320
+ * cancelled. Null if not cancelled.
321
+ * @property {Object} [metadata] - Additional metadata associated with the charge.
322
+ * @property {string} [return_url] - URL to redirect to after processing the charge.
323
+ * @property {boolean} [is_test] - Indicates whether the charge is for testing purposes.
324
+ * @property {string} [pricing_type] - Pricing model for the charge (e.g., 'one_time').
325
+ * @property {string} [subscriber_id] - Unique identifier for the subscriber
326
+ * associated with the charge.
327
+ * @property {string} [entity_type] - Type of the entity related to the charge
328
+ * (e.g., 'subscription', 'user').
329
+ * @property {string} [entity_id] - Unique identifier for the entity associated
330
+ * with the charge.
331
+ * @property {Object} [meta] - Additional metadata associated with the charge.
278
332
  * @property {EntityChargePrice} [price]
279
333
  */
280
334
  /**
281
335
  * @typedef CreateOneTimeChargeResponse
282
336
  * @property {Charge} [charge]
283
- * @property {string} [confirm_url]
337
+ * @property {string} [confirm_url] - URL to which users are redirected to
338
+ * confirm or complete the payment or subscription process.
284
339
  */
285
340
  /**
286
341
  * @typedef Charge
@@ -288,245 +343,291 @@ export = BillingPlatformModel;
288
343
  */
289
344
  /**
290
345
  * @typedef InvoiceDetailsStatusTrail
291
- * @property {string} [_id]
292
- * @property {string} [value]
293
- * @property {string} [timestamp]
346
+ * @property {string} [_id] - Unique identifier for the status trail entry.
347
+ * @property {string} [value] - The status value of the invoice at a particular
348
+ * point in time.
349
+ * @property {string} [timestamp] - The date and time when this status was recorded.
294
350
  */
295
351
  /**
296
352
  * @typedef InvoiceItemsPlanRecurring
297
- * @property {string} [interval]
298
- * @property {number} [interval_count]
353
+ * @property {string} [interval] - The interval at which the plan recurs (e.g.,
354
+ * month, year).
355
+ * @property {number} [interval_count] - The number of intervals for the recurring plan.
299
356
  */
300
357
  /**
301
358
  * @typedef InvoiceItemsPlan
302
359
  * @property {InvoiceItemsPlanRecurring} [recurring]
303
- * @property {boolean} [is_trial_plan]
304
- * @property {string} [plan_group]
305
- * @property {string[]} [tag_lines]
306
- * @property {string} [currency]
307
- * @property {boolean} [is_active]
308
- * @property {boolean} [is_visible]
309
- * @property {number} [trial_period]
310
- * @property {string[]} [addons]
311
- * @property {string[]} [tags]
312
- * @property {string} [type]
313
- * @property {string} [country]
314
- * @property {string} [_id]
315
- * @property {string} [name]
316
- * @property {string} [description]
317
- * @property {number} [amount]
318
- * @property {string} [product_suite_id]
319
- * @property {string} [created_at]
320
- * @property {string} [modified_at]
360
+ * @property {boolean} [is_trial_plan] - Indicates whether the plan is a trial plan.
361
+ * @property {string} [plan_group] - Group or category to which the plan belongs.
362
+ * @property {string[]} [tag_lines] - List of tag lines or short descriptions
363
+ * for the plan.
364
+ * @property {string} [currency] - Currency code for the pricing of the plan.
365
+ * @property {boolean} [is_active] - Indicates whether the plan is currently active.
366
+ * @property {boolean} [is_visible] - Indicates whether the plan is visible to users.
367
+ * @property {number} [trial_period] - The number of days for the trial period.
368
+ * @property {string[]} [addons] - List of add-ons available with the plan.
369
+ * @property {string[]} [tags] - Tags associated with the plan for categorization.
370
+ * @property {string} [type] - Type of the plan (e.g., public, private).
371
+ * @property {string} [country] - Country for which plan is created
372
+ * @property {string} [_id] - Unique identifier for the plan.
373
+ * @property {string} [name] - Name of the plan.
374
+ * @property {string} [description] - Detailed description of the plan.
375
+ * @property {number} [amount] - Price of the plan in the specified currency.
376
+ * @property {string} [product_suite_id] - Identifier for the product suite to
377
+ * which the plan belongs.
378
+ * @property {string} [created_at] - Timestamp when the plan was created.
379
+ * @property {string} [modified_at] - Timestamp when the plan was last modified.
321
380
  */
322
381
  /**
323
382
  * @typedef InvoiceItemsPeriod
324
- * @property {string} [start]
325
- * @property {string} [end]
383
+ * @property {string} [start] - Start date of the invoice period.
384
+ * @property {string} [end] - End date of the invoice period.
326
385
  */
327
386
  /**
328
387
  * @typedef InvoiceItems
329
- * @property {string} [_id]
330
- * @property {string} [currency]
388
+ * @property {string} [_id] - Unique identifier for the invoice item.
389
+ * @property {string} [currency] - Currency for the amount.
331
390
  * @property {InvoiceItemsPlan} [plan]
332
- * @property {string} [name]
333
- * @property {number} [quantity]
334
- * @property {string} [description]
391
+ * @property {string} [name] - Name of the invoice item.
392
+ * @property {number} [quantity] - Number of units of the invoice item.
393
+ * @property {string} [description] - Description of the invoice item.
335
394
  * @property {InvoiceItemsPeriod} [period]
336
- * @property {number} [unit_amount]
337
- * @property {number} [amount]
338
- * @property {string} [type]
339
- * @property {string} [invoice_id]
340
- * @property {string} [created_at]
341
- * @property {string} [modified_at]
395
+ * @property {number} [unit_amount] - Amount per unit of the invoice item.
396
+ * @property {number} [amount] - Total amount for the invoice item.
397
+ * @property {string} [type] - Type of the invoice item (e.g., subscription, extension).
398
+ * @property {string} [invoice_id] - Identifier for the invoice to which the item belongs.
399
+ * @property {string} [created_at] - Timestamp when the invoice item was created.
400
+ * @property {string} [modified_at] - Timestamp when the invoice item was last modified.
342
401
  */
343
402
  /**
344
403
  * @typedef InvoicesDataClient
345
- * @property {string} [name]
346
- * @property {string} [email]
347
- * @property {string} [phone]
348
- * @property {string[]} [address_lines]
404
+ * @property {string} [name] - Name of the client.
405
+ * @property {string} [email] - Email address of the client.
406
+ * @property {string} [phone] - Phone number of the client.
407
+ * @property {string[]} [address_lines] - Array of address lines for the client’s address.
349
408
  */
350
409
  /**
351
410
  * @typedef InvoicesDataPeriod
352
- * @property {string} [start]
353
- * @property {string} [end]
411
+ * @property {string} [start] - The start date and time of the invoice period.
412
+ * @property {string} [end] - The end date and time of the invoice period.
354
413
  */
355
414
  /**
356
415
  * @typedef InvoicesDataPaymentMethod
357
- * @property {string} [pg_payment_method_id]
416
+ * @property {string} [pg_payment_method_id] - Payment gateway-specific payment
417
+ * method identifier. Nullable if not applicable.
358
418
  */
359
419
  /**
360
420
  * @typedef InvoicesData
361
- * @property {string} [_id]
362
- * @property {Object} [documents]
363
- * @property {Object} [payment]
364
- * @property {number} [old_settlement]
365
- * @property {number} [credit_balance]
366
- * @property {Object} [discount]
367
- * @property {Object} [taxation]
368
- * @property {number} [credit_note_amount]
421
+ * @property {string} [_id] - Unique identifier for the invoice.
422
+ * @property {Object} [documents] - Associated documents related to the invoice.
423
+ * @property {Object} [payment] - Payment details for the invoice.
424
+ * @property {number} [old_settlement] - Previous settlement amount, if applicable.
425
+ * @property {number} [credit_balance] - Remaining credit balance applied to the
426
+ * invoice, if any.
427
+ * @property {Object} [discount] - Details of any discounts applied to the invoice.
428
+ * @property {Object} [taxation] - Taxation details associated with the invoice.
429
+ * @property {number} [credit_note_amount] - Amount covered by credit notes, if any.
369
430
  * @property {InvoicesDataClient} [client]
370
- * @property {boolean} [auto_advance]
371
- * @property {string} [currency]
372
- * @property {boolean} [paid]
373
- * @property {number} [attemp]
374
- * @property {string} [collection_method]
375
- * @property {string} [subscriber_id]
376
- * @property {string} [invoice_url]
377
- * @property {string} [number]
378
- * @property {Object} [pg_data]
431
+ * @property {boolean} [auto_advance] - Indicates if the invoice should be
432
+ * auto-advanced in the billing process.
433
+ * @property {string} [currency] - Currency code used for the invoice amount.
434
+ * @property {boolean} [paid] - Indicates if the invoice has been paid.
435
+ * @property {number} [attemp] - Number of payment attempts made for the invoice.
436
+ * @property {string} [collection_method] - Method used to collect payment for
437
+ * the invoice.
438
+ * @property {string} [subscriber_id] - Identifier for the subscriber associated
439
+ * with the invoice.
440
+ * @property {string} [invoice_url] - URL to view or download the invoice.
441
+ * "null" if not available.
442
+ * @property {string} [number] - Unique invoice number.
443
+ * @property {Object} [pg_data] - Payment gateway-related data for the invoice.
379
444
  * @property {InvoicesDataPeriod} [period]
380
- * @property {string} [receipt_number]
381
- * @property {string} [statement_descriptor]
382
- * @property {string} [current_status]
383
- * @property {InvoiceDetailsStatusTrail[]} [status_trail]
384
- * @property {number} [subtotal]
385
- * @property {number} [total]
386
- * @property {string} [subscription]
387
- * @property {string} [next_action_time]
388
- * @property {string} [created_at]
389
- * @property {string} [modified_at]
390
- * @property {string} [hash_identifier]
445
+ * @property {string} [receipt_number] - Receipt number for the invoice payment.
446
+ * @property {string} [statement_descriptor] - Descriptor that appears on the
447
+ * client's statement for the invoice.
448
+ * @property {string} [current_status] - Current status of the invoice (e.g.,
449
+ * paid, pending).
450
+ * @property {InvoiceDetailsStatusTrail[]} [status_trail] - History of status
451
+ * changes for the invoice.
452
+ * @property {number} [subtotal] - Subtotal amount before taxes and discounts.
453
+ * @property {number} [total] - Total amount including taxes and discounts.
454
+ * @property {string} [subscription] - Identifier for the subscription
455
+ * associated with the invoice.
456
+ * @property {string} [next_action_time] - Scheduled time for the next action
457
+ * related to the invoice.
458
+ * @property {string} [created_at] - Timestamp when the invoice was created.
459
+ * @property {string} [modified_at] - Timestamp when the invoice was last modified.
460
+ * @property {string} [hash_identifier] - Unique hash identifier for the invoice.
391
461
  * @property {InvoicesDataPaymentMethod} [payment_method]
392
- * @property {InvoiceItems[]} [invoice_items]
462
+ * @property {InvoiceItems[]} [invoice_items] - List of items included in the invoice.
463
+ * @property {string} [invoice_type] - Type of invoice (e.g., extension, subscription).
393
464
  */
394
465
  /**
395
466
  * @typedef Invoices
396
467
  * @property {InvoicesData[]} [data]
397
- * @property {number} [start]
398
- * @property {number} [end]
399
- * @property {number} [limit]
400
- * @property {number} [page]
401
- * @property {number} [total]
468
+ * @property {number} [start] - Index of the first item in the results.
469
+ * @property {number} [end] - Index of the last item in the results.
470
+ * @property {number} [limit] - Number of items per page.
471
+ * @property {number} [page] - Page number of the results.
472
+ * @property {number} [total] - Total number of items available.
402
473
  */
403
474
  /**
404
475
  * @typedef Phone
405
- * @property {string} [phone_number]
406
- * @property {string} [phone_country_code]
476
+ * @property {string} [phone_number] - The phone number of the contact.
477
+ * @property {string} [phone_country_code] - The country code of the phone number.
407
478
  */
408
479
  /**
409
480
  * @typedef SubscriptionBillingAddress
410
- * @property {string} [country]
411
- * @property {string} [state]
412
- * @property {string} [city]
413
- * @property {string} [line1]
414
- * @property {string} [line2]
415
- * @property {string} [postal_code]
481
+ * @property {string} [country] - Name of the country for the billing address.
482
+ * @property {string} [country_code] - ISO country code for the billing address.
483
+ * @property {string} [state] - State or province for the billing address.
484
+ * @property {string} [city] - City for the billing address.
485
+ * @property {string} [line1] - First line of the street address.
486
+ * @property {string} [line2] - Second line of the street address (optional).
487
+ * @property {string} [postal_code] - Postal or ZIP code for the billing address.
416
488
  */
417
489
  /**
418
490
  * @typedef SubscriptionCustomer
419
491
  * @property {Phone} [phone]
420
492
  * @property {SubscriptionBillingAddress} [billing_address]
421
- * @property {string} [_id]
422
- * @property {string} [unique_id]
423
- * @property {string} [type]
424
- * @property {string} [name]
425
- * @property {string} [email]
426
- * @property {string} [created_at]
427
- * @property {string} [modified_at]
428
- * @property {Object} [data]
429
- * @property {Object} [documents]
430
- * @property {boolean} [consent]
431
- * @property {boolean} [comms]
432
- * @property {number} [credit_balance]
493
+ * @property {string} [_id] - Unique identifier for the subscriber.
494
+ * @property {string} [unique_id] - Identifier specific to the company.
495
+ * @property {string} [type] - Type of the customer (e.g., developer, company).
496
+ * @property {string} [name] - Name of the customer.
497
+ * @property {string} [email] - Email address of the customer.
498
+ * @property {string} [created_at] - Timestamp when the customer record was created.
499
+ * @property {string} [modified_at] - Timestamp when the customer record was
500
+ * last modified.
501
+ * @property {Object} [data] - Additional data related to the customer.
502
+ * @property {Object} [documents] - Associated documents related to the customer.
503
+ * @property {boolean} [consent] - Indicates whether the customer has given consent.
504
+ * @property {boolean} [comms] - Indicates whether the customer has opted in for
505
+ * communications.
506
+ * @property {number} [credit_balance] - Current credit balance for the customer, if any.
433
507
  * @property {BusinessCountryInfo} [business_country_info]
434
508
  */
435
509
  /**
436
510
  * @typedef SubscriptionCustomerCreate
437
511
  * @property {Phone} [phone]
438
512
  * @property {SubscriptionBillingAddress} [billing_address]
439
- * @property {string} [unique_id]
440
- * @property {string} [type]
441
- * @property {string} [name]
442
- * @property {string} [email]
513
+ * @property {string} [unique_id] - Company id for the customer, generated by the client.
514
+ * @property {string} [type] - Type of company
515
+ * @property {string} [name] - Name of the company
516
+ * @property {string} [email] - Email address of the company
443
517
  */
444
518
  /**
445
519
  * @typedef SubscriptionCurrentPeriod
446
- * @property {string} [start]
447
- * @property {string} [end]
520
+ * @property {string} [start] - The start date and time of the current
521
+ * subscription period.
522
+ * @property {string} [end] - The end date and time of the current subscription period.
448
523
  */
449
524
  /**
450
525
  * @typedef SubscriptionPauseCollection
451
- * @property {string} [behavior]
452
- * @property {string} [resume_at]
526
+ * @property {string} [behavior] - Defines the behavior of the subscription when
527
+ * it is paused. Possible values could include `keep_as_draft` or `cancel`.
528
+ * @property {string} [resume_at] - The date and time when the paused
529
+ * subscription is scheduled to resume.
453
530
  */
454
531
  /**
455
532
  * @typedef SubscriptionTrial
456
- * @property {string} [start]
457
- * @property {string} [end]
533
+ * @property {string} [start] - The start date and time of the subscription trial period.
534
+ * @property {string} [end] - The end date and time of the subscription trial period.
458
535
  */
459
536
  /**
460
537
  * @typedef SubscriptionInvoiceSettings
461
- * @property {boolean} [generation]
462
- * @property {boolean} [charging]
538
+ * @property {boolean} [generation] - Indicates whether invoices are
539
+ * automatically generated for the subscription.
540
+ * @property {boolean} [charging] - Indicates whether charging is enabled for
541
+ * the subscription. This setting determines if charges are applied based on
542
+ * the invoice settings.
463
543
  */
464
544
  /**
465
545
  * @typedef Subscription
466
- * @property {Object} [meta]
546
+ * @property {Object} [meta] - Additional metadata related to the subscription.
467
547
  * @property {SubscriptionCurrentPeriod} [current_period]
468
548
  * @property {SubscriptionPauseCollection} [pause_collection]
469
549
  * @property {SubscriptionTrial} [trial]
470
550
  * @property {SubscriptionInvoiceSettings} [invoice_settings]
471
- * @property {boolean} [is_active]
472
- * @property {boolean} [cancel_at_period_end]
473
- * @property {string} [_id]
474
- * @property {string} [subscriber_id]
475
- * @property {string} [plan_id]
476
- * @property {string} [product_suite_id]
551
+ * @property {boolean} [is_active] - Indicates whether the subscription is
552
+ * currently active.
553
+ * @property {boolean} [cancel_at_period_end] - Indicates whether the
554
+ * subscription will be canceled at the end of the current period.
555
+ * @property {string} [_id] - Unique identifier for the subscription.
556
+ * @property {string} [subscriber_id] - Unique identifier for the subscriber
557
+ * associated with the subscription.
558
+ * @property {string} [plan_id] - Unique identifier for the plan associated with
559
+ * the subscription.
560
+ * @property {string} [product_suite_id] - Unique identifier for the product
561
+ * suite associated with the subscription.
562
+ * @property {boolean} [is_eligible_for_plan_change] - Indicates whether the
563
+ * subscriber is eligible to change their subscription plan.
477
564
  * @property {Plan} [plan_data]
478
- * @property {string} [current_status]
479
- * @property {string} [collection_method]
480
- * @property {string} [created_at]
481
- * @property {string} [modified_at]
482
- * @property {string} [latest_invoice]
483
- * @property {string} [channel_type]
484
- * @property {boolean} [freezed]
485
- * @property {string} [cancel_at]
486
- * @property {string} [canceled_at]
565
+ * @property {string} [current_status] - The current status of the subscription
566
+ * (e.g., active, canceled).
567
+ * @property {string} [collection_method] - Method used to collect payments for
568
+ * the subscription (e.g., charge_automatically, invoice).
569
+ * @property {string} [created_at] - The date and time when the subscription was created.
570
+ * @property {string} [modified_at] - The date and time when the subscription
571
+ * was last modified.
572
+ * @property {string} [latest_invoice] - Unique identifier for the most recent
573
+ * invoice related to the subscription.
574
+ * @property {string} [channel_type] - Ordering channel for which the
575
+ * subscription was created (e.g., ecomm, fynd).
576
+ * @property {boolean} [freezed] - Indicates whether the subscription is
577
+ * currently freezed.
578
+ * @property {string} [cancel_at] - The date and time when the subscription is
579
+ * scheduled to be canceled, if applicable.
580
+ * @property {string} [canceled_at] - The date and time when the subscription
581
+ * was actually canceled.
487
582
  */
488
583
  /**
489
584
  * @typedef SubscriptionStatus
490
- * @property {boolean} [is_enabled]
585
+ * @property {boolean} [is_enabled] - Indicates whether the subscription status
586
+ * is enabled.
491
587
  * @property {Subscription} [subscription]
492
588
  * @property {InvoicesData} [latest_invoice]
493
589
  * @property {Plan} [next_plan]
494
- * @property {Subscription[]} [current_subscriptions]
495
- * @property {number} [mandate_amount]
496
- * @property {string} [message]
590
+ * @property {Subscription[]} [current_subscriptions] - List of current
591
+ * subscriptions associated with the user.
592
+ * @property {number} [mandate_amount] - The amount mandated for the
593
+ * subscription or service.
594
+ * @property {string} [message] - A message providing additional context or
595
+ * information about the subscription status.
497
596
  */
498
597
  /**
499
598
  * @typedef SubscriptionLimitApplication
500
- * @property {boolean} [enabled]
501
- * @property {number} [hard_limit]
502
- * @property {number} [soft_limit]
599
+ * @property {boolean} [enabled] - Indicates whether the application limit is enabled.
600
+ * @property {number} [hard_limit] - The maximum number of applications allowed.
601
+ * @property {number} [soft_limit] - The soft limit of applications allowed,
602
+ * typically a warning threshold before reaching the hard limit.
503
603
  */
504
604
  /**
505
605
  * @typedef SubscriptionLimitMarketplace
506
- * @property {boolean} [enabled]
606
+ * @property {boolean} [enabled] - Indicates whether the marketplace limit is enabled.
507
607
  */
508
608
  /**
509
609
  * @typedef SubscriptionLimitOtherPlatform
510
- * @property {boolean} [enabled]
610
+ * @property {boolean} [enabled] - Indicates whether the other platform limit is enabled.
511
611
  */
512
612
  /**
513
613
  * @typedef SubscriptionLimitTeam
514
- * @property {number} [limit]
614
+ * @property {number} [limit] - The limit for team-related features.
515
615
  */
516
616
  /**
517
617
  * @typedef SubscriptionLimitProducts
518
- * @property {boolean} [bulk]
519
- * @property {number} [limit]
618
+ * @property {boolean} [bulk] - Indicates whether bulk product limits are enabled.
619
+ * @property {number} [limit] - The limit for products.
520
620
  */
521
621
  /**
522
622
  * @typedef SubscriptionLimitExtensions
523
- * @property {boolean} [enabled]
524
- * @property {number} [limit]
623
+ * @property {boolean} [enabled] - Indicates whether the extensions limit is enabled.
624
+ * @property {number} [limit] - The limit for extensions.
525
625
  */
526
626
  /**
527
627
  * @typedef SubscriptionLimitIntegrations
528
- * @property {boolean} [enabled]
529
- * @property {number} [limit]
628
+ * @property {boolean} [enabled] - Indicates whether the integrations limit is enabled.
629
+ * @property {number} [limit] - The limit for integrations. A value of `-1`
630
+ * usually indicates no limit.
530
631
  */
531
632
  /**
532
633
  * @typedef SubscriptionLimit
@@ -537,42 +638,57 @@ export = BillingPlatformModel;
537
638
  * @property {SubscriptionLimitProducts} [products]
538
639
  * @property {SubscriptionLimitExtensions} [extensions]
539
640
  * @property {SubscriptionLimitIntegrations} [integrations]
540
- * @property {boolean} [is_trial_plan]
641
+ * @property {boolean} [is_trial_plan] - Indicates whether the subscription is
642
+ * for a trial plan.
541
643
  */
542
644
  /**
543
645
  * @typedef IntentReq
544
- * @property {string} [unique_external_id]
545
- * @property {string} [plan_id]
646
+ * @property {string} [unique_external_id] - A unique identifier for the
647
+ * external resource, used to track and reference the request like company id.
648
+ * @property {string} [plan_id] - The identifier for the plan associated with the intent.
546
649
  */
547
650
  /**
548
651
  * @typedef PutIntentReq
549
- * @property {string} [unique_external_id]
550
- * @property {string} [setup_intent_id]
551
- * @property {string} [payment_method_id]
552
- * @property {boolean} [set_default]
652
+ * @property {string} [unique_external_id] - A unique identifier for the
653
+ * external resource, used to track and reference the request like company id.
654
+ * @property {string} [setup_intent_id] - The ID of the setup intent for payment
655
+ * methods, if applicable.
656
+ * @property {string} [payment_method_id] - The ID of the payment method to use
657
+ * for the intent.
658
+ * @property {boolean} [set_default] - Indicates whether the payment method
659
+ * should be set as default.
553
660
  */
554
661
  /**
555
662
  * @typedef SubscriptionActivateReq
556
- * @property {string} [unique_id]
557
- * @property {string} [type]
558
- * @property {string} [product_suite]
559
- * @property {string} [plan_id]
560
- * @property {string} [payment_method]
561
- * @property {string} [subscription_id]
562
- * @property {string} [coupon]
563
- * @property {Object} [meta]
663
+ * @property {string} [unique_id] - A unique identifier for the subscription
664
+ * activation request.
665
+ * @property {string} [type] - The type of subscriber account, e.g., company or developer.
666
+ * @property {string} [product_suite] - The product suite associated with the
667
+ * subscription.
668
+ * @property {string} [plan_id] - The ID of the plan to be activated for the subscription.
669
+ * @property {string} [payment_method] - The payment method ID to be used for
670
+ * this subscription.
671
+ * @property {string} [subscription_id] - The ID of the subscription to be
672
+ * activated, if applicable.
673
+ * @property {string} [coupon] - A coupon code for applying discounts, if applicable.
674
+ * @property {Object} [meta] - Additional metadata related to the subscription
675
+ * activation request.
564
676
  */
565
677
  /**
566
678
  * @typedef SubscriptionActivateRes
567
- * @property {boolean} [success]
679
+ * @property {boolean} [success] - Indicates whether the subscription activation
680
+ * was successful.
568
681
  * @property {Subscription} [data]
569
682
  */
570
683
  /**
571
684
  * @typedef CancelSubscriptionReq
572
- * @property {string} [unique_id]
573
- * @property {string} [type]
574
- * @property {string} [product_suite]
575
- * @property {string} [subscription_id]
685
+ * @property {string} [unique_id] - A unique identifier for the subscription
686
+ * cancellation request like company id.
687
+ * @property {string} [type] - The type of subscription to be canceled, e.g.,
688
+ * company or developer.
689
+ * @property {string} [product_suite] - The product suite associated with the
690
+ * subscription to be canceled.
691
+ * @property {string} [subscription_id] - The ID of the subscription to be canceled.
576
692
  */
577
693
  /**
578
694
  * @typedef CancelSubscriptionRes
@@ -581,154 +697,193 @@ export = BillingPlatformModel;
581
697
  */
582
698
  /**
583
699
  * @typedef PlanStatusUpdateReq
584
- * @property {string} [plan_id]
585
- * @property {string} [reason]
586
- * @property {string} [seller_status]
700
+ * @property {string} [plan_id] - The identifier of the plan whose status is
701
+ * being updated.
702
+ * @property {string} [reason] - The reason for updating the plan status.
703
+ * @property {string} [seller_status] - The new status of the plan as set by the
704
+ * seller (e.g., approved, rejected, pending).
587
705
  */
588
706
  /**
589
- * @typedef SunscribePlan
590
- * @property {string} [entity_type]
591
- * @property {string} [collection_type]
592
- * @property {string} [plan_id]
593
- * @property {string} [callback_url]
707
+ * @typedef SubscribePlan
708
+ * @property {string} [entity_type] - The type of entity for which the plan is
709
+ * being subscribed (e.g., subscription, extension).
710
+ * @property {string} [collection_type] - The method of collection for the
711
+ * subscription (e.g., online, offline).
712
+ * @property {string} [plan_id] - The identifier of the plan to subscribe to.
713
+ * @property {string} [callback_url] - URL to which the payment result will be sent
594
714
  * @property {Meta} [meta]
595
715
  */
596
716
  /**
597
717
  * @typedef Meta
598
- * @property {boolean} [subscribe]
599
- * @property {boolean} [is_custom_plan]
600
- * @property {boolean} [is_plan_upgrade]
718
+ * @property {boolean} [subscribe] - Indicates whether the subscription is being
719
+ * initiated.
720
+ * @property {boolean} [is_custom_plan] - Indicates if the plan is a custom plan
721
+ * rather than a standard one.
722
+ * @property {boolean} [is_plan_upgrade] - Indicates whether this subscription
723
+ * is an upgrade from a previous plan.
601
724
  */
602
725
  /**
603
726
  * @typedef SubscribePlanRes
604
- * @property {string} [redirect_url]
605
- * @property {string} [transaction_id]
606
- * @property {string} [current_status]
727
+ * @property {string} [redirect_url] - The URL to which the user should be
728
+ * redirected after completion of subscription process.
729
+ * @property {string} [transaction_id] - The unique identifier for the
730
+ * subscription transaction.
731
+ * @property {string} [current_status] - The current status of the subscription
732
+ * process (e.g., initiated, success, failed).
607
733
  * @property {Meta} [meta]
608
734
  */
609
735
  /**
610
736
  * @typedef EntityDetail
611
- * @property {string} [entity]
737
+ * @property {string} [entity] - Specifies the type of entity (e.g., subscription, user).
612
738
  * @property {Subscription} [item]
613
739
  */
614
740
  /**
615
741
  * @typedef PaymentOptions
616
- * @property {string} [_id]
617
- * @property {string} [name]
618
- * @property {string} [description]
619
- * @property {string} [logo]
620
- * @property {string} [aggregator_id]
621
- * @property {string} [aggregator]
622
- * @property {string} [created_at]
623
- * @property {string} [modified_at]
624
- * @property {number} [__v]
742
+ * @property {string} [_id] - Unique identifier for the payment option.
743
+ * @property {string} [name] - Name of the payment option.
744
+ * @property {string} [description] - Brief description of the payment option's
745
+ * functionality.
746
+ * @property {string} [logo] - URL of the payment option's logo like upi logo.
747
+ * @property {string} [aggregator_id] - Unique identifier for the payment aggregator.
748
+ * @property {string} [aggregator] - Identifier for the payment aggregator system.
749
+ * @property {string} [created_at] - Date and time when the payment option was created.
750
+ * @property {string} [modified_at] - Date and time when the payment option was
751
+ * last modified.
752
+ * @property {number} [__v] - Version key for document revision control.
625
753
  */
626
754
  /**
627
755
  * @typedef VerifyPaymentReq
628
- * @property {string} [razorpay_payment_id]
629
- * @property {string} [razorpay_order_id]
630
- * @property {string} [razorpay_signature]
631
- * @property {number} [status_code]
632
- * @property {string} [provider_type]
756
+ * @property {string} [razorpay_payment_id] - Unique identifier for the Razorpay payment.
757
+ * @property {string} [razorpay_order_id] - Unique identifier for the Razorpay order.
758
+ * @property {string} [razorpay_signature] - Signature generated by Razorpay to
759
+ * verify the payment.
760
+ * @property {number} [status_code] - HTTP status code of the payment
761
+ * verification response.
762
+ * @property {string} [provider_type] - The payment provider used for the transaction.
633
763
  */
634
764
  /**
635
765
  * @typedef Documents
636
- * @property {string} [pan]
637
- * @property {string} [gst]
766
+ * @property {string} [pan] - Permanent Account Number (PAN) used for tax purposes.
767
+ * @property {string} [gst] - Goods and Services Tax (GST) number for business taxation.
638
768
  */
639
769
  /**
640
770
  * @typedef BillingAddress
641
- * @property {string} [country]
642
- * @property {string} [state]
643
- * @property {string} [city]
644
- * @property {string} [line1]
645
- * @property {string} [line2]
646
- * @property {string} [postal_code]
647
- * @property {string} [country_code]
771
+ * @property {string} [country] - The country where the billing address is located.
772
+ * @property {string} [state] - The state or region within the country.
773
+ * @property {string} [city] - The city of the billing address.
774
+ * @property {string} [line1] - The first line of the billing address.
775
+ * @property {string} [line2] - The second line of the billing address (if applicable).
776
+ * @property {string} [postal_code] - The ZIP code of the billing address.
777
+ * @property {string} [country_code] - ISO country code for the country of the
778
+ * billing address.
648
779
  */
649
780
  /**
650
781
  * @typedef Currency
651
- * @property {string} [code]
652
- * @property {string} [symbol]
653
- * @property {string} [name]
782
+ * @property {string} [code] - Currency code as per ISO 4217.
783
+ * @property {string} [symbol] - Symbol representing the currency.
784
+ * @property {string} [name] - Full name of the currency.
654
785
  */
655
786
  /**
656
787
  * @typedef BusinessCountryInfo
657
- * @property {string} [country]
658
- * @property {string} [country_code]
788
+ * @property {string} [country] - The country where the business is registered.
789
+ * @property {string} [country_code] - ISO country code for the business's country.
659
790
  * @property {Currency} [currency]
660
- * @property {string} [timezone]
791
+ * @property {string} [timezone] - Timezone in which the business operates.
661
792
  */
662
793
  /**
663
794
  * @typedef SubscriberData
664
- * @property {boolean} [pg_user_exists]
665
- * @property {Object} [id]
666
- * @property {string} [pg_customer_id]
667
- * @property {string} [default_payment_method]
795
+ * @property {boolean} [pg_user_exists] - Indicates if the user exists in the
796
+ * payment gateway system.
797
+ * @property {string} [id] - Unique identifier for the subscriber.
798
+ * @property {string} [pg_customer_id] - Unique customer ID assigned by the
799
+ * payment gateway.
800
+ * @property {string} [default_payment_method] - Identifier for the default
801
+ * payment method used by the subscriber.
668
802
  */
669
803
  /**
670
804
  * @typedef Subscriber
671
805
  * @property {Documents} [documents]
672
- * @property {Object} [phone]
806
+ * @property {Object} [phone] - Contact information for the subscriber, such as
807
+ * phone number.
673
808
  * @property {BillingAddress} [billing_address]
674
- * @property {boolean} [consent]
675
- * @property {boolean} [comms]
676
- * @property {string} [_id]
677
- * @property {string} [type]
678
- * @property {string} [unique_id]
679
- * @property {string} [name]
680
- * @property {string} [email]
809
+ * @property {boolean} [consent] - Indicates whether the subscriber has given
810
+ * consent for processing.
811
+ * @property {boolean} [comms] - Indicates whether the subscriber has opted in
812
+ * for communications.
813
+ * @property {string} [_id] - Unique identifier for the subscriber in the system.
814
+ * @property {string} [type] - The type of the subscriber, such as 'individual'
815
+ * or 'company'.
816
+ * @property {string} [unique_id] - A unique identifier assigned to the subscriber.
817
+ * @property {string} [name] - The name of the subscriber.
818
+ * @property {string} [email] - Email address of the subscriber.
681
819
  * @property {BusinessCountryInfo} [business_country_info]
682
- * @property {string} [created_at]
683
- * @property {string} [modified_at]
684
- * @property {number} [credit_balance]
820
+ * @property {string} [created_at] - The date and time when the subscriber was created.
821
+ * @property {string} [modified_at] - The date and time when the subscriber
822
+ * details were last modified.
823
+ * @property {number} [credit_balance] - The current credit balance for the
824
+ * subscriber, if any.
685
825
  * @property {SubscriberData} [data]
686
826
  */
827
+ /**
828
+ * @typedef AuthorModifiedDetails
829
+ * @property {string} [first_name] - The first name of the author who made modifications.
830
+ * @property {string} [last_name] - The last name of the author who made modifications.
831
+ * @property {boolean} [is_admin] - Indicates whether the author has
832
+ * administrative privileges.
833
+ */
687
834
  /**
688
835
  * @typedef Author
689
- * @property {Object} [modified_by_details]
836
+ * @property {AuthorModifiedDetails} [modified_by_details]
837
+ * @property {string} [created_by] - Identifier of the user who created the record.
838
+ * @property {string} [modified_by] - Identifier of the user who last modified the record.
690
839
  */
691
840
  /**
692
841
  * @typedef EndingBalance
693
- * @property {number} [amount]
694
- * @property {string} [old_entry_ref]
842
+ * @property {number} [amount] - The ending balance amount.
843
+ * @property {string} [old_entry_ref] - Reference to the previous entry if applicable.
695
844
  */
696
845
  /**
697
846
  * @typedef PaymentData
698
- * @property {string} [transaction_id]
699
- * @property {string} [aggregator]
700
- * @property {string} [aggregator_order_id]
847
+ * @property {string} [transaction_id] - The unique identifier for the transaction.
848
+ * @property {string} [aggregator] - The payment aggregator used for the transaction.
849
+ * @property {string} [aggregator_order_id] - The order ID generated by the
850
+ * payment aggregator.
851
+ * @property {string} [receipt_date] - The date and time when the receipt was generated.
852
+ * @property {string} [unique_transaction_reference] - A unique reference for
853
+ * the transaction.
701
854
  */
702
855
  /**
703
856
  * @typedef CreditTransaction
704
- * @property {Object} [entity]
857
+ * @property {Object} [entity] - The entity associated with the transaction.
705
858
  * @property {Author} [author]
706
- * @property {string} [_id]
707
- * @property {number} [amount]
708
- * @property {string} [currency]
709
- * @property {string} [subscriber_id]
710
- * @property {string} [description]
711
- * @property {Object} [is_test]
859
+ * @property {string} [_id] - The unique identifier for the credit transaction.
860
+ * @property {number} [amount] - The amount credited in the transaction.
861
+ * @property {string} [currency] - The currency of the transaction amount.
862
+ * @property {string} [subscriber_id] - The unique identifier of the subscriber
863
+ * involved in the transaction.
864
+ * @property {string} [description] - A brief description of the transaction.
865
+ * @property {string} [is_test] - Indicates if the transaction is a test transaction.
712
866
  * @property {EndingBalance} [ending_balance]
713
867
  * @property {PaymentData} [payment]
714
- * @property {string} [type]
715
- * @property {string} [created_at]
716
- * @property {string} [modified_at]
868
+ * @property {string} [type] - The type of credit transaction.
869
+ * @property {string} [created_at] - The date and time when the transaction was created.
870
+ * @property {string} [modified_at] - The date and time when the transaction was
871
+ * last modified.
717
872
  */
718
873
  /**
719
874
  * @typedef VerifyPaymentData
720
- * @property {boolean} [success]
875
+ * @property {boolean} [success] - Indicates if the payment verification was successful.
721
876
  * @property {Subscriber} [subscriber]
722
877
  * @property {CreditTransaction} [credit_transaction]
723
878
  */
724
879
  /**
725
880
  * @typedef VerifyPaymentRes
726
- * @property {string} [status]
881
+ * @property {string} [status] - The status of the payment verification.
727
882
  * @property {VerifyPaymentData} [data]
728
883
  */
729
884
  /**
730
885
  * @typedef DefaultMerchants
731
- * @property {string} [stripe]
886
+ * @property {string} [stripe] - The default Stripe merchant identifier.
732
887
  */
733
888
  /**
734
889
  * @typedef GlobalSettingsPayment
@@ -737,232 +892,247 @@ export = BillingPlatformModel;
737
892
  /**
738
893
  * @typedef GlobalSettingsData
739
894
  * @property {GlobalSettingsPayment} [payment]
740
- * @property {boolean} [freeze_panel]
741
- * @property {string} [_id]
742
- * @property {string} [created_at]
743
- * @property {string} [modified_at]
895
+ * @property {boolean} [freeze_panel] - Indicates if the panel is frozen.
896
+ * @property {string} [_id] - Unique identifier for the global settings.
897
+ * @property {string} [created_at] - The date and time when the global settings
898
+ * were created.
899
+ * @property {string} [modified_at] - The date and time when the global settings
900
+ * were last modified.
744
901
  */
745
902
  /**
746
903
  * @typedef GlobalSettings
747
- * @property {string} [status]
904
+ * @property {string} [status] - The status of the global settings retrieval.
748
905
  * @property {GlobalSettingsData} [data]
749
906
  */
750
907
  /**
751
908
  * @typedef MethodChecks
752
- * @property {string} [address_line1_check]
753
- * @property {string} [address_postal_code_check]
754
- * @property {string} [cvc_check]
909
+ * @property {string} [address_line1_check] - Result of the address line 1 check.
910
+ * @property {string} [address_postal_code_check] - Result of the address postal
911
+ * code check.
912
+ * @property {string} [cvc_check] - Result of the CVC check.
755
913
  */
756
914
  /**
757
915
  * @typedef MethodNetworks
758
- * @property {string[]} [available]
759
- * @property {string} [preferred]
916
+ * @property {string[]} [available] - List of available networks for the payment method.
917
+ * @property {string} [preferred] - Preferred network for the payment method.
760
918
  */
761
919
  /**
762
920
  * @typedef MethodSecureUsage
763
- * @property {boolean} [supported]
921
+ * @property {boolean} [supported] - Indicates if 3D Secure is supported for the
922
+ * payment method.
764
923
  */
765
924
  /**
766
925
  * @typedef MethodDetails
767
- * @property {string} [id]
768
- * @property {string} [type]
769
- * @property {boolean} [mandate_available]
770
- * @property {number} [mandate_amount]
771
- * @property {string} [pg_payment_method_id]
772
- * @property {boolean} [is_default]
926
+ * @property {string} [id] - Unique identifier for the payment method.
927
+ * @property {string} [type] - Type of payment method.
928
+ * @property {boolean} [mandate_available] - Indicates if a mandate is available
929
+ * for the payment method.
930
+ * @property {number} [mandate_amount] - Mandate amount for the payment method.
931
+ * @property {string} [pg_payment_method_id] - Payment gateway's payment method
932
+ * identifier.
933
+ * @property {boolean} [is_default] - Indicates if the payment method is the default.
773
934
  * @property {SubscriptionMethodData} [data]
774
935
  */
775
936
  /**
776
937
  * @typedef SubscriptionMethodData
777
- * @property {string} [brand]
938
+ * @property {string} [brand] - Brand of the payment method.
778
939
  * @property {MethodChecks} [checks]
779
- * @property {string} [country]
780
- * @property {number} [exp_month]
781
- * @property {number} [exp_year]
782
- * @property {string} [fingerprint]
783
- * @property {string} [funding]
784
- * @property {string} [generated_from]
785
- * @property {string} [last4]
940
+ * @property {string} [country] - Country of the payment method.
941
+ * @property {number} [exp_month] - Expiration month of the payment method.
942
+ * @property {number} [exp_year] - Expiration year of the payment method.
943
+ * @property {string} [fingerprint] - Fingerprint of the payment method.
944
+ * @property {string} [funding] - Funding type of the payment method.
945
+ * @property {string} [generated_from] - Source from which the payment method
946
+ * was generated.
947
+ * @property {string} [last4] - Last 4 digits of the payment method.
786
948
  * @property {MethodNetworks} [networks]
787
949
  * @property {MethodSecureUsage} [three_d_secure_usage]
788
- * @property {string} [wallet]
789
- * @property {string} [name]
790
- * @property {boolean} [is_default]
950
+ * @property {string} [wallet] - Wallet associated with the payment method.
951
+ * @property {string} [name] - Name associated with the payment method.
952
+ * @property {boolean} [is_default] - Indicates if the payment method is the default.
791
953
  */
792
954
  /**
793
955
  * @typedef SubscriptionMethods
794
- * @property {boolean} [success]
795
- * @property {MethodDetails[]} [data]
956
+ * @property {boolean} [success] - Indicates if the retrieval of subscription
957
+ * methods was successful.
958
+ * @property {MethodDetails[]} [data] - List of subscription methods.
796
959
  */
797
960
  /**
798
961
  * @typedef ConfigPublicKey
799
- * @property {string} [public_key]
962
+ * @property {string} [public_key] - Public key for the payment aggregator.
800
963
  */
801
964
  /**
802
965
  * @typedef ConfigRes
803
- * @property {boolean} [success]
804
- * @property {string} [aggregator]
966
+ * @property {boolean} [success] - Indicates if the retrieval of configuration
967
+ * was successful.
968
+ * @property {string} [aggregator] - The payment aggregator.
805
969
  * @property {ConfigPublicKey} [config]
806
970
  */
807
971
  /**
808
972
  * @typedef PlanChangeData
809
- * @property {number} [total]
810
- * @property {number} [credit_note_amount]
811
- * @property {number} [settlement]
812
- * @property {number} [taxable_amount]
813
- * @property {number} [gst_amount]
814
- * @property {number} [gross_total]
815
- * @property {number} [gst]
816
- * @property {number} [discount]
973
+ * @property {number} [total] - The total amount after the plan change.
974
+ * @property {number} [credit_note_amount] - The amount credited due to the plan change.
975
+ * @property {number} [settlement] - The settlement amount for the plan change.
976
+ * @property {number} [taxable_amount] - The taxable amount for the plan change.
977
+ * @property {number} [gst_amount] - The GST amount for the plan change.
978
+ * @property {number} [gross_total] - The gross total amount for the plan change.
979
+ * @property {number} [gst] - The GST for the plan change.
980
+ * @property {number} [discount] - The discount amount applied to the plan change.
817
981
  */
818
982
  /**
819
983
  * @typedef PlanChangeDetails
820
- * @property {string} [status]
984
+ * @property {string} [status] - Status of the plan change.
821
985
  * @property {PlanChangeData} [data]
822
986
  */
823
987
  /**
824
988
  * @typedef TransactionMeta
825
- * @property {string} [invoice_id]
989
+ * @property {string} [invoice_id] - Invoice ID associated with the transaction.
826
990
  */
827
991
  /**
828
992
  * @typedef PaymentTransactionDetails
829
- * @property {Object} [aggregator]
830
- * @property {string} [currency]
831
- * @property {string} [current_status]
832
- * @property {string} [_id]
833
- * @property {string} [subscriber_id]
834
- * @property {number} [amount]
835
- * @property {string} [entity_type]
836
- * @property {string} [collection_type]
993
+ * @property {Object} [aggregator] - Payment aggregator details.
994
+ * @property {string} [currency] - Currency used in the transaction.
995
+ * @property {string} [current_status] - Current status of the transaction.
996
+ * @property {string} [_id] - Unique identifier for the payment transaction.
997
+ * @property {string} [subscriber_id] - Unique identifier for the subscriber.
998
+ * @property {number} [amount] - Amount involved in the transaction.
999
+ * @property {string} [entity_type] - Type of entity involved in the transaction.
1000
+ * @property {string} [collection_type] - Type of collection for the transaction.
837
1001
  * @property {TransactionMeta} [meta]
838
- * @property {string} [created_at]
839
- * @property {string} [modified_at]
1002
+ * @property {string} [created_at] - Timestamp when the transaction was created.
1003
+ * @property {string} [modified_at] - Timestamp when the transaction was last modified.
840
1004
  */
841
1005
  /**
842
1006
  * @typedef PaymentItems
843
- * @property {string} [name]
844
- * @property {string} [code]
845
- * @property {string} [aggregator]
1007
+ * @property {string} [name] - Name of the payment option.
1008
+ * @property {string} [code] - Code for the payment option
1009
+ * @property {string} [aggregator] - Aggregator used for the payment option.
846
1010
  */
847
1011
  /**
848
1012
  * @typedef GetPaymentOptions
849
- * @property {PaymentItems[]} [payment_options]
1013
+ * @property {PaymentItems[]} [payment_options] - List of available payment options.
850
1014
  */
851
1015
  /**
852
1016
  * @typedef TopupReq
853
- * @property {number} [amount]
854
- * @property {string} [currency]
855
- * @property {string} [provider_type]
1017
+ * @property {number} [amount] - Amount to be topped up.
1018
+ * @property {string} [currency] - Currency in which the top-up is made.
1019
+ * @property {string} [provider_type] - Provider type for the top-up.
856
1020
  */
857
1021
  /**
858
1022
  * @typedef SetupMandateReq
859
- * @property {string} [intent_id]
860
- * @property {string} [payment_method_id]
1023
+ * @property {string} [intent_id] - ID of the setup intent.
1024
+ * @property {string} [payment_method_id] - ID of the payment method.
861
1025
  */
862
1026
  /**
863
1027
  * @typedef SetupPaymentReq
864
- * @property {string} [payment_method]
865
- * @property {string} [payment_id]
866
- * @property {string} [plan_id]
867
- * @property {string} [invoice_id]
1028
+ * @property {string} [payment_method] - Payment method to be used.
1029
+ * @property {string} [payment_id] - ID of the payment.
1030
+ * @property {string} [plan_id] - ID of the plan.
1031
+ * @property {string} [invoice_id] - ID of the invoice.
868
1032
  */
869
1033
  /**
870
1034
  * @typedef SubscriptionRenewReq
871
- * @property {string} [invoice_id]
872
- * @property {string} [entity_type]
873
- * @property {string} [collection_type]
874
- * @property {string} [callback_url]
1035
+ * @property {string} [invoice_id] - ID of the invoice for renewal.
1036
+ * @property {string} [entity_type] - Type of entity for the renewal.
1037
+ * @property {string} [collection_type] - Collection type for the renewal.
1038
+ * @property {string} [callback_url] - URL to which the payment result will be sent
875
1039
  * @property {RenewMeta} [meta]
876
1040
  */
877
1041
  /**
878
1042
  * @typedef RenewMeta
879
- * @property {boolean} [invoice_payment]
880
- * @property {boolean} [renew]
1043
+ * @property {boolean} [invoice_payment] - Indicates whether the invoice payment
1044
+ * is involved in the renewal.
1045
+ * @property {boolean} [renew] - Indicates whether the subscription is being renewed.
881
1046
  */
882
1047
  /**
883
1048
  * @typedef SubscriptionMethodsReq
884
- * @property {string} [unique_external_id]
885
- * @property {string} [setup_intent_id]
886
- * @property {string} [pg_payment_method_id]
887
- * @property {boolean} [set_default]
1049
+ * @property {string} [unique_external_id] - The unique external identifier for
1050
+ * the subscription method.
1051
+ * @property {string} [setup_intent_id] - The setup intent ID for the subscription method.
1052
+ * @property {string} [pg_payment_method_id] - The payment gateway payment method ID.
1053
+ * @property {boolean} [set_default] - Indicates whether this payment method
1054
+ * should be set as the default.
888
1055
  */
889
1056
  /**
890
1057
  * @typedef CreditTransactionResponse
891
- * @property {number} [total] - Total number of transactions
892
- * @property {number} [limit] - Maximum number of transactions per page
893
- * @property {number} [page] - Current page number
894
- * @property {number} [pages] - Total number of pages
895
- * @property {CreditTransaction[]} [items]
1058
+ * @property {number} [total] - Total number of transactions.
1059
+ * @property {number} [limit] - Maximum number of transactions per page.
1060
+ * @property {number} [page] - Current page number.
1061
+ * @property {number} [pages] - Total number of pages.
1062
+ * @property {CreditTransaction[]} [items] - List of credit transactions.
896
1063
  */
897
1064
  /**
898
1065
  * @typedef DowngradePlanReq
899
- * @property {string} [unique_id]
900
- * @property {string} [type]
901
- * @property {string} [product_suite]
902
- * @property {string} [plan_id]
903
- * @property {string} [reason]
904
- * @property {string} [platform]
1066
+ * @property {string} [unique_id] - Unique identifier for the request.
1067
+ * @property {string} [type] - Type of entity requesting the downgrade.
1068
+ * @property {string} [product_suite] - Product suite for the plan.
1069
+ * @property {string} [plan_id] - Plan ID for the downgrade request.
1070
+ * @property {string} [reason] - Reason for downgrading the plan.
1071
+ * @property {string} [platform] - Platform from which the request is made.
905
1072
  */
906
1073
  /**
907
1074
  * @typedef Taxation
908
- * @property {number} [gst] - GST percentage
1075
+ * @property {number} [gst] - GST percentage.
909
1076
  */
910
1077
  /**
911
1078
  * @typedef OneTimeFees
912
- * @property {number} [developement]
913
- * @property {number} [marketing]
1079
+ * @property {number} [developement] - One-time development fee.
1080
+ * @property {number} [marketing] - One-time marketing fee.
914
1081
  */
915
1082
  /**
916
1083
  * @typedef CreditLine
917
- * @property {boolean} [is_active]
1084
+ * @property {boolean} [is_active] - Indicates whether the credit line is active.
918
1085
  */
919
1086
  /**
920
1087
  * @typedef StatusMessage
921
- * @property {string} [status]
922
- * @property {string} [message]
923
- * @property {boolean} [success]
924
- * @property {string} [code]
1088
+ * @property {string} [status] - Status of the request.
1089
+ * @property {string} [message] - Detailed message regarding the status.
1090
+ * @property {boolean} [success] - Indicates whether the operation was successful.
1091
+ * @property {string} [code] - Status code of the operation.
925
1092
  */
926
1093
  /**
927
1094
  * @typedef PaymentCollectReq
928
- * @property {string} [transaction_id]
929
- * @property {boolean} [credit_balance]
930
- * @property {string} [payment_mode]
931
- * @property {string} [payment_method]
932
- * @property {string} [invoice_id]
1095
+ * @property {string} [transaction_id] - ID of the transaction to collect payment for.
1096
+ * @property {boolean} [credit_balance] - Indicates whether to use credit
1097
+ * balance for the payment.
1098
+ * @property {string} [payment_mode] - Mode of payment.
1099
+ * @property {string} [payment_method] - Payment method to be used.
1100
+ * @property {string} [invoice_id] - ID of the invoice for which the payment is collected.
933
1101
  */
934
1102
  /**
935
1103
  * @typedef SubscriptionRenewResMeta
936
- * @property {boolean} [invoice_payment]
937
- * @property {boolean} [renew]
1104
+ * @property {boolean} [invoice_payment] - Indicates whether the invoice payment
1105
+ * is involved in the renewal.
1106
+ * @property {boolean} [renew] - Indicates whether the subscription is being renewed.
938
1107
  */
939
1108
  /**
940
1109
  * @typedef SubscriptionRenewRes
941
- * @property {string} [redirect_url]
942
- * @property {string} [transaction_id]
943
- * @property {string} [current_status]
1110
+ * @property {string} [redirect_url] - URL to redirect the user for completing
1111
+ * the renewal.
1112
+ * @property {string} [transaction_id] - ID of the renewal transaction.
1113
+ * @property {string} [current_status] - Current status of the renewal process.
944
1114
  * @property {SubscriptionRenewResMeta} [meta]
945
1115
  */
946
1116
  /**
947
1117
  * @typedef SetupIntentRes
948
- * @property {boolean} [success]
1118
+ * @property {boolean} [success] - Indicates if the setup intent was successful.
949
1119
  * @property {SetupIntentData} [data]
950
1120
  */
951
1121
  /**
952
1122
  * @typedef SetupIntentData
953
- * @property {string} [id]
954
- * @property {string} [client_secret]
955
- * @property {Object} [customer]
956
- * @property {string} [status]
1123
+ * @property {string} [id] - The ID of the setup intent.
1124
+ * @property {string} [client_secret] - The client secret of the setup intent.
1125
+ * @property {string} [customer] - The customer associated with the setup intent.
1126
+ * @property {string} [status] - The status of the setup intent.
957
1127
  */
958
1128
  /**
959
1129
  * @typedef SetupPayment
960
- * @property {string} [id]
961
- * @property {string} [status]
962
- * @property {Object} [customer]
963
- * @property {string} [client_secret]
964
- * @property {string} [payment_method]
965
- * @property {string} [mandate]
1130
+ * @property {string} [id] - The ID of the setup payment.
1131
+ * @property {string} [status] - The status of the setup payment.
1132
+ * @property {string} [customer] - The customer associated with the setup payment.
1133
+ * @property {string} [client_secret] - The client secret of the setup payment.
1134
+ * @property {string} [payment_method] - The payment method used for the setup payment.
1135
+ * @property {string} [mandate] - The mandate ID associated with the setup payment.
966
1136
  * @property {PaymentMethodOptions} [payment_method_options]
967
1137
  */
968
1138
  /**
@@ -975,67 +1145,189 @@ export = BillingPlatformModel;
975
1145
  */
976
1146
  /**
977
1147
  * @typedef MandateOptions
978
- * @property {number} [amount]
1148
+ * @property {number} [amount] - The mandate amount.
979
1149
  */
980
1150
  /**
981
1151
  * @typedef Message
982
- * @property {string} [message]
1152
+ * @property {string} [message] - A message providing details about the operation status.
983
1153
  */
984
1154
  /**
985
1155
  * @typedef TopupRes
986
- * @property {string} [status]
987
- * @property {string} [aggregator_order_id]
988
- * @property {number} [amount]
989
- * @property {string} [currency]
990
- * @property {string} [transaction_id]
1156
+ * @property {string} [status] - The status of the top-up request.
1157
+ * @property {string} [aggregator_order_id] - The order ID from the aggregator.
1158
+ * @property {number} [amount] - The amount of the top-up.
1159
+ * @property {string} [currency] - The currency of the top-up.
1160
+ * @property {string} [transaction_id] - The transaction ID for the top-up.
991
1161
  */
992
1162
  /**
993
1163
  * @typedef CancelTopupReq
994
- * @property {string} [order_id]
1164
+ * @property {string} [order_id] - The order ID of the top-up to cancel.
995
1165
  */
996
1166
  /**
997
1167
  * @typedef CancelTopupRes
998
- * @property {string} [_id]
999
- * @property {string} [subscriber_id]
1000
- * @property {number} [amount]
1001
- * @property {string} [currency]
1002
- * @property {string} [aggregator]
1003
- * @property {string} [aggregator_order_id]
1004
- * @property {string} [created_at]
1005
- * @property {string} [modified_at]
1006
- * @property {number} [__v]
1007
- * @property {string} [aggregator_status]
1008
- * @property {string} [current_status]
1168
+ * @property {string} [_id] - The ID of the canceled top-up.
1169
+ * @property {string} [subscriber_id] - The subscriber ID associated with the top-up.
1170
+ * @property {number} [amount] - The amount of the canceled top-up.
1171
+ * @property {string} [currency] - The currency of the canceled top-up.
1172
+ * @property {string} [aggregator] - The aggregator used for the top-up.
1173
+ * @property {string} [aggregator_order_id] - The order ID from the aggregator.
1174
+ * @property {string} [created_at] - The date and time when the top-up was created.
1175
+ * @property {string} [modified_at] - The date and time when the top-up was modified.
1176
+ * @property {number} [__v] - The version key, used for internal purposes.
1177
+ * @property {string} [aggregator_status] - The status of the top-up with the aggregator.
1178
+ * @property {string} [current_status] - The current status of the top-up.
1009
1179
  */
1010
1180
  /**
1011
1181
  * @typedef DefaultReq
1012
- * @property {string} [payment_method_id]
1182
+ * @property {string} [payment_method_id] - The ID of the payment method to set
1183
+ * as default.
1184
+ */
1185
+ /**
1186
+ * @typedef EntityChargeRecurring
1187
+ * @property {string} interval - The interval of the subscription.
1188
+ */
1189
+ /**
1190
+ * @typedef ChargeLineItem
1191
+ * @property {string} name - Its name of the extension plan.
1192
+ * @property {string} term - It indicates how it will be charged.
1193
+ * @property {string} pricing_type - It indicates the extension subscription
1194
+ * will be auto renewed timely.
1195
+ * @property {EntityChargePrice} price
1196
+ * @property {EntityChargeRecurring} [recurring]
1197
+ * @property {number} [capped_amount]
1198
+ * @property {number} [trial_days]
1199
+ * @property {boolean} [is_test]
1200
+ * @property {Object} [metadata]
1201
+ */
1202
+ /**
1203
+ * @typedef CreateSubscriptionCharge
1204
+ * @property {string} name - The name of the charge.
1205
+ * @property {number} [trial_days]
1206
+ * @property {ChargeLineItem[]} line_items
1207
+ * @property {boolean} [is_test] - Indicates whether the charge is for testing purposes.
1208
+ * @property {string} return_url - The URL passed in request which extension
1209
+ * expects in return.
1210
+ */
1211
+ /**
1212
+ * @typedef EntityChargeDetails
1213
+ * @property {string} [_id] - Unique identifier for the charge.
1214
+ * @property {string} [subscription_id] - Unique identifier of the extension subscription.
1215
+ * @property {string} [subscriber_id] - Unique identifier of the
1216
+ * subscriber/company who installed extension subscription.
1217
+ * @property {string} [entity_type] - The type of entity associated with the
1218
+ * charge (e.g., 'extension', 'subscription').
1219
+ * @property {string} [entity_id] - Unique identifier for the entity associated
1220
+ * with the charge.
1221
+ * @property {string} [name] - The name of the charge.
1222
+ * @property {string} [term] - Description of the charge term.
1223
+ * @property {string} [charge_type] - The type of charge (e.g., 'standalone',
1224
+ * 'recurring').
1225
+ * @property {string} [pricing_type] - The pricing model for the charge (e.g.,
1226
+ * 'one_time', 'recurring').
1227
+ * @property {EntityChargePrice} [price]
1228
+ * @property {ChargeRecurring} [recurring]
1229
+ * @property {string} [status] - Current status of the charge.
1230
+ * @property {number} [capped_amount] - Maximum amount that can be charged, if applicable.
1231
+ * @property {string} [activated_on] - Date and time when the charge was activated.
1232
+ * @property {string} [cancelled_on] - Date and time when the charge was cancelled.
1233
+ * @property {string} [billing_date] - Date and time when the charge was billed.
1234
+ * @property {SubscriptionTrialPeriod} [current_period]
1235
+ * @property {string} [modified_at] - Date and time when the charge details were
1236
+ * last modified.
1237
+ * @property {string} [created_at] - Date and time when the charge was created.
1238
+ * @property {boolean} [is_test] - Indicates whether the charge is for testing purposes.
1239
+ * @property {string} [company_id] - Company id.
1240
+ * @property {Object} [meta] - Additional metadata associated with the charge.
1241
+ * @property {number} [__v] - Internal version key for the charge record.
1242
+ */
1243
+ /**
1244
+ * @typedef EntitySubscription
1245
+ * @property {string} [_id] - Unique identifier for the subscription charge
1246
+ * @property {string} [product_suit_id] - ID of the product suit associated with
1247
+ * the charge
1248
+ * @property {string} [entity_id] - Unique identifier for the entity
1249
+ * @property {string} [entity_type] - Type of entity (e.g., subscription, extension)
1250
+ * @property {string} [name] - Name of the subscription charge
1251
+ * @property {string} [status] - Current status of the subscription charge
1252
+ * @property {number} [trial_days] - Number of trial days provided
1253
+ * @property {boolean} [is_test] - Indicates if the charge is for testing purposes
1254
+ * @property {string} [created_at] - Timestamp when the charge was created
1255
+ * @property {string} [modified_at] - Timestamp when the charge was last modified
1256
+ * @property {string} [subscriber_id] - Unique Identifier of the company
1257
+ * @property {EntityChargeDetails[]} [line_items]
1258
+ * @property {string} [return_url] - The URL passed in request which extension
1259
+ * expects in return.
1260
+ */
1261
+ /**
1262
+ * @typedef CreateSubscriptionResponse
1263
+ * @property {EntitySubscription} [subscription]
1264
+ * @property {string} [confirm_url] - URL to which users are redirected to
1265
+ * confirm or complete the payment or subscription process.
1013
1266
  */
1014
1267
  declare class BillingPlatformModel {
1015
1268
  }
1016
1269
  declare namespace BillingPlatformModel {
1017
- export { CompanyInfo, AddressDetails, InvoiceData, InvoiceDetailsData, Client, Period, StatusTrail, PaymentCollectRes, SubscriptionChargeRes, PostDowngradeRes, DowngradeRes, PaymentStatusData, PaymentStatusResponse, BadRequest, ResourceNotFound, InternalServerError, CheckValidityResponse, PlanRecurring, PlanMeta, Plan, SubscriptionTrialPeriod, EntityChargePrice, OneTimeChargeItem, CreateOneTimeCharge, ChargeRecurring, ChargeDetails, OneTimeChargeEntity, CreateOneTimeChargeResponse, Charge, InvoiceDetailsStatusTrail, InvoiceItemsPlanRecurring, InvoiceItemsPlan, InvoiceItemsPeriod, InvoiceItems, InvoicesDataClient, InvoicesDataPeriod, InvoicesDataPaymentMethod, InvoicesData, Invoices, Phone, SubscriptionBillingAddress, SubscriptionCustomer, SubscriptionCustomerCreate, SubscriptionCurrentPeriod, SubscriptionPauseCollection, SubscriptionTrial, SubscriptionInvoiceSettings, Subscription, SubscriptionStatus, SubscriptionLimitApplication, SubscriptionLimitMarketplace, SubscriptionLimitOtherPlatform, SubscriptionLimitTeam, SubscriptionLimitProducts, SubscriptionLimitExtensions, SubscriptionLimitIntegrations, SubscriptionLimit, IntentReq, PutIntentReq, SubscriptionActivateReq, SubscriptionActivateRes, CancelSubscriptionReq, CancelSubscriptionRes, PlanStatusUpdateReq, SunscribePlan, Meta, SubscribePlanRes, EntityDetail, PaymentOptions, VerifyPaymentReq, Documents, BillingAddress, Currency, BusinessCountryInfo, SubscriberData, Subscriber, Author, EndingBalance, PaymentData, CreditTransaction, VerifyPaymentData, VerifyPaymentRes, DefaultMerchants, GlobalSettingsPayment, GlobalSettingsData, GlobalSettings, MethodChecks, MethodNetworks, MethodSecureUsage, MethodDetails, SubscriptionMethodData, SubscriptionMethods, ConfigPublicKey, ConfigRes, PlanChangeData, PlanChangeDetails, TransactionMeta, PaymentTransactionDetails, PaymentItems, GetPaymentOptions, TopupReq, SetupMandateReq, SetupPaymentReq, SubscriptionRenewReq, RenewMeta, SubscriptionMethodsReq, CreditTransactionResponse, DowngradePlanReq, Taxation, OneTimeFees, CreditLine, StatusMessage, PaymentCollectReq, SubscriptionRenewResMeta, SubscriptionRenewRes, SetupIntentRes, SetupIntentData, SetupPayment, PaymentMethodOptions, Card, MandateOptions, Message, TopupRes, CancelTopupReq, CancelTopupRes, DefaultReq };
1270
+ export { CompanyInfo, AddressDetails, InvoiceData, InvoiceDetailsData, Client, Period, StatusTrail, PaymentCollectRes, SubscriptionChargeRes, PostDowngradeRes, DowngradeRes, PaymentStatusData, PaymentStatusResponse, BadRequest, ResourceNotFound, InternalServerError, CheckValidityResponse, PlanRecurring, PlanMeta, CountryRes, Plan, SubscriptionTrialPeriod, EntityChargePrice, OneTimeChargeItem, CreateOneTimeCharge, ChargeRecurring, ChargeDetails, OneTimeChargeEntity, CreateOneTimeChargeResponse, Charge, InvoiceDetailsStatusTrail, InvoiceItemsPlanRecurring, InvoiceItemsPlan, InvoiceItemsPeriod, InvoiceItems, InvoicesDataClient, InvoicesDataPeriod, InvoicesDataPaymentMethod, InvoicesData, Invoices, Phone, SubscriptionBillingAddress, SubscriptionCustomer, SubscriptionCustomerCreate, SubscriptionCurrentPeriod, SubscriptionPauseCollection, SubscriptionTrial, SubscriptionInvoiceSettings, Subscription, SubscriptionStatus, SubscriptionLimitApplication, SubscriptionLimitMarketplace, SubscriptionLimitOtherPlatform, SubscriptionLimitTeam, SubscriptionLimitProducts, SubscriptionLimitExtensions, SubscriptionLimitIntegrations, SubscriptionLimit, IntentReq, PutIntentReq, SubscriptionActivateReq, SubscriptionActivateRes, CancelSubscriptionReq, CancelSubscriptionRes, PlanStatusUpdateReq, SubscribePlan, Meta, SubscribePlanRes, EntityDetail, PaymentOptions, VerifyPaymentReq, Documents, BillingAddress, Currency, BusinessCountryInfo, SubscriberData, Subscriber, AuthorModifiedDetails, Author, EndingBalance, PaymentData, CreditTransaction, VerifyPaymentData, VerifyPaymentRes, DefaultMerchants, GlobalSettingsPayment, GlobalSettingsData, GlobalSettings, MethodChecks, MethodNetworks, MethodSecureUsage, MethodDetails, SubscriptionMethodData, SubscriptionMethods, ConfigPublicKey, ConfigRes, PlanChangeData, PlanChangeDetails, TransactionMeta, PaymentTransactionDetails, PaymentItems, GetPaymentOptions, TopupReq, SetupMandateReq, SetupPaymentReq, SubscriptionRenewReq, RenewMeta, SubscriptionMethodsReq, CreditTransactionResponse, DowngradePlanReq, Taxation, OneTimeFees, CreditLine, StatusMessage, PaymentCollectReq, SubscriptionRenewResMeta, SubscriptionRenewRes, SetupIntentRes, SetupIntentData, SetupPayment, PaymentMethodOptions, Card, MandateOptions, Message, TopupRes, CancelTopupReq, CancelTopupRes, DefaultReq, EntityChargeRecurring, ChargeLineItem, CreateSubscriptionCharge, EntityChargeDetails, EntitySubscription, CreateSubscriptionResponse };
1018
1271
  }
1019
1272
  /** @returns {CompanyInfo} */
1020
1273
  declare function CompanyInfo(): CompanyInfo;
1021
1274
  type CompanyInfo = {
1275
+ /**
1276
+ * - Name of the company
1277
+ */
1022
1278
  company_name?: string;
1279
+ /**
1280
+ * - Goods and Services Tax Identification Number
1281
+ */
1023
1282
  gstin?: string;
1283
+ /**
1284
+ * - Main address of the company
1285
+ */
1024
1286
  address?: string;
1025
1287
  address_details?: AddressDetails;
1288
+ /**
1289
+ * - Permanent Account Number of the company
1290
+ */
1026
1291
  pan?: string;
1292
+ /**
1293
+ * - Contact phone number for the company
1294
+ */
1027
1295
  phone?: string;
1296
+ /**
1297
+ * - Contact email address for the company
1298
+ */
1028
1299
  email?: string;
1300
+ /**
1301
+ * - Corporate Identification Number
1302
+ */
1029
1303
  cin?: string;
1030
1304
  };
1031
1305
  /** @returns {AddressDetails} */
1032
1306
  declare function AddressDetails(): AddressDetails;
1033
1307
  type AddressDetails = {
1308
+ /**
1309
+ * - First line of the address
1310
+ */
1034
1311
  address_line_1?: string;
1312
+ /**
1313
+ * - Second line of the address (optional)
1314
+ */
1035
1315
  address_line_2?: string;
1316
+ /**
1317
+ * - Company city
1318
+ */
1036
1319
  city?: string;
1320
+ /**
1321
+ * - Company pincode
1322
+ */
1037
1323
  pincode?: string;
1324
+ /**
1325
+ * - Company state
1326
+ */
1038
1327
  state?: string;
1328
+ /**
1329
+ * - Company country
1330
+ */
1039
1331
  country?: string;
1040
1332
  };
1041
1333
  /** @returns {InvoiceData} */
@@ -1048,80 +1340,250 @@ type InvoiceData = {
1048
1340
  /** @returns {InvoiceDetailsData} */
1049
1341
  declare function InvoiceDetailsData(): InvoiceDetailsData;
1050
1342
  type InvoiceDetailsData = {
1343
+ /**
1344
+ * - Number of attempts made to collect the invoice payment
1345
+ */
1051
1346
  attemp?: number;
1347
+ /**
1348
+ * - Documents associated with the invoice
1349
+ */
1052
1350
  documents?: any;
1351
+ /**
1352
+ * - Payment details related to the invoice
1353
+ */
1053
1354
  payment?: any;
1054
1355
  period?: Period;
1055
1356
  client?: Client;
1357
+ /**
1358
+ * - Discount applied to the invoice
1359
+ */
1056
1360
  discount?: any;
1361
+ /**
1362
+ * - Taxation applied to the invoice
1363
+ */
1057
1364
  taxation?: any;
1365
+ /**
1366
+ * - Unique identifier for the invoice
1367
+ */
1058
1368
  _id?: string;
1369
+ /**
1370
+ * - Indicates if the invoice will
1371
+ * automatically advance to the next stage of collection
1372
+ */
1059
1373
  auto_advance?: boolean;
1374
+ /**
1375
+ * - Method of collection (e.g.,
1376
+ * charge_automatically, send_invoice)
1377
+ */
1060
1378
  collection_method?: string;
1379
+ /**
1380
+ * - Identifier for the subscriber associated
1381
+ * with the invoice
1382
+ */
1061
1383
  subscriber_id?: string;
1384
+ /**
1385
+ * - Currency in which the invoice is issued
1386
+ */
1062
1387
  currency?: string;
1388
+ /**
1389
+ * - URL to view the invoice pdf
1390
+ */
1063
1391
  invoice_url?: string;
1392
+ /**
1393
+ * - Invoice number
1394
+ */
1064
1395
  number?: string;
1396
+ /**
1397
+ * - Indicates if the invoice has been paid
1398
+ */
1065
1399
  paid?: boolean;
1400
+ /**
1401
+ * - Payment gateway data related to the invoice
1402
+ */
1066
1403
  pg_data?: any;
1404
+ /**
1405
+ * - Receipt number for the invoice payment
1406
+ */
1067
1407
  receipt_number?: string;
1408
+ /**
1409
+ * - Statement descriptor for the invoice
1410
+ */
1068
1411
  statement_descriptor?: string;
1412
+ /**
1413
+ * - Current status of the invoice (e.g., paid, open)
1414
+ */
1069
1415
  current_status?: string;
1416
+ /**
1417
+ * - Trail of status changes for the invoice
1418
+ */
1070
1419
  status_trail?: StatusTrail[];
1420
+ /**
1421
+ * - Subtotal amount of the invoice
1422
+ */
1071
1423
  subtotal?: number;
1424
+ /**
1425
+ * - Total amount of the invoice
1426
+ */
1072
1427
  total?: number;
1428
+ /**
1429
+ * - Previous settlement amount (if any)
1430
+ */
1073
1431
  old_settlement?: number;
1432
+ /**
1433
+ * - Credit balance applied to the invoice
1434
+ */
1074
1435
  credit_balance?: number;
1436
+ /**
1437
+ * - Subscription associated with the invoice
1438
+ */
1075
1439
  subscription?: string;
1440
+ /**
1441
+ * - Number of attempts made to pay the invoice
1442
+ */
1076
1443
  attempt?: number;
1444
+ /**
1445
+ * - Timestamp for the next action on the invoice
1446
+ */
1077
1447
  next_action_time?: string;
1448
+ /**
1449
+ * - Amount of credit notes applied to the invoice
1450
+ */
1078
1451
  credit_note_amount?: number;
1452
+ /**
1453
+ * - Timestamp when the invoice was created
1454
+ */
1079
1455
  created_at?: string;
1456
+ /**
1457
+ * - Timestamp when the invoice was last modified
1458
+ */
1080
1459
  modified_at?: string;
1460
+ /**
1461
+ * - Type of invoice (e.g., subscription, extension)
1462
+ */
1463
+ invoice_type?: string;
1081
1464
  };
1082
1465
  /** @returns {Client} */
1083
1466
  declare function Client(): Client;
1084
1467
  type Client = {
1468
+ /**
1469
+ * - Name of the client
1470
+ */
1085
1471
  name?: string;
1472
+ /**
1473
+ * - Email address of the client
1474
+ */
1086
1475
  email?: string;
1476
+ /**
1477
+ * - Phone number of the client
1478
+ */
1087
1479
  phone?: string;
1480
+ /**
1481
+ * - List of address lines for the client's address
1482
+ */
1088
1483
  address_lines?: string[];
1089
1484
  };
1090
1485
  /** @returns {Period} */
1091
1486
  declare function Period(): Period;
1092
1487
  type Period = {
1488
+ /**
1489
+ * - Start date of the period
1490
+ */
1093
1491
  start?: string;
1492
+ /**
1493
+ * - End date of the period
1494
+ */
1094
1495
  end?: string;
1095
1496
  };
1096
1497
  /** @returns {StatusTrail} */
1097
1498
  declare function StatusTrail(): StatusTrail;
1098
1499
  type StatusTrail = {
1500
+ /**
1501
+ * - The status value of the invoice at a particular
1502
+ * timestamp (e.g., open, paid, payment_due)
1503
+ */
1099
1504
  value?: string;
1505
+ /**
1506
+ * - The date and time when the status was
1507
+ * recorded, in ISO 8601 format
1508
+ */
1100
1509
  timestamp?: string;
1510
+ /**
1511
+ * - Unique identifier for the status trail entry
1512
+ */
1101
1513
  _id?: string;
1102
1514
  };
1103
1515
  /** @returns {PaymentCollectRes} */
1104
1516
  declare function PaymentCollectRes(): PaymentCollectRes;
1105
1517
  type PaymentCollectRes = {
1518
+ /**
1519
+ * - Unique identifier for the transaction
1520
+ */
1106
1521
  transaction_id?: string;
1522
+ /**
1523
+ * - Current status of the payment
1524
+ * collection (e.g., pending, completed, failed)
1525
+ */
1107
1526
  current_status?: string;
1108
1527
  };
1109
1528
  /** @returns {SubscriptionChargeRes} */
1110
1529
  declare function SubscriptionChargeRes(): SubscriptionChargeRes;
1111
1530
  type SubscriptionChargeRes = {
1531
+ /**
1532
+ * - Unique identifier for the subscription charge
1533
+ */
1112
1534
  _id?: string;
1535
+ /**
1536
+ * - ID of the product suit associated with
1537
+ * the charge
1538
+ */
1113
1539
  product_suit_id?: string;
1540
+ /**
1541
+ * - Unique identifier for the entity
1542
+ */
1114
1543
  entity_id?: string;
1544
+ /**
1545
+ * - Type of entity (e.g., subscription, extension)
1546
+ */
1115
1547
  entity_type?: string;
1548
+ /**
1549
+ * - Name of the subscription charge
1550
+ */
1116
1551
  name?: string;
1552
+ /**
1553
+ * - Current status of the subscription charge
1554
+ */
1117
1555
  status?: string;
1556
+ /**
1557
+ * - Number of trial days provided
1558
+ */
1118
1559
  trial_days?: number;
1560
+ /**
1561
+ * - Date when the charge was activated
1562
+ */
1119
1563
  activated_on?: string;
1564
+ /**
1565
+ * - Date when the charge was cancelled
1566
+ */
1120
1567
  cancelled_on?: string;
1568
+ /**
1569
+ * - Indicates if the charge is for testing purposes
1570
+ */
1121
1571
  is_test?: boolean;
1572
+ /**
1573
+ * - Timestamp when the charge was created
1574
+ */
1122
1575
  created_at?: string;
1576
+ /**
1577
+ * - Timestamp when the charge was last modified
1578
+ */
1123
1579
  modified_at?: string;
1580
+ /**
1581
+ * - Company id
1582
+ */
1124
1583
  company_id?: string;
1584
+ /**
1585
+ * - List of line items associated with the charge
1586
+ */
1125
1587
  line_items?: any[];
1126
1588
  };
1127
1589
  /** @returns {PostDowngradeRes} */
@@ -1133,33 +1595,104 @@ type PostDowngradeRes = {
1133
1595
  /** @returns {DowngradeRes} */
1134
1596
  declare function DowngradeRes(): DowngradeRes;
1135
1597
  type DowngradeRes = {
1598
+ /**
1599
+ * - Unique identifier for the downgrade request
1600
+ */
1136
1601
  _id?: string;
1602
+ /**
1603
+ * - Current status of the downgrade request (e.g.,
1604
+ * pending, completed)
1605
+ */
1137
1606
  status?: string;
1607
+ /**
1608
+ * - Unique identifier for the subscriber
1609
+ * making the downgrade request
1610
+ */
1138
1611
  subscriber_id?: string;
1612
+ /**
1613
+ * - Indicates if the downgrade has been activated
1614
+ */
1139
1615
  activated?: boolean;
1616
+ /**
1617
+ * - Timestamp when the downgrade request was created
1618
+ */
1140
1619
  created_at?: string;
1620
+ /**
1621
+ * - Timestamp when the downgrade request was
1622
+ * last modified
1623
+ */
1141
1624
  modified_at?: string;
1625
+ /**
1626
+ * - ID of the plan to which the subscriber is downgrading
1627
+ */
1142
1628
  plan_id?: string;
1629
+ /**
1630
+ * - Reason provided for the downgrade request
1631
+ */
1143
1632
  reason?: string;
1633
+ /**
1634
+ * - ID of the user who initiated the
1635
+ * downgrade request
1636
+ */
1144
1637
  request_user_id?: string;
1638
+ /**
1639
+ * - ID of the subscription associated with
1640
+ * the downgrade request
1641
+ */
1145
1642
  subscription_id?: string;
1146
1643
  };
1147
1644
  /** @returns {PaymentStatusData} */
1148
1645
  declare function PaymentStatusData(): PaymentStatusData;
1149
1646
  type PaymentStatusData = {
1647
+ /**
1648
+ * - Unique identifier for the payment status data
1649
+ */
1150
1650
  _id?: string;
1651
+ /**
1652
+ * - Payment journey status, such as 'forward' or 'backward'
1653
+ */
1151
1654
  journey?: string;
1655
+ /**
1656
+ * - List of responses received from
1657
+ * webhooks related to the payment
1658
+ */
1152
1659
  webhook_response?: any[];
1660
+ /**
1661
+ * - Status of the payment as provided by
1662
+ * the aggregator (e.g., succeeded, failed)
1663
+ */
1153
1664
  aggregator_status?: string;
1665
+ /**
1666
+ * - Current status of the payment (e.g.,
1667
+ * paid, pending)
1668
+ */
1154
1669
  current_status?: string;
1670
+ /**
1671
+ * - Timestamp when the payment status data was created
1672
+ */
1155
1673
  created_at?: string;
1674
+ /**
1675
+ * - Timestamp when the payment status data was
1676
+ * last modified
1677
+ */
1156
1678
  modified_at?: string;
1679
+ /**
1680
+ * - Version key for the payment status data (typically
1681
+ * used for versioning in databases)
1682
+ */
1157
1683
  __v?: number;
1684
+ /**
1685
+ * - Unique identifier for the order
1686
+ * provided by the payment aggregator
1687
+ */
1158
1688
  aggregator_order_id?: string;
1159
1689
  };
1160
1690
  /** @returns {PaymentStatusResponse} */
1161
1691
  declare function PaymentStatusResponse(): PaymentStatusResponse;
1162
1692
  type PaymentStatusResponse = {
1693
+ /**
1694
+ * - The status of the payment.
1695
+ */
1163
1696
  status?: string;
1164
1697
  data?: PaymentStatusData;
1165
1698
  };
@@ -1185,7 +1718,7 @@ type ResourceNotFound = {
1185
1718
  declare function InternalServerError(): InternalServerError;
1186
1719
  type InternalServerError = {
1187
1720
  /**
1188
- * - Internal server Server error
1721
+ * - Internal server error
1189
1722
  */
1190
1723
  message?: string;
1191
1724
  /**
@@ -1196,88 +1729,247 @@ type InternalServerError = {
1196
1729
  /** @returns {CheckValidityResponse} */
1197
1730
  declare function CheckValidityResponse(): CheckValidityResponse;
1198
1731
  type CheckValidityResponse = {
1732
+ /**
1733
+ * - Indicates whether the request is valid.
1734
+ */
1199
1735
  is_valid?: boolean;
1736
+ /**
1737
+ * - The amount of discount applicable.
1738
+ */
1200
1739
  discount_amount?: number;
1201
1740
  };
1202
1741
  /** @returns {PlanRecurring} */
1203
1742
  declare function PlanRecurring(): PlanRecurring;
1204
1743
  type PlanRecurring = {
1744
+ /**
1745
+ * - The interval at which the plan recurs.
1746
+ */
1205
1747
  interval?: string;
1206
1748
  interval_count?: number;
1207
1749
  };
1208
1750
  /** @returns {PlanMeta} */
1209
1751
  declare function PlanMeta(): PlanMeta;
1210
1752
  type PlanMeta = {
1753
+ /**
1754
+ * - Status of the seller associated with the plan.
1755
+ */
1211
1756
  seller_status?: string;
1757
+ /**
1758
+ * - Name of the company offering the plan.
1759
+ */
1212
1760
  company?: string;
1761
+ /**
1762
+ * - Display name for platform slug.
1763
+ */
1213
1764
  plan_platform_display_name?: string;
1765
+ /**
1766
+ * - Tags associated with the plan for
1767
+ * categorization or identification.
1768
+ */
1769
+ tags?: string[];
1770
+ };
1771
+ /** @returns {CountryRes} */
1772
+ declare function CountryRes(): CountryRes;
1773
+ type CountryRes = {
1774
+ /**
1775
+ * - Name of the country.
1776
+ */
1777
+ name?: string;
1778
+ /**
1779
+ * - Country code.
1780
+ */
1781
+ code?: string;
1214
1782
  };
1215
1783
  /** @returns {Plan} */
1216
1784
  declare function Plan(): Plan;
1217
1785
  type Plan = {
1786
+ /**
1787
+ * - List of fee components associated
1788
+ * with the plan. Each component may be represented as a string or an object.
1789
+ */
1218
1790
  fee_components?: any[];
1219
1791
  recurring?: PlanRecurring;
1792
+ /**
1793
+ * - Indicates whether the plan is a trial plan.
1794
+ */
1220
1795
  is_trial_plan?: boolean;
1796
+ /**
1797
+ * - Group or category of the plan.
1798
+ */
1221
1799
  plan_group?: string;
1800
+ /**
1801
+ * - List of tag lines or descriptions
1802
+ * associated with the plan.
1803
+ */
1222
1804
  tag_lines?: string[];
1805
+ /**
1806
+ * - Currency code used for the plan's pricing.
1807
+ */
1223
1808
  currency?: string;
1809
+ /**
1810
+ * - Identifier of the user or system that
1811
+ * approved the plan.
1812
+ */
1813
+ approved_by?: string;
1814
+ /**
1815
+ * - Indicates if the plan is currently active.
1816
+ */
1224
1817
  is_active?: boolean;
1225
- is_visible?: boolean;
1818
+ /**
1819
+ * - Indicates if the plan is visible to users.
1820
+ */
1821
+ is_visible?: boolean;
1822
+ /**
1823
+ * - Number of days for the trial period, if applicable.
1824
+ */
1226
1825
  trial_period?: number;
1826
+ /**
1827
+ * - List of add-ons available for the plan.
1828
+ */
1227
1829
  addons?: string[];
1830
+ /**
1831
+ * - List of tags associated with the plan.
1832
+ */
1228
1833
  tags?: string[];
1834
+ /**
1835
+ * - Type of the plan (e.g., public, private).
1836
+ */
1229
1837
  type?: string;
1230
- country?: string;
1838
+ country?: CountryRes;
1839
+ /**
1840
+ * - Unique identifier for the plan.
1841
+ */
1231
1842
  _id?: string;
1843
+ /**
1844
+ * - Name of the plan.
1845
+ */
1232
1846
  name?: string;
1847
+ /**
1848
+ * - Description of the plan.
1849
+ */
1233
1850
  description?: string;
1851
+ /**
1852
+ * - Amount to be charged for the plan.
1853
+ */
1234
1854
  amount?: number;
1855
+ /**
1856
+ * - Identifier of the product suite to
1857
+ * which the plan belongs.
1858
+ */
1235
1859
  product_suite_id?: string;
1860
+ /**
1861
+ * - Timestamp when the plan was created.
1862
+ */
1236
1863
  created_at?: string;
1864
+ /**
1865
+ * - Timestamp when the plan was last modified.
1866
+ */
1237
1867
  modified_at?: string;
1238
1868
  taxation?: Taxation;
1239
1869
  one_time_fees?: OneTimeFees;
1240
1870
  credit_line?: CreditLine;
1871
+ /**
1872
+ * - Current status of the plan (e.g.,
1873
+ * active, inactive).
1874
+ */
1241
1875
  current_status?: string;
1876
+ /**
1877
+ * - Type of channel where the plan is offered
1878
+ * (e.g., ecomm, retail).
1879
+ */
1242
1880
  channel_type?: string;
1243
- company_ids?: any[];
1881
+ /**
1882
+ * - List of company IDs associated with the
1883
+ * plan. Can be null.
1884
+ */
1885
+ company_ids?: string[];
1886
+ /**
1887
+ * - Platform where the plan is available (e.g.,
1888
+ * web, mobile). Can be null.
1889
+ */
1244
1890
  platform?: string;
1891
+ /**
1892
+ * - Timestamp when the plan was activated.
1893
+ */
1245
1894
  activated_on?: string;
1246
1895
  meta?: PlanMeta;
1896
+ /**
1897
+ * - Identifier of the user who created the plan.
1898
+ */
1247
1899
  created_by?: string;
1248
1900
  };
1249
1901
  /** @returns {SubscriptionTrialPeriod} */
1250
1902
  declare function SubscriptionTrialPeriod(): SubscriptionTrialPeriod;
1251
1903
  type SubscriptionTrialPeriod = {
1904
+ /**
1905
+ * - The start date and time of the trial period.
1906
+ */
1252
1907
  start_date?: string;
1908
+ /**
1909
+ * - The end date and time of the trial period.
1910
+ */
1253
1911
  end_date?: string;
1254
1912
  };
1255
1913
  /** @returns {EntityChargePrice} */
1256
1914
  declare function EntityChargePrice(): EntityChargePrice;
1257
1915
  type EntityChargePrice = {
1258
1916
  /**
1259
- * - Amount for price. Minimum value 1
1917
+ * - The amount for the price. The minimum value is 1.
1260
1918
  */
1261
1919
  amount?: number;
1920
+ /**
1921
+ * - The currency code for the price
1922
+ */
1262
1923
  currency_code?: string;
1263
1924
  };
1264
1925
  /** @returns {OneTimeChargeItem} */
1265
1926
  declare function OneTimeChargeItem(): OneTimeChargeItem;
1266
1927
  type OneTimeChargeItem = {
1928
+ /**
1929
+ * - The name of the one-time charge item.
1930
+ */
1267
1931
  name?: string;
1932
+ /**
1933
+ * - The term or description of the charge.
1934
+ */
1268
1935
  term?: string;
1936
+ /**
1937
+ * - The type of pricing for the charge item.
1938
+ */
1269
1939
  pricing_type?: string;
1270
1940
  price?: EntityChargePrice;
1941
+ /**
1942
+ * - The maximum amount that can be charged
1943
+ * for this item, if applicable.
1944
+ */
1271
1945
  capped_amount?: number;
1946
+ /**
1947
+ * - Indicates whether the charge item is for
1948
+ * testing purposes.
1949
+ */
1272
1950
  is_test?: boolean;
1951
+ /**
1952
+ * - Additional metadata associated with the charge item.
1953
+ */
1273
1954
  metadata?: any;
1274
1955
  };
1275
1956
  /** @returns {CreateOneTimeCharge} */
1276
1957
  declare function CreateOneTimeCharge(): CreateOneTimeCharge;
1277
1958
  type CreateOneTimeCharge = {
1959
+ /**
1960
+ * - The name of the one-time charge to be created.
1961
+ */
1278
1962
  name?: string;
1279
1963
  charge?: OneTimeChargeItem;
1964
+ /**
1965
+ * - Indicates whether the charge creation is for
1966
+ * testing purposes.
1967
+ */
1280
1968
  is_test?: boolean;
1969
+ /**
1970
+ * - URL to which the user will be redirected
1971
+ * after creating the charge.
1972
+ */
1281
1973
  return_url?: string;
1282
1974
  };
1283
1975
  /** @returns {ChargeRecurring} */
@@ -1289,50 +1981,179 @@ type ChargeRecurring = {
1289
1981
  /** @returns {ChargeDetails} */
1290
1982
  declare function ChargeDetails(): ChargeDetails;
1291
1983
  type ChargeDetails = {
1984
+ /**
1985
+ * - Unique identifier for the charge.
1986
+ */
1292
1987
  _id?: string;
1988
+ /**
1989
+ * - The type of entity associated with the
1990
+ * charge (e.g., 'extension', 'subscription').
1991
+ */
1293
1992
  entity_type?: string;
1993
+ /**
1994
+ * - Unique identifier for the entity associated
1995
+ * with the charge.
1996
+ */
1294
1997
  entity_id?: string;
1998
+ /**
1999
+ * - The name of the charge.
2000
+ */
1295
2001
  name?: string;
2002
+ /**
2003
+ * - Description of the charge term.
2004
+ */
1296
2005
  term?: string;
2006
+ /**
2007
+ * - The type of charge (e.g., 'standalone',
2008
+ * 'recurring').
2009
+ */
1297
2010
  charge_type?: string;
2011
+ /**
2012
+ * - The pricing model for the charge (e.g.,
2013
+ * 'one_time', 'recurring').
2014
+ */
1298
2015
  pricing_type?: string;
1299
2016
  price?: EntityChargePrice;
1300
2017
  recurring?: ChargeRecurring;
2018
+ /**
2019
+ * - Current status of the charge.
2020
+ */
1301
2021
  status?: string;
2022
+ /**
2023
+ * - Maximum amount that can be charged, if applicable.
2024
+ */
1302
2025
  capped_amount?: number;
2026
+ /**
2027
+ * - Date and time when the charge was activated.
2028
+ */
1303
2029
  activated_on?: string;
2030
+ /**
2031
+ * - Date and time when the charge was cancelled.
2032
+ */
1304
2033
  cancelled_on?: string;
2034
+ /**
2035
+ * - Date and time when the charge was billed.
2036
+ */
1305
2037
  billing_date?: string;
1306
2038
  current_period?: SubscriptionTrialPeriod;
2039
+ /**
2040
+ * - Date and time when the charge details were
2041
+ * last modified.
2042
+ */
1307
2043
  modified_at?: string;
2044
+ /**
2045
+ * - Date and time when the charge was created.
2046
+ */
1308
2047
  created_at?: string;
2048
+ /**
2049
+ * - Indicates whether the charge is for testing purposes.
2050
+ */
1309
2051
  is_test?: boolean;
2052
+ /**
2053
+ * - Company id.
2054
+ */
1310
2055
  company_id?: string;
2056
+ /**
2057
+ * - Additional metadata associated with the charge.
2058
+ */
1311
2059
  meta?: any;
2060
+ /**
2061
+ * - Internal version key for the charge record.
2062
+ */
1312
2063
  __v?: number;
1313
2064
  };
1314
2065
  /** @returns {OneTimeChargeEntity} */
1315
2066
  declare function OneTimeChargeEntity(): OneTimeChargeEntity;
1316
2067
  type OneTimeChargeEntity = {
2068
+ /**
2069
+ * - Description of the charge term or usage.
2070
+ */
1317
2071
  term?: string;
2072
+ /**
2073
+ * - Type of the charge (e.g., 'subscription',
2074
+ * 'extension').
2075
+ */
1318
2076
  charge_type?: string;
2077
+ /**
2078
+ * - Maximum amount that can be charged. If
2079
+ * no cap, the value should be 0.
2080
+ */
1319
2081
  capped_amount?: number;
2082
+ /**
2083
+ * - Date when the charge was billed. Null if
2084
+ * not yet billed.
2085
+ */
1320
2086
  billing_date?: string;
2087
+ /**
2088
+ * - Date and time when the charge entity was created.
2089
+ */
1321
2090
  created_at?: string;
2091
+ /**
2092
+ * - Date and time when the charge entity was
2093
+ * last modified.
2094
+ */
1322
2095
  modified_at?: string;
2096
+ /**
2097
+ * - Internal version key for the charge record.
2098
+ */
1323
2099
  __v?: number;
2100
+ /**
2101
+ * - Unique identifier for the charge entity.
2102
+ */
1324
2103
  _id?: string;
2104
+ /**
2105
+ * - The name of the one-time charge.
2106
+ */
1325
2107
  name?: string;
2108
+ /**
2109
+ * - Current status of the charge (e.g., 'pending',
2110
+ * 'completed').
2111
+ */
1326
2112
  status?: string;
2113
+ /**
2114
+ * - Date and time when the charge was
2115
+ * activated. Null if not yet activated.
2116
+ */
1327
2117
  activated_on?: string;
2118
+ /**
2119
+ * - Date and time when the charge was
2120
+ * cancelled. Null if not cancelled.
2121
+ */
1328
2122
  cancelled_on?: string;
2123
+ /**
2124
+ * - Additional metadata associated with the charge.
2125
+ */
1329
2126
  metadata?: any;
2127
+ /**
2128
+ * - URL to redirect to after processing the charge.
2129
+ */
1330
2130
  return_url?: string;
2131
+ /**
2132
+ * - Indicates whether the charge is for testing purposes.
2133
+ */
1331
2134
  is_test?: boolean;
2135
+ /**
2136
+ * - Pricing model for the charge (e.g., 'one_time').
2137
+ */
1332
2138
  pricing_type?: string;
2139
+ /**
2140
+ * - Unique identifier for the subscriber
2141
+ * associated with the charge.
2142
+ */
1333
2143
  subscriber_id?: string;
2144
+ /**
2145
+ * - Type of the entity related to the charge
2146
+ * (e.g., 'subscription', 'user').
2147
+ */
1334
2148
  entity_type?: string;
2149
+ /**
2150
+ * - Unique identifier for the entity associated
2151
+ * with the charge.
2152
+ */
1335
2153
  entity_id?: string;
2154
+ /**
2155
+ * - Additional metadata associated with the charge.
2156
+ */
1336
2157
  meta?: any;
1337
2158
  price?: EntityChargePrice;
1338
2159
  };
@@ -1340,6 +2161,10 @@ type OneTimeChargeEntity = {
1340
2161
  declare function CreateOneTimeChargeResponse(): CreateOneTimeChargeResponse;
1341
2162
  type CreateOneTimeChargeResponse = {
1342
2163
  charge?: Charge;
2164
+ /**
2165
+ * - URL to which users are redirected to
2166
+ * confirm or complete the payment or subscription process.
2167
+ */
1343
2168
  confirm_url?: string;
1344
2169
  };
1345
2170
  /** @returns {Charge} */
@@ -1350,141 +2175,419 @@ type Charge = {
1350
2175
  /** @returns {InvoiceDetailsStatusTrail} */
1351
2176
  declare function InvoiceDetailsStatusTrail(): InvoiceDetailsStatusTrail;
1352
2177
  type InvoiceDetailsStatusTrail = {
2178
+ /**
2179
+ * - Unique identifier for the status trail entry.
2180
+ */
1353
2181
  _id?: string;
2182
+ /**
2183
+ * - The status value of the invoice at a particular
2184
+ * point in time.
2185
+ */
1354
2186
  value?: string;
2187
+ /**
2188
+ * - The date and time when this status was recorded.
2189
+ */
1355
2190
  timestamp?: string;
1356
2191
  };
1357
2192
  /** @returns {InvoiceItemsPlanRecurring} */
1358
2193
  declare function InvoiceItemsPlanRecurring(): InvoiceItemsPlanRecurring;
1359
2194
  type InvoiceItemsPlanRecurring = {
2195
+ /**
2196
+ * - The interval at which the plan recurs (e.g.,
2197
+ * month, year).
2198
+ */
1360
2199
  interval?: string;
2200
+ /**
2201
+ * - The number of intervals for the recurring plan.
2202
+ */
1361
2203
  interval_count?: number;
1362
2204
  };
1363
2205
  /** @returns {InvoiceItemsPlan} */
1364
2206
  declare function InvoiceItemsPlan(): InvoiceItemsPlan;
1365
2207
  type InvoiceItemsPlan = {
1366
2208
  recurring?: InvoiceItemsPlanRecurring;
2209
+ /**
2210
+ * - Indicates whether the plan is a trial plan.
2211
+ */
1367
2212
  is_trial_plan?: boolean;
2213
+ /**
2214
+ * - Group or category to which the plan belongs.
2215
+ */
1368
2216
  plan_group?: string;
2217
+ /**
2218
+ * - List of tag lines or short descriptions
2219
+ * for the plan.
2220
+ */
1369
2221
  tag_lines?: string[];
2222
+ /**
2223
+ * - Currency code for the pricing of the plan.
2224
+ */
1370
2225
  currency?: string;
2226
+ /**
2227
+ * - Indicates whether the plan is currently active.
2228
+ */
1371
2229
  is_active?: boolean;
2230
+ /**
2231
+ * - Indicates whether the plan is visible to users.
2232
+ */
1372
2233
  is_visible?: boolean;
2234
+ /**
2235
+ * - The number of days for the trial period.
2236
+ */
1373
2237
  trial_period?: number;
2238
+ /**
2239
+ * - List of add-ons available with the plan.
2240
+ */
1374
2241
  addons?: string[];
2242
+ /**
2243
+ * - Tags associated with the plan for categorization.
2244
+ */
1375
2245
  tags?: string[];
2246
+ /**
2247
+ * - Type of the plan (e.g., public, private).
2248
+ */
1376
2249
  type?: string;
2250
+ /**
2251
+ * - Country for which plan is created
2252
+ */
1377
2253
  country?: string;
2254
+ /**
2255
+ * - Unique identifier for the plan.
2256
+ */
1378
2257
  _id?: string;
2258
+ /**
2259
+ * - Name of the plan.
2260
+ */
1379
2261
  name?: string;
2262
+ /**
2263
+ * - Detailed description of the plan.
2264
+ */
1380
2265
  description?: string;
2266
+ /**
2267
+ * - Price of the plan in the specified currency.
2268
+ */
1381
2269
  amount?: number;
2270
+ /**
2271
+ * - Identifier for the product suite to
2272
+ * which the plan belongs.
2273
+ */
1382
2274
  product_suite_id?: string;
2275
+ /**
2276
+ * - Timestamp when the plan was created.
2277
+ */
1383
2278
  created_at?: string;
2279
+ /**
2280
+ * - Timestamp when the plan was last modified.
2281
+ */
1384
2282
  modified_at?: string;
1385
2283
  };
1386
2284
  /** @returns {InvoiceItemsPeriod} */
1387
2285
  declare function InvoiceItemsPeriod(): InvoiceItemsPeriod;
1388
2286
  type InvoiceItemsPeriod = {
2287
+ /**
2288
+ * - Start date of the invoice period.
2289
+ */
1389
2290
  start?: string;
2291
+ /**
2292
+ * - End date of the invoice period.
2293
+ */
1390
2294
  end?: string;
1391
2295
  };
1392
2296
  /** @returns {InvoiceItems} */
1393
2297
  declare function InvoiceItems(): InvoiceItems;
1394
2298
  type InvoiceItems = {
2299
+ /**
2300
+ * - Unique identifier for the invoice item.
2301
+ */
1395
2302
  _id?: string;
2303
+ /**
2304
+ * - Currency for the amount.
2305
+ */
1396
2306
  currency?: string;
1397
2307
  plan?: InvoiceItemsPlan;
2308
+ /**
2309
+ * - Name of the invoice item.
2310
+ */
1398
2311
  name?: string;
2312
+ /**
2313
+ * - Number of units of the invoice item.
2314
+ */
1399
2315
  quantity?: number;
2316
+ /**
2317
+ * - Description of the invoice item.
2318
+ */
1400
2319
  description?: string;
1401
2320
  period?: InvoiceItemsPeriod;
2321
+ /**
2322
+ * - Amount per unit of the invoice item.
2323
+ */
1402
2324
  unit_amount?: number;
2325
+ /**
2326
+ * - Total amount for the invoice item.
2327
+ */
1403
2328
  amount?: number;
2329
+ /**
2330
+ * - Type of the invoice item (e.g., subscription, extension).
2331
+ */
1404
2332
  type?: string;
2333
+ /**
2334
+ * - Identifier for the invoice to which the item belongs.
2335
+ */
1405
2336
  invoice_id?: string;
2337
+ /**
2338
+ * - Timestamp when the invoice item was created.
2339
+ */
1406
2340
  created_at?: string;
2341
+ /**
2342
+ * - Timestamp when the invoice item was last modified.
2343
+ */
1407
2344
  modified_at?: string;
1408
2345
  };
1409
2346
  /** @returns {InvoicesDataClient} */
1410
2347
  declare function InvoicesDataClient(): InvoicesDataClient;
1411
2348
  type InvoicesDataClient = {
2349
+ /**
2350
+ * - Name of the client.
2351
+ */
1412
2352
  name?: string;
2353
+ /**
2354
+ * - Email address of the client.
2355
+ */
1413
2356
  email?: string;
2357
+ /**
2358
+ * - Phone number of the client.
2359
+ */
1414
2360
  phone?: string;
2361
+ /**
2362
+ * - Array of address lines for the client’s address.
2363
+ */
1415
2364
  address_lines?: string[];
1416
2365
  };
1417
2366
  /** @returns {InvoicesDataPeriod} */
1418
2367
  declare function InvoicesDataPeriod(): InvoicesDataPeriod;
1419
2368
  type InvoicesDataPeriod = {
2369
+ /**
2370
+ * - The start date and time of the invoice period.
2371
+ */
1420
2372
  start?: string;
2373
+ /**
2374
+ * - The end date and time of the invoice period.
2375
+ */
1421
2376
  end?: string;
1422
2377
  };
1423
2378
  /** @returns {InvoicesDataPaymentMethod} */
1424
2379
  declare function InvoicesDataPaymentMethod(): InvoicesDataPaymentMethod;
1425
2380
  type InvoicesDataPaymentMethod = {
2381
+ /**
2382
+ * - Payment gateway-specific payment
2383
+ * method identifier. Nullable if not applicable.
2384
+ */
1426
2385
  pg_payment_method_id?: string;
1427
2386
  };
1428
2387
  /** @returns {InvoicesData} */
1429
2388
  declare function InvoicesData(): InvoicesData;
1430
2389
  type InvoicesData = {
2390
+ /**
2391
+ * - Unique identifier for the invoice.
2392
+ */
1431
2393
  _id?: string;
2394
+ /**
2395
+ * - Associated documents related to the invoice.
2396
+ */
1432
2397
  documents?: any;
2398
+ /**
2399
+ * - Payment details for the invoice.
2400
+ */
1433
2401
  payment?: any;
2402
+ /**
2403
+ * - Previous settlement amount, if applicable.
2404
+ */
1434
2405
  old_settlement?: number;
2406
+ /**
2407
+ * - Remaining credit balance applied to the
2408
+ * invoice, if any.
2409
+ */
1435
2410
  credit_balance?: number;
2411
+ /**
2412
+ * - Details of any discounts applied to the invoice.
2413
+ */
1436
2414
  discount?: any;
2415
+ /**
2416
+ * - Taxation details associated with the invoice.
2417
+ */
1437
2418
  taxation?: any;
2419
+ /**
2420
+ * - Amount covered by credit notes, if any.
2421
+ */
1438
2422
  credit_note_amount?: number;
1439
2423
  client?: InvoicesDataClient;
2424
+ /**
2425
+ * - Indicates if the invoice should be
2426
+ * auto-advanced in the billing process.
2427
+ */
1440
2428
  auto_advance?: boolean;
2429
+ /**
2430
+ * - Currency code used for the invoice amount.
2431
+ */
1441
2432
  currency?: string;
2433
+ /**
2434
+ * - Indicates if the invoice has been paid.
2435
+ */
1442
2436
  paid?: boolean;
2437
+ /**
2438
+ * - Number of payment attempts made for the invoice.
2439
+ */
1443
2440
  attemp?: number;
2441
+ /**
2442
+ * - Method used to collect payment for
2443
+ * the invoice.
2444
+ */
1444
2445
  collection_method?: string;
2446
+ /**
2447
+ * - Identifier for the subscriber associated
2448
+ * with the invoice.
2449
+ */
1445
2450
  subscriber_id?: string;
2451
+ /**
2452
+ * - URL to view or download the invoice.
2453
+ * "null" if not available.
2454
+ */
1446
2455
  invoice_url?: string;
2456
+ /**
2457
+ * - Unique invoice number.
2458
+ */
1447
2459
  number?: string;
2460
+ /**
2461
+ * - Payment gateway-related data for the invoice.
2462
+ */
1448
2463
  pg_data?: any;
1449
2464
  period?: InvoicesDataPeriod;
2465
+ /**
2466
+ * - Receipt number for the invoice payment.
2467
+ */
1450
2468
  receipt_number?: string;
2469
+ /**
2470
+ * - Descriptor that appears on the
2471
+ * client's statement for the invoice.
2472
+ */
1451
2473
  statement_descriptor?: string;
2474
+ /**
2475
+ * - Current status of the invoice (e.g.,
2476
+ * paid, pending).
2477
+ */
1452
2478
  current_status?: string;
2479
+ /**
2480
+ * - History of status
2481
+ * changes for the invoice.
2482
+ */
1453
2483
  status_trail?: InvoiceDetailsStatusTrail[];
2484
+ /**
2485
+ * - Subtotal amount before taxes and discounts.
2486
+ */
1454
2487
  subtotal?: number;
2488
+ /**
2489
+ * - Total amount including taxes and discounts.
2490
+ */
1455
2491
  total?: number;
2492
+ /**
2493
+ * - Identifier for the subscription
2494
+ * associated with the invoice.
2495
+ */
1456
2496
  subscription?: string;
2497
+ /**
2498
+ * - Scheduled time for the next action
2499
+ * related to the invoice.
2500
+ */
1457
2501
  next_action_time?: string;
2502
+ /**
2503
+ * - Timestamp when the invoice was created.
2504
+ */
1458
2505
  created_at?: string;
2506
+ /**
2507
+ * - Timestamp when the invoice was last modified.
2508
+ */
1459
2509
  modified_at?: string;
2510
+ /**
2511
+ * - Unique hash identifier for the invoice.
2512
+ */
1460
2513
  hash_identifier?: string;
1461
2514
  payment_method?: InvoicesDataPaymentMethod;
2515
+ /**
2516
+ * - List of items included in the invoice.
2517
+ */
1462
2518
  invoice_items?: InvoiceItems[];
2519
+ /**
2520
+ * - Type of invoice (e.g., extension, subscription).
2521
+ */
2522
+ invoice_type?: string;
1463
2523
  };
1464
2524
  /** @returns {Invoices} */
1465
2525
  declare function Invoices(): Invoices;
1466
2526
  type Invoices = {
1467
2527
  data?: InvoicesData[];
2528
+ /**
2529
+ * - Index of the first item in the results.
2530
+ */
1468
2531
  start?: number;
2532
+ /**
2533
+ * - Index of the last item in the results.
2534
+ */
1469
2535
  end?: number;
2536
+ /**
2537
+ * - Number of items per page.
2538
+ */
1470
2539
  limit?: number;
2540
+ /**
2541
+ * - Page number of the results.
2542
+ */
1471
2543
  page?: number;
2544
+ /**
2545
+ * - Total number of items available.
2546
+ */
1472
2547
  total?: number;
1473
2548
  };
1474
2549
  /** @returns {Phone} */
1475
2550
  declare function Phone(): Phone;
1476
2551
  type Phone = {
2552
+ /**
2553
+ * - The phone number of the contact.
2554
+ */
1477
2555
  phone_number?: string;
2556
+ /**
2557
+ * - The country code of the phone number.
2558
+ */
1478
2559
  phone_country_code?: string;
1479
2560
  };
1480
2561
  /** @returns {SubscriptionBillingAddress} */
1481
2562
  declare function SubscriptionBillingAddress(): SubscriptionBillingAddress;
1482
2563
  type SubscriptionBillingAddress = {
2564
+ /**
2565
+ * - Name of the country for the billing address.
2566
+ */
1483
2567
  country?: string;
2568
+ /**
2569
+ * - ISO country code for the billing address.
2570
+ */
2571
+ country_code?: string;
2572
+ /**
2573
+ * - State or province for the billing address.
2574
+ */
1484
2575
  state?: string;
2576
+ /**
2577
+ * - City for the billing address.
2578
+ */
1485
2579
  city?: string;
2580
+ /**
2581
+ * - First line of the street address.
2582
+ */
1486
2583
  line1?: string;
2584
+ /**
2585
+ * - Second line of the street address (optional).
2586
+ */
1487
2587
  line2?: string;
2588
+ /**
2589
+ * - Postal or ZIP code for the billing address.
2590
+ */
1488
2591
  postal_code?: string;
1489
2592
  };
1490
2593
  /** @returns {SubscriptionCustomer} */
@@ -1492,17 +2595,55 @@ declare function SubscriptionCustomer(): SubscriptionCustomer;
1492
2595
  type SubscriptionCustomer = {
1493
2596
  phone?: Phone;
1494
2597
  billing_address?: SubscriptionBillingAddress;
2598
+ /**
2599
+ * - Unique identifier for the subscriber.
2600
+ */
1495
2601
  _id?: string;
2602
+ /**
2603
+ * - Identifier specific to the company.
2604
+ */
1496
2605
  unique_id?: string;
2606
+ /**
2607
+ * - Type of the customer (e.g., developer, company).
2608
+ */
1497
2609
  type?: string;
2610
+ /**
2611
+ * - Name of the customer.
2612
+ */
1498
2613
  name?: string;
2614
+ /**
2615
+ * - Email address of the customer.
2616
+ */
1499
2617
  email?: string;
2618
+ /**
2619
+ * - Timestamp when the customer record was created.
2620
+ */
1500
2621
  created_at?: string;
2622
+ /**
2623
+ * - Timestamp when the customer record was
2624
+ * last modified.
2625
+ */
1501
2626
  modified_at?: string;
2627
+ /**
2628
+ * - Additional data related to the customer.
2629
+ */
1502
2630
  data?: any;
2631
+ /**
2632
+ * - Associated documents related to the customer.
2633
+ */
1503
2634
  documents?: any;
2635
+ /**
2636
+ * - Indicates whether the customer has given consent.
2637
+ */
1504
2638
  consent?: boolean;
2639
+ /**
2640
+ * - Indicates whether the customer has opted in for
2641
+ * communications.
2642
+ */
1505
2643
  comms?: boolean;
2644
+ /**
2645
+ * - Current credit balance for the customer, if any.
2646
+ */
1506
2647
  credit_balance?: number;
1507
2648
  business_country_info?: BusinessCountryInfo;
1508
2649
  };
@@ -1511,109 +2652,271 @@ declare function SubscriptionCustomerCreate(): SubscriptionCustomerCreate;
1511
2652
  type SubscriptionCustomerCreate = {
1512
2653
  phone?: Phone;
1513
2654
  billing_address?: SubscriptionBillingAddress;
2655
+ /**
2656
+ * - Company id for the customer, generated by the client.
2657
+ */
1514
2658
  unique_id?: string;
2659
+ /**
2660
+ * - Type of company
2661
+ */
1515
2662
  type?: string;
2663
+ /**
2664
+ * - Name of the company
2665
+ */
1516
2666
  name?: string;
2667
+ /**
2668
+ * - Email address of the company
2669
+ */
1517
2670
  email?: string;
1518
2671
  };
1519
2672
  /** @returns {SubscriptionCurrentPeriod} */
1520
2673
  declare function SubscriptionCurrentPeriod(): SubscriptionCurrentPeriod;
1521
2674
  type SubscriptionCurrentPeriod = {
2675
+ /**
2676
+ * - The start date and time of the current
2677
+ * subscription period.
2678
+ */
1522
2679
  start?: string;
2680
+ /**
2681
+ * - The end date and time of the current subscription period.
2682
+ */
1523
2683
  end?: string;
1524
2684
  };
1525
2685
  /** @returns {SubscriptionPauseCollection} */
1526
2686
  declare function SubscriptionPauseCollection(): SubscriptionPauseCollection;
1527
2687
  type SubscriptionPauseCollection = {
2688
+ /**
2689
+ * - Defines the behavior of the subscription when
2690
+ * it is paused. Possible values could include `keep_as_draft` or `cancel`.
2691
+ */
1528
2692
  behavior?: string;
2693
+ /**
2694
+ * - The date and time when the paused
2695
+ * subscription is scheduled to resume.
2696
+ */
1529
2697
  resume_at?: string;
1530
2698
  };
1531
2699
  /** @returns {SubscriptionTrial} */
1532
2700
  declare function SubscriptionTrial(): SubscriptionTrial;
1533
2701
  type SubscriptionTrial = {
2702
+ /**
2703
+ * - The start date and time of the subscription trial period.
2704
+ */
1534
2705
  start?: string;
2706
+ /**
2707
+ * - The end date and time of the subscription trial period.
2708
+ */
1535
2709
  end?: string;
1536
2710
  };
1537
2711
  /** @returns {SubscriptionInvoiceSettings} */
1538
2712
  declare function SubscriptionInvoiceSettings(): SubscriptionInvoiceSettings;
1539
2713
  type SubscriptionInvoiceSettings = {
2714
+ /**
2715
+ * - Indicates whether invoices are
2716
+ * automatically generated for the subscription.
2717
+ */
1540
2718
  generation?: boolean;
2719
+ /**
2720
+ * - Indicates whether charging is enabled for
2721
+ * the subscription. This setting determines if charges are applied based on
2722
+ * the invoice settings.
2723
+ */
1541
2724
  charging?: boolean;
1542
2725
  };
1543
2726
  /** @returns {Subscription} */
1544
2727
  declare function Subscription(): Subscription;
1545
2728
  type Subscription = {
2729
+ /**
2730
+ * - Additional metadata related to the subscription.
2731
+ */
1546
2732
  meta?: any;
1547
2733
  current_period?: SubscriptionCurrentPeriod;
1548
2734
  pause_collection?: SubscriptionPauseCollection;
1549
2735
  trial?: SubscriptionTrial;
1550
2736
  invoice_settings?: SubscriptionInvoiceSettings;
2737
+ /**
2738
+ * - Indicates whether the subscription is
2739
+ * currently active.
2740
+ */
1551
2741
  is_active?: boolean;
2742
+ /**
2743
+ * - Indicates whether the
2744
+ * subscription will be canceled at the end of the current period.
2745
+ */
1552
2746
  cancel_at_period_end?: boolean;
2747
+ /**
2748
+ * - Unique identifier for the subscription.
2749
+ */
1553
2750
  _id?: string;
2751
+ /**
2752
+ * - Unique identifier for the subscriber
2753
+ * associated with the subscription.
2754
+ */
1554
2755
  subscriber_id?: string;
2756
+ /**
2757
+ * - Unique identifier for the plan associated with
2758
+ * the subscription.
2759
+ */
1555
2760
  plan_id?: string;
2761
+ /**
2762
+ * - Unique identifier for the product
2763
+ * suite associated with the subscription.
2764
+ */
1556
2765
  product_suite_id?: string;
2766
+ /**
2767
+ * - Indicates whether the
2768
+ * subscriber is eligible to change their subscription plan.
2769
+ */
2770
+ is_eligible_for_plan_change?: boolean;
1557
2771
  plan_data?: Plan;
2772
+ /**
2773
+ * - The current status of the subscription
2774
+ * (e.g., active, canceled).
2775
+ */
1558
2776
  current_status?: string;
2777
+ /**
2778
+ * - Method used to collect payments for
2779
+ * the subscription (e.g., charge_automatically, invoice).
2780
+ */
1559
2781
  collection_method?: string;
2782
+ /**
2783
+ * - The date and time when the subscription was created.
2784
+ */
1560
2785
  created_at?: string;
2786
+ /**
2787
+ * - The date and time when the subscription
2788
+ * was last modified.
2789
+ */
1561
2790
  modified_at?: string;
2791
+ /**
2792
+ * - Unique identifier for the most recent
2793
+ * invoice related to the subscription.
2794
+ */
1562
2795
  latest_invoice?: string;
2796
+ /**
2797
+ * - Ordering channel for which the
2798
+ * subscription was created (e.g., ecomm, fynd).
2799
+ */
1563
2800
  channel_type?: string;
2801
+ /**
2802
+ * - Indicates whether the subscription is
2803
+ * currently freezed.
2804
+ */
1564
2805
  freezed?: boolean;
2806
+ /**
2807
+ * - The date and time when the subscription is
2808
+ * scheduled to be canceled, if applicable.
2809
+ */
1565
2810
  cancel_at?: string;
2811
+ /**
2812
+ * - The date and time when the subscription
2813
+ * was actually canceled.
2814
+ */
1566
2815
  canceled_at?: string;
1567
2816
  };
1568
2817
  /** @returns {SubscriptionStatus} */
1569
2818
  declare function SubscriptionStatus(): SubscriptionStatus;
1570
2819
  type SubscriptionStatus = {
2820
+ /**
2821
+ * - Indicates whether the subscription status
2822
+ * is enabled.
2823
+ */
1571
2824
  is_enabled?: boolean;
1572
2825
  subscription?: Subscription;
1573
2826
  latest_invoice?: InvoicesData;
1574
2827
  next_plan?: Plan;
2828
+ /**
2829
+ * - List of current
2830
+ * subscriptions associated with the user.
2831
+ */
1575
2832
  current_subscriptions?: Subscription[];
2833
+ /**
2834
+ * - The amount mandated for the
2835
+ * subscription or service.
2836
+ */
1576
2837
  mandate_amount?: number;
2838
+ /**
2839
+ * - A message providing additional context or
2840
+ * information about the subscription status.
2841
+ */
1577
2842
  message?: string;
1578
2843
  };
1579
2844
  /** @returns {SubscriptionLimitApplication} */
1580
2845
  declare function SubscriptionLimitApplication(): SubscriptionLimitApplication;
1581
2846
  type SubscriptionLimitApplication = {
2847
+ /**
2848
+ * - Indicates whether the application limit is enabled.
2849
+ */
1582
2850
  enabled?: boolean;
2851
+ /**
2852
+ * - The maximum number of applications allowed.
2853
+ */
1583
2854
  hard_limit?: number;
2855
+ /**
2856
+ * - The soft limit of applications allowed,
2857
+ * typically a warning threshold before reaching the hard limit.
2858
+ */
1584
2859
  soft_limit?: number;
1585
2860
  };
1586
2861
  /** @returns {SubscriptionLimitMarketplace} */
1587
2862
  declare function SubscriptionLimitMarketplace(): SubscriptionLimitMarketplace;
1588
2863
  type SubscriptionLimitMarketplace = {
2864
+ /**
2865
+ * - Indicates whether the marketplace limit is enabled.
2866
+ */
1589
2867
  enabled?: boolean;
1590
2868
  };
1591
2869
  /** @returns {SubscriptionLimitOtherPlatform} */
1592
2870
  declare function SubscriptionLimitOtherPlatform(): SubscriptionLimitOtherPlatform;
1593
2871
  type SubscriptionLimitOtherPlatform = {
2872
+ /**
2873
+ * - Indicates whether the other platform limit is enabled.
2874
+ */
1594
2875
  enabled?: boolean;
1595
2876
  };
1596
2877
  /** @returns {SubscriptionLimitTeam} */
1597
2878
  declare function SubscriptionLimitTeam(): SubscriptionLimitTeam;
1598
2879
  type SubscriptionLimitTeam = {
2880
+ /**
2881
+ * - The limit for team-related features.
2882
+ */
1599
2883
  limit?: number;
1600
2884
  };
1601
2885
  /** @returns {SubscriptionLimitProducts} */
1602
2886
  declare function SubscriptionLimitProducts(): SubscriptionLimitProducts;
1603
2887
  type SubscriptionLimitProducts = {
2888
+ /**
2889
+ * - Indicates whether bulk product limits are enabled.
2890
+ */
1604
2891
  bulk?: boolean;
2892
+ /**
2893
+ * - The limit for products.
2894
+ */
1605
2895
  limit?: number;
1606
2896
  };
1607
2897
  /** @returns {SubscriptionLimitExtensions} */
1608
2898
  declare function SubscriptionLimitExtensions(): SubscriptionLimitExtensions;
1609
2899
  type SubscriptionLimitExtensions = {
2900
+ /**
2901
+ * - Indicates whether the extensions limit is enabled.
2902
+ */
1610
2903
  enabled?: boolean;
2904
+ /**
2905
+ * - The limit for extensions.
2906
+ */
1611
2907
  limit?: number;
1612
2908
  };
1613
2909
  /** @returns {SubscriptionLimitIntegrations} */
1614
2910
  declare function SubscriptionLimitIntegrations(): SubscriptionLimitIntegrations;
1615
2911
  type SubscriptionLimitIntegrations = {
2912
+ /**
2913
+ * - Indicates whether the integrations limit is enabled.
2914
+ */
1616
2915
  enabled?: boolean;
2916
+ /**
2917
+ * - The limit for integrations. A value of `-1`
2918
+ * usually indicates no limit.
2919
+ */
1617
2920
  limit?: number;
1618
2921
  };
1619
2922
  /** @returns {SubscriptionLimit} */
@@ -1626,46 +2929,121 @@ type SubscriptionLimit = {
1626
2929
  products?: SubscriptionLimitProducts;
1627
2930
  extensions?: SubscriptionLimitExtensions;
1628
2931
  integrations?: SubscriptionLimitIntegrations;
2932
+ /**
2933
+ * - Indicates whether the subscription is
2934
+ * for a trial plan.
2935
+ */
1629
2936
  is_trial_plan?: boolean;
1630
2937
  };
1631
2938
  /** @returns {IntentReq} */
1632
2939
  declare function IntentReq(): IntentReq;
1633
2940
  type IntentReq = {
2941
+ /**
2942
+ * - A unique identifier for the
2943
+ * external resource, used to track and reference the request like company id.
2944
+ */
1634
2945
  unique_external_id?: string;
2946
+ /**
2947
+ * - The identifier for the plan associated with the intent.
2948
+ */
1635
2949
  plan_id?: string;
1636
2950
  };
1637
2951
  /** @returns {PutIntentReq} */
1638
2952
  declare function PutIntentReq(): PutIntentReq;
1639
2953
  type PutIntentReq = {
2954
+ /**
2955
+ * - A unique identifier for the
2956
+ * external resource, used to track and reference the request like company id.
2957
+ */
1640
2958
  unique_external_id?: string;
2959
+ /**
2960
+ * - The ID of the setup intent for payment
2961
+ * methods, if applicable.
2962
+ */
1641
2963
  setup_intent_id?: string;
2964
+ /**
2965
+ * - The ID of the payment method to use
2966
+ * for the intent.
2967
+ */
1642
2968
  payment_method_id?: string;
2969
+ /**
2970
+ * - Indicates whether the payment method
2971
+ * should be set as default.
2972
+ */
1643
2973
  set_default?: boolean;
1644
2974
  };
1645
2975
  /** @returns {SubscriptionActivateReq} */
1646
2976
  declare function SubscriptionActivateReq(): SubscriptionActivateReq;
1647
2977
  type SubscriptionActivateReq = {
2978
+ /**
2979
+ * - A unique identifier for the subscription
2980
+ * activation request.
2981
+ */
1648
2982
  unique_id?: string;
2983
+ /**
2984
+ * - The type of subscriber account, e.g., company or developer.
2985
+ */
1649
2986
  type?: string;
2987
+ /**
2988
+ * - The product suite associated with the
2989
+ * subscription.
2990
+ */
1650
2991
  product_suite?: string;
2992
+ /**
2993
+ * - The ID of the plan to be activated for the subscription.
2994
+ */
1651
2995
  plan_id?: string;
2996
+ /**
2997
+ * - The payment method ID to be used for
2998
+ * this subscription.
2999
+ */
1652
3000
  payment_method?: string;
3001
+ /**
3002
+ * - The ID of the subscription to be
3003
+ * activated, if applicable.
3004
+ */
1653
3005
  subscription_id?: string;
3006
+ /**
3007
+ * - A coupon code for applying discounts, if applicable.
3008
+ */
1654
3009
  coupon?: string;
3010
+ /**
3011
+ * - Additional metadata related to the subscription
3012
+ * activation request.
3013
+ */
1655
3014
  meta?: any;
1656
3015
  };
1657
3016
  /** @returns {SubscriptionActivateRes} */
1658
3017
  declare function SubscriptionActivateRes(): SubscriptionActivateRes;
1659
3018
  type SubscriptionActivateRes = {
3019
+ /**
3020
+ * - Indicates whether the subscription activation
3021
+ * was successful.
3022
+ */
1660
3023
  success?: boolean;
1661
3024
  data?: Subscription;
1662
3025
  };
1663
3026
  /** @returns {CancelSubscriptionReq} */
1664
3027
  declare function CancelSubscriptionReq(): CancelSubscriptionReq;
1665
3028
  type CancelSubscriptionReq = {
3029
+ /**
3030
+ * - A unique identifier for the subscription
3031
+ * cancellation request like company id.
3032
+ */
1666
3033
  unique_id?: string;
3034
+ /**
3035
+ * - The type of subscription to be canceled, e.g.,
3036
+ * company or developer.
3037
+ */
1667
3038
  type?: string;
3039
+ /**
3040
+ * - The product suite associated with the
3041
+ * subscription to be canceled.
3042
+ */
1668
3043
  product_suite?: string;
3044
+ /**
3045
+ * - The ID of the subscription to be canceled.
3046
+ */
1669
3047
  subscription_id?: string;
1670
3048
  };
1671
3049
  /** @returns {CancelSubscriptionRes} */
@@ -1677,159 +3055,442 @@ type CancelSubscriptionRes = {
1677
3055
  /** @returns {PlanStatusUpdateReq} */
1678
3056
  declare function PlanStatusUpdateReq(): PlanStatusUpdateReq;
1679
3057
  type PlanStatusUpdateReq = {
3058
+ /**
3059
+ * - The identifier of the plan whose status is
3060
+ * being updated.
3061
+ */
1680
3062
  plan_id?: string;
3063
+ /**
3064
+ * - The reason for updating the plan status.
3065
+ */
1681
3066
  reason?: string;
3067
+ /**
3068
+ * - The new status of the plan as set by the
3069
+ * seller (e.g., approved, rejected, pending).
3070
+ */
1682
3071
  seller_status?: string;
1683
3072
  };
1684
- /** @returns {SunscribePlan} */
1685
- declare function SunscribePlan(): SunscribePlan;
1686
- type SunscribePlan = {
3073
+ /** @returns {SubscribePlan} */
3074
+ declare function SubscribePlan(): SubscribePlan;
3075
+ type SubscribePlan = {
3076
+ /**
3077
+ * - The type of entity for which the plan is
3078
+ * being subscribed (e.g., subscription, extension).
3079
+ */
1687
3080
  entity_type?: string;
3081
+ /**
3082
+ * - The method of collection for the
3083
+ * subscription (e.g., online, offline).
3084
+ */
1688
3085
  collection_type?: string;
3086
+ /**
3087
+ * - The identifier of the plan to subscribe to.
3088
+ */
1689
3089
  plan_id?: string;
3090
+ /**
3091
+ * - URL to which the payment result will be sent
3092
+ */
1690
3093
  callback_url?: string;
1691
3094
  meta?: Meta;
1692
3095
  };
1693
3096
  /** @returns {Meta} */
1694
3097
  declare function Meta(): Meta;
1695
3098
  type Meta = {
3099
+ /**
3100
+ * - Indicates whether the subscription is being
3101
+ * initiated.
3102
+ */
1696
3103
  subscribe?: boolean;
3104
+ /**
3105
+ * - Indicates if the plan is a custom plan
3106
+ * rather than a standard one.
3107
+ */
1697
3108
  is_custom_plan?: boolean;
3109
+ /**
3110
+ * - Indicates whether this subscription
3111
+ * is an upgrade from a previous plan.
3112
+ */
1698
3113
  is_plan_upgrade?: boolean;
1699
3114
  };
1700
3115
  /** @returns {SubscribePlanRes} */
1701
3116
  declare function SubscribePlanRes(): SubscribePlanRes;
1702
3117
  type SubscribePlanRes = {
3118
+ /**
3119
+ * - The URL to which the user should be
3120
+ * redirected after completion of subscription process.
3121
+ */
1703
3122
  redirect_url?: string;
3123
+ /**
3124
+ * - The unique identifier for the
3125
+ * subscription transaction.
3126
+ */
1704
3127
  transaction_id?: string;
3128
+ /**
3129
+ * - The current status of the subscription
3130
+ * process (e.g., initiated, success, failed).
3131
+ */
1705
3132
  current_status?: string;
1706
3133
  meta?: Meta;
1707
3134
  };
1708
3135
  /** @returns {EntityDetail} */
1709
3136
  declare function EntityDetail(): EntityDetail;
1710
3137
  type EntityDetail = {
3138
+ /**
3139
+ * - Specifies the type of entity (e.g., subscription, user).
3140
+ */
1711
3141
  entity?: string;
1712
3142
  item?: Subscription;
1713
3143
  };
1714
3144
  /** @returns {PaymentOptions} */
1715
3145
  declare function PaymentOptions(): PaymentOptions;
1716
3146
  type PaymentOptions = {
3147
+ /**
3148
+ * - Unique identifier for the payment option.
3149
+ */
1717
3150
  _id?: string;
3151
+ /**
3152
+ * - Name of the payment option.
3153
+ */
1718
3154
  name?: string;
3155
+ /**
3156
+ * - Brief description of the payment option's
3157
+ * functionality.
3158
+ */
1719
3159
  description?: string;
3160
+ /**
3161
+ * - URL of the payment option's logo like upi logo.
3162
+ */
1720
3163
  logo?: string;
3164
+ /**
3165
+ * - Unique identifier for the payment aggregator.
3166
+ */
1721
3167
  aggregator_id?: string;
3168
+ /**
3169
+ * - Identifier for the payment aggregator system.
3170
+ */
1722
3171
  aggregator?: string;
3172
+ /**
3173
+ * - Date and time when the payment option was created.
3174
+ */
1723
3175
  created_at?: string;
1724
- modified_at?: string;
3176
+ /**
3177
+ * - Date and time when the payment option was
3178
+ * last modified.
3179
+ */
3180
+ modified_at?: string;
3181
+ /**
3182
+ * - Version key for document revision control.
3183
+ */
1725
3184
  __v?: number;
1726
3185
  };
1727
3186
  /** @returns {VerifyPaymentReq} */
1728
3187
  declare function VerifyPaymentReq(): VerifyPaymentReq;
1729
3188
  type VerifyPaymentReq = {
3189
+ /**
3190
+ * - Unique identifier for the Razorpay payment.
3191
+ */
1730
3192
  razorpay_payment_id?: string;
3193
+ /**
3194
+ * - Unique identifier for the Razorpay order.
3195
+ */
1731
3196
  razorpay_order_id?: string;
3197
+ /**
3198
+ * - Signature generated by Razorpay to
3199
+ * verify the payment.
3200
+ */
1732
3201
  razorpay_signature?: string;
3202
+ /**
3203
+ * - HTTP status code of the payment
3204
+ * verification response.
3205
+ */
1733
3206
  status_code?: number;
3207
+ /**
3208
+ * - The payment provider used for the transaction.
3209
+ */
1734
3210
  provider_type?: string;
1735
3211
  };
1736
3212
  /** @returns {Documents} */
1737
3213
  declare function Documents(): Documents;
1738
3214
  type Documents = {
3215
+ /**
3216
+ * - Permanent Account Number (PAN) used for tax purposes.
3217
+ */
1739
3218
  pan?: string;
3219
+ /**
3220
+ * - Goods and Services Tax (GST) number for business taxation.
3221
+ */
1740
3222
  gst?: string;
1741
3223
  };
1742
3224
  /** @returns {BillingAddress} */
1743
3225
  declare function BillingAddress(): BillingAddress;
1744
3226
  type BillingAddress = {
3227
+ /**
3228
+ * - The country where the billing address is located.
3229
+ */
1745
3230
  country?: string;
3231
+ /**
3232
+ * - The state or region within the country.
3233
+ */
1746
3234
  state?: string;
3235
+ /**
3236
+ * - The city of the billing address.
3237
+ */
1747
3238
  city?: string;
3239
+ /**
3240
+ * - The first line of the billing address.
3241
+ */
1748
3242
  line1?: string;
3243
+ /**
3244
+ * - The second line of the billing address (if applicable).
3245
+ */
1749
3246
  line2?: string;
3247
+ /**
3248
+ * - The ZIP code of the billing address.
3249
+ */
1750
3250
  postal_code?: string;
3251
+ /**
3252
+ * - ISO country code for the country of the
3253
+ * billing address.
3254
+ */
1751
3255
  country_code?: string;
1752
3256
  };
1753
3257
  /** @returns {Currency} */
1754
3258
  declare function Currency(): Currency;
1755
3259
  type Currency = {
3260
+ /**
3261
+ * - Currency code as per ISO 4217.
3262
+ */
1756
3263
  code?: string;
3264
+ /**
3265
+ * - Symbol representing the currency.
3266
+ */
1757
3267
  symbol?: string;
3268
+ /**
3269
+ * - Full name of the currency.
3270
+ */
1758
3271
  name?: string;
1759
3272
  };
1760
3273
  /** @returns {BusinessCountryInfo} */
1761
3274
  declare function BusinessCountryInfo(): BusinessCountryInfo;
1762
3275
  type BusinessCountryInfo = {
3276
+ /**
3277
+ * - The country where the business is registered.
3278
+ */
1763
3279
  country?: string;
3280
+ /**
3281
+ * - ISO country code for the business's country.
3282
+ */
1764
3283
  country_code?: string;
1765
3284
  currency?: Currency;
3285
+ /**
3286
+ * - Timezone in which the business operates.
3287
+ */
1766
3288
  timezone?: string;
1767
3289
  };
1768
3290
  /** @returns {SubscriberData} */
1769
3291
  declare function SubscriberData(): SubscriberData;
1770
3292
  type SubscriberData = {
3293
+ /**
3294
+ * - Indicates if the user exists in the
3295
+ * payment gateway system.
3296
+ */
1771
3297
  pg_user_exists?: boolean;
1772
- id?: any;
3298
+ /**
3299
+ * - Unique identifier for the subscriber.
3300
+ */
3301
+ id?: string;
3302
+ /**
3303
+ * - Unique customer ID assigned by the
3304
+ * payment gateway.
3305
+ */
1773
3306
  pg_customer_id?: string;
3307
+ /**
3308
+ * - Identifier for the default
3309
+ * payment method used by the subscriber.
3310
+ */
1774
3311
  default_payment_method?: string;
1775
3312
  };
1776
3313
  /** @returns {Subscriber} */
1777
3314
  declare function Subscriber(): Subscriber;
1778
3315
  type Subscriber = {
1779
3316
  documents?: Documents;
3317
+ /**
3318
+ * - Contact information for the subscriber, such as
3319
+ * phone number.
3320
+ */
1780
3321
  phone?: any;
1781
3322
  billing_address?: BillingAddress;
3323
+ /**
3324
+ * - Indicates whether the subscriber has given
3325
+ * consent for processing.
3326
+ */
1782
3327
  consent?: boolean;
3328
+ /**
3329
+ * - Indicates whether the subscriber has opted in
3330
+ * for communications.
3331
+ */
1783
3332
  comms?: boolean;
3333
+ /**
3334
+ * - Unique identifier for the subscriber in the system.
3335
+ */
1784
3336
  _id?: string;
3337
+ /**
3338
+ * - The type of the subscriber, such as 'individual'
3339
+ * or 'company'.
3340
+ */
1785
3341
  type?: string;
3342
+ /**
3343
+ * - A unique identifier assigned to the subscriber.
3344
+ */
1786
3345
  unique_id?: string;
3346
+ /**
3347
+ * - The name of the subscriber.
3348
+ */
1787
3349
  name?: string;
3350
+ /**
3351
+ * - Email address of the subscriber.
3352
+ */
1788
3353
  email?: string;
1789
3354
  business_country_info?: BusinessCountryInfo;
3355
+ /**
3356
+ * - The date and time when the subscriber was created.
3357
+ */
1790
3358
  created_at?: string;
3359
+ /**
3360
+ * - The date and time when the subscriber
3361
+ * details were last modified.
3362
+ */
1791
3363
  modified_at?: string;
3364
+ /**
3365
+ * - The current credit balance for the
3366
+ * subscriber, if any.
3367
+ */
1792
3368
  credit_balance?: number;
1793
3369
  data?: SubscriberData;
1794
3370
  };
3371
+ /** @returns {AuthorModifiedDetails} */
3372
+ declare function AuthorModifiedDetails(): AuthorModifiedDetails;
3373
+ type AuthorModifiedDetails = {
3374
+ /**
3375
+ * - The first name of the author who made modifications.
3376
+ */
3377
+ first_name?: string;
3378
+ /**
3379
+ * - The last name of the author who made modifications.
3380
+ */
3381
+ last_name?: string;
3382
+ /**
3383
+ * - Indicates whether the author has
3384
+ * administrative privileges.
3385
+ */
3386
+ is_admin?: boolean;
3387
+ };
1795
3388
  /** @returns {Author} */
1796
3389
  declare function Author(): Author;
1797
3390
  type Author = {
1798
- modified_by_details?: any;
3391
+ modified_by_details?: AuthorModifiedDetails;
3392
+ /**
3393
+ * - Identifier of the user who created the record.
3394
+ */
3395
+ created_by?: string;
3396
+ /**
3397
+ * - Identifier of the user who last modified the record.
3398
+ */
3399
+ modified_by?: string;
1799
3400
  };
1800
3401
  /** @returns {EndingBalance} */
1801
3402
  declare function EndingBalance(): EndingBalance;
1802
3403
  type EndingBalance = {
3404
+ /**
3405
+ * - The ending balance amount.
3406
+ */
1803
3407
  amount?: number;
3408
+ /**
3409
+ * - Reference to the previous entry if applicable.
3410
+ */
1804
3411
  old_entry_ref?: string;
1805
3412
  };
1806
3413
  /** @returns {PaymentData} */
1807
3414
  declare function PaymentData(): PaymentData;
1808
3415
  type PaymentData = {
3416
+ /**
3417
+ * - The unique identifier for the transaction.
3418
+ */
1809
3419
  transaction_id?: string;
3420
+ /**
3421
+ * - The payment aggregator used for the transaction.
3422
+ */
1810
3423
  aggregator?: string;
3424
+ /**
3425
+ * - The order ID generated by the
3426
+ * payment aggregator.
3427
+ */
1811
3428
  aggregator_order_id?: string;
3429
+ /**
3430
+ * - The date and time when the receipt was generated.
3431
+ */
3432
+ receipt_date?: string;
3433
+ /**
3434
+ * - A unique reference for
3435
+ * the transaction.
3436
+ */
3437
+ unique_transaction_reference?: string;
1812
3438
  };
1813
3439
  /** @returns {CreditTransaction} */
1814
3440
  declare function CreditTransaction(): CreditTransaction;
1815
3441
  type CreditTransaction = {
3442
+ /**
3443
+ * - The entity associated with the transaction.
3444
+ */
1816
3445
  entity?: any;
1817
3446
  author?: Author;
3447
+ /**
3448
+ * - The unique identifier for the credit transaction.
3449
+ */
1818
3450
  _id?: string;
3451
+ /**
3452
+ * - The amount credited in the transaction.
3453
+ */
1819
3454
  amount?: number;
3455
+ /**
3456
+ * - The currency of the transaction amount.
3457
+ */
1820
3458
  currency?: string;
3459
+ /**
3460
+ * - The unique identifier of the subscriber
3461
+ * involved in the transaction.
3462
+ */
1821
3463
  subscriber_id?: string;
3464
+ /**
3465
+ * - A brief description of the transaction.
3466
+ */
1822
3467
  description?: string;
1823
- is_test?: any;
3468
+ /**
3469
+ * - Indicates if the transaction is a test transaction.
3470
+ */
3471
+ is_test?: string;
1824
3472
  ending_balance?: EndingBalance;
1825
3473
  payment?: PaymentData;
3474
+ /**
3475
+ * - The type of credit transaction.
3476
+ */
1826
3477
  type?: string;
3478
+ /**
3479
+ * - The date and time when the transaction was created.
3480
+ */
1827
3481
  created_at?: string;
3482
+ /**
3483
+ * - The date and time when the transaction was
3484
+ * last modified.
3485
+ */
1828
3486
  modified_at?: string;
1829
3487
  };
1830
3488
  /** @returns {VerifyPaymentData} */
1831
3489
  declare function VerifyPaymentData(): VerifyPaymentData;
1832
3490
  type VerifyPaymentData = {
3491
+ /**
3492
+ * - Indicates if the payment verification was successful.
3493
+ */
1833
3494
  success?: boolean;
1834
3495
  subscriber?: Subscriber;
1835
3496
  credit_transaction?: CreditTransaction;
@@ -1837,12 +3498,18 @@ type VerifyPaymentData = {
1837
3498
  /** @returns {VerifyPaymentRes} */
1838
3499
  declare function VerifyPaymentRes(): VerifyPaymentRes;
1839
3500
  type VerifyPaymentRes = {
3501
+ /**
3502
+ * - The status of the payment verification.
3503
+ */
1840
3504
  status?: string;
1841
3505
  data?: VerifyPaymentData;
1842
3506
  };
1843
3507
  /** @returns {DefaultMerchants} */
1844
3508
  declare function DefaultMerchants(): DefaultMerchants;
1845
3509
  type DefaultMerchants = {
3510
+ /**
3511
+ * - The default Stripe merchant identifier.
3512
+ */
1846
3513
  stripe?: string;
1847
3514
  };
1848
3515
  /** @returns {GlobalSettingsPayment} */
@@ -1854,279 +3521,627 @@ type GlobalSettingsPayment = {
1854
3521
  declare function GlobalSettingsData(): GlobalSettingsData;
1855
3522
  type GlobalSettingsData = {
1856
3523
  payment?: GlobalSettingsPayment;
3524
+ /**
3525
+ * - Indicates if the panel is frozen.
3526
+ */
1857
3527
  freeze_panel?: boolean;
3528
+ /**
3529
+ * - Unique identifier for the global settings.
3530
+ */
1858
3531
  _id?: string;
3532
+ /**
3533
+ * - The date and time when the global settings
3534
+ * were created.
3535
+ */
1859
3536
  created_at?: string;
3537
+ /**
3538
+ * - The date and time when the global settings
3539
+ * were last modified.
3540
+ */
1860
3541
  modified_at?: string;
1861
3542
  };
1862
3543
  /** @returns {GlobalSettings} */
1863
3544
  declare function GlobalSettings(): GlobalSettings;
1864
3545
  type GlobalSettings = {
3546
+ /**
3547
+ * - The status of the global settings retrieval.
3548
+ */
1865
3549
  status?: string;
1866
3550
  data?: GlobalSettingsData;
1867
3551
  };
1868
3552
  /** @returns {MethodChecks} */
1869
3553
  declare function MethodChecks(): MethodChecks;
1870
3554
  type MethodChecks = {
3555
+ /**
3556
+ * - Result of the address line 1 check.
3557
+ */
1871
3558
  address_line1_check?: string;
3559
+ /**
3560
+ * - Result of the address postal
3561
+ * code check.
3562
+ */
1872
3563
  address_postal_code_check?: string;
3564
+ /**
3565
+ * - Result of the CVC check.
3566
+ */
1873
3567
  cvc_check?: string;
1874
3568
  };
1875
3569
  /** @returns {MethodNetworks} */
1876
3570
  declare function MethodNetworks(): MethodNetworks;
1877
3571
  type MethodNetworks = {
3572
+ /**
3573
+ * - List of available networks for the payment method.
3574
+ */
1878
3575
  available?: string[];
3576
+ /**
3577
+ * - Preferred network for the payment method.
3578
+ */
1879
3579
  preferred?: string;
1880
3580
  };
1881
3581
  /** @returns {MethodSecureUsage} */
1882
3582
  declare function MethodSecureUsage(): MethodSecureUsage;
1883
3583
  type MethodSecureUsage = {
3584
+ /**
3585
+ * - Indicates if 3D Secure is supported for the
3586
+ * payment method.
3587
+ */
1884
3588
  supported?: boolean;
1885
3589
  };
1886
3590
  /** @returns {MethodDetails} */
1887
3591
  declare function MethodDetails(): MethodDetails;
1888
3592
  type MethodDetails = {
3593
+ /**
3594
+ * - Unique identifier for the payment method.
3595
+ */
1889
3596
  id?: string;
3597
+ /**
3598
+ * - Type of payment method.
3599
+ */
1890
3600
  type?: string;
3601
+ /**
3602
+ * - Indicates if a mandate is available
3603
+ * for the payment method.
3604
+ */
1891
3605
  mandate_available?: boolean;
3606
+ /**
3607
+ * - Mandate amount for the payment method.
3608
+ */
1892
3609
  mandate_amount?: number;
3610
+ /**
3611
+ * - Payment gateway's payment method
3612
+ * identifier.
3613
+ */
1893
3614
  pg_payment_method_id?: string;
3615
+ /**
3616
+ * - Indicates if the payment method is the default.
3617
+ */
1894
3618
  is_default?: boolean;
1895
3619
  data?: SubscriptionMethodData;
1896
3620
  };
1897
3621
  /** @returns {SubscriptionMethodData} */
1898
3622
  declare function SubscriptionMethodData(): SubscriptionMethodData;
1899
3623
  type SubscriptionMethodData = {
3624
+ /**
3625
+ * - Brand of the payment method.
3626
+ */
1900
3627
  brand?: string;
1901
3628
  checks?: MethodChecks;
3629
+ /**
3630
+ * - Country of the payment method.
3631
+ */
1902
3632
  country?: string;
3633
+ /**
3634
+ * - Expiration month of the payment method.
3635
+ */
1903
3636
  exp_month?: number;
3637
+ /**
3638
+ * - Expiration year of the payment method.
3639
+ */
1904
3640
  exp_year?: number;
3641
+ /**
3642
+ * - Fingerprint of the payment method.
3643
+ */
1905
3644
  fingerprint?: string;
3645
+ /**
3646
+ * - Funding type of the payment method.
3647
+ */
1906
3648
  funding?: string;
3649
+ /**
3650
+ * - Source from which the payment method
3651
+ * was generated.
3652
+ */
1907
3653
  generated_from?: string;
3654
+ /**
3655
+ * - Last 4 digits of the payment method.
3656
+ */
1908
3657
  last4?: string;
1909
3658
  networks?: MethodNetworks;
1910
3659
  three_d_secure_usage?: MethodSecureUsage;
3660
+ /**
3661
+ * - Wallet associated with the payment method.
3662
+ */
1911
3663
  wallet?: string;
3664
+ /**
3665
+ * - Name associated with the payment method.
3666
+ */
1912
3667
  name?: string;
3668
+ /**
3669
+ * - Indicates if the payment method is the default.
3670
+ */
1913
3671
  is_default?: boolean;
1914
3672
  };
1915
3673
  /** @returns {SubscriptionMethods} */
1916
3674
  declare function SubscriptionMethods(): SubscriptionMethods;
1917
3675
  type SubscriptionMethods = {
3676
+ /**
3677
+ * - Indicates if the retrieval of subscription
3678
+ * methods was successful.
3679
+ */
1918
3680
  success?: boolean;
3681
+ /**
3682
+ * - List of subscription methods.
3683
+ */
1919
3684
  data?: MethodDetails[];
1920
3685
  };
1921
3686
  /** @returns {ConfigPublicKey} */
1922
3687
  declare function ConfigPublicKey(): ConfigPublicKey;
1923
3688
  type ConfigPublicKey = {
3689
+ /**
3690
+ * - Public key for the payment aggregator.
3691
+ */
1924
3692
  public_key?: string;
1925
3693
  };
1926
3694
  /** @returns {ConfigRes} */
1927
3695
  declare function ConfigRes(): ConfigRes;
1928
3696
  type ConfigRes = {
3697
+ /**
3698
+ * - Indicates if the retrieval of configuration
3699
+ * was successful.
3700
+ */
1929
3701
  success?: boolean;
3702
+ /**
3703
+ * - The payment aggregator.
3704
+ */
1930
3705
  aggregator?: string;
1931
3706
  config?: ConfigPublicKey;
1932
3707
  };
1933
3708
  /** @returns {PlanChangeData} */
1934
3709
  declare function PlanChangeData(): PlanChangeData;
1935
3710
  type PlanChangeData = {
3711
+ /**
3712
+ * - The total amount after the plan change.
3713
+ */
1936
3714
  total?: number;
3715
+ /**
3716
+ * - The amount credited due to the plan change.
3717
+ */
1937
3718
  credit_note_amount?: number;
3719
+ /**
3720
+ * - The settlement amount for the plan change.
3721
+ */
1938
3722
  settlement?: number;
3723
+ /**
3724
+ * - The taxable amount for the plan change.
3725
+ */
1939
3726
  taxable_amount?: number;
3727
+ /**
3728
+ * - The GST amount for the plan change.
3729
+ */
1940
3730
  gst_amount?: number;
3731
+ /**
3732
+ * - The gross total amount for the plan change.
3733
+ */
1941
3734
  gross_total?: number;
3735
+ /**
3736
+ * - The GST for the plan change.
3737
+ */
1942
3738
  gst?: number;
3739
+ /**
3740
+ * - The discount amount applied to the plan change.
3741
+ */
1943
3742
  discount?: number;
1944
3743
  };
1945
3744
  /** @returns {PlanChangeDetails} */
1946
3745
  declare function PlanChangeDetails(): PlanChangeDetails;
1947
3746
  type PlanChangeDetails = {
3747
+ /**
3748
+ * - Status of the plan change.
3749
+ */
1948
3750
  status?: string;
1949
3751
  data?: PlanChangeData;
1950
3752
  };
1951
3753
  /** @returns {TransactionMeta} */
1952
3754
  declare function TransactionMeta(): TransactionMeta;
1953
3755
  type TransactionMeta = {
3756
+ /**
3757
+ * - Invoice ID associated with the transaction.
3758
+ */
1954
3759
  invoice_id?: string;
1955
3760
  };
1956
3761
  /** @returns {PaymentTransactionDetails} */
1957
3762
  declare function PaymentTransactionDetails(): PaymentTransactionDetails;
1958
3763
  type PaymentTransactionDetails = {
3764
+ /**
3765
+ * - Payment aggregator details.
3766
+ */
1959
3767
  aggregator?: any;
3768
+ /**
3769
+ * - Currency used in the transaction.
3770
+ */
1960
3771
  currency?: string;
3772
+ /**
3773
+ * - Current status of the transaction.
3774
+ */
1961
3775
  current_status?: string;
3776
+ /**
3777
+ * - Unique identifier for the payment transaction.
3778
+ */
1962
3779
  _id?: string;
3780
+ /**
3781
+ * - Unique identifier for the subscriber.
3782
+ */
1963
3783
  subscriber_id?: string;
3784
+ /**
3785
+ * - Amount involved in the transaction.
3786
+ */
1964
3787
  amount?: number;
3788
+ /**
3789
+ * - Type of entity involved in the transaction.
3790
+ */
1965
3791
  entity_type?: string;
3792
+ /**
3793
+ * - Type of collection for the transaction.
3794
+ */
1966
3795
  collection_type?: string;
1967
3796
  meta?: TransactionMeta;
3797
+ /**
3798
+ * - Timestamp when the transaction was created.
3799
+ */
1968
3800
  created_at?: string;
3801
+ /**
3802
+ * - Timestamp when the transaction was last modified.
3803
+ */
1969
3804
  modified_at?: string;
1970
3805
  };
1971
3806
  /** @returns {PaymentItems} */
1972
3807
  declare function PaymentItems(): PaymentItems;
1973
3808
  type PaymentItems = {
3809
+ /**
3810
+ * - Name of the payment option.
3811
+ */
1974
3812
  name?: string;
3813
+ /**
3814
+ * - Code for the payment option
3815
+ */
1975
3816
  code?: string;
3817
+ /**
3818
+ * - Aggregator used for the payment option.
3819
+ */
1976
3820
  aggregator?: string;
1977
3821
  };
1978
3822
  /** @returns {GetPaymentOptions} */
1979
3823
  declare function GetPaymentOptions(): GetPaymentOptions;
1980
3824
  type GetPaymentOptions = {
3825
+ /**
3826
+ * - List of available payment options.
3827
+ */
1981
3828
  payment_options?: PaymentItems[];
1982
3829
  };
1983
3830
  /** @returns {TopupReq} */
1984
3831
  declare function TopupReq(): TopupReq;
1985
3832
  type TopupReq = {
3833
+ /**
3834
+ * - Amount to be topped up.
3835
+ */
1986
3836
  amount?: number;
3837
+ /**
3838
+ * - Currency in which the top-up is made.
3839
+ */
1987
3840
  currency?: string;
3841
+ /**
3842
+ * - Provider type for the top-up.
3843
+ */
1988
3844
  provider_type?: string;
1989
3845
  };
1990
3846
  /** @returns {SetupMandateReq} */
1991
3847
  declare function SetupMandateReq(): SetupMandateReq;
1992
3848
  type SetupMandateReq = {
3849
+ /**
3850
+ * - ID of the setup intent.
3851
+ */
1993
3852
  intent_id?: string;
3853
+ /**
3854
+ * - ID of the payment method.
3855
+ */
1994
3856
  payment_method_id?: string;
1995
3857
  };
1996
3858
  /** @returns {SetupPaymentReq} */
1997
3859
  declare function SetupPaymentReq(): SetupPaymentReq;
1998
3860
  type SetupPaymentReq = {
3861
+ /**
3862
+ * - Payment method to be used.
3863
+ */
1999
3864
  payment_method?: string;
3865
+ /**
3866
+ * - ID of the payment.
3867
+ */
2000
3868
  payment_id?: string;
3869
+ /**
3870
+ * - ID of the plan.
3871
+ */
2001
3872
  plan_id?: string;
3873
+ /**
3874
+ * - ID of the invoice.
3875
+ */
2002
3876
  invoice_id?: string;
2003
3877
  };
2004
3878
  /** @returns {SubscriptionRenewReq} */
2005
3879
  declare function SubscriptionRenewReq(): SubscriptionRenewReq;
2006
3880
  type SubscriptionRenewReq = {
3881
+ /**
3882
+ * - ID of the invoice for renewal.
3883
+ */
2007
3884
  invoice_id?: string;
3885
+ /**
3886
+ * - Type of entity for the renewal.
3887
+ */
2008
3888
  entity_type?: string;
3889
+ /**
3890
+ * - Collection type for the renewal.
3891
+ */
2009
3892
  collection_type?: string;
3893
+ /**
3894
+ * - URL to which the payment result will be sent
3895
+ */
2010
3896
  callback_url?: string;
2011
3897
  meta?: RenewMeta;
2012
3898
  };
2013
3899
  /** @returns {RenewMeta} */
2014
3900
  declare function RenewMeta(): RenewMeta;
2015
3901
  type RenewMeta = {
3902
+ /**
3903
+ * - Indicates whether the invoice payment
3904
+ * is involved in the renewal.
3905
+ */
2016
3906
  invoice_payment?: boolean;
3907
+ /**
3908
+ * - Indicates whether the subscription is being renewed.
3909
+ */
2017
3910
  renew?: boolean;
2018
3911
  };
2019
3912
  /** @returns {SubscriptionMethodsReq} */
2020
3913
  declare function SubscriptionMethodsReq(): SubscriptionMethodsReq;
2021
3914
  type SubscriptionMethodsReq = {
3915
+ /**
3916
+ * - The unique external identifier for
3917
+ * the subscription method.
3918
+ */
2022
3919
  unique_external_id?: string;
3920
+ /**
3921
+ * - The setup intent ID for the subscription method.
3922
+ */
2023
3923
  setup_intent_id?: string;
3924
+ /**
3925
+ * - The payment gateway payment method ID.
3926
+ */
2024
3927
  pg_payment_method_id?: string;
3928
+ /**
3929
+ * - Indicates whether this payment method
3930
+ * should be set as the default.
3931
+ */
2025
3932
  set_default?: boolean;
2026
3933
  };
2027
3934
  /** @returns {CreditTransactionResponse} */
2028
3935
  declare function CreditTransactionResponse(): CreditTransactionResponse;
2029
3936
  type CreditTransactionResponse = {
2030
3937
  /**
2031
- * - Total number of transactions
3938
+ * - Total number of transactions.
2032
3939
  */
2033
3940
  total?: number;
2034
3941
  /**
2035
- * - Maximum number of transactions per page
3942
+ * - Maximum number of transactions per page.
2036
3943
  */
2037
3944
  limit?: number;
2038
3945
  /**
2039
- * - Current page number
3946
+ * - Current page number.
2040
3947
  */
2041
3948
  page?: number;
2042
3949
  /**
2043
- * - Total number of pages
3950
+ * - Total number of pages.
2044
3951
  */
2045
3952
  pages?: number;
3953
+ /**
3954
+ * - List of credit transactions.
3955
+ */
2046
3956
  items?: CreditTransaction[];
2047
3957
  };
2048
3958
  /** @returns {DowngradePlanReq} */
2049
3959
  declare function DowngradePlanReq(): DowngradePlanReq;
2050
3960
  type DowngradePlanReq = {
3961
+ /**
3962
+ * - Unique identifier for the request.
3963
+ */
2051
3964
  unique_id?: string;
3965
+ /**
3966
+ * - Type of entity requesting the downgrade.
3967
+ */
2052
3968
  type?: string;
3969
+ /**
3970
+ * - Product suite for the plan.
3971
+ */
2053
3972
  product_suite?: string;
3973
+ /**
3974
+ * - Plan ID for the downgrade request.
3975
+ */
2054
3976
  plan_id?: string;
3977
+ /**
3978
+ * - Reason for downgrading the plan.
3979
+ */
2055
3980
  reason?: string;
3981
+ /**
3982
+ * - Platform from which the request is made.
3983
+ */
2056
3984
  platform?: string;
2057
3985
  };
2058
3986
  /** @returns {Taxation} */
2059
3987
  declare function Taxation(): Taxation;
2060
3988
  type Taxation = {
2061
3989
  /**
2062
- * - GST percentage
3990
+ * - GST percentage.
2063
3991
  */
2064
3992
  gst?: number;
2065
3993
  };
2066
3994
  /** @returns {OneTimeFees} */
2067
3995
  declare function OneTimeFees(): OneTimeFees;
2068
3996
  type OneTimeFees = {
3997
+ /**
3998
+ * - One-time development fee.
3999
+ */
2069
4000
  developement?: number;
4001
+ /**
4002
+ * - One-time marketing fee.
4003
+ */
2070
4004
  marketing?: number;
2071
4005
  };
2072
4006
  /** @returns {CreditLine} */
2073
4007
  declare function CreditLine(): CreditLine;
2074
4008
  type CreditLine = {
4009
+ /**
4010
+ * - Indicates whether the credit line is active.
4011
+ */
2075
4012
  is_active?: boolean;
2076
4013
  };
2077
4014
  /** @returns {StatusMessage} */
2078
4015
  declare function StatusMessage(): StatusMessage;
2079
4016
  type StatusMessage = {
4017
+ /**
4018
+ * - Status of the request.
4019
+ */
2080
4020
  status?: string;
4021
+ /**
4022
+ * - Detailed message regarding the status.
4023
+ */
2081
4024
  message?: string;
4025
+ /**
4026
+ * - Indicates whether the operation was successful.
4027
+ */
2082
4028
  success?: boolean;
4029
+ /**
4030
+ * - Status code of the operation.
4031
+ */
2083
4032
  code?: string;
2084
4033
  };
2085
4034
  /** @returns {PaymentCollectReq} */
2086
4035
  declare function PaymentCollectReq(): PaymentCollectReq;
2087
4036
  type PaymentCollectReq = {
4037
+ /**
4038
+ * - ID of the transaction to collect payment for.
4039
+ */
2088
4040
  transaction_id?: string;
4041
+ /**
4042
+ * - Indicates whether to use credit
4043
+ * balance for the payment.
4044
+ */
2089
4045
  credit_balance?: boolean;
4046
+ /**
4047
+ * - Mode of payment.
4048
+ */
2090
4049
  payment_mode?: string;
4050
+ /**
4051
+ * - Payment method to be used.
4052
+ */
2091
4053
  payment_method?: string;
4054
+ /**
4055
+ * - ID of the invoice for which the payment is collected.
4056
+ */
2092
4057
  invoice_id?: string;
2093
4058
  };
2094
4059
  /** @returns {SubscriptionRenewResMeta} */
2095
4060
  declare function SubscriptionRenewResMeta(): SubscriptionRenewResMeta;
2096
4061
  type SubscriptionRenewResMeta = {
4062
+ /**
4063
+ * - Indicates whether the invoice payment
4064
+ * is involved in the renewal.
4065
+ */
2097
4066
  invoice_payment?: boolean;
4067
+ /**
4068
+ * - Indicates whether the subscription is being renewed.
4069
+ */
2098
4070
  renew?: boolean;
2099
4071
  };
2100
4072
  /** @returns {SubscriptionRenewRes} */
2101
4073
  declare function SubscriptionRenewRes(): SubscriptionRenewRes;
2102
4074
  type SubscriptionRenewRes = {
4075
+ /**
4076
+ * - URL to redirect the user for completing
4077
+ * the renewal.
4078
+ */
2103
4079
  redirect_url?: string;
4080
+ /**
4081
+ * - ID of the renewal transaction.
4082
+ */
2104
4083
  transaction_id?: string;
4084
+ /**
4085
+ * - Current status of the renewal process.
4086
+ */
2105
4087
  current_status?: string;
2106
4088
  meta?: SubscriptionRenewResMeta;
2107
4089
  };
2108
4090
  /** @returns {SetupIntentRes} */
2109
4091
  declare function SetupIntentRes(): SetupIntentRes;
2110
4092
  type SetupIntentRes = {
4093
+ /**
4094
+ * - Indicates if the setup intent was successful.
4095
+ */
2111
4096
  success?: boolean;
2112
4097
  data?: SetupIntentData;
2113
4098
  };
2114
4099
  /** @returns {SetupIntentData} */
2115
4100
  declare function SetupIntentData(): SetupIntentData;
2116
4101
  type SetupIntentData = {
4102
+ /**
4103
+ * - The ID of the setup intent.
4104
+ */
2117
4105
  id?: string;
4106
+ /**
4107
+ * - The client secret of the setup intent.
4108
+ */
2118
4109
  client_secret?: string;
2119
- customer?: any;
4110
+ /**
4111
+ * - The customer associated with the setup intent.
4112
+ */
4113
+ customer?: string;
4114
+ /**
4115
+ * - The status of the setup intent.
4116
+ */
2120
4117
  status?: string;
2121
4118
  };
2122
4119
  /** @returns {SetupPayment} */
2123
4120
  declare function SetupPayment(): SetupPayment;
2124
4121
  type SetupPayment = {
4122
+ /**
4123
+ * - The ID of the setup payment.
4124
+ */
2125
4125
  id?: string;
4126
+ /**
4127
+ * - The status of the setup payment.
4128
+ */
2126
4129
  status?: string;
2127
- customer?: any;
4130
+ /**
4131
+ * - The customer associated with the setup payment.
4132
+ */
4133
+ customer?: string;
4134
+ /**
4135
+ * - The client secret of the setup payment.
4136
+ */
2128
4137
  client_secret?: string;
4138
+ /**
4139
+ * - The payment method used for the setup payment.
4140
+ */
2129
4141
  payment_method?: string;
4142
+ /**
4143
+ * - The mandate ID associated with the setup payment.
4144
+ */
2130
4145
  mandate?: string;
2131
4146
  payment_method_options?: PaymentMethodOptions;
2132
4147
  };
@@ -2143,44 +4158,313 @@ type Card = {
2143
4158
  /** @returns {MandateOptions} */
2144
4159
  declare function MandateOptions(): MandateOptions;
2145
4160
  type MandateOptions = {
4161
+ /**
4162
+ * - The mandate amount.
4163
+ */
2146
4164
  amount?: number;
2147
4165
  };
2148
4166
  /** @returns {Message} */
2149
4167
  declare function Message(): Message;
2150
4168
  type Message = {
4169
+ /**
4170
+ * - A message providing details about the operation status.
4171
+ */
2151
4172
  message?: string;
2152
4173
  };
2153
4174
  /** @returns {TopupRes} */
2154
4175
  declare function TopupRes(): TopupRes;
2155
4176
  type TopupRes = {
4177
+ /**
4178
+ * - The status of the top-up request.
4179
+ */
2156
4180
  status?: string;
4181
+ /**
4182
+ * - The order ID from the aggregator.
4183
+ */
2157
4184
  aggregator_order_id?: string;
4185
+ /**
4186
+ * - The amount of the top-up.
4187
+ */
2158
4188
  amount?: number;
4189
+ /**
4190
+ * - The currency of the top-up.
4191
+ */
2159
4192
  currency?: string;
4193
+ /**
4194
+ * - The transaction ID for the top-up.
4195
+ */
2160
4196
  transaction_id?: string;
2161
4197
  };
2162
4198
  /** @returns {CancelTopupReq} */
2163
4199
  declare function CancelTopupReq(): CancelTopupReq;
2164
4200
  type CancelTopupReq = {
4201
+ /**
4202
+ * - The order ID of the top-up to cancel.
4203
+ */
2165
4204
  order_id?: string;
2166
4205
  };
2167
4206
  /** @returns {CancelTopupRes} */
2168
4207
  declare function CancelTopupRes(): CancelTopupRes;
2169
4208
  type CancelTopupRes = {
4209
+ /**
4210
+ * - The ID of the canceled top-up.
4211
+ */
2170
4212
  _id?: string;
4213
+ /**
4214
+ * - The subscriber ID associated with the top-up.
4215
+ */
2171
4216
  subscriber_id?: string;
4217
+ /**
4218
+ * - The amount of the canceled top-up.
4219
+ */
2172
4220
  amount?: number;
4221
+ /**
4222
+ * - The currency of the canceled top-up.
4223
+ */
2173
4224
  currency?: string;
4225
+ /**
4226
+ * - The aggregator used for the top-up.
4227
+ */
2174
4228
  aggregator?: string;
4229
+ /**
4230
+ * - The order ID from the aggregator.
4231
+ */
2175
4232
  aggregator_order_id?: string;
4233
+ /**
4234
+ * - The date and time when the top-up was created.
4235
+ */
2176
4236
  created_at?: string;
4237
+ /**
4238
+ * - The date and time when the top-up was modified.
4239
+ */
2177
4240
  modified_at?: string;
4241
+ /**
4242
+ * - The version key, used for internal purposes.
4243
+ */
2178
4244
  __v?: number;
4245
+ /**
4246
+ * - The status of the top-up with the aggregator.
4247
+ */
2179
4248
  aggregator_status?: string;
4249
+ /**
4250
+ * - The current status of the top-up.
4251
+ */
2180
4252
  current_status?: string;
2181
4253
  };
2182
4254
  /** @returns {DefaultReq} */
2183
4255
  declare function DefaultReq(): DefaultReq;
2184
4256
  type DefaultReq = {
4257
+ /**
4258
+ * - The ID of the payment method to set
4259
+ * as default.
4260
+ */
2185
4261
  payment_method_id?: string;
2186
4262
  };
4263
+ /** @returns {EntityChargeRecurring} */
4264
+ declare function EntityChargeRecurring(): EntityChargeRecurring;
4265
+ type EntityChargeRecurring = {
4266
+ /**
4267
+ * - The interval of the subscription.
4268
+ */
4269
+ interval: string;
4270
+ };
4271
+ /** @returns {ChargeLineItem} */
4272
+ declare function ChargeLineItem(): ChargeLineItem;
4273
+ type ChargeLineItem = {
4274
+ /**
4275
+ * - Its name of the extension plan.
4276
+ */
4277
+ name: string;
4278
+ /**
4279
+ * - It indicates how it will be charged.
4280
+ */
4281
+ term: string;
4282
+ /**
4283
+ * - It indicates the extension subscription
4284
+ * will be auto renewed timely.
4285
+ */
4286
+ pricing_type: string;
4287
+ price: EntityChargePrice;
4288
+ recurring?: EntityChargeRecurring;
4289
+ capped_amount?: number;
4290
+ trial_days?: number;
4291
+ is_test?: boolean;
4292
+ metadata?: any;
4293
+ };
4294
+ /** @returns {CreateSubscriptionCharge} */
4295
+ declare function CreateSubscriptionCharge(): CreateSubscriptionCharge;
4296
+ type CreateSubscriptionCharge = {
4297
+ /**
4298
+ * - The name of the charge.
4299
+ */
4300
+ name: string;
4301
+ trial_days?: number;
4302
+ line_items: ChargeLineItem[];
4303
+ /**
4304
+ * - Indicates whether the charge is for testing purposes.
4305
+ */
4306
+ is_test?: boolean;
4307
+ /**
4308
+ * - The URL passed in request which extension
4309
+ * expects in return.
4310
+ */
4311
+ return_url: string;
4312
+ };
4313
+ /** @returns {EntityChargeDetails} */
4314
+ declare function EntityChargeDetails(): EntityChargeDetails;
4315
+ type EntityChargeDetails = {
4316
+ /**
4317
+ * - Unique identifier for the charge.
4318
+ */
4319
+ _id?: string;
4320
+ /**
4321
+ * - Unique identifier of the extension subscription.
4322
+ */
4323
+ subscription_id?: string;
4324
+ /**
4325
+ * - Unique identifier of the
4326
+ * subscriber/company who installed extension subscription.
4327
+ */
4328
+ subscriber_id?: string;
4329
+ /**
4330
+ * - The type of entity associated with the
4331
+ * charge (e.g., 'extension', 'subscription').
4332
+ */
4333
+ entity_type?: string;
4334
+ /**
4335
+ * - Unique identifier for the entity associated
4336
+ * with the charge.
4337
+ */
4338
+ entity_id?: string;
4339
+ /**
4340
+ * - The name of the charge.
4341
+ */
4342
+ name?: string;
4343
+ /**
4344
+ * - Description of the charge term.
4345
+ */
4346
+ term?: string;
4347
+ /**
4348
+ * - The type of charge (e.g., 'standalone',
4349
+ * 'recurring').
4350
+ */
4351
+ charge_type?: string;
4352
+ /**
4353
+ * - The pricing model for the charge (e.g.,
4354
+ * 'one_time', 'recurring').
4355
+ */
4356
+ pricing_type?: string;
4357
+ price?: EntityChargePrice;
4358
+ recurring?: ChargeRecurring;
4359
+ /**
4360
+ * - Current status of the charge.
4361
+ */
4362
+ status?: string;
4363
+ /**
4364
+ * - Maximum amount that can be charged, if applicable.
4365
+ */
4366
+ capped_amount?: number;
4367
+ /**
4368
+ * - Date and time when the charge was activated.
4369
+ */
4370
+ activated_on?: string;
4371
+ /**
4372
+ * - Date and time when the charge was cancelled.
4373
+ */
4374
+ cancelled_on?: string;
4375
+ /**
4376
+ * - Date and time when the charge was billed.
4377
+ */
4378
+ billing_date?: string;
4379
+ current_period?: SubscriptionTrialPeriod;
4380
+ /**
4381
+ * - Date and time when the charge details were
4382
+ * last modified.
4383
+ */
4384
+ modified_at?: string;
4385
+ /**
4386
+ * - Date and time when the charge was created.
4387
+ */
4388
+ created_at?: string;
4389
+ /**
4390
+ * - Indicates whether the charge is for testing purposes.
4391
+ */
4392
+ is_test?: boolean;
4393
+ /**
4394
+ * - Company id.
4395
+ */
4396
+ company_id?: string;
4397
+ /**
4398
+ * - Additional metadata associated with the charge.
4399
+ */
4400
+ meta?: any;
4401
+ /**
4402
+ * - Internal version key for the charge record.
4403
+ */
4404
+ __v?: number;
4405
+ };
4406
+ /** @returns {EntitySubscription} */
4407
+ declare function EntitySubscription(): EntitySubscription;
4408
+ type EntitySubscription = {
4409
+ /**
4410
+ * - Unique identifier for the subscription charge
4411
+ */
4412
+ _id?: string;
4413
+ /**
4414
+ * - ID of the product suit associated with
4415
+ * the charge
4416
+ */
4417
+ product_suit_id?: string;
4418
+ /**
4419
+ * - Unique identifier for the entity
4420
+ */
4421
+ entity_id?: string;
4422
+ /**
4423
+ * - Type of entity (e.g., subscription, extension)
4424
+ */
4425
+ entity_type?: string;
4426
+ /**
4427
+ * - Name of the subscription charge
4428
+ */
4429
+ name?: string;
4430
+ /**
4431
+ * - Current status of the subscription charge
4432
+ */
4433
+ status?: string;
4434
+ /**
4435
+ * - Number of trial days provided
4436
+ */
4437
+ trial_days?: number;
4438
+ /**
4439
+ * - Indicates if the charge is for testing purposes
4440
+ */
4441
+ is_test?: boolean;
4442
+ /**
4443
+ * - Timestamp when the charge was created
4444
+ */
4445
+ created_at?: string;
4446
+ /**
4447
+ * - Timestamp when the charge was last modified
4448
+ */
4449
+ modified_at?: string;
4450
+ /**
4451
+ * - Unique Identifier of the company
4452
+ */
4453
+ subscriber_id?: string;
4454
+ line_items?: EntityChargeDetails[];
4455
+ /**
4456
+ * - The URL passed in request which extension
4457
+ * expects in return.
4458
+ */
4459
+ return_url?: string;
4460
+ };
4461
+ /** @returns {CreateSubscriptionResponse} */
4462
+ declare function CreateSubscriptionResponse(): CreateSubscriptionResponse;
4463
+ type CreateSubscriptionResponse = {
4464
+ subscription?: EntitySubscription;
4465
+ /**
4466
+ * - URL to which users are redirected to
4467
+ * confirm or complete the payment or subscription process.
4468
+ */
4469
+ confirm_url?: string;
4470
+ };