> For the complete documentation index, see [llms.txt](https://docs.payengine.co/developer-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payengine.co/developer-docs/payengine-portal/mfa.md).

# Registering for Multi-Factor Authentication (MFA)

### Overview <a href="#overview" id="overview"></a>

Multi-factor authentication (MFA) is mandatory for every user of the PayEngine Partner Portal and Merchant Portal. Each user registers once, on their first sign-in after MFA is enforced. Registration takes about two minutes and has two steps: link an authenticator app, then save a backup code.

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

Install an authenticator app on your phone. Any app that supports time-based one-time passwords (TOTP) works, including:

* Google Authenticator
* Microsoft Authenticator
* 1Password or another password manager with TOTP support

Have your PayEngine username and password ready.

### Step 1: Link your authenticator app <a href="#step-1-link-your-authenticator-app" id="step-1-link-your-authenticator-app"></a>

After you enter your username and password, PayEngine shows the **Two-Factor Authentication** setup screen with the message: *Two-factor authentication is required for your account. Scan the QR code below with an authenticator app such as Google Authenticator and enter the verification code.*

1. Open your authenticator app and choose the option to add an account (usually a **+** button or **Scan a QR code**).
2. Scan the QR code shown on the screen. A PayEngine entry appears in the app with a 6-digit code that refreshes every 30 seconds.
3. Type the current 6-digit code into the **Verification Code** field.
4. Click **Verify**.

<figure><img src="https://2556322805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRlN2yYeruyG-6M2wZN%2Fuploads%2FL3LnzDxDFJ3N8dTmdghv%2FScreenshot%202026-11-05%20at%205.07.17%E2%80%AFPM.png?alt=media&amp;token=39f272af-2573-4db4-bf9b-a8aaa01acddc" alt=""><figcaption></figcaption></figure>

If the code is rejected, wait for the app to show a new code and try again. Repeated failures usually mean your phone's clock is out of sync; turn on automatic date and time in your phone's settings.

### Step 2: Save your backup code <a href="#step-2-save-your-backup-code" id="step-2-save-your-backup-code"></a>

Once the verification code is accepted, PayEngine displays your backup code. You need this code to sign in if you lose access to your authenticator app, for example if your phone is lost, reset or replaced.

1. Click the copy icon next to the code.
2. Store it somewhere safe and separate from your phone, such as your company's password manager.
3. Click **Continue to PayEngine**.

<figure><img src="https://2556322805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRlN2yYeruyG-6M2wZN%2Fuploads%2F9pnNDb67Y4UO6INSv9Xl%2FScreenshot%202026-11-05%20at%205.12.11%E2%80%AFPM.png?alt=media&amp;token=a7eff216-d266-4872-9e09-73044be9e3e3" alt=""><figcaption></figcaption></figure>

The backup code is shown only once. Do not share it, email it, or store it in plain text alongside your password.

### Signing in after setup <a href="#signing-in-after-setup" id="signing-in-after-setup"></a>

On every later sign-in, enter your username and password, then the current 6-digit code from your authenticator app.

If you lose access to your authenticator app, sign in with your backup code instead of the 6-digit code. If you no longer have your backup code either, contact PayEngine support to reset MFA on your account.

### For partner admins: enforcing MFA for all users <a href="#for-partner-admins-enforcing-mfa-for-all-users" id="for-partner-admins-enforcing-mfa-for-all-users"></a>

Partner admins require MFA for every user on their account:

1. Log in to [console.payengine.co](https://console.payengine.co).
2. Go to the **Account and Settings** tab.
3. Under **Other Settings**, set **Enforce 2FA for all users** to **Yes**.

Each user is prompted to complete Step 1 and Step 2 at their next sign-in.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.payengine.co/developer-docs/payengine-portal/mfa.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
