Skip to content

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.

By Wameed compliance teamZATCA and e-invoicing

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

TaskWhat it means
Log in as the taxpayerAn authorised user of the VAT-registered entity signs in
Onboard a deviceRegister an e-invoicing unit (a POS terminal or a server solution)
Generate an OTPA one-time password that lets the device request its certificate
View devices and statusSee which units are onboarded and their certificates
Renew a certificateBefore it expires
Revoke a deviceWhen it is lost, retired or compromised
Find guidanceDocumentation and technical specifications

The onboarding sequence

Per device, the sequence is:

  1. The POS generates a key pair and a certificate signing request (CSR) on the device. The private key stays on the device.
  2. You generate an OTP on the portal for that device, entering the details it asks for.
  3. You enter the OTP into the POS.
  4. The POS sends the CSR and OTP to ZATCA and receives acompliance CSID (a compliance certificate).
  5. 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.
  6. ZATCA issues the production CSID, the certificate the device signs real invoices with.
  7. The device is live. Real invoices are signed and sent.

Seedevice onboarding and CSID for the detail.

Who does what

StepYouThe 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

ProblemLikely causeFix
OTP rejectedExpired or mistypedGenerate a new one; enter promptly
Compliance checks failMissing fields, wrong tax category, clock errorReview the error list; correct the master data; retry
Certificate request failsWrong entity detailsMatch the VAT registration exactly
Portal login problemsAccess rightsAsk your administrator or ZATCA support
Device offline at onboardingNo connectionConnect and retry
Duplicate onboardingRe-installing without revokingRevoke 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

ZATCA and e-invoicing

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.