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

# When something goes wrong

> The errors you can hit while linking, what each one means, and what to do about it.

Most linking problems are one of a handful of things. Find the message you're seeing
below.

## "Invalid Email Id." — FTA code 403

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-error-403.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=1648e72ac8c1d5a34a540b22c302fdd3" alt="The wizard showing the FTA rejection: Invalid Email Id., FTA code 403" width="512" height="540" data-path="images/en/fta-linking/wizard-error-403.png" />
</Frame>

**What it means.** The e-mail address you entered isn't the one the FTA holds for
this TIN. The FTA checked it and refused — this is its answer, passed straight
through to you.

**What to do.** Use the address registered against the taxable person in EmaraTax.
If you're not sure what it is, check the taxable person's profile in EmaraTax, or
update it there first and then retry the link.

<Note>
  Our own field validation can only check that an address is *well formed*. Whether it
  is the *right* address is something only the FTA can answer, which is why this error
  appears after you select **Verify Applicant Details** rather than as you type.
</Note>

## "TIN is already linked with an ASP." — FTA code 200

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-error-200.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=4887160bfa249a7f3377a7801d595444" alt="The wizard showing the FTA rejection: TIN is already linked with an ASP, FTA code 200" width="512" height="540" data-path="images/en/fta-linking/wizard-error-200.png" />
</Frame>

**What it means.** This TIN already has an active link — to us or to another
accredited service provider. A TIN can only be linked to one provider at a time.

**What to do.** Check the **Linkage Status with ASP** tab in EmaraTax to see who
it's linked to. To move to Fatorly, [delink from the current
provider](/en/fta-linking/offboarding) first, then onboard again.

## A gateway error mentioning `GSB_003`

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-error-gateway.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=334cfa45cb153ee6dde691fbb868cae6" alt="The wizard showing a retryable gateway error quoting GSB_003" width="512" height="540" data-path="images/en/fta-linking/wizard-error-gateway.png" />
</Frame>

**What it means.** The FTA's own gateway was temporarily unable to service the
request. It is not a problem with your details, and nothing was submitted.

**What to do.** **Retry.** The error is retryable by design — your entered values
are preserved and the **Verify** button stays live, so you can simply select it
again. If it persists past a few minutes, come back a little later or
[contact support](/en/settings/support-access).

## Your session expired

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-session-expired.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=8a1c52edd6c18646853c7390146d5e2b" alt="The session-expired screen directing you back to the FTA portal" width="512" height="540" data-path="images/en/fta-linking/wizard-session-expired.png" />
</Frame>

**What it means.** Linking sessions last **15 minutes** — there's a countdown in the
bottom-left corner of the wizard. Yours ran out.

**What to do.** Nothing is lost and nothing was half-submitted. Go back to EmaraTax
and start a fresh linking request.

## The Verify button won't respond

It's disabled, and it stays disabled until **every** field passes format validation.
Check for an inline error message under the fields:

| Field                                  | Rule                                              |
| -------------------------------------- | ------------------------------------------------- |
| **TIN**                                | Exactly 10 digits, starting with `1`.             |
| **Registered EmaraTax E-mail Address** | Must be a valid address, e.g. `name@company.com`. |
| **Reason**                             | Mandatory on reverification and delinking.        |

<Frame>
  <img src="https://mintcdn.com/fatorly/YuYy4X5ifgx6woHB/images/en/fta-linking/wizard-step1-errors.png?fit=max&auto=format&n=YuYy4X5ifgx6woHB&q=85&s=ab2835a9deb882bcaeb85823ec12a9fc" alt="Inline validation errors on the e-mail and TIN fields, with the Verify button greyed out" width="512" height="540" data-path="images/en/fta-linking/wizard-step1-errors.png" />
</Frame>

## "Missing request" when you open the wizard

You reached `/onboarding` directly instead of being handed over by EmaraTax. The
wizard needs the secure, single-use request that EmaraTax creates. Start from
**EmaraTax → E-INVOICING** — see [Onboarding](/en/fta-linking/onboarding).

## My reverification didn't change anything in EmaraTax

That is correct and expected. See [Why EmaraTax looks unchanged
afterwards](/en/fta-linking/reverification#why-emaratax-looks-unchanged-afterwards).

## Still stuck?

[Contact support](/en/settings/support-access) with your TIN and the exact message
on screen — including any reference ID a gateway error quotes. That reference lets
us trace the specific call.
