Common Issues
Last reviewed: 16 November 2026
Start here. Find your symptom, then follow the link.
| Symptom | Go to |
|---|---|
| A button is missing on a subscription | Subscription issues |
| Trial can’t be extended or cancelled the way I want | Subscription issues |
| Cancellation rejected | Notice period |
| Amount on an invoice looks wrong | Billing issues |
| Usage not billed | Usage is missing |
| Payment failed / not recorded | Payment issues |
| Coupon refused | A 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.
- Check the notification is on under Settings > Notifications > Customer Notifications.
- Check the customer’s email in their communication profile.
- Ask them to check spam.
- 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.