Guides
  1. GSP Credentials

Upload IRN portal credentials

OneFinOps stores your NIC IRP credential and signs to NIC on your behalf when you call /v1/einvoices/*. You upload the credential once per GSTIN through the Developer hub in the OneFinOps web app — not through the public API.

Prerequisites

A NIC IRP API user for the target GSTIN. Create one at einvoice1.gst.gov.in → API Registration → Create API User. NIC issues a username and a password. This is a one-time setup on NIC's side, outside OneFinOps.

Upload the credential

  1. Sign in to the OneFinOps app.
  2. Open Developer hub → GSP credentials → IRN.
  3. Click Add credential, enter the GSTIN, the NIC username, and the password.
  4. Save. OneFinOps encrypts the password at rest and uses it from that point on for every /v1/einvoices/* call where the gstin header matches.

Verify the credential against NIC

From the same screen, hit Test connection on the credential row. OneFinOps runs a no-op call against NIC's IRP. A green tick means the credential works; a red error surfaces NIC's response so you can fix and retry.

Rotation

NIC's API passwords expire on a fixed cadence (90 days by default). When rotation is due:

  1. Generate a new password on the NIC portal.
  2. In the OneFinOps app, open the existing credential row and click Rotate.
  3. Enter the new password. The record is replaced in place — no historical passwords are retained.

Test-rotate against a non-production GSTIN first so a typo doesn't lock you out of live filing.

Audit trail

Every upload, rotation, deletion, and use is logged. Open Developer hub → Audit log for the timeline (or ask support to pull it).

Where to next