Payment and Billing Issues
Troubleshoot common payment and billing issues on Koji — failed payments, invoice questions, plan changes, cancellations, and refund policies.
Troubleshooting Payment and Billing Issues
Koji uses Stripe for all payment processing, providing enterprise-grade security and reliability. Here's how to resolve common billing issues.
Ways to Pay for Koji
Koji uses credits worth €1 each. A text interview costs 1 credit, a voice interview 3 credits and a report refresh 5 credits, on every plan.
| Plan | Price | Credits |
|---|---|---|
| Free | Free | 10 one-time credits |
| Insights | €29/month or €290/year | 29 credits every month |
| Interviews | €79/month or €790/year | 79 credits every month, 3 seats included |
| Enterprise | From €500/month or €6,000/year (see plan) | Committed volume (negotiated) |
| Extra credits | From €1 per credit, one-time | 10 to 1,000 credits per purchase, 5% off from 51 credits, 10% off from 201 to 500 |
Annual billing gives two months free. Extra seats on Interviews cost €15/month or €150/year each. See the plan comparison guide for full details.
Failed Payments
Why Payments Fail
- Expired card -- your card on file has passed its expiration date
- Insufficient funds -- the charge exceeds your available balance
- Bank decline -- your bank flagged the transaction (common with international payments)
- 3D Secure authentication -- your bank requires additional verification
How to Fix a Failed Payment
- Go to Account Settings > Billing
- Click Manage Billing to open the Stripe billing portal
- Update your payment method with a valid card
- Stripe will automatically retry the failed charge
What Happens During a Failed Payment
- Your subscription remains active for a grace period while Stripe retries
- Stripe attempts the charge multiple times over several days
- If all retries fail, your subscription may be paused
- No data is deleted -- all studies, interviews, and reports are preserved
- Once payment succeeds, full access is restored immediately
Understanding Your Invoice
Your Stripe invoice includes:
| Line Item | Description |
|---|---|
| Base subscription | Your plan fee (Insights €29/month or Interviews €79/month, or the annual price) |
| Extra seats | Additional Interviews seats at €15/month or €150/year each |
| One-time purchases | Extra credit packs bought manually or by auto-reload |
| Proration | Credits or charges for mid-cycle plan changes |
| Tax | VAT/sales tax if applicable to your region |
Usage itself never creates its own line item. Credits are only bought as one-time purchases.
Accessing Invoices
- Go to Account Settings > Billing
- Click Manage Billing to open the Stripe portal
- View and download all past invoices as PDF
- Invoices include a detailed breakdown of all charges
Plan Change Issues
Upgrade Not Reflecting
If you upgraded but don't see new features:
- Refresh the page -- sometimes a hard refresh (Ctrl/Cmd + Shift + R) is needed
- Check your subscription status -- verify in Account Settings > Billing
- Clear browser cache -- cached data may show old plan details
- If the issue persists, contact support
Downgrade Timing
- Downgrades take effect at the end of your current billing period
- You retain full access to your current plan until then
- Your credit allocation changes to the new plan's level at the next period
Proration on Upgrades
- Upgrades take effect immediately
- You receive a prorated credit for unused time on your old plan
- You're charged the prorated rate for the new plan for the remaining days
Unexpected Charges
Charges Beyond Your Plan Fee
If you see a charge beyond your base subscription, it is usually one of these:
- An extra credit pack someone on your account bought (from €1 per credit)
- An auto-reload top-up, if a workspace owner turned on auto-reload. Auto-reload never spends more than the monthly limit you set, and you can turn it off in your billing settings
- Extra seats added to an Interviews plan
- Check your usage and purchase history in your billing settings
- See Extra Usage and Top-ups Explained for what happens when your balance is empty
Currency
All Koji pricing is in EUR. Your bank may apply currency conversion fees if your card is in a different currency.
Cancellation
How to Cancel
- Go to Account Settings > Billing
- Click Manage Billing to open the Stripe portal
- Select Cancel Subscription
- Your plan remains active until the end of the current billing period
- After cancellation, your account reverts to the Free plan
After Cancellation
- All data is preserved -- studies, interviews, transcripts, reports
- You keep Free plan access (but no new credits unless you have unused bonus credits)
- You can resubscribe at any time to restore full access
Refund Policy
- Annual plans: Refunds are available within the first 14 days of purchase
- Monthly plans: No refunds for partial months, but you can cancel anytime
- Extra credit packs: contact support. Unused credits can be reviewed case by case
- Quality gate protection: Remember that conversations scoring below 3/5 are never charged, reducing the likelihood of paying for unused value
To request a refund, contact the Koji support team with your account email and subscription details.
Payment Security
Koji never stores your card details directly. All payment processing is handled by Stripe, which is:
- PCI DSS Level 1 certified -- the highest level of payment security compliance
- 3D Secure supported -- additional authentication for supported banks
- 256-bit SSL encrypted -- all payment data is encrypted in transit
Your billing information is securely managed through Stripe's infrastructure, separate from Koji's application servers.
Related Articles
Managing Payment Methods
Learn how to update your credit card, view invoices, access the Stripe billing portal, and manage VAT/tax settings on Koji.
Running Out of Credits, Explained
Koji has no overage billing. See what credits cost, how plans and credit packs work, what happens when credits run out, and how auto-reload and the monthly spending cap keep you in control.
Plan Comparison Guide
Compare Koji's Free, Insights, Interviews and Enterprise plans: monthly credits, seats, annual pricing, extra credits and which plan fits your research.
Understanding Usage & Credits
Learn how Koji's credit system works — what actions cost credits, how limits are tracked, and how to manage your research budget effectively.
Browser Compatibility
Which browsers work with Koji and known limitations for voice and text interviews.
Common Error Codes
Every error the Koji Headless API returns: the error envelope, status codes, all error strings with fixes, and a debugging checklist.