subscription_inactive
The subscription is unpaid or cancelled, so you cannot create orders.
Your plan includes this endpoint. The subscription is not paid.
Why it happens
| Subscription | Result |
|---|---|
active | Everything works. |
past_due | Everything still works. Stripe is retrying the payment. |
unpaid or canceled | POST /v1/orders returns this error. |
Only new orders stop. You can still read, list, change, cancel and advance the orders you have, and their webhooks still work.
Why. Parcels that a courier already has must still arrive, and you must still see them. A payment problem must not stop a delivery in progress.
An Advanced endpoint on an unpaid subscription also returns this code, not
feature_not_available. Your plan includes it, so pay the
invoice — do not upgrade.
How to fix it
Pay the invoice. Access returns when the subscription is active.
Find out early
While the subscription is past_due, POST /v1/orders and POST /v1/orders/quote return
this header:
Univooz-Subscription-State: past_dueThe header is absent in all other states. Look for it in your logs. You then learn about a failed card before an order stops.
Example response
{
"error": {
"type": "billing_error",
"code": "subscription_inactive",
"message": "Your subscription is not active.",
"doc_url": "https://docs.univooz.com/errors/subscription_inactive",
"request_id": "req_01KZCCF8ZH4M7XQ2VB9RSTNPKD"
}
}