File TY 2025-26 return by 30 September 2026File
Easy Tax Online
All calculators

FBR IRIS Error Decoder

Search 17 common IRIS errors by code, message, or symptom. Each entry names the cause and the exact fix - filing-season lifesaver when the portal keeps rejecting your submission.

Compiled from FBR IRIS field validation + Section 165 / 118 / 114 portal responses

Login / authentication

OTP not received on registered mobile

OTP not received

Cause: The mobile SIM you're using is not registered against your CNIC in NADRA's Pakistan Mobile Database (PMD). FBR routes the OTP via the PMD-linked SIM only.

Fix: Check with your telco: dial *8888# from the SIM to verify it's registered on your CNIC. If not, visit any Franchise office with your CNIC and re-register the SIM. Then try IRIS login again - allow 15 minutes for NADRA to sync.

Login credentials invalid

Login credentials invalid

Cause: Wrong password, or the account is locked after 3 failed attempts. IRIS locks for 15 minutes after 3 wrong attempts.

Fix: Wait 15 minutes, then use 'Forgot Password'. Reset OTP goes to the PMD-registered mobile. If your CNIC has expired or been reissued (different last digit), the account may need helpline reset (051-111-772-772).

Registration

Registration flow won't complete

Registration for Unregistered Person failed

Cause: Either the mobile SIM isn't linked to your CNIC in NADRA PMD (most common), the email domain is blacklisted (some free email providers), or you already have an IRIS registration from before.

Fix: 1) Verify SIM registration via *8888#. 2) Use a gmail.com / outlook.com / hotmail.com email, not a company / university email. 3) Try 'Forgot Password' with your CNIC - if it returns a masked email, you already have an account.
NTN registration checklist

Form fields

Employer NTN not found / invalid

Employer NTN not found

Cause: The 13-digit CNIC or 7-digit NTN you entered as employer doesn't match FBR's active taxpayer database. Common when HR gives you the wrong NTN or you type the CNIC of a partner instead of the company NTN.

Fix: Ask HR for the company's 7-digit NTN (NOT a partner's CNIC). Verify at e.fbr.gov.pk/olv/verify. Correct NTN is essential - IRIS uses it to pre-fill your Section 149 WHT amount.
ATL / NTN check

Personal expenses (7089) field required

Field 7089 required

Cause: You've entered assets and liabilities in the Wealth Statement but the Personal Expenses total (line 7089) is zero or blank. IRIS requires a positive number.

Fix: Enter your annual personal + household expenses on line 7087 (Other Personal Expenses) - rent, utilities, groceries, medical, education, travel, insurance. IRIS auto-rolls it up to 7089 as the total. Typical middle-income filer: PKR 800k-1.5M/year.
Wealth statement checker

Section 149 salary WHT doesn't match employer statement

Section 149 WHT mismatch

Cause: The 'Salary WHT deducted' amount you entered doesn't match what your employer reported to FBR. IRIS cross-checks against the employer's Section 165 statement.

Fix: Get your salary certificate from HR - the annual Section 149 figure on it is the number FBR sees. If HR's figure looks wrong, get their certificate amended before submitting. IRIS will not accept a WHT credit larger than the employer-reported amount.

PSEB Section 154A field not appearing

Section 154A field missing

Cause: Your PSEB registration is not valid for the tax year, or FBR's system hasn't synced your latest renewal. Only PSEB-registered exporters see the 0.25% final tax field.

Fix: Log into pseb.org.pk and verify your registration status for the current tax year. If lapsed, renew and wait 3-5 business days for FBR sync. If registration is valid but field still missing, contact PSEB helpline before submitting - all export receipts otherwise fall to slab rates.
PRC & foreign tax credit guide

Reconciliation

Unreconciled amount on line 703000 too large

Reconciliation exceeds threshold

Cause: Your closing net wealth minus opening net wealth does not equal declared inflows minus outflows. Gap above roughly PKR 500,000 triggers this validation.

Fix: Do NOT doctor asset totals. Instead, find the missing line item: forgot a gift received? A loan repayment? A large medical bill? A remittance credit? Add the missing entry under Inflows or Outflows. The Wealth Statement Checker tool models this offline.
Reconciliation checker

Submission

Return still shows 'Draft' after clicking Submit

Draft status after submit

Cause: IRIS silently failed the submission. Usually a required field is missing, or the session timed out (15 minutes idle) and 'Submit' saved as draft without server-side confirmation.

Fix: Refresh the page. Check every red-highlighted field. Look for 'Wealth Statement not submitted' - it has its OWN Submit button. Re-click Submit and wait for the Acknowledgement Receipt (Form 114A) to load. Screenshot the receipt.

Wealth Statement (116) not submitted

Wealth Statement not submitted

Cause: You submitted the Return (114) but forgot the Wealth Statement (116) - IRIS treats them as separate submissions each with its own Submit button.

Fix: Navigate to 'Declaration' -> '116 Wealth Statement' -> verify all totals -> click Submit. Both must be submitted before 30 September for the filing to be complete on time.

Digital signature required (company filers)

Digital signature required

Cause: Companies filing Form 115 need a valid digital signature certificate issued by NIFT.

Fix: Purchase a Class 3 signing certificate from NIFT (nift.pk). Install on the browser. Company directors sign via the plugin. This is a one-time setup per director.

Return already filed - cannot resubmit

Return already filed

Cause: You already submitted a return for this tax year. IRIS won't accept a second submission for the same year.

Fix: Use 'Revised Return' under Section 114(6) if you need to correct the original. Revised return can be filed within 5 years and requires providing a reason. Otherwise, the original submission stands.

Payment / CPR

CPR entered but 'not applicable' error

CPR not applicable

Cause: You entered a Computerised Payment Receipt number, but IRIS doesn't recognise it as matching this taxpayer / tax year. Common when CPR was created for a different tax year or wrong PSID.

Fix: Generate a fresh PSID from within the current return (Payment tab -> 'Generate PSID'). Pay against THAT PSID. The new CPR then matches. Old CPRs from a prior PSID cannot be reused across tax years.

Return won't submit - amount payable > PKR 0

Amount payable > PKR 0

Cause: Your computation shows tax payable, but no CPR has been attached. IRIS refuses to submit a return with unpaid tax.

Fix: Go to the Payment tab, generate PSID, pay via bank (branch or internet banking), get CPR, enter CPR back into IRIS, refresh - the payable becomes zero and Submit unlocks.

Portal / system

Session expired / logged out

Session expired

Cause: IRIS logs you out after 15 minutes of inactivity. Any unsaved changes on the current tab are lost.

Fix: Log in again. IRIS auto-saves after each tab switch, so you'll only lose changes made on the CURRENT tab since your last navigation. Prevention: switch tabs / save frequently, don't leave the form open in a background browser tab.

Cannot see TY 2025-26 in the tax year dropdown

Tax year selector missing

Cause: IRIS opens the tax year for filing only after the year ends (1 July onwards for individuals). If it's missing after that date, browser cache is stale.

Fix: Hard refresh (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac). Clear cookies for iris.fbr.gov.pk. Try in a private / incognito window. If still missing, wait 24 hours - FBR sometimes opens tax years in phased rollouts.

IRIS portal is down or returns 502 / 504

Portal down / 502

Cause: FBR server overloaded or under maintenance. Extremely common in the final 72 hours before 30 September.

Fix: Try again after 15-30 minutes. Overnight (midnight to 6 AM PKT) is materially faster than daytime. Take a full screenshot with timestamp if you can't file; email helpline@fbr.gov.pk to establish a record - useful evidence if you need to argue for a late-filing extension.

Frequently asked questions

Why does IRIS keep giving me errors?
Three most common causes: (1) mobile SIM not registered against your CNIC in NADRA PMD - blocks OTP; (2) wealth statement not reconciling - blocks submission; (3) tax payable > 0 without CPR attached - blocks submission. Fix these three and 90% of IRIS errors disappear.
Is IRIS down right now?
FBR doesn't publish a real-time status page. Check @FBRPakistan on X for outage announcements. Practical test: try iris.fbr.gov.pk from a different network (mobile hotspot vs home wifi) - if both fail, the portal is genuinely down.
Can I file offline if IRIS is down on 30 September?
No - IRIS is the only submission channel. FBR's standing position is that portal outages don't extend the deadline unless FBR formally acknowledges the outage via SRO. Screenshot every error with timestamp; that record helps if you need to argue for penalty waiver later.
What is a PSID vs CPR?
PSID = Payment Slip ID, generated by IRIS when you need to pay tax. CPR = Computerised Payment Receipt, issued by the bank when you actually pay. You take the PSID to the bank, pay, receive the CPR, and enter the CPR back into IRIS. The CPR links your payment to your return.

How to actually get past an IRIS error

90% of IRIS errors trace to one of three causes: mobile SIM not registered on your CNIC in NADRA's Pakistan Mobile Database (blocks OTP - so no login, no registration); the wealth statement not reconciling (line 703000 gap too large); or tax payable greater than zero without a matching CPR attached. Fix those three categories and most other errors dissolve.

When IRIS returns a genuine system error (portal down, 502, session expired mid-form), the practical play is to try again outside peak hours. Overnight (midnight to 6 AM PKT) is materially faster than daytime, especially in the last 72 hours before 30 September. Screenshot every failure with a visible timestamp - that record is useful evidence if you later need to argue for a late-filing penalty waiver.

Guidance only. Easy Tax Online is not affiliated with FBR, PSEB, the State Bank, or any other authority. Tax law in Pakistan changes annually with each Finance Act - always verify the applicable rate on the FBR website or with a chartered accountant before remitting or filing. Withholding deducted by your AMC, broker, bank, or employer is authoritative; this calculator is a cross-check.