Subscription Issues
Last reviewed: 16 November 2026
Each issue lists symptoms, causes, how to check, the fix, and how to prevent it. Error messages are quoted exactly as BillHive shows them.
An action button is missing or the API says “Cannot … a subscription that is …”
Symptoms. Pause, Change Plan or another button isn’t on the subscription page; the API returns 400, e.g. Cannot change the plan of a subscription that is Paused.
Cause. Each status allows only some actions. Plan and frequency changes need Active; Reactivate needs Cancelled or Expired.
Check. The subscription’s status badge, against Actions by status.
Fix. Move the subscription to a status that allows the action first: resume a paused subscription, or convert a trial.
Prevent. In your integration, read the status before calling an action.
“This plan needs a payment method at signup”
Cause. The trial price has Require billing at signup, and the order has no payment method or Auto Collect.
Fix. Collect a payment method (checkout does this), or turn the setting off on the price if you want card-free trials.
A trial can’t be extended
Symptoms. The trial is already converting. Extend it before <date>.
Cause. The subscription is in Trial Pending Activation: the first payment is already under way.
Fix. Extending is no longer possible. Let the conversion finish, then use Edit Next Billing Date or a credit memo to give extra time.
Prevent. Extend before the trial’s last day.
“A trial can only be cancelled immediately…”
Cause. End of Term and Specific Date aren’t offered for trials (nor for Future, Non Renewing or In Dunning subscriptions).
Fix. Cancel immediately, or turn off Auto Renew so the trial runs out.
A cancellation is rejected because of the notice period
Symptoms. Cancellation must be at least 30 days from today (notice period); earliest allowed date is …
Cause. The plan or subscription has contract terms with a notice period.
Fix. Choose a date on or after the earliest allowed date, or (admins only) tick Override contract terms and give a reason.
The customer was charged an early termination fee
Cause. The cancellation takes effect inside the minimum commitment. See Early termination fee.
Fix. If it was charged in error, issue a credit memo. Next time use Override contract terms, which waives the fee.
A scheduled change, pause or cancellation disappeared
Cause. The newest action wins. Pausing discards a scheduled plan change; a new plan change discards a scheduled pause; cancelling replaces scheduled changes.
Check. The subscription’s Activity Log records the discard.
Fix. Schedule the action again, in the order you want them to happen.
“A plan change is still being processed”
Cause. An Immediately plan change hasn’t finished (for example it’s waiting for payment or a mandate).
Fix. Wait for it to complete, then retry. If it’s waiting for a mandate, ask the customer to approve it.
An upgrade isn’t applied
Cause. The customer pays by a mandate whose maximum is below the new amount. BillHive waits for the customer to approve a new mandate (Cashfree only).
Check. The subscription shows the change waiting; the customer received a Change Mandate Required email.
Fix. Ask the customer to approve the mandate from the email.
Edit Next Billing Date is refused
Causes. The subscription isn’t Active; a plan change, cancellation or pause is scheduled; a plan change is processing; it pays with a periodic mandate; or a Fixed price is on its last cycle.
Fix. Remove the scheduled action first; for periodic mandates the gateway fixes the debit date, so the date can’t be moved.
“No scheduled pause”
Cause. You called Remove Scheduled Pause on a subscription with no future pause.
A reactivated subscription stays Cancelled
Cause. Reactivation waits for the first payment. If it fails, the subscription stays Cancelled or Expired.
Fix. Collect the payment (retry, or the customer pays the invoice). Also check the plan’s price is still Active; otherwise reactivation returns 400.
The subscription renewed at the old price
Cause. By design, renewals charge the current term’s price, not today’s list price.
Fix. Use Change Plan (or a frequency change) to move the subscriber to the new price.
A subscription stopped renewing after N invoices
Cause. The price is Fixed with term length N. After N cycles it becomes Non Renewing and expires.
Fix. Renew manually, or move the customer to a Forever price. See Fixed and Forever prices.
Backdated start date rejected
Cause. The start date is further back than the Backdating limit (90 days by default).
Fix. Raise the limit in Subscription Settings if the backdating is legitimate.