Troubleshooting & FAQCommon Issues

Common Issues

Last reviewed: 16 November 2026

Start here. Find your symptom, then follow the link.

SymptomGo to
A button is missing on a subscriptionSubscription issues
Trial can’t be extended or cancelled the way I wantSubscription issues
Cancellation rejectedNotice period
Amount on an invoice looks wrongBilling issues
Usage not billedUsage is missing
Payment failed / not recordedPayment issues
Coupon refusedA discount didn’t apply

Access and sign-in

I can’t see a menu or screen. Your role doesn’t include it. Ask an admin to check your roles under Settings > Team Members. See Roles.

API calls return 401. Unauthorized API Key: the key is wrong, deleted or regenerated. Authorization header not found: the request has no x-api-key or Authorization header. See Authentication.

API calls return 403. The key or user lacks the permission scope for that endpoint.

Emails and notifications

A customer didn’t receive an email.

  1. Check the notification is on under Settings > Notifications > Customer Notifications.
  2. Check the customer’s email in their communication profile.
  3. Ask them to check spam.
  4. If you use your own SMTP server, check Settings > Mailbox.

An email shows the wrong text. Edit the template under Settings > Templates and Publish it.

Imports

Customer import fails. Check the file against the template in Importing Customer Accounts.

Usage CSV import fails. The file needs the columns eventId, eventType, subscriptionId, accountId and eventTimestamp, and must be under 5 MB. See Usage Events.

Reports

Analytics numbers differ from invoice totals. MRR is normalised recurring revenue; it leaves out one-time fees and taxes and spreads yearly plans over 12 months. Invoices show what was billed. See Revenue Metrics.

Multi-currency totals look off. Analytics convert currencies with synced exchange rates. See Currency Conversion in Analytics.

Still stuck?

Collect the subscription or invoice ID, the time, the exact message, and what you expected, and contact BillHive support.