KSeF environments: test, demo and production
KSeF (Poland's national e-invoicing system) runs three public environments. Only one of them holds real invoices.
| Short name | Environment | API documentation | QR verification address | Accepted formats |
|---|---|---|---|---|
| TEST | Test (Release Candidate) Testowe (Release Candidate) | https://api-test.ksef.mf.gov.pl/docs/v2 | https://qr-test.ksef.mf.gov.pl | FA(2), FA(3), FA_PEF (3), FA_KOR_PEF (3) |
| DEMO | Pre-production Przedprodukcyjne (Demo) | https://api-demo.ksef.mf.gov.pl/docs/v2 | https://qr-demo.ksef.mf.gov.pl | FA(3), FA_PEF (3), FA_KOR_PEF (3) |
| PROD | Production Produkcyjne | https://api.ksef.mf.gov.pl/docs/v2 | https://qr.ksef.mf.gov.pl | FA(3), FA_PEF (3), FA_KOR_PEF (3) |
What the documentation says about each
| Environment | Description (Polish) |
|---|---|
| TEST | Środowisko do testowania integracji z KSeF API 2.0, zawiera wersje RC. |
| DEMO | Środowisko odpowiadające konfiguracji produkcyjnej, przeznaczone do końcowej walidacji integracji w warunkach zbliżonych do produkcji. |
| PROD | Środowisko do wystawiania i odbierania faktur o pełnej mocy prawnej, z gwarantowanym SLA i właściwymi danymi produkcyjnymi. |
Things to know before testing
- Data in the test environment is not isolated. Self-signed certificates are accepted there, so several integrators can work in the context of one company. The documentation asks for random NIP numbers: Do testów należy używać losowych identyfikatorów NIP, unikając jakichkolwiek danych rzeczywistych.
- Service work may take place on the test environments between 16:00 and 18:00, since 1 October 2025.
- When the API returns an address for downloading or sending a resource, its host belongs to the environment the call was made to.
Have a ZIP of KSeF XML invoices?
Turn it into an Excel workbook and PDFs. Free up to 5 files, nothing uploaded.
Questions
How can I tell that a verification link is not from a real invoice?
A link that starts with https://qr-test.ksef.mf.gov.pl or https://qr-demo.ksef.mf.gov.pl points to a test or demo environment. Production links start with https://qr.ksef.mf.gov.pl.
Can I send real invoices to the test environment?
No. The documentation says the test environments are only for testing the integration and that production invoices and real data of entities must not be sent to them.
Does the test environment still accept FA(2)?
According to the environment table, yes: TEST lists FA(2) and FA(3), while DEMO and PROD list FA(3) only (next to the PEF formats).
Source: Środowiska KSeF API 2.0 (KSeF documentation, dated 16.03.2026); Kody weryfikujące QR (KSeF documentation, dated 21.08.2025). Read 2026-11-10.