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

# Register diagnostics (MojoDiag)

> Check why card payments are slow at a register, and send the results to Mojo Payments.

**MojoDiag** checks a Windows register that takes card payments through Mojo Payments: the computer, its network and
internet connection, the payment software and its settings, and how long each step of a payment takes. It sends a
report to your location in the portal, and Mojo Payments reviews it. If payments look slow, we contact you with what
we found.

Run it when payments feel slow, or set it to run by itself every night so problems are spotted before anyone notices.

## What you need

* A Windows register (Windows 10 or 11) that takes card payments with Mojo Payments.
* Permission to run register diagnostics at the location, to get a code: Owners, Admins and
  [Technical support](https://kb.paymentsmojo.com/merchants/service-partners.md#the-technical-support-role), so your service partner can do it too.
* Administrator rights on the register for the full check and for a nightly routine. Without them MojoDiag still runs,
  but a few checks are limited.

## Download MojoDiag

1. In the portal, open **Locations** and the location the register is at.
2. Under **Register diagnostics (MojoDiag)**, choose **Download MojoDiag**.
3. Unzip it on the register. It's one file, `MojoDiag.exe`, with nothing to install.

Windows may say it protected your PC the first time you open it. Choose **More info**, then **Run anyway**.

MojoDiag keeps itself up to date. When a newer version is out, the nightly check updates itself, and when you run it
yourself it asks: **An update is available. Would you like to update this file now?** It only installs updates signed
by Mojo Payments.

![Register diagnostics on a location: the download link, the code buttons, the registers that send reports, and their signed reports.](https://mintcdn.com/mojo-payments/kQbuPygvM6YiG3_c/images/portal/register-diagnostics.png?fit=max\&auto=format\&n=kQbuPygvM6YiG3_c\&q=85\&s=618c210f63a2d593435bac81fcfb37b5)

A location's Register diagnostics (portal as of October 2026)

## Run it once

1. In the location's **Register diagnostics (MojoDiag)**, choose the **Terminal at the register** (the terminals listed
   are the ones on the location's MID), then **Get a MojoDiag code**.
2. On the register, right-click `MojoDiag.exe` and choose **Run as administrator**.
3. When it starts, type the code. That's all it needs: the code tells it the location, the MID and the terminal.
4. Answer its questions. It asks before it tests the card terminal (the terminal shows "Mojo diagnostics" for a
   moment), and before it watches a real payment: ring up a sale on the point of sale, tap a card, then void the sale.
   You can skip either one. At the end it asks to send the report.

The code connects the register to your location and its terminal. After that, the register doesn't need a code again:
next time, just answer **yes** when MojoDiag asks to send the report. If the register gets a different terminal, change
it in **Registers that send reports here**; MojoDiag picks it up on its next run.

A code works for 30 days, and any register at the location can use it during that time. Unused codes simply expire;
registers already connected keep working.

## Run it every night

1. In the location's **Register diagnostics (MojoDiag)**, choose the register's terminal, then **Code for a scheduled
   routine**.

   ![A code for a scheduled routine, with the MojoDiag command to run in a field with a Copy button.](https://mintcdn.com/mojo-payments/AH_c1cMWs2GfBXIj/images/portal/diagnostics-routine-code.png?fit=max\&auto=format\&n=AH_c1cMWs2GfBXIj\&q=85\&s=1cf9000e919cd6c4b62173ee38d44125)

   A code for the nightly check, with its command to copy (portal as of October 2026)

2. On the register, open Command Prompt as administrator in the folder with `MojoDiag.exe`, and paste the command
   (**Copy** next to it in the portal), for example:

   ```
   MojoDiag.exe --schedule daily --at 02:00 --submit ABCD-EFGH-JKMN
   ```

MojoDiag copies itself to `C:\ProgramData\Mojo Payments\MojoDiag` and adds a Windows scheduled task, **Mojo
Payments\MojoDiag**, that runs it at that time every day and sends the report.

The nightly run never tests the terminal or asks for a card, so it can't get in the way of a sale. It measures payment
times from the payment software's own records of the day's real payments. It reads those records without locking them.

To stop the nightly run, open Command Prompt as administrator and run:

```
"C:\ProgramData\Mojo Payments\MojoDiag\MojoDiag.exe" --unschedule
```

## Other ways to run it

| Command | What it does |
| - | - |
| `MojoDiag.exe` | The full check, asking before the terminal test and the payment it watches. |
| `MojoDiag.exe --unattended --submit CODE` | No questions: skips the terminal test and the payment, and sends the report. |
| `MojoDiag.exe --unattended --capture-seconds 300` | Also times real payments for 5 minutes while the cashier works. |
| `MojoDiag.exe --help` | Every option. |

When you run it yourself, MojoDiag opens the report for you to read. Once the report is sent, it's deleted from the
register, so nothing piles up on the computer. Nothing is saved on the desktop.

If a report can't be sent (the register can't reach the internet, or you skipped the code), MojoDiag tells you where the
`.zip` is and keeps it for 7 days. Bring it to another computer and choose **Upload a report (.zip)** on the location.

## What's in a report

The report covers the register's settings and measurements: computer name, Windows version, network addresses, folder
paths, antivirus, the payment software's settings, your MIDs and terminal serial numbers, and timings.

It contains no card numbers and no passwords. MojoDiag masks them before the report leaves the register, and Mojo
Payments checks again when it arrives.

Each report is signed by the register that made it. Mojo Payments only accepts a report from a register connected to
your location, and refuses one that was changed after MojoDiag made it.

## Registers that send reports

The location lists **Registers that send reports here**: each register's name, when it was connected and its last
report. Choose **Remove** for a computer you've replaced or don't recognize. Its reports stop until it's connected
again with a new code.

**Stop all codes** stops every code for the location from connecting more registers. Registers already connected keep
sending reports until you remove them.

## Questions

Email [hello@paymentsmojo.com](mailto:hello@paymentsmojo.com) with the location's name.


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