Guides
  1. GSP Credentials

Upload EWB portal credentials

OneFinOps stores your NIC EWB-portal credential and signs to NIC on your behalf when you call /v1/ewaybills/*. You upload the credential once per GSTIN (or TRANSIN) through the Developer hub in the OneFinOps web app — not through the public API.

Prerequisites

A NIC EWB API user for the target GSTIN or TRANSIN. Create one at ewaybillgst.gov.in → For GSP → Registration. NIC issues a username and a password.

Transporters without a GSTIN: register for a TRANSIN on the EWB portal and use it everywhere OneFinOps asks for gstin — the field accepts either.

Upload the credential

  1. Sign in to the OneFinOps app.
  2. Open Developer hub → GSP credentials → EWB.
  3. Click Add credential, enter the GSTIN (or TRANSIN), the NIC username, and the password.
  4. Save. OneFinOps encrypts the password at rest and uses it for every /v1/ewaybills/* call where the gstin header matches.

Verify the credential against NIC

Use the Test connection button on the credential row. OneFinOps runs a no-op call against NIC's EWB portal and reports the result inline.

Two portals, two credentials

NIC runs the IRP and EWB portals on separate authentication systems. To do both flows for a single GSTIN you need two uploaded credentials — one IRP, one EWB. The username and password may differ between them.

Exception: a POST /v1/einvoices/generate call with an eWayBillDetails block reuses the IRP credential for the linked EWB leg in the same response (see Generate IRN with E-Way Bill). That's the only case where one credential covers both portals.

Where to next