The Fatoora portal explained: onboarding a device, the OTP, certificates and renewals
The Fatoora portal is where your business meets ZATCA’s e-invoicing system: you onboard a device, get a one-time password, and manage certificates. Knowing the sequence makes adding a terminal a five-minute job instead of a support ticket.
5 min read
In short: theFatoora portal is ZATCA’s site for e-invoicing. A VAT-registered business uses it toonboard each e-invoicing device (an “EGS unit”): the business generates aone-time password (OTP) for the device, the POS software uses the OTP to request acompliance certificate, passes the compliance checks with sample invoices, and receives aproduction certificate (CSID) it signs with. You also use the portal toview your devices,renew or revoke certificates, and follow guidance. A good POS handles the technical steps and asks you only for the OTP. Screens and procedures change, so follow ZATCA’s current instructions.
The portal is the front door. Your POS does the paperwork behind it.
What the portal is for
| Task | What it means |
|---|---|
| Log in as the taxpayer | An authorised user of the VAT-registered entity signs in |
| Onboard a device | Register an e-invoicing unit (a POS terminal or a server solution) |
| Generate an OTP | A one-time password that lets the device request its certificate |
| View devices and status | See which units are onboarded and their certificates |
| Renew a certificate | Before it expires |
| Revoke a device | When it is lost, retired or compromised |
| Find guidance | Documentation and technical specifications |
The onboarding sequence
Per device, the sequence is:
- The POS generates a key pair and a certificate signing request (CSR) on the device. The private key stays on the device.
- You generate an OTP on the portal for that device, entering the details it asks for.
- You enter the OTP into the POS.
- The POS sends the CSR and OTP to ZATCA and receives acompliance CSID (a compliance certificate).
- The POS runs the compliance checks: it generates sample invoices of each required type (standard, simplified, credit and debit notes), signs them and submits them for validation.
- ZATCA issues the production CSID, the certificate the device signs real invoices with.
- The device is live. Real invoices are signed and sent.
Seedevice onboarding and CSID for the detail.
Who does what
| Step | You | The POS |
|---|---|---|
| Authorise the user | ✔ | |
| Generate OTP | ✔ | |
| Key pair and CSR | ✔ | |
| Request the compliance certificate | ✔ | |
| Run compliance checks | ✔ | |
| Receive the production certificate | ✔ | |
| Store the key securely | ✔ |
A vendor that makes the OTP your only job has done its homework. A vendor that requires a technician visit for each terminal has not.
Before you start
- Be VAT-registered with correct details (legal name, VAT number, address) in the tax system. The invoice uses them.
- Have an authorised user for the portal with the right access. Do not share one person’s credentials around.
- Know your device count and plan onboarding for each terminal.
- Update the POS to the version that supports onboarding.
- Check the clock on the device; signing uses timestamps.
- Have a connection during onboarding.
Each new terminal needs onboarding
Add a terminal on a Thursday evening and you need an OTP that evening. Plan:
- A named person who can sign in to the portal.
- A procedure for generating an OTP and entering it.
- A test invoice after onboarding.
Do not copy certificates between devices. Each device has its own key and certificate.
Renewals and expiry
Certificates have a limited life. Track expiry dates and renewbefore they lapse. Ask your vendor how renewals work, whether the POS warns you, and whether it renews automatically. An expired certificate stops a device from issuing valid invoices.
Revoking a device
If a terminal islost, stolen, sold or retired, revoke its certificate so nobody can use it to sign invoices. Then onboard its replacement. Keep a device register: serial number, location, onboarding date, certificate expiry.
Common problems and fixes
| Problem | Likely cause | Fix |
|---|---|---|
| OTP rejected | Expired or mistyped | Generate a new one; enter promptly |
| Compliance checks fail | Missing fields, wrong tax category, clock error | Review the error list; correct the master data; retry |
| Certificate request fails | Wrong entity details | Match the VAT registration exactly |
| Portal login problems | Access rights | Ask your administrator or ZATCA support |
| Device offline at onboarding | No connection | Connect and retry |
| Duplicate onboarding | Re-installing without revoking | Revoke the old unit; onboard again |
Changing POS vendor
When you change vendors, the new system needs its own onboarding; the old devices should be revoked. Plan the switch so there is no gap in compliant invoicing. Seechanging POS without breaking ZATCA.
Security
- The private key never leaves the device. Protect the device.
- Limit portal access to those who need it.
- Do not share OTPs by chat.
- Keep a log of who onboarded what and when.
- Use strong, unique passwords and multi-factor authentication if offered.
How Wameed handles it
Wameed generates the key pair and signing request on the device, asks for the OTP, completes the compliance checks and stores the production certificate securely on the device, signing invoices there. Adding a terminal is an OTP step, not a service visit. SeeZATCA Phase 2 guide.
Frequently asked questions
What is an OTP for?
A one-time password that authorises a device to request its certificate.
Do I onboard each terminal?
Yes, each device is onboarded separately.
What happens if a certificate expires?
The device can no longer sign valid invoices until it is renewed.
Can I do it myself?
With a POS that automates the technical steps, you usually only enter the OTP.
- #بوابة فاتورة
- #منصة فاتورة زاتكا
- #رمز OTP فاتورة
- #إدراج الأجهزة
- #Fatoora portal
- #ZATCA onboarding OTP
- #EGS unit management
Share this article
Ask about your own shop
Thirty minutes on your products, your tax setup and your hardware — not a slide deck.
Keep reading
6 min read
ZATCA compliance checklist for a new shop: registration, e-invoicing, devices and the first month
Opening a shop means licences, a bank account, stock and staff. The tax side is easy to leave until later, and expensive to fix after. Here is a practical checklist to be compliant before the first sale.
6 min read
Preparing your VAT return from your invoices: a monthly routine that makes filing a 30-minute job
The VAT return is arithmetic on invoices you already hold. Reconcile sales, purchases, credit notes and adjustments before the deadline and filing is a calm half hour; leave it to the last day and it is a crisis.
7 min read
ZATCA Phase 2: the complete guide for Saudi merchants
What Phase 2 actually requires of your till, in plain language: the XML, the cryptographic stamp, the hash chain, clearance versus reporting, and the eight things to check before your wave arrives.

