Enable your business & get your keys

Before Zinye can send invoices to NRS, your business must be enabled for e-invoicing on the NRS portal, and you need to collect a few credentials. You only do this once.

1. Enable your business

1. Go to the NRS e-Invoicing portal and Register / request enablement for your business.
2. Submit your business details (TIN, CAC/RC number, etc.) and wait for approval.
3. Once approved, you can log in to the portal.

Note

You must be enabled before you can log in. If login says you’re not enabled yet, your application is still being reviewed.

2. Find your API credentials

In the portal:

1. Open My Account → API Integration (the View API Credentials page).
2. Note these values — you’ll paste them into Zinye:
   • Base URL (sandbox or production)
   • Business ID
   • API Key
   • Client Secret
   • Service ID — shown inside the IRN Template (e.g. {{invoice_id}}-B0B17AB7-{{YYYYMMDD}} → your Service ID is B0B17AB7)

3. Download your cryptographic keys

The QR code on your invoices is built from your public key and certificate.

1. On the API Integration page, find Cryptographic key → Manage Cryptographic Keys.
2. If you don’t have an active key yet, click Generate cryptographic key.
3. Use More actions → Re-download Key to download a file named crypto_keys.txt.
4. Open it — it contains two values you’ll need:

{
  "public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZ...",
  "certificate": "VmRLanBDUUxiNlVUM0s1bjcr..."
}

Caution

Keep crypto_keys.txt safe — it’s tied to your business. Copy the public_key and certificate values exactly (they’re long) — a single wrong character will stop the QR code from working.

Test mode vs live

The portal has a Test Mode toggle. While testing, keep it on and use the sandbox Base URL (https://eivc-k6z6d.ondigitalocean.app). Invoices sent in test mode are not binding. Switch to live only when you’re ready to file real invoices.

Next

• Configure Nigeria Compliance Settings