Skip to content

Invoices ​

To access your invoices in the EMQX Cloud Console, click Billing -> Invoices. Select General Invoices for other EMQX Cloud service invoices or Agents Invoices for EMQX Agents subscription invoices.

General Invoices ​

View Invoice Status ​

The General Invoices list shows generated invoices along with their billing date, amount, tax, and current status.

StatusDescription
PendingInvoice has been generated but is not yet paid.
IssuedInvoice has been paid and is finalized.

Download Invoices ​

To download a copy of an invoice:

  1. Locate the invoice you wish to download from the list.
  2. Click the download icon in the Download column corresponding to that invoice.

This action will download a PDF copy of the invoice for your records.

invoice

Agents Invoices ​

EMQX Cloud uses Stripe, a third-party payment service provider, to generate and manage Agents subscription invoices separately from general EMQX Cloud invoices. The root user, Administrators, Accountants, and Auditors can view the Agents invoice list. The root user, Administrators, and Accountants can use View Invoice. For the complete permissions matrix, see Role Permissions Matrix.

View Agents Invoices ​

  1. Click Billing -> Invoices in the Console.
  2. Select Agents Invoices.
  3. Locate the subscription invoice. Use the pagination controls to view additional records.

The list shows:

FieldDescription
Issued On (UTC)The invoice creation date in UTC, displayed as YYYY-MM-DD.
Invoice NumberThe invoice number assigned by Stripe. A missing number is displayed as —.
Deployment NameThe associated deployment's name, displayed as plain text. If the name is missing, the deployment ID is shown. If both are missing, the row displays —.
AmountThe invoice total, including applicable taxes, in the invoice's currency.
StatusThe Stripe invoice status described below.
ActionsView Invoice opens the Stripe invoice page when a link is available and your role permits it.

The list includes zero-amount invoices generated for free trials. A zero-amount invoice does not indicate a subscription charge. Draft and Open invoices are not displayed. If your account has no Agents subscription invoices, the list is empty.

You can change the billing country only after all Agents subscriptions have ended. After the change, historical Agents invoices remain available, including invoices for deleted deployments.

Understand Agents Invoice Statuses ​

StatusDescription
PaidThe invoice has been paid.
UncollectibleThe invoice has been marked as unlikely to be collected. This does not mean that it has been paid.
VoidThe invoice has been voided.

An invoice status describes the invoice. It does not replace the subscription status on Deployment Settings. General invoices use the statuses listed in View Invoice Status.

Open an Agents Invoice ​

  1. Locate the invoice on the Agents Invoices list.
  2. Click the view icon in Actions. The Stripe-hosted invoice page opens in a new tab.
  3. On the Stripe page, review the invoice details and download the available invoice PDF or receipt.

If the row displays — in Actions, no Stripe invoice link is available for that record. Auditors can view the Agents invoice list but cannot open invoices.

For an overdue subscription payment, open the deployment's Deployment Settings page and follow Complete an Overdue Payment. Verify the resulting subscription status after payment.