@kelviq/mcp-server 0.2.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/LICENSE +21 -0
- package/README.md +322 -0
- package/dist/config.d.ts +16 -0
- package/dist/config.js +45 -0
- package/dist/config.js.map +1 -0
- package/dist/docs/README.md +128 -0
- package/dist/docs/api-reference/authentication.md +41 -0
- package/dist/docs/backend-integration/node-sdk.md +1040 -0
- package/dist/docs/backend-integration/python-sdk.md +1198 -0
- package/dist/docs/changelog/app.md +80 -0
- package/dist/docs/changelog/checkout-api.md +59 -0
- package/dist/docs/changelog/js-promotions-ui.md +14 -0
- package/dist/docs/changelog/js-sdk.md +281 -0
- package/dist/docs/changelog/node-sdk.md +378 -0
- package/dist/docs/changelog/python-sdk.md +456 -0
- package/dist/docs/changelog/react-sdk.md +580 -0
- package/dist/docs/checkout/checkout-configuration.md +434 -0
- package/dist/docs/coustomers-management/overview.md +111 -0
- package/dist/docs/customer-portal/overview.md +81 -0
- package/dist/docs/frontend-integration/js-sdk.md +676 -0
- package/dist/docs/frontend-integration/promotions-ui-js.md +265 -0
- package/dist/docs/frontend-integration/react-promotions-ui.md +361 -0
- package/dist/docs/frontend-integration/react-sdk.md +1187 -0
- package/dist/docs/frontend-integration/react-ui.md +771 -0
- package/dist/docs/getstarted/fees.md +160 -0
- package/dist/docs/getstarted/introduction-to-kelviq.md +80 -0
- package/dist/docs/getstarted/merchant-of-record.md +64 -0
- package/dist/docs/getstarted/review-process.md +190 -0
- package/dist/docs/guides/subscription-integration-for-nextjs.md +512 -0
- package/dist/docs/guides/subscription-integration.md +291 -0
- package/dist/docs/guides/webhooks.md +963 -0
- package/dist/docs/legal/approved-prohibited-policy.md +252 -0
- package/dist/docs/legal/buyer-terms.md +177 -0
- package/dist/docs/legal/compliant-user-flow.md +216 -0
- package/dist/docs/legal/master-service-agreement.md +404 -0
- package/dist/docs/legal/payment-flow-diagram.md +188 -0
- package/dist/docs/legal/seller-terms.md +169 -0
- package/dist/docs/manifest.json +415 -0
- package/dist/docs/monetization/offerings.md +156 -0
- package/dist/docs/monetization/pricing-tables.md +226 -0
- package/dist/docs/monetization/targeting-rules.md +278 -0
- package/dist/docs/openapi.json +5479 -0
- package/dist/docs/payouts/overview.md +43 -0
- package/dist/docs/payouts/payout-account.md +12 -0
- package/dist/docs/payouts/transactions.md +23 -0
- package/dist/docs/product-catalog/digital-downloads.md +117 -0
- package/dist/docs/product-catalog/discounts.md +69 -0
- package/dist/docs/product-catalog/entitlements.md +428 -0
- package/dist/docs/product-catalog/free-and-trials.md +36 -0
- package/dist/docs/product-catalog/license-keys.md +324 -0
- package/dist/docs/product-catalog/links.md +92 -0
- package/dist/docs/product-catalog/location-based-pricing.md +41 -0
- package/dist/docs/product-catalog/one-time-payments.md +24 -0
- package/dist/docs/product-catalog/plans.md +199 -0
- package/dist/docs/product-catalog/products.md +60 -0
- package/dist/docs/product-catalog/subscriptions.md +29 -0
- package/dist/docs/product-catalog/tax-settings.md +37 -0
- package/dist/docs/product-catalog/usage-based-billing.md +119 -0
- package/dist/docs/promotions/create-a-promotion.md +75 -0
- package/dist/docs/promotions/customize-banner.md +41 -0
- package/dist/docs/promotions/integrate.md +38 -0
- package/dist/docs/promotions/overview.md +51 -0
- package/dist/docs/quickstart/core-concepts.md +146 -0
- package/dist/docs/quickstart/dashboard-setup.md +129 -0
- package/dist/docs/quickstart/integrate-with-your-app.md +149 -0
- package/dist/docs/sales/checkout-sessions.md +58 -0
- package/dist/docs/sales/orders.md +76 -0
- package/dist/http/client.d.ts +28 -0
- package/dist/http/client.js +76 -0
- package/dist/http/client.js.map +1 -0
- package/dist/http/errors.d.ts +20 -0
- package/dist/http/errors.js +58 -0
- package/dist/http/errors.js.map +1 -0
- package/dist/resources/docs-index.d.ts +25 -0
- package/dist/resources/docs-index.js +109 -0
- package/dist/resources/docs-index.js.map +1 -0
- package/dist/resources/index.d.ts +2 -0
- package/dist/resources/index.js +73 -0
- package/dist/resources/index.js.map +1 -0
- package/dist/schemas/kelviq.d.ts +1304 -0
- package/dist/schemas/kelviq.js +468 -0
- package/dist/schemas/kelviq.js.map +1 -0
- package/dist/server.d.ts +2 -0
- package/dist/server.js +41 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/_util.d.ts +15 -0
- package/dist/tools/_util.js +15 -0
- package/dist/tools/_util.js.map +1 -0
- package/dist/tools/checkout.d.ts +3 -0
- package/dist/tools/checkout.js +18 -0
- package/dist/tools/checkout.js.map +1 -0
- package/dist/tools/customers.d.ts +3 -0
- package/dist/tools/customers.js +32 -0
- package/dist/tools/customers.js.map +1 -0
- package/dist/tools/docs.d.ts +2 -0
- package/dist/tools/docs.js +43 -0
- package/dist/tools/docs.js.map +1 -0
- package/dist/tools/entitlements.d.ts +3 -0
- package/dist/tools/entitlements.js +22 -0
- package/dist/tools/entitlements.js.map +1 -0
- package/dist/tools/features.d.ts +3 -0
- package/dist/tools/features.js +55 -0
- package/dist/tools/features.js.map +1 -0
- package/dist/tools/index.d.ts +3 -0
- package/dist/tools/index.js +44 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/licenses.d.ts +3 -0
- package/dist/tools/licenses.js +44 -0
- package/dist/tools/licenses.js.map +1 -0
- package/dist/tools/media.d.ts +3 -0
- package/dist/tools/media.js +18 -0
- package/dist/tools/media.js.map +1 -0
- package/dist/tools/offerings.d.ts +3 -0
- package/dist/tools/offerings.js +21 -0
- package/dist/tools/offerings.js.map +1 -0
- package/dist/tools/partner.d.ts +3 -0
- package/dist/tools/partner.js +55 -0
- package/dist/tools/partner.js.map +1 -0
- package/dist/tools/plan-entitlements.d.ts +3 -0
- package/dist/tools/plan-entitlements.js +56 -0
- package/dist/tools/plan-entitlements.js.map +1 -0
- package/dist/tools/plan-files.d.ts +3 -0
- package/dist/tools/plan-files.js +43 -0
- package/dist/tools/plan-files.js.map +1 -0
- package/dist/tools/plans.d.ts +3 -0
- package/dist/tools/plans.js +120 -0
- package/dist/tools/plans.js.map +1 -0
- package/dist/tools/portal.d.ts +3 -0
- package/dist/tools/portal.js +18 -0
- package/dist/tools/portal.js.map +1 -0
- package/dist/tools/product-files.d.ts +3 -0
- package/dist/tools/product-files.js +31 -0
- package/dist/tools/product-files.js.map +1 -0
- package/dist/tools/product-settings.d.ts +3 -0
- package/dist/tools/product-settings.js +31 -0
- package/dist/tools/product-settings.js.map +1 -0
- package/dist/tools/products.d.ts +3 -0
- package/dist/tools/products.js +69 -0
- package/dist/tools/products.js.map +1 -0
- package/dist/tools/promotions.d.ts +3 -0
- package/dist/tools/promotions.js +19 -0
- package/dist/tools/promotions.js.map +1 -0
- package/dist/tools/subscriptions.d.ts +3 -0
- package/dist/tools/subscriptions.js +63 -0
- package/dist/tools/subscriptions.js.map +1 -0
- package/dist/tools/usage.d.ts +3 -0
- package/dist/tools/usage.js +18 -0
- package/dist/tools/usage.js.map +1 -0
- package/package.json +88 -0
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Fees"
|
|
3
|
+
slug: "getstarted/fees"
|
|
4
|
+
section: "getstarted"
|
|
5
|
+
description: "Kelviq's transparent pricing structure"
|
|
6
|
+
---
|
|
7
|
+
Kelviq operates as a [Merchant of Record](/getstarted/merchant-of-record), handling payments, tax compliance, and global selling on your behalf. Our pricing is simple and all-inclusiveโno hidden fees, no monthly minimums.
|
|
8
|
+
|
|
9
|
+
## What's Included
|
|
10
|
+
|
|
11
|
+
Your transaction fee covers everything you need to sell globally:
|
|
12
|
+
|
|
13
|
+
- Payment processing (cards, wallets, local payment methods)
|
|
14
|
+
- Sales tax, VAT, and GST calculation, collection, and remittance
|
|
15
|
+
- Fraud protection and chargeback handling
|
|
16
|
+
- Localized pricing in 135+ currencies
|
|
17
|
+
- Compliance with regional regulations
|
|
18
|
+
- Usage metering and billing
|
|
19
|
+
- License key generation
|
|
20
|
+
- Digital product and file delivery
|
|
21
|
+
- Feature and entitlement management
|
|
22
|
+
- Customer billing portal
|
|
23
|
+
|
|
24
|
+
## Transaction Fees
|
|
25
|
+
|
|
26
|
+
Fees are charged only on successful transactions:
|
|
27
|
+
|
|
28
|
+
| Fee Type | Rate | Description |
|
|
29
|
+
|----------|------|-------------|
|
|
30
|
+
| Base fee | 3.5% + $0.40 | Applied to every transaction |
|
|
31
|
+
| International cards | +1.5% | Cards issued outside the US |
|
|
32
|
+
| Recurring billing | +0.7% | Subscription and renewal charges |
|
|
33
|
+
|
|
34
|
+
Fees are calculated on the transaction amount before tax.
|
|
35
|
+
|
|
36
|
+
## Fee Examples
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
**$100 product, US customer, US-issued card**
|
|
41
|
+
|
|
42
|
+
| Component | Calculation | Amount |
|
|
43
|
+
|-----------|-------------|--------|
|
|
44
|
+
| Base fee | $100 ร 3.5% | $3.50 |
|
|
45
|
+
| Fixed fee | โ | $0.40 |
|
|
46
|
+
| **Total fee** | | **$3.90** |
|
|
47
|
+
|
|
48
|
+
You receive: $96.10
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
**$100 product, UK customer, UK-issued card**
|
|
54
|
+
|
|
55
|
+
| Component | Calculation | Amount |
|
|
56
|
+
|-----------|-------------|--------|
|
|
57
|
+
| Base fee | $100 ร 3.5% | $3.50 |
|
|
58
|
+
| Fixed fee | โ | $0.40 |
|
|
59
|
+
| International | $100 ร 1.5% | $1.50 |
|
|
60
|
+
| **Total fee** | | **$5.40** |
|
|
61
|
+
|
|
62
|
+
You receive: $94.60
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
**$50/month subscription, US customer, US-issued card**
|
|
68
|
+
|
|
69
|
+
| Component | Calculation | Amount |
|
|
70
|
+
|-----------|-------------|--------|
|
|
71
|
+
| Base fee | $50 ร 3.5% | $1.75 |
|
|
72
|
+
| Fixed fee | โ | $0.40 |
|
|
73
|
+
| Recurring | $50 ร 0.7% | $0.35 |
|
|
74
|
+
| **Total fee** | | **$2.50** |
|
|
75
|
+
|
|
76
|
+
You receive: $47.50 per month
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
**$50/month subscription, German customer, German-issued card**
|
|
82
|
+
|
|
83
|
+
| Component | Calculation | Amount |
|
|
84
|
+
|-----------|-------------|--------|
|
|
85
|
+
| Base fee | $50 ร 3.5% | $1.75 |
|
|
86
|
+
| Fixed fee | โ | $0.40 |
|
|
87
|
+
| International | $50 ร 1.5% | $0.75 |
|
|
88
|
+
| Recurring | $50 ร 0.7% | $0.35 |
|
|
89
|
+
| **Total fee** | | **$3.25** |
|
|
90
|
+
|
|
91
|
+
You receive: $46.75 per month
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
## Refunds
|
|
95
|
+
|
|
96
|
+
When you issue a refund to a customer, the original transaction fee is **retained**. This applies to both full and partial refunds.
|
|
97
|
+
|
|
98
|
+
| Scenario | What happens |
|
|
99
|
+
|----------|--------------|
|
|
100
|
+
| Full refund | Customer receives full amount; original fee retained |
|
|
101
|
+
| Partial refund | Customer receives partial amount; proportional fee retained |
|
|
102
|
+
|
|
103
|
+
Our payment partners charge non-refundable processing fees on the original transaction. We pass this cost structure through to maintain transparent pricing.
|
|
104
|
+
|
|
105
|
+
## Disputes & Chargebacks
|
|
106
|
+
|
|
107
|
+
When a customer disputes a charge with their bank, a **$15 fee** applies regardless of the dispute outcome.
|
|
108
|
+
|
|
109
|
+
| Outcome | Fee | Transaction amount |
|
|
110
|
+
|---------|-----|-------------------|
|
|
111
|
+
| You win | $15 | Returned to you |
|
|
112
|
+
| You lose | $15 | Refunded to customer |
|
|
113
|
+
|
|
114
|
+
### Reducing Disputes
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
|
|
118
|
+
Use a recognizable business name on statements so customers remember the purchase.
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
Make it easy for customers to contact you before they escalate to their bank.
|
|
124
|
+
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
Set clear expectations about what customers are purchasing and delivery timelines.
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
For subscriptions, provide a simple way to cancel to prevent "friendly fraud" disputes.
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
## FAQ
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
Fees are deducted automatically from each transaction before the payout reaches your account.
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
No. You only pay when you make a sale. There are no setup fees, monthly fees, or minimum transaction requirements.
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
A transaction is considered international when the customer's card is issued outside the United States. Since Kelviq is the Merchant of Record registered in the US, this applies regardless of where your business is located.
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
No. Fees only apply to successful paid transactions. $0 trial authorizations do not incur fees.
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
|
|
160
|
+
No fees are charged for declined or failed transactions.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Introduction to kelviq"
|
|
3
|
+
slug: "getstarted/introduction-to-kelviq"
|
|
4
|
+
section: "getstarted"
|
|
5
|
+
---
|
|
6
|
+
##### Kelviq is the complete monetization platform for your SaaS, AI agents, and digital products. It combines a merchant of record, subscription management, and usage-based billing into one system so you can set prices, track variable compute costs, collect payments, and stay compliant with global tax.
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Why Kelviq
|
|
11
|
+
|
|
12
|
+
Monetization is more than just a payment. It's a complex system of pricing models, usage metering, subscription logic, feature access, global tax, and compliance. Building this from scratch takes months of engineering time and ongoing legal overhead.
|
|
13
|
+
|
|
14
|
+
Kelviq is the complete revenue system that handles all this complexity for you. You can launch any pricing model and sell globally from day one, all while staying compliant.
|
|
15
|
+
|
|
16
|
+
With Kelviq you can:
|
|
17
|
+
|
|
18
|
+
- **Get started in minutes** You donโt have to handle dozens of webhooks, build a database layer to track customers, manage subscription states, or hardcode feature access. Kelviq provides a single, unified system.
|
|
19
|
+
|
|
20
|
+
- **Handle Global Tax & Compliance Automatically** As your Merchant of Record, Kelviq takes on the full liability for global sales tax (VAT, GST, etc.), fraud, and regulatory compliance. You can sell in 100+ countries without ever registering for a foreign tax ID.
|
|
21
|
+
|
|
22
|
+
- **Run any pricing model** Flat fee, usage, seats, tiers, volume, credits, pay-as-you-go, overage charges, or hybrids. Configure them in minutes.
|
|
23
|
+
|
|
24
|
+
- **Sell digital products with ease** Securely deliver files, e-books, or software on purchase and automatically generates license keys right after checkout.
|
|
25
|
+
|
|
26
|
+
- **Meter usage in real time** Track every API request, workflow run, background agent task, or LLM token usage as it happens. Set soft or hard caps, pick reset cycles, send alerts, and handle overages with one call.
|
|
27
|
+
|
|
28
|
+
- **Control feature access** Define features per plan. Turn them on or off and check access in your app with one SDK call.
|
|
29
|
+
|
|
30
|
+
- **Localized pricing by country** Offer country-specific prices in 135+ currencies with VPN, proxy, and fraud protection built in. You can also set up promotions for specific countries.
|
|
31
|
+
|
|
32
|
+
- **Ship pricing changes without touching code** A/B test plans, roll out changes, or update pricing in real time without redeploys.
|
|
33
|
+
|
|
34
|
+
- **Manage the full customer lifecycle** Handle upgrades, downgrades, migrations, overrides, and grandfathering without writing custom scripts.
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
## How Kelviq is Different
|
|
38
|
+
|
|
39
|
+
Traditional billing forces you to build complex infrastructure. Kelviq eliminates this overhead entirely.
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
Stop handling dozens of webhook events to sync subscription state. Query customer data directly from our APIโalways accurate, always real-time.
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
No more subscription tables in your database. No sync jobs. No stale data. Kelviq is your source of truth.
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
Stop scattering feature checks throughout your codebase. Check entitlements with one SDK call. Update plans from the dashboard.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
Change prices, plans, trials, or entitlements from the dashboard. Ship pricing changes instantly without waiting for engineering.
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Who kelviq is for
|
|
64
|
+
|
|
65
|
+
- **AI product companies** โ track what your autonomous agents do for each customer and bill based on actual usage. Maintain healthy unit economics as your underlying compute costs scale.
|
|
66
|
+
|
|
67
|
+
- **Developers** โ integrate billing without spending weeks writing complex custom usage code, database sync jobs, or webhook listeners.
|
|
68
|
+
|
|
69
|
+
- **Product managers** โ take ownership of pricing and plans. Run experiments, roll out promotions, and update entitlements directly from the dashboard without waiting for engineering.
|
|
70
|
+
|
|
71
|
+
- **Founders** โ Launch globally from day one without becoming a tax expert. Kelviq acts as your merchant of record and takes on the full legal liability for VAT, sales tax, and compliance so you can focus on building the product.
|
|
72
|
+
|
|
73
|
+
- **Digital creators** โ Sell your e-books, software, design assets, or courses with zero hassle. Kelviq provides a complete, all-in-one solution that securely delivers your files, generates license keys, and handles all global taxes for youโno code or complex setup required.
|
|
74
|
+
|
|
75
|
+
## Need help?
|
|
76
|
+
|
|
77
|
+
Have questions, need help with implementation, or want a walkthrough?
|
|
78
|
+
Email us at **hi@kelviq.com** or [book a demo](https://tidycal.com/neravath/15-minute-meeting).
|
|
79
|
+
|
|
80
|
+
---
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Merchant of Record"
|
|
3
|
+
slug: "getstarted/merchant-of-record"
|
|
4
|
+
section: "getstarted"
|
|
5
|
+
---
|
|
6
|
+
Kelviq operates as your Merchant of Record (MoR). This means we are the legal reseller of your products to the end customer. We handle the taxes, compliance, and payment liability so you donโt have to.
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## What is a Merchant of Record (MOR)?
|
|
11
|
+
|
|
12
|
+
The "Merchant of Record" is the most important concept to understand when using Kelviq. It's the engine that enables you to sell globally without handling the legal and financial complexity yourself.
|
|
13
|
+
|
|
14
|
+
A Merchant of Record is the entity that is **legally responsible for selling a product to an end customer**.
|
|
15
|
+
|
|
16
|
+
When a customer buys your product, their financial transaction is with the MOR (Kelviq), not with your company. We take on the responsibility for that sale, handling all the complex financial and legal requirements that come with it.
|
|
17
|
+
|
|
18
|
+
This model allows you to focus 100% on building your product while we handle the entire checkout, tax, and compliance backend.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
### The Core Responsibilities of an MOR
|
|
23
|
+
|
|
24
|
+
By acting as your MOR, Kelviq takes on a massive amount of financial and legal liability. This is the "hard part" of global sales that we handle for you:
|
|
25
|
+
|
|
26
|
+
* **๐ Global Tax & Compliance**
|
|
27
|
+
This is the single biggest challenge of selling online. An MOR is responsible for calculating, collecting, and remitting sales taxes like VAT (Europe), GST (Australia), JCT (Japan), and state-level sales tax in the U.S.
|
|
28
|
+
* **๐ก๏ธ Financial Liability & Risk**
|
|
29
|
+
The MOR is financially liable for every transaction. This includes bearing the cost of customer chargebacks (disputes) and all fraudulent payments.
|
|
30
|
+
* **โ๏ธ Payment & Regulatory Burden**
|
|
31
|
+
The MOR ensures that every part of the checkout and payment process is compliant with global regulations, such as PCI-DSS and PSD2/SCA.
|
|
32
|
+
|
|
33
|
+
### How it Works: A Real-World Example
|
|
34
|
+
|
|
35
|
+
To understand exactly where the money goes, let's look at a specific transaction.
|
|
36
|
+
|
|
37
|
+
1. **The Sale:** A customer in **Germany** visits your site and buys your product. You have set the price at **โฌ50.00**.
|
|
38
|
+
2. **The Calculation:** Kelviq automatically detects the customer is in Germany and adds the 19% German VAT (โฌ9.50). The customer pays a total of **โฌ59.50**.
|
|
39
|
+
3. **The Legal Transaction:** The customer's โฌ59.50 transaction is legally with Kelviq. We are the "seller" on their invoice.
|
|
40
|
+
4. **Tax Remittance (The Hard Part):** At the end of the quarter, our finance team takes that **โฌ9.50** and files the VAT return with the German authorities. You never see or touch this tax money, so you never have to worry about it.
|
|
41
|
+
5. **Your Payout:** We take our simple platform fee from the original **โฌ50.00** and deposit the rest directly into your bank account.
|
|
42
|
+
|
|
43
|
+
You get your expected revenue. We handle the legal and tax complexity of the extra โฌ9.50.
|
|
44
|
+
|
|
45
|
+
### MOR vs. Payment Service Provider (PSP)
|
|
46
|
+
|
|
47
|
+
A PSP (like Stripe or PayPal) gives you the *tools* to process a payment, but **you** are still the seller of record.
|
|
48
|
+
|
|
49
|
+
| Feature | Payment Service Provider (PSP) | Merchant of Record (Kelviq) |
|
|
50
|
+
| :--- | :--- | :--- |
|
|
51
|
+
| **Who is the Seller?** | **You** are the seller of record. | **Kelviq** is the seller of record. |
|
|
52
|
+
| **Tax Liability** | **Your responsibility.** You must register, file, and remit. | **Kelviq's responsibility.** We handle all filing and payments. |
|
|
53
|
+
| **Fraud Risk** | **You.** You lose the sale + fees on chargebacks. | **Kelviq.** We take the financial hit. |
|
|
54
|
+
| **Time to Market** | Weeks or months of setup. | Minutes. |
|
|
55
|
+
|
|
56
|
+
### Your Two Model Choices in Kelviq
|
|
57
|
+
|
|
58
|
+
Kelviq is designed to be flexible, offering two primary ways to operate:
|
|
59
|
+
|
|
60
|
+
**1. Kelviq as your Merchant of Record (Recommended)**
|
|
61
|
+
This is the default and recommended model. When you sign up, Kelviq acts as your MOR, handling all the responsibilities described on this page. You get the full all-in-one platform with zero compliance overhead.
|
|
62
|
+
|
|
63
|
+
**2. Bring Your Own Stripe Account (BYOA)**
|
|
64
|
+
For businesses that prefer to remain the Merchant of Record, you can connect your own Stripe account. In this model, **you are responsible for your own tax, fraud, and compliance**, but you still get access to all of Kelviq's monetization featuresโsuch as our usage-based billing engine, feature flagging, and localization tools. Please contact us at hi@kelviq.com to enable this option.
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Review Process"
|
|
3
|
+
slug: "getstarted/review-process"
|
|
4
|
+
section: "getstarted"
|
|
5
|
+
---
|
|
6
|
+
Because Kelviq operates as your **Merchant of Record (MOR)**, we are legally and financially responsible for every transaction processed through our platform. To ensure the safety of the ecosystem and comply with global financial regulations, we must strictly review the businesses we support.
|
|
7
|
+
|
|
8
|
+
This guide outlines what we support, what we prohibit, and how our review process works.
|
|
9
|
+
|
|
10
|
+
## 1. Supported Business Models
|
|
11
|
+
|
|
12
|
+
Kelviq is optimized for **digital products and software**. We are the best fit for:
|
|
13
|
+
|
|
14
|
+
* **SaaS & Software:** B2B or B2C web applications, desktop software, AI tools, and browser extensions.
|
|
15
|
+
* **Digital Downloads:** E-books, PDFs, design templates, audio files, video courses, and fonts.
|
|
16
|
+
* **Membership Sites:** Newsletters, research communities, and gated content.
|
|
17
|
+
* **Professional Services:** *Only if sold alongside a software product (e.g., "Setup Fee" or "Priority Support").*
|
|
18
|
+
|
|
19
|
+
> **The Golden Rule:**
|
|
20
|
+
> Your product should be **digital**, **owned by you** (or properly licensed), and **deliverable immediately** upon purchase.
|
|
21
|
+
|
|
22
|
+
### โ The Three Fundamental Limitations
|
|
23
|
+
|
|
24
|
+
Before proceeding, please note the three "Hard No" rules of our MOR service:
|
|
25
|
+
|
|
26
|
+
1. **Digital Only:** We cannot support physical goods, shipping, or logistics.
|
|
27
|
+
2. **No Manual Services:** We cannot support 1-on-1 coaching, consulting, or agencies where the primary value is your manual labor.
|
|
28
|
+
3. **No Marketplaces:** You must be the original creator or licensed distributor. You cannot use Kelviq to process payments for other unverified sellers.
|
|
29
|
+
|
|
30
|
+
## 2. Global Compliance & High-Risk Categories (Prohibited)
|
|
31
|
+
|
|
32
|
+
We are required by law and our financial partners to block any product or service that is illegal, deceptive, or creates a high financial risk.
|
|
33
|
+
|
|
34
|
+
This list is not exhaustive, and we reserve the right to review, suspend, or terminate any account that we believe violates the spirit of these rules.
|
|
35
|
+
|
|
36
|
+
### A. Illegal, Deceptive, or Hateful Content
|
|
37
|
+
* Any product or service that is illegal in the U.S. or your customer's location.
|
|
38
|
+
* Content that infringes on someone else's Intellectual Property (IP), copyright, or trademark. (e.g., pirated software, stolen ebooks, cracked license keys).
|
|
39
|
+
* Hate speech or content that promotes violence, self-harm, or discrimination against any group.
|
|
40
|
+
* Deceptive marketing practices, fake testimonials, or unrealistic "get rich quick" schemes.
|
|
41
|
+
* Low-value, exploitative content (e.g., rapidly AI-generated ebooks with minimal substance sold at a high price).
|
|
42
|
+
* Identity services, fake IDs, or products that support academic cheating.
|
|
43
|
+
|
|
44
|
+
### B. Financial and Legal Services
|
|
45
|
+
* **Regulated Financial Products:** We cannot sell investment advice, trading signals, cryptocurrency, NFTs, lending services, or act as a money transmitter.
|
|
46
|
+
* **Gambling:** All forms of gambling, betting, or games of chance.
|
|
47
|
+
* **Regulated Professional Services:** We cannot sell legal, tax, or accounting advice.
|
|
48
|
+
* **Donations:** We cannot process donations where no specific product is delivered.
|
|
49
|
+
* **Regulatory Evasion:** Any service designed to help others evade taxes, mask their identity, or bypass financial regulations.
|
|
50
|
+
|
|
51
|
+
### C. Adult & Regulated Industries
|
|
52
|
+
* **Adult Content:** Explicitly sexual content (videos, images, text), whether real or **AI-generated**. This includes "AI Girlfriend/Boyfriend" services, NSFW chatbots, and services related to OnlyFans.
|
|
53
|
+
* **Controlled Substances:** Alcohol, tobacco, vaping products, drugs, or drug paraphernalia.
|
|
54
|
+
* **Weapons:** Firearms, ammunition, explosives, or combat training.
|
|
55
|
+
* **Pharmaceuticals:** Prescription drugs or unverified medical/wellness supplements.
|
|
56
|
+
|
|
57
|
+
### D. Platform & Technology Abuse
|
|
58
|
+
* **Spam & Scraping:** Tools for mass cold emailing, lead scraping, or sending bulk SMS/WhatsApp messages.
|
|
59
|
+
* **Hacking & Cheating:** Tools designed to cheat in games, bypass software rules, or gain unauthorized access.
|
|
60
|
+
* **Circumvention Tools:** Services that bypass API limits, platform rules, or geo-restrictions (e.g., IP cloaking).
|
|
61
|
+
* **Surveillance Tech:** Products that violate user privacy or enable unauthorized surveillance (e.g., keyloggers, stalkerware).
|
|
62
|
+
|
|
63
|
+
## 3. Restricted Businesses (Requires Extensive Review)
|
|
64
|
+
|
|
65
|
+
The following businesses are not automatically prohibited, but they are considered high-risk and require extensive review by our compliance team. Approval is not guaranteed and may be subject to additional conditions (like holding funds in reserve).
|
|
66
|
+
|
|
67
|
+
* **AI-Powered Services:** Especially tools for AI-generated text, images, or voice. We need to review your product to ensure it has proper safeguards against generating harmful, deceptive, or adult content.
|
|
68
|
+
* **Marketing Services:** Some marketing tools may be allowed, but we must review them to ensure they do not facilitate spam or mass outreach.
|
|
69
|
+
* **Pre-Orders & Paid Waitlists:** We generally **do not** allow pre-orders. This is a very high-risk category for an MOR. In rare cases, we may make an exception for established creators, but funds will be withheld until the product is verifiably shipped.
|
|
70
|
+
|
|
71
|
+
## 4. Prohibited & Supported Countries
|
|
72
|
+
|
|
73
|
+
### Prohibited Countries
|
|
74
|
+
As a U.S. company, Kelviq is required to comply with U.S. sanctions laws (OFAC). We are **strictly prohibited** from doing business with any individual or entity located in:
|
|
75
|
+
|
|
76
|
+
* North Korea
|
|
77
|
+
* Iran
|
|
78
|
+
* Cuba
|
|
79
|
+
* Syria
|
|
80
|
+
* Russia
|
|
81
|
+
* Belarus
|
|
82
|
+
* The regions of Crimea, Donetsk, and Luhansk
|
|
83
|
+
|
|
84
|
+
### Supported Payout Countries
|
|
85
|
+
We support businesses registered in **90+ countries**. You can receive payouts in your local bank account in currencies including USD, EUR, GBP, CAD, AUD, INR, and more.
|
|
86
|
+
|
|
87
|
+
| | | |
|
|
88
|
+
| :--- | :--- | :--- |
|
|
89
|
+
| ๐ฆ๐ฑ Albania | ๐ฆ๐ฌ Antigua & Barbuda | ๐ฆ๐ท Argentina |
|
|
90
|
+
| ๐ฆ๐ฒ Armenia | ๐ฆ๐บ Australia | ๐ฆ๐น Austria |
|
|
91
|
+
| ๐ง๐ธ Bahamas | ๐ง๐ญ Bahrain | ๐ง๐ช Belgium |
|
|
92
|
+
| ๐ง๐ฏ Benin | ๐ง๐ด Bolivia | ๐ง๐ฆ Bosnia & Herzegovina |
|
|
93
|
+
| ๐ง๐ผ Botswana | ๐ง๐ณ Brunei | ๐ง๐ฌ Bulgaria |
|
|
94
|
+
| ๐ฐ๐ญ Cambodia | ๐จ๐ฆ Canada | ๐จ๐ฑ Chile |
|
|
95
|
+
| ๐จ๐ด Colombia | ๐จ๐ท Costa Rica | ๐จ๐ฎ Cรดte d'Ivoire |
|
|
96
|
+
| ๐จ๐พ Cyprus | ๐จ๐ฟ Czech Republic | ๐ฉ๐ฐ Denmark |
|
|
97
|
+
| ๐ฉ๐ด Dominican Republic | ๐ช๐จ Ecuador | ๐ช๐ฌ Egypt |
|
|
98
|
+
| ๐ธ๐ป El Salvador | ๐ช๐ช Estonia | ๐ช๐น Ethiopia |
|
|
99
|
+
| ๐ซ๐ฎ Finland | ๐ซ๐ท France | ๐ฌ๐ฒ Gambia |
|
|
100
|
+
| ๐ฉ๐ช Germany | ๐ฌ๐ญ Ghana | ๐ฌ๐ท Greece |
|
|
101
|
+
| ๐ฌ๐น Guatemala | ๐ฌ๐พ Guyana | ๐ญ๐ฐ Hong Kong |
|
|
102
|
+
| ๐ญ๐บ Hungary | ๐ฎ๐ณ India | ๐ฎ๐ธ Iceland |
|
|
103
|
+
| ๐ฎ๐ช Ireland | ๐ฎ๐ฑ Israel | ๐ฎ๐น Italy |
|
|
104
|
+
| ๐ฏ๐ฒ Jamaica | ๐ฏ๐ต Japan | ๐ฏ๐ด Jordan |
|
|
105
|
+
| ๐ฐ๐ช Kenya | ๐ฐ๐ผ Kuwait | ๐ฑ๐ป Latvia |
|
|
106
|
+
| ๐ฑ๐น Lithuania | ๐ฑ๐บ Luxembourg | ๐ฒ๐ด Macao SAR China |
|
|
107
|
+
| ๐ฒ๐ฌ Madagascar | ๐ฒ๐น Malta | ๐ฒ๐บ Mauritius |
|
|
108
|
+
| ๐ฒ๐ฝ Mexico | ๐ฒ๐ฉ Moldova | ๐ฒ๐จ Monaco |
|
|
109
|
+
| ๐ฒ๐ณ Mongolia | ๐ฒ๐ฆ Morocco | ๐ณ๐ฆ Namibia |
|
|
110
|
+
| ๐ณ๐ฑ Netherlands | ๐ณ๐ฟ New Zealand | ๐ณ๐ฌ Nigeria |
|
|
111
|
+
| ๐ฒ๐ฐ North Macedonia | ๐ณ๐ด Norway | ๐ด๐ฒ Oman |
|
|
112
|
+
| ๐ต๐ฐ Pakistan | ๐ต๐ฆ Panama | ๐ต๐พ Paraguay |
|
|
113
|
+
| ๐ต๐ช Peru | ๐ต๐ญ Philippines | ๐ต๐ฑ Poland |
|
|
114
|
+
| ๐ต๐น Portugal | ๐ถ๐ฆ Qatar | ๐ท๐ด Romania |
|
|
115
|
+
| ๐ท๐ผ Rwanda | ๐ธ๐ฆ Saudi Arabia | ๐ธ๐ณ Senegal |
|
|
116
|
+
| ๐ท๐ธ Serbia | ๐ธ๐ฌ Singapore | ๐ธ๐ฐ Slovakia |
|
|
117
|
+
| ๐ธ๐ฎ Slovenia | ๐ฟ๐ฆ South Africa | ๐ฐ๐ท South Korea |
|
|
118
|
+
| ๐ช๐ธ Spain | ๐ฑ๐ฐ Sri Lanka | ๐ฑ๐จ St. Lucia |
|
|
119
|
+
| ๐ธ๐ช Sweden | ๐จ๐ญ Switzerland | ๐น๐ผ Taiwan |
|
|
120
|
+
| ๐น๐ฟ Tanzania | ๐น๐ญ Thailand | ๐น๐น Trinidad & Tobago |
|
|
121
|
+
| ๐น๐ณ Tunisia | ๐น๐ท Turkey | ๐ฆ๐ช United Arab Emirates |
|
|
122
|
+
| ๐ฌ๐ง United Kingdom | ๐บ๐ธ United States | ๐บ๐พ Uruguay |
|
|
123
|
+
| ๐บ๐ฟ Uzbekistan | ๐ป๐ณ Vietnam | |
|
|
124
|
+
|
|
125
|
+
*This list is determined by our payment provider and is subject to change. If your country is not listed here, you will not be able to complete onboarding or receive payouts.*
|
|
126
|
+
|
|
127
|
+
## 5. The Review Process
|
|
128
|
+
|
|
129
|
+
Before you can process real payments, your account must pass our verification process. You can integrate and test in "Sandbox Mode" immediately, but "Live Mode" requires approval.
|
|
130
|
+
|
|
131
|
+
There are two steps to complete before you can start accepting real payments:
|
|
132
|
+
|
|
133
|
+
### Step 1: Business Verification
|
|
134
|
+
|
|
135
|
+
You'll see a **Business Verification** prompt in the sidebar of your dashboard. Click **Start verification** to begin.
|
|
136
|
+
|
|
137
|
+
<img src="/images/review-process/business-verification-prompt.png" alt="Business Verification prompt in sidebar" />
|
|
138
|
+
|
|
139
|
+
Fill in your business details and click **Submit for review** when you're done.
|
|
140
|
+
|
|
141
|
+
<img src="/images/review-process/business-details-form.png" alt="Business details form" />
|
|
142
|
+
|
|
143
|
+
**What happens next:**
|
|
144
|
+
- Most reviews are completed within **12-24 hours**.
|
|
145
|
+
- If we need more information, we'll reach out to you via email.
|
|
146
|
+
- Once your verification is approved, you'll receive a confirmation email.
|
|
147
|
+
|
|
148
|
+
### Step 2: Set Up Payouts
|
|
149
|
+
|
|
150
|
+
After your business is verified, you need to set up payouts to receive money from your sales. We partner with **Stripe** to enable secure payouts.
|
|
151
|
+
|
|
152
|
+
Navigate to the **Payouts** section in your dashboard, or go directly to [app.kelviq.com/payout](https://app.kelviq.com/payout).
|
|
153
|
+
|
|
154
|
+
<img src="/images/review-process/payouts-setup.png" alt="Payouts setup page" />
|
|
155
|
+
|
|
156
|
+
Click the **Set up payouts** button. You'll be redirected to Stripe to complete a quick setup:
|
|
157
|
+
|
|
158
|
+
1. **Verify your identity** - Stripe will ask for a few details to verify your identity and business.
|
|
159
|
+
2. **Connect your bank account** - Add your bank account details to receive payouts.
|
|
160
|
+
|
|
161
|
+
Once you complete the Stripe setup, you'll be redirected back to Kelviq.
|
|
162
|
+
|
|
163
|
+
### You're Ready to Go Live
|
|
164
|
+
|
|
165
|
+
Once both steps are completed (Business Verification and Payout Setup), you can start accepting real payments from customers.
|
|
166
|
+
|
|
167
|
+
## 6. Testing Payments
|
|
168
|
+
|
|
169
|
+
Do not use your own real card to test payment flows.
|
|
170
|
+
|
|
171
|
+
For testing, you have two options:
|
|
172
|
+
|
|
173
|
+
1. **Use Sandbox Mode** - Switch to sandbox mode in your dashboard to test the entire checkout flow with test card numbers.
|
|
174
|
+
2. **Use 100% Discount Coupons** - Create a discount coupon with 100% off to test the checkout workflow in live mode without being charged.
|
|
175
|
+
|
|
176
|
+
## 7. Enforcement & Monitoring
|
|
177
|
+
|
|
178
|
+
Once you are live, we continuously monitor account activity to prevent fraud and ensure ongoing compliance.
|
|
179
|
+
|
|
180
|
+
* **Refund Rate Monitoring:** If your refund rate exceeds acceptable thresholds (typically >10%), we may reach out to help you improve your product quality or support.
|
|
181
|
+
* **Chargeback Monitoring:** We maintain a strict low-tolerance policy for chargebacks. Excessive dispute levels may result in account review.
|
|
182
|
+
* **Prohibited Activity:** If an account is found to be selling prohibited items or engaging in money laundering/fraud after approval, the account will be suspended immediately and funds may be held to cover potential disputes.
|
|
183
|
+
|
|
184
|
+
## 8. Have a Question About Your Product?
|
|
185
|
+
|
|
186
|
+
We know this list is long, and the line can be blurry, especially with new AI tools. We want to support innovative products.
|
|
187
|
+
|
|
188
|
+
If you are unsure if your product is allowed, **please contact us at hi@kelviq.com *before* you launch.**
|
|
189
|
+
|
|
190
|
+
Our simple "gut check" is: **Is this a high-quality, legitimate product that you are proud of, that you own the rights to, and that is delivered digitally?** If you can answer "yes" to all three, you are probably in the clear.
|