@kelviq/mcp-server 0.2.3 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -17
- package/dist/config.d.ts +8 -1
- package/dist/config.js +37 -6
- package/dist/config.js.map +1 -1
- package/dist/docs/api-reference/authentication.md +7 -3
- package/dist/docs/api-reference/introduction.md +143 -0
- package/dist/docs/backend-integration/node-sdk.md +148 -6
- package/dist/docs/backend-integration/python-sdk.md +195 -11
- package/dist/docs/changelog/api.md +119 -0
- package/dist/docs/changelog/app.md +693 -0
- package/dist/docs/changelog/node-sdk.md +153 -0
- package/dist/docs/changelog/python-sdk.md +182 -0
- package/dist/docs/cli/commands.md +225 -0
- package/dist/docs/cli/environments.md +95 -0
- package/dist/docs/cli/kelviq-config.md +141 -0
- package/dist/docs/cli/overview.md +223 -0
- package/dist/docs/customer-portal/managing-payment-methods.md +72 -0
- package/dist/docs/guides/mcp-server.md +129 -173
- package/dist/docs/guides/sandbox.md +107 -0
- package/dist/docs/guides/webhooks.md +81 -0
- package/dist/docs/manifest.json +57 -8
- package/dist/docs/openapi.json +1206 -50
- package/dist/docs/product-catalog/one-time-payments.md +3 -1
- package/dist/docs/product-catalog/usage-based-billing.md +86 -7
- package/dist/docs/quickstart/dashboard-setup.md +1 -1
- package/dist/schemas/kelviq.d.ts +0 -128
- package/dist/schemas/kelviq.js +0 -63
- package/dist/schemas/kelviq.js.map +1 -1
- package/dist/tools/index.js +0 -4
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/plan-files.js +1 -1
- package/dist/tools/plan-files.js.map +1 -1
- package/dist/tools/plans.js +1 -15
- package/dist/tools/plans.js.map +1 -1
- package/dist/tools/portal.d.ts +11 -1
- package/dist/tools/portal.js +27 -2
- package/dist/tools/portal.js.map +1 -1
- package/dist/tools/products.js +1 -1
- package/dist/tools/products.js.map +1 -1
- package/dist/tools/subscriptions.js +1 -1
- package/dist/tools/subscriptions.js.map +1 -1
- package/package.json +5 -2
|
@@ -4,6 +4,699 @@ slug: "changelog/app"
|
|
|
4
4
|
section: "changelog"
|
|
5
5
|
description: "Changelog for the Kelviq Dashboard"
|
|
6
6
|
---
|
|
7
|
+
<Update label="v1.11" description="June 26, 2026">
|
|
8
|
+
|
|
9
|
+

|
|
10
|
+
|
|
11
|
+
## Quarterly billing periods
|
|
12
|
+
|
|
13
|
+
Kelviq now supports quarterly billing periods. Sellers can now offer plans that renew every 3 months.
|
|
14
|
+
|
|
15
|
+
Example pricing:
|
|
16
|
+
|
|
17
|
+
```text
|
|
18
|
+
Monthly: $29 per month
|
|
19
|
+
Quarterly: $79 per quarter
|
|
20
|
+
Annual: $299 per year
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Quarterly billing is useful when monthly feels too short and annual feels too expensive. It works well for:
|
|
24
|
+
|
|
25
|
+
- AI tools
|
|
26
|
+
- Developer tools
|
|
27
|
+
- Creator products
|
|
28
|
+
- Small business SaaS
|
|
29
|
+
- B2B products with longer buying cycles
|
|
30
|
+
|
|
31
|
+
## Pay as you go improvements
|
|
32
|
+
|
|
33
|
+
We improved pay as you go support across the product. This makes it easier to set up and review usage based billing.
|
|
34
|
+
|
|
35
|
+
## Usage based pricing improvements
|
|
36
|
+
|
|
37
|
+
We improved the usage based pricing experience in the UI. This helps sellers create usage based plans with less confusion. Supported pricing patterns include:
|
|
38
|
+
|
|
39
|
+
- Per unit pricing
|
|
40
|
+
- Package pricing
|
|
41
|
+
- Included usage with overage
|
|
42
|
+
- Pay as you go
|
|
43
|
+
- Subscription plus usage
|
|
44
|
+
- Credit based usage
|
|
45
|
+
|
|
46
|
+
Example:
|
|
47
|
+
|
|
48
|
+
```text
|
|
49
|
+
Starter plan: $19 per month
|
|
50
|
+
Includes: 100 AI credits
|
|
51
|
+
Extra credits: $10 per 100 credits
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Checkout pricing improvements
|
|
55
|
+
|
|
56
|
+
Checkout now handles more pricing cases across custom amounts, usage based plans, and tax behavior. This helps keep pricing consistent across:
|
|
57
|
+
|
|
58
|
+
- Pricing page
|
|
59
|
+
- Checkout page
|
|
60
|
+
- Customer portal
|
|
61
|
+
- Transaction details
|
|
62
|
+
- Invoices
|
|
63
|
+
|
|
64
|
+
## Node SDK webhook improvements
|
|
65
|
+
|
|
66
|
+
The Node SDK includes more webhook improvements for safer event handling. This helps developers build reliable flows for:
|
|
67
|
+
|
|
68
|
+
- License generation
|
|
69
|
+
- Subscription access
|
|
70
|
+
- Plan changes
|
|
71
|
+
- Customer portal links
|
|
72
|
+
- Usage updates
|
|
73
|
+
- Billing state sync
|
|
74
|
+
|
|
75
|
+
## Final fixes and cleanup
|
|
76
|
+
|
|
77
|
+
We also shipped smaller fixes and cleanup across checkout, pricing, product setup, and plan setup. This includes improvements for:
|
|
78
|
+
|
|
79
|
+
- Checkout plan switching
|
|
80
|
+
- Package pricing labels
|
|
81
|
+
- Product setup flows
|
|
82
|
+
- Plan setup flows
|
|
83
|
+
- Checkout management
|
|
84
|
+
- Dashboard clarity
|
|
85
|
+
|
|
86
|
+
</Update>
|
|
87
|
+
|
|
88
|
+
<Update label="v1.10" description="June 19, 2026">
|
|
89
|
+
|
|
90
|
+

|
|
91
|
+
|
|
92
|
+
## Organization settings page
|
|
93
|
+
|
|
94
|
+
Kelviq now has an Organization settings page. This gives teams a central place to manage organization level settings. The goal is to keep account level setup separate from product level setup.
|
|
95
|
+
|
|
96
|
+
This can include:
|
|
97
|
+
|
|
98
|
+
- Organization name
|
|
99
|
+
- Business details
|
|
100
|
+
- Team settings
|
|
101
|
+
- Billing settings
|
|
102
|
+
- Product defaults
|
|
103
|
+
|
|
104
|
+
## Payout tab is visible before business verification
|
|
105
|
+
|
|
106
|
+
The payout tab is now visible before business verification is complete. This avoids confusion for new sellers. Before this, some users were not sure where payout setup would appear. Now sellers can see the payout area earlier, even if live payouts are not enabled yet.
|
|
107
|
+
|
|
108
|
+
## Zapier integration
|
|
109
|
+
|
|
110
|
+
Kelviq now supports Zapier integration. This helps sellers connect Kelviq with other tools without custom code.
|
|
111
|
+
|
|
112
|
+
Examples:
|
|
113
|
+
|
|
114
|
+
- Send a Slack message when a new order is created
|
|
115
|
+
- Add a new customer to HubSpot
|
|
116
|
+
- Create a Google Sheets row after checkout
|
|
117
|
+
- Send an onboarding email after payment
|
|
118
|
+
- Notify support when a refund happens
|
|
119
|
+
- Add a buyer to a course platform
|
|
120
|
+
|
|
121
|
+
## Plans removed from the sidebar
|
|
122
|
+
|
|
123
|
+
We removed Plans from the sidebar because it was confusing. Plans are now managed inside products. This makes the dashboard easier to understand. This matches how sellers usually think about setup:
|
|
124
|
+
|
|
125
|
+
1. Create a product
|
|
126
|
+
2. Add plans to the product
|
|
127
|
+
3. Create checkout links for those plans
|
|
128
|
+
|
|
129
|
+
## Email removed from checkout list
|
|
130
|
+
|
|
131
|
+
We removed the separate email field from the checkout list because the customer column already shows the email. This makes the table cleaner and reduces repeated information.
|
|
132
|
+
|
|
133
|
+
## Frontend improvements
|
|
134
|
+
|
|
135
|
+
We shipped several dashboard improvements focused on clarity and setup speed. This includes:
|
|
136
|
+
|
|
137
|
+
- Cleaner product navigation
|
|
138
|
+
- Better table layout
|
|
139
|
+
- Better empty states
|
|
140
|
+
- Easier checkout link access
|
|
141
|
+
- Clearer plan setup
|
|
142
|
+
- Better plan publishing flow
|
|
143
|
+
|
|
144
|
+
## Custom checkout pricing improvements
|
|
145
|
+
|
|
146
|
+
We improved the custom checkout pricing flow. This is useful for sales led deals and private pricing. You can create a custom checkout for that customer without adding a public plan.
|
|
147
|
+
|
|
148
|
+
</Update>
|
|
149
|
+
|
|
150
|
+
<Update label="v1.9" description="June 12, 2026">
|
|
151
|
+
|
|
152
|
+

|
|
153
|
+
|
|
154
|
+
## Subscription data in license validation
|
|
155
|
+
|
|
156
|
+
License checks can return subscription context along with the license result. This is important for desktop software, private model tooling, and downloadable products where access is tied to both a license key and a live subscription.
|
|
157
|
+
|
|
158
|
+
Example response:
|
|
159
|
+
|
|
160
|
+
```json
|
|
161
|
+
{
|
|
162
|
+
"license": {
|
|
163
|
+
"key": "LIC-123",
|
|
164
|
+
"status": "active"
|
|
165
|
+
},
|
|
166
|
+
"subscription": {
|
|
167
|
+
"status": "active",
|
|
168
|
+
"plan": "Pro",
|
|
169
|
+
"trialDaysRemaining": 0
|
|
170
|
+
...
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## License API support in the Node SDK
|
|
176
|
+
|
|
177
|
+
The Node SDK now supports the License API. You can validate license keys and connect license status directly to your app. Backend services using `@kelviq/node-sdk` can validate licenses without making manual API requests. For example, a CLI product can validate a license key on launch, confirm the associated subscription is active, and decide whether to unlock premium features.
|
|
178
|
+
|
|
179
|
+
**Example:**
|
|
180
|
+
|
|
181
|
+
```js
|
|
182
|
+
const result = await client.license.validate({
|
|
183
|
+
licenseKey: "LIC-123"
|
|
184
|
+
});
|
|
185
|
+
|
|
186
|
+
if (result.valid) {
|
|
187
|
+
// Unlock product access
|
|
188
|
+
}
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
This is useful for products such as:
|
|
192
|
+
|
|
193
|
+
* macOS apps
|
|
194
|
+
* WordPress plugins
|
|
195
|
+
* VS Code extensions
|
|
196
|
+
* Figma plugins
|
|
197
|
+
* Desktop developer tools
|
|
198
|
+
* Paid templates
|
|
199
|
+
|
|
200
|
+
## Trial end support for subscription updates
|
|
201
|
+
|
|
202
|
+
The Node SDK now supports `trialEnd` when updating subscriptions. This gives developers more control over trials. This helps teams extend a trial after sales approval or shorten a trial when a customer upgrades early.
|
|
203
|
+
|
|
204
|
+
You can now handle flows like:
|
|
205
|
+
|
|
206
|
+
- Extend a trial by 7 days
|
|
207
|
+
- End a trial immediately
|
|
208
|
+
- Set a custom trial end date
|
|
209
|
+
- Move a customer from trial to paid
|
|
210
|
+
- Give a sales led customer a longer trial
|
|
211
|
+
|
|
212
|
+
```js
|
|
213
|
+
await client.subscriptions.update({
|
|
214
|
+
subscriptionId: "sub_123",
|
|
215
|
+
trialEnd: "2026-06-30T23:59:59Z"
|
|
216
|
+
});
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
## Portal session support in the Node SDK
|
|
220
|
+
|
|
221
|
+
The Node SDK now supports customer portal sessions. You can create a signed portal link from your backend and send customers to the portal.
|
|
222
|
+
|
|
223
|
+
Example:
|
|
224
|
+
|
|
225
|
+
```js
|
|
226
|
+
const session = await client.portal.createSession({
|
|
227
|
+
customerId: "cust_789",
|
|
228
|
+
});
|
|
229
|
+
|
|
230
|
+
// Redirect your customer to the portal
|
|
231
|
+
res.redirect(session.customerPortalUrl);
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
Customers can use the portal to:
|
|
235
|
+
|
|
236
|
+
- View invoices
|
|
237
|
+
- Update payment method
|
|
238
|
+
- Cancel subscription
|
|
239
|
+
- Manage billing details
|
|
240
|
+
- Access downloads
|
|
241
|
+
- View license keys
|
|
242
|
+
|
|
243
|
+
## Signed customer portal link from order details
|
|
244
|
+
|
|
245
|
+
You can now generate and send a signed customer portal link directly from the order details page. This is especially useful for support workflows.
|
|
246
|
+
|
|
247
|
+
**Example:** A customer asks:
|
|
248
|
+
|
|
249
|
+
```text
|
|
250
|
+
Can you send me my invoice?
|
|
251
|
+
I need to update my payment method.
|
|
252
|
+
I need access to my license details.
|
|
253
|
+
```
|
|
254
|
+
You can open the order, generate a secure customer portal link, and send it to the customer. Customers can then access invoices, update their payment method, manage subscriptions, and view license details on their own. No custom engineering is required for this support workflow.
|
|
255
|
+
|
|
256
|
+
## Webhooks in the dashboard
|
|
257
|
+
|
|
258
|
+
We added webhook support in the dashboard. This gives developers a clear place to manage webhook related setup. Webhooks are useful when your app needs to react to Kelviq events.
|
|
259
|
+
|
|
260
|
+
Examples:
|
|
261
|
+
|
|
262
|
+
- Create a license after checkout
|
|
263
|
+
- Unlock a paid feature
|
|
264
|
+
- Update a subscription
|
|
265
|
+
- Sync customer state
|
|
266
|
+
- Send an onboarding email
|
|
267
|
+
- Disable access after cancellation
|
|
268
|
+
|
|
269
|
+
## Webhook improvements in the Node SDK
|
|
270
|
+
|
|
271
|
+
The Node SDK now includes webhook improvements. This helps developers verify and handle webhook events more safely.
|
|
272
|
+
|
|
273
|
+
Example events:
|
|
274
|
+
|
|
275
|
+
```text
|
|
276
|
+
checkout.completed
|
|
277
|
+
order.created
|
|
278
|
+
subscription.created
|
|
279
|
+
subscription.updated
|
|
280
|
+
subscription.cancelled
|
|
281
|
+
plan.changed
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
## Webhook logs
|
|
285
|
+
|
|
286
|
+
Kelviq now includes webhook logs. This helps developers debug webhook delivery issues. This is useful when your endpoint is down, slow, or returning an error. You can inspect:
|
|
287
|
+
|
|
288
|
+
- Event type
|
|
289
|
+
- Delivery status
|
|
290
|
+
- Response code
|
|
291
|
+
- Timestamp
|
|
292
|
+
- Error response
|
|
293
|
+
|
|
294
|
+
## Plan changed webhook
|
|
295
|
+
|
|
296
|
+
We added a plan changed webhook. This helps your app react when a customer changes plans.
|
|
297
|
+
|
|
298
|
+
Example: A customer moves from `Starter` to `Pro`.
|
|
299
|
+
|
|
300
|
+
Your app can listen for the event and update:
|
|
301
|
+
|
|
302
|
+
- Feature access
|
|
303
|
+
- Usage limits
|
|
304
|
+
- Seat limits
|
|
305
|
+
- Credit balance
|
|
306
|
+
- Internal customer state
|
|
307
|
+
|
|
308
|
+
## Publish plan UI and UX update
|
|
309
|
+
|
|
310
|
+
We updated the publish plan UI and UX. The new flow makes it clearer when a plan is still a draft and when it is ready for customers. This helps reduce mistakes before sharing checkout links.
|
|
311
|
+
|
|
312
|
+
## Plan description in plan detail header
|
|
313
|
+
|
|
314
|
+
Plan detail pages now show the plan description in the header. This makes it easier to identify similar plans.
|
|
315
|
+
|
|
316
|
+
Example:
|
|
317
|
+
|
|
318
|
+
```text
|
|
319
|
+
Pro
|
|
320
|
+
For growing AI teams with higher usage limits
|
|
321
|
+
```
|
|
322
|
+
|
|
323
|
+
## Free plan switch disabled for published plans
|
|
324
|
+
|
|
325
|
+
Kelviq now disables free plan switching for published plans when switching is not possible. This prevents users from selecting an action that cannot be completed.
|
|
326
|
+
|
|
327
|
+
</Update>
|
|
328
|
+
|
|
329
|
+
<Update label="v1.8" description="June 5, 2026">
|
|
330
|
+
|
|
331
|
+

|
|
332
|
+
|
|
333
|
+
## Usage based pricing in the dashboard
|
|
334
|
+
|
|
335
|
+
Merchants can configure metered pricing without leaving the dashboard. A plan can include a base subscription, included usage, and overage pricing for usage beyond the included amount.
|
|
336
|
+
|
|
337
|
+
## Pay as you go
|
|
338
|
+
|
|
339
|
+
Kelviq now supports pay as you go pricing. Your customers can continue using a metered product after included usage runs out, then pay for additional consumption. This fits LLM tools, API platforms, transcription products, and image generation products where hard cutoffs create poor customer experiences.
|
|
340
|
+
|
|
341
|
+
Example: A customer uses the following in one month:
|
|
342
|
+
|
|
343
|
+
```text
|
|
344
|
+
120,000 tokens
|
|
345
|
+
40 image generations
|
|
346
|
+
500 API calls
|
|
347
|
+
```
|
|
348
|
+
|
|
349
|
+
Kelviq will calculate the bill based on the pricing rules you set.
|
|
350
|
+
|
|
351
|
+
## Enable pay as you go from the dashboard
|
|
352
|
+
|
|
353
|
+
You can now enable pay as you go from the dashboard. This helps sellers launch usage based pricing without building their own billing system. A simple AI product can now charge like this:
|
|
354
|
+
|
|
355
|
+
```text
|
|
356
|
+
Base plan: $20 per month
|
|
357
|
+
Included usage: 100,000 tokens
|
|
358
|
+
Overage: $2 per 10,000 tokens
|
|
359
|
+
```
|
|
360
|
+
|
|
361
|
+
## Usage alerts
|
|
362
|
+
|
|
363
|
+
Kelviq now supports usage alerts. Usage alerts help you know when a customer reaches an important usage threshold. Merchants can notify customers when metered usage crosses a configured limit. This is especially useful for AI products where usage can grow quickly across tokens, image generations, API calls, embeddings, storage, or compute minutes.
|
|
364
|
+
|
|
365
|
+
Examples:
|
|
366
|
+
|
|
367
|
+
- Customer used 80% of included credits
|
|
368
|
+
- Customer crossed 10,000 API calls
|
|
369
|
+
- Customer used more than `$100` in AI model cost
|
|
370
|
+
- Customer is close to the monthly usage limit
|
|
371
|
+
- Customer is likely to need an upgrade soon
|
|
372
|
+
|
|
373
|
+
This helps sellers avoid surprise bills and give customers a better experience.
|
|
374
|
+
|
|
375
|
+
## Usage alerts for status entitlements
|
|
376
|
+
|
|
377
|
+
Usage alerts now work with status entitlements. This helps connect product access with usage state.
|
|
378
|
+
|
|
379
|
+
Example: A customer has `100` credits. Different features can consume credits differently:
|
|
380
|
+
|
|
381
|
+
```text
|
|
382
|
+
GPT 5.1 request: 2 credits
|
|
383
|
+
Claude Sonnet request: 3 credits
|
|
384
|
+
Page crawl: 5 credits
|
|
385
|
+
Long report generation: 20 credits
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
Kelviq can help track when the customer is close to the limit and trigger an alert.
|
|
389
|
+
|
|
390
|
+
## Negative usage values
|
|
391
|
+
|
|
392
|
+
Usage reporting now supports negative values. This is useful when you need to correct usage after it was reported. If an app accidentally reports `125,000` tokens instead of `120,000`, it can send `-5,000` to bring the meter back in line.
|
|
393
|
+
|
|
394
|
+
Examples:
|
|
395
|
+
|
|
396
|
+
- Remove duplicate API usage
|
|
397
|
+
- Reverse usage after a failed job
|
|
398
|
+
- Credit back usage after a refund
|
|
399
|
+
- Fix a metering mistake
|
|
400
|
+
- Adjust token usage after an LLM call failed
|
|
401
|
+
- Reserve tokens up front and return the unused amount once the action completes
|
|
402
|
+
|
|
403
|
+
This also enables a reserve-and-settle pattern. You can block a number of tokens in advance, then report a negative value to return whatever wasn't used once the action finishes. For example, reserve `1,000` tokens before an LLM call, then send `-400` if only `600` were consumed.
|
|
404
|
+
|
|
405
|
+
```js
|
|
406
|
+
import { BEHAVIOUR_CHOICES } from '@kelviq/node-sdk';
|
|
407
|
+
|
|
408
|
+
// Reserve tokens before the action
|
|
409
|
+
await client.reporting.reportUsage({
|
|
410
|
+
value: 1000,
|
|
411
|
+
customerId: "cus_123",
|
|
412
|
+
featureId: "tokens",
|
|
413
|
+
behaviour: BEHAVIOUR_CHOICES.DELTA
|
|
414
|
+
});
|
|
415
|
+
|
|
416
|
+
// Return the unused tokens after it completes
|
|
417
|
+
await client.reporting.reportUsage({
|
|
418
|
+
value: -400,
|
|
419
|
+
customerId: "cus_123",
|
|
420
|
+
featureId: "tokens",
|
|
421
|
+
behaviour: BEHAVIOUR_CHOICES.DELTA
|
|
422
|
+
});
|
|
423
|
+
```
|
|
424
|
+
|
|
425
|
+
## Checkout API supports locked email and default billing country
|
|
426
|
+
|
|
427
|
+
The checkout API now supports locked email and default billing country. This helps create a cleaner checkout flow when your app already knows the customer.
|
|
428
|
+
|
|
429
|
+
Example:
|
|
430
|
+
|
|
431
|
+
```js
|
|
432
|
+
await client.checkout.createSession({
|
|
433
|
+
planIdentifier: "plan-pro",
|
|
434
|
+
customerId: "cust_789",
|
|
435
|
+
lockEmail: true,
|
|
436
|
+
defaultBillingCountry: "US"
|
|
437
|
+
});
|
|
438
|
+
```
|
|
439
|
+
|
|
440
|
+
This prevents customers from using the wrong email during checkout.
|
|
441
|
+
|
|
442
|
+
## Prefill customer email in checkout links
|
|
443
|
+
|
|
444
|
+
Checkout links can now prefill the customer email when available. This is useful when checkout starts from your app.
|
|
445
|
+
|
|
446
|
+
Example: A logged in customer clicks upgrade. Checkout opens with their email already filled in.
|
|
447
|
+
|
|
448
|
+
```text
|
|
449
|
+
alex@company.com
|
|
450
|
+
```
|
|
451
|
+
|
|
452
|
+
This reduces checkout mistakes and support issues.
|
|
453
|
+
|
|
454
|
+
## Lock email using checkout config
|
|
455
|
+
|
|
456
|
+
Checkout links now support locking the email field using config. This means customers can see the email but cannot edit it.
|
|
457
|
+
|
|
458
|
+
This is useful for:
|
|
459
|
+
|
|
460
|
+
- License keys
|
|
461
|
+
- Account based access
|
|
462
|
+
- Customer portal access
|
|
463
|
+
- Subscription upgrades
|
|
464
|
+
- Team plans
|
|
465
|
+
|
|
466
|
+
## SEPA payment method
|
|
467
|
+
|
|
468
|
+
Checkout now supports SEPA. This helps sellers serve more European customers, especially B2B customers who prefer bank debit. SEPA is useful for:
|
|
469
|
+
|
|
470
|
+
- SaaS subscriptions
|
|
471
|
+
- B2B tools
|
|
472
|
+
- Annual contracts
|
|
473
|
+
- European customers
|
|
474
|
+
- Larger invoice amounts
|
|
475
|
+
|
|
476
|
+
</Update>
|
|
477
|
+
|
|
478
|
+
<Update label="v1.7" description="May 29, 2026">
|
|
479
|
+
|
|
480
|
+

|
|
481
|
+
|
|
482
|
+
## Tax inclusive pricing settings
|
|
483
|
+
|
|
484
|
+
Kelviq now supports tax inclusive pricing settings. This lets you decide whether the price shown to the customer already includes tax.
|
|
485
|
+
|
|
486
|
+
Example: A customer sees:
|
|
487
|
+
|
|
488
|
+
```text
|
|
489
|
+
$20 per month
|
|
490
|
+
```
|
|
491
|
+
|
|
492
|
+
If tax inclusive pricing is enabled, the customer still pays $20 per month.
|
|
493
|
+
|
|
494
|
+
Kelviq calculates the tax portion from that amount. This is useful in markets where customers expect the displayed price to be the final price.
|
|
495
|
+
|
|
496
|
+
## Tax inclusive behavior is shown in checkout
|
|
497
|
+
|
|
498
|
+
Checkout now respects tax inclusive settings so the buyer sees the same pricing behavior that was configured for the plan. This avoids the common confusion where a pricing page says `$49` but checkout unexpectedly adds tax on top.
|
|
499
|
+
|
|
500
|
+
## Tax type and tax percentage in checkout
|
|
501
|
+
|
|
502
|
+
Checkout links now support tax type (such as VAT, GST, Sales Tax, or any other configured tax type) and the tax percentage. This gives customers a clearer view of what they are paying.
|
|
503
|
+
|
|
504
|
+
Example with tax added on top:
|
|
505
|
+
|
|
506
|
+
```text
|
|
507
|
+
Product price: $100
|
|
508
|
+
Tax: 10%
|
|
509
|
+
Total: $110
|
|
510
|
+
```
|
|
511
|
+
|
|
512
|
+
Example with tax included:
|
|
513
|
+
|
|
514
|
+
```text
|
|
515
|
+
Total: €20
|
|
516
|
+
Includes tax: €3.33
|
|
517
|
+
```
|
|
518
|
+
|
|
519
|
+
## Tax behavior in plan details
|
|
520
|
+
|
|
521
|
+
Plan detail pages now show tax behavior. Teams can confirm that a `Pro EU` plan includes VAT, while a `Pro US` plan remains tax exclusive. You can see whether a plan is tax inclusive or tax exclusive before sharing it with customers, helping you avoid setup mistakes.
|
|
522
|
+
|
|
523
|
+
## Tax code category on products
|
|
524
|
+
|
|
525
|
+
You can now set a tax code category when creating or editing a product. This helps Kelviq apply the right tax treatment based on what you sell.
|
|
526
|
+
|
|
527
|
+
Examples:
|
|
528
|
+
|
|
529
|
+
- SaaS subscription
|
|
530
|
+
- API access
|
|
531
|
+
- AI credits
|
|
532
|
+
- Digital download
|
|
533
|
+
- License key
|
|
534
|
+
- Course
|
|
535
|
+
- Template
|
|
536
|
+
- Plugin
|
|
537
|
+
|
|
538
|
+
This matters because different product types can have different tax rules.
|
|
539
|
+
|
|
540
|
+
## Tax information in transactions
|
|
541
|
+
|
|
542
|
+
Transaction views now show tax details so support and finance teams can answer customer questions without leaving the dashboard.
|
|
543
|
+
|
|
544
|
+
You can use this to answer questions like:
|
|
545
|
+
|
|
546
|
+
- What was the product price?
|
|
547
|
+
- How much tax was charged?
|
|
548
|
+
- Was tax included in the price?
|
|
549
|
+
- What did the customer pay in total?
|
|
550
|
+
|
|
551
|
+
## Custom checkout pricing
|
|
552
|
+
|
|
553
|
+
Kelviq now supports custom checkout pricing. This lets you create a checkout with a custom amount instead of always using the fixed public plan price.
|
|
554
|
+
|
|
555
|
+
This is useful for:
|
|
556
|
+
|
|
557
|
+
- Custom quotes
|
|
558
|
+
- One off payments
|
|
559
|
+
- Sales led plans
|
|
560
|
+
- Manual upgrades
|
|
561
|
+
- Private deals
|
|
562
|
+
- Customer specific pricing
|
|
563
|
+
|
|
564
|
+
Example: A customer agrees to a custom price of `$349 per month`.
|
|
565
|
+
|
|
566
|
+
You can create a checkout session for that amount without creating a public plan for every custom price.
|
|
567
|
+
|
|
568
|
+
## Custom amount on checkout page
|
|
569
|
+
|
|
570
|
+
Checkout can now show and charge a custom amount. This gives sellers more flexibility when dealing with larger customers or special pricing cases.
|
|
571
|
+
|
|
572
|
+
Example:
|
|
573
|
+
|
|
574
|
+
```text
|
|
575
|
+
Custom plan
|
|
576
|
+
$349 per month
|
|
577
|
+
```
|
|
578
|
+
|
|
579
|
+
## Regional pricing minimum value validation
|
|
580
|
+
|
|
581
|
+
We added validation for regional pricing minimum values. This helps prevent a regional price from becoming too low to process.
|
|
582
|
+
|
|
583
|
+
Example: A plan is priced at `$5`.
|
|
584
|
+
|
|
585
|
+
A very large regional discount could reduce the price below the minimum amount allowed by the payment method. Kelviq now catches this earlier so sellers can fix it before customers reach checkout.
|
|
586
|
+
|
|
587
|
+
## Fixes
|
|
588
|
+
|
|
589
|
+
**Canada postal code** —
|
|
590
|
+
Fixed an issue with Canadian postal codes during checkout. Canadian postal codes such as `M5V 2T6` are now handled correctly.
|
|
591
|
+
|
|
592
|
+
**Checkout plan switching** —
|
|
593
|
+
Fixed an issue where checkout could fail when customers switched between plans. This improves checkout reliability when customers compare plans before paying.
|
|
594
|
+
|
|
595
|
+
**Package pricing label** —
|
|
596
|
+
Fixed the label for package based pricing. This makes package pricing easier for customers to understand at checkout.
|
|
597
|
+
|
|
598
|
+
Example:
|
|
599
|
+
```text
|
|
600
|
+
$10 per 1,000 API calls
|
|
601
|
+
```
|
|
602
|
+
|
|
603
|
+
**One time payment cancellation** —
|
|
604
|
+
Fixed an issue where cancel subscription was visible for one time payments. One time payments do not have a subscription to cancel, so that action is now hidden.
|
|
605
|
+
|
|
606
|
+
</Update>
|
|
607
|
+
|
|
608
|
+
<Update label="v1.6" description="May 22, 2026">
|
|
609
|
+
|
|
610
|
+

|
|
611
|
+
|
|
612
|
+
## Promotions are now faster and more reliable
|
|
613
|
+
|
|
614
|
+
We moved Promotions storage to DynamoDB. This gives promotion rules
|
|
615
|
+
a durable home across the dashboard, APIs, and hosted checkout.
|
|
616
|
+
|
|
617
|
+
Example: A merchant selling an AI support agent can create `STARTUP20`,
|
|
618
|
+
limit it to the Pro plan, and keep the rule available when checkout
|
|
619
|
+
links are regenerated.
|
|
620
|
+
|
|
621
|
+
## Promotions are now available in the dashboard
|
|
622
|
+
|
|
623
|
+
We added Promotions to the Kelviq dashboard. Teams can now create,
|
|
624
|
+
review, and manage offers without asking engineering to touch config.
|
|
625
|
+
The flow is built around what a billing owner actually needs to know:
|
|
626
|
+
which plan is discounted, whether the promotion is active, and where
|
|
627
|
+
the SDK docs are when you need to wire it up from code.
|
|
628
|
+
|
|
629
|
+
A common flow looks like this:
|
|
630
|
+
|
|
631
|
+
1. Create a product
|
|
632
|
+
2. Create a plan
|
|
633
|
+
3. Add a promotion
|
|
634
|
+
4. Copy the checkout link
|
|
635
|
+
5. Share the link or add it to your pricing page
|
|
636
|
+
|
|
637
|
+
## API and SDK docs are linked from Promotions
|
|
638
|
+
|
|
639
|
+
The dashboard now connects promotion setup to the integration docs a developer needs when creating checkout sessions from the backend. This helps developers move from setup to integration faster.
|
|
640
|
+
|
|
641
|
+
## Checkout link empty screen is clearer
|
|
642
|
+
|
|
643
|
+
The empty screen now points users toward creating or copying the right checkout link instead of leaving the page feeling broken.
|
|
644
|
+
|
|
645
|
+
## Checkout links are easier to access
|
|
646
|
+
|
|
647
|
+
You can now get checkout links from product and plan listing pages. This saves time when you are setting up a product and want to quickly copy a checkout link.
|
|
648
|
+
|
|
649
|
+
## Product cards are now fully clickable
|
|
650
|
+
|
|
651
|
+
Instead of clicking only on a small button or title, you can click anywhere on the product card to open it. This makes navigation easier when you have multiple products.
|
|
652
|
+
|
|
653
|
+
## Developers tab is now API Key
|
|
654
|
+
|
|
655
|
+
We renamed the Developers tab to API Key. Most people go there to find their API key, so the label now matches the destination.
|
|
656
|
+
|
|
657
|
+
Before: **Developers**
|
|
658
|
+
|
|
659
|
+
Now: **API Key**
|
|
660
|
+
|
|
661
|
+
## Chart theming support
|
|
662
|
+
|
|
663
|
+
We added theming options for charts, including branded and dark mode. Charts now stay consistent with the rest of your dashboard without manual workarounds.
|
|
664
|
+
|
|
665
|
+
## Analytics style update
|
|
666
|
+
|
|
667
|
+
We updated the analytics UI style to make revenue, customers,
|
|
668
|
+
transactions, and product data easier to scan.
|
|
669
|
+
|
|
670
|
+
This is helpful when you want to quickly answer questions like:
|
|
671
|
+
|
|
672
|
+
- How much did we sell today?
|
|
673
|
+
- Which plan is performing better?
|
|
674
|
+
- Which product has the most transactions?
|
|
675
|
+
- Are refunds increasing?
|
|
676
|
+
- Are more customers choosing annual plans?
|
|
677
|
+
|
|
678
|
+
## Docs copy cleanup
|
|
679
|
+
|
|
680
|
+
We updated docs copy from `archive` to `delete` in more places.
|
|
681
|
+
This makes the docs match the real product action.
|
|
682
|
+
|
|
683
|
+
## Fixes
|
|
684
|
+
|
|
685
|
+
**Duplicate file upload issue** —
|
|
686
|
+
Fixed an issue where duplicate files could be created during
|
|
687
|
+
multiple file uploads.
|
|
688
|
+
|
|
689
|
+
**Plan dialog issue** —
|
|
690
|
+
Fixed an issue where the add plan dialog closed even when the
|
|
691
|
+
user selected the option to create more plans. Now users can
|
|
692
|
+
create multiple plans without reopening the dialog each time.
|
|
693
|
+
|
|
694
|
+
**Feature delete issue** —
|
|
695
|
+
Fixed an issue where a feature was not removed correctly from
|
|
696
|
+
the list after deletion.
|
|
697
|
+
|
|
698
|
+
</Update>
|
|
699
|
+
|
|
7
700
|
<Update label="v1.5" description="May 15, 2026">
|
|
8
701
|
|
|
9
702
|
### Payments & Billing
|