> ## Documentation Index
> Fetch the complete documentation index at: https://widgetic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Status

> How a partner account is activated, what a pause or an unpaid invoice stops, and how it starts again

A partner account is in one of four states. Widgetic decides three of them. The fourth, **payment arrears**, follows from an unpaid invoice of your contract: nobody sets it, and it ends when the invoice is paid. This page says what each state means for you and for your customers, so that a stop never comes as a surprise.

## The Four States

| Status | What it means | Your customers |
| - | - | - |
| `inactive` | Not activated yet. Every new account starts here, and an account that was deactivated returns here | Cannot use Widgetic through you |
| `active` | In force | Everything works |
| `suspended` | Paused by hand by Widgetic. The reason is recorded and you can read it | Their editors stop, and your published widgets are not served |
| `payment_arrears` | An invoice of your contract is unpaid after its due date. It starts the day after the due date (UTC) and ends when the invoice is paid | The same as a pause: their editors stop, and your published widgets are not served |

Read your own state with `GET /partners/mine`. The answer has `standing` for the account as a whole (`inactive`, `active`, `suspended` or `payment_arrears`, or `not_a_partner` for an account that administers no partner), `overdueSince` and the `partners` you administer. `overdueSince` is the due date of the oldest unpaid invoice of your contract while `standing` is `payment_arrears`, and `null` otherwise. Each partner has its `id`, which the other partner routes ask for, its `status`, its `platformDomain` (the website where you integrate Widgetic, which can always show your widgets, with its subdomains: see [Security](https://widgetic.com/resources/security.md#your-platform-is-always-allowed)) and, while it is paused, `suspendedAt` and `suspensionReason`.

```bash theme={null}
curl -sS -H "Authorization: Bearer $WIDGETIC_PARTNER_KEY" \
  "https://api.widgetic.com/v1/partners/mine"
```

```json theme={null}
{
  "success": true,
  "data": {
    "standing": "suspended",
    "overdueSince": null,
    "partners": [
      {
        "id": "7d5f3c1a-2b64-4c0e-9a51-6f1e2d3c4b5a",
        "name": "Your Company",
        "status": "suspended",
        "contactEmail": "billing@yourcompany.com",
        "allowedDomains": [],
        "platformDomain": "yourcompany.com",
        "suspendedAt": "2026-10-20T09:00:00.000Z",
        "suspensionReason": "Contract under review",
        "createdAt": "2026-09-01T10:00:00.000Z"
      }
    ]
  }
}
```

With an unpaid invoice, `standing` is `payment_arrears` and `overdueSince` has the date. The partner itself is not paused, so its `status` stays `active` and there is no `suspensionReason`: nobody wrote a reason, an invoice is the cause.

> [!NOTE]
>
> A pause is a person's decision: a person at Widgetic decides, and writes the reason you read here. Payment arrears is different, because nobody decides it. An invoice of your contract that is still unpaid after its due date stops the account by itself, and paying the invoice ends the stop by itself. Widgetic reminds you before and after the due date (see [When an invoice is not paid](https://widgetic.com/docs/partners/credits-billing.md#when-an-invoice-is-not-paid)). An unpaid invoice for extra credits stops nothing.

## Getting Activated

A partner has no trial. You pay from the first day, and you can use the account only once Widgetic has activated it. Widgetic activates it when two things are in place:

1. **A contract in force.** Widgetic records what was agreed: the credits for each billing period, your price for a credit, the billing cycle and the dates. The dates must cover today.
2. **Storage that works.** Your own [storage destination](https://widgetic.com/docs/partners/storage.md) is saved and has passed its check. This one is yours to do, and it is the part that takes the longest, so start with it.

Until then the account is `inactive`. You can set up your storage and read your contract, invoices and notifications, and you can pay. Everything that makes something is refused with `PARTNER_INACTIVE`. When Widgetic activates the account you get a `partner.activated` [notification](https://widgetic.com/docs/partners/notifications.md).

The first invoice is not a requirement for the activation. Widgetic issues it on the day your contract starts, and you pay it from the Billing page of your [dashboard](https://widgetic.com/docs/partners/dashboard.md) or from the link in the invoice email.

## What a Pause or Payment Arrears Stops

**For you.** Everything that makes something or starts work is refused with `403`: creating or changing widgets and compositions, publishing, generating with the AI, uploading, and making managed users and their editor sessions. The answer says why. For a pause:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "PARTNER_SUSPENDED",
    "message": "This partner account is paused. Billing, invoices, credits and notifications are still available; everything else comes back when Widgetic resumes the account.",
    "details": {
      "partnerStatus": "suspended",
      "reason": "Contract under review"
    }
  }
}
```

And for an unpaid invoice:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "PARTNER_PAYMENT_ARREARS",
    "message": "This partner account is stopped because an invoice is past its due date. Billing, invoices, credits and notifications are still available; pay the overdue invoice and everything else comes back at once.",
    "details": {
      "partnerStatus": "payment_arrears",
      "overdueSince": "2026-11-01T00:00:00.000Z"
    }
  }
}
```

`details.partnerStatus` is `suspended`, `payment_arrears` or `inactive`. `details.reason` is the reason recorded with a pause, and `details.overdueSince` is the due date of the oldest unpaid invoice. Branch on `error.code` (`PARTNER_SUSPENDED`, `PARTNER_PAYMENT_ARREARS` or `PARTNER_INACTIVE`), not on the message.

**What stays open to you.** Reading everything, so that you can see what is stopped and why. And what you need to get going again: [billing, invoices, buying credits and your credits](https://widgetic.com/docs/partners/credits-billing.md), your contract, your [storage](https://widgetic.com/docs/partners/storage.md), your [notifications](https://widgetic.com/docs/partners/notifications.md), your API keys (a leaked key can still be revoked) and signing in and out. A generation that is already running can still be stopped, since stopping only saves credits.

**For your customers.** Their [editor sessions](https://widgetic.com/docs/partners/editor-sessions.md) stop working at the next call, with `403` and the same code, and no new session can be made. What the customer reads is only:

> This service is not available right now. Please contact the website that sent you here.

It says nothing about money, because the customer did not cause it and cannot fix it. Your published widgets are not served while the account is not in force: their public address answers `404`.

**What it keeps.** Nothing is deleted. Your customers, compositions, widgets, uploads, credits and invoices stay as they were, and everything comes back when the account is resumed or the invoice is paid.

## Getting Going Again

### After an unpaid invoice

Pay the overdue invoice on its invoice page (`hostedInvoiceUrl`), or from the Billing page of your dashboard. **That is all.** Service comes back by itself as soon as the payment is confirmed, for you and for your customers, and you get a `partner.resumed` notification. Nobody at Widgetic has to switch the account on, and you do not need to write to anyone. If you paid and the account is still stopped an hour later, write to [partners@widgetic.com](mailto:partners@widgetic.com) with the invoice number.

### After a pause

**1. See why**

Read `suspensionReason` in `GET /partners/mine`, the email Widgetic sent (a `partner.paused` notification), or the banner at the top of your dashboard.

**2. Put it right**

Usually that means paying an open invoice. Billing stays open while the account is paused, so you can pay from the invoice link or from your dashboard.

**3. Tell Widgetic**

Write to [partners@widgetic.com](mailto:partners@widgetic.com). A person at Widgetic resumes the account; a pause is never lifted automatically.

**4. Carry on**

You get a `partner.resumed` notification. The change takes effect within seconds, for you and for your customers. Resuming is never held up by paperwork.

## Hearing About It

Three events tell you about the standing of the account, and all three are emailed whatever your settings say, because they are about money and access:

| Event | When |
| - | - |
| `partner.activated` | Widgetic activated your account |
| `partner.paused` | Your account was stopped, by a pause or by an unpaid invoice. `data.reason` has the reason: the one Widgetic wrote for a pause, or a sentence that names the overdue invoice |
| `partner.resumed` | Your account is served again, after a pause or because the overdue invoice was paid |

They are also in the list of your dashboard and, when you have set one up, sent to your [webhook](https://widgetic.com/docs/partners/notifications.md#your-own-webhook). Their `data` is `{ "status": "active" | "suspended" | "payment_arrears", "previousStatus": "active" | "inactive" | "suspended" | "payment_arrears" | null, "reason": string | null }`. For a stop that an unpaid invoice caused, `partner.paused` has `status` set to `payment_arrears`, and `partner.resumed` has `previousStatus` set to `payment_arrears`.

## Errors

| Status | Code | When | What to do |
| - | - | - | - |
| 403 | `PARTNER_PAYMENT_ARREARS` | An invoice of your contract is unpaid after its due date and the request is not one that stays open | Pay the overdue invoice. `details.overdueSince` says when the oldest one was due |
| 403 | `PARTNER_SUSPENDED` | The account is paused and the request is not one that stays open | Pay what is due and write to Widgetic. `details.reason` says why it was paused |
| 403 | `PARTNER_INACTIVE` | The account has not been activated yet | Finish your [storage](https://widgetic.com/docs/partners/storage.md) and wait for the activation |

> [card] [Credits & Billing](https://widgetic.com/docs/partners/credits-billing.md)
>
> Invoices, tax, reminders and how to pay

> [card] [Storage](https://widgetic.com/docs/partners/storage.md)
>
> The bucket your customers' files are kept in


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.