Other ways to request an access token

Request an access token using portal login credentials for temporary testing or debugging. Use API-key authentication for production integrations.

Request an access token with your portal login credentials for debugging or temporary use with N-Genius Online.

🚧

Security warning: user credentials

Do not use user credentials in production systems or any persistent integration to N-Genius Online. This would represent a significant security risk. User credentials also expire after a given number of days and become invalid.

Use this procedure only for debugging or temporary testing.

For production integrations, use the recommended API-key method to request an access token.

Request an access token using portal login credentials

HTTP Request Method: POST
Resource (URI): https://identity.sandbox.ngenius-payments.com/auth/realms/TENANTREALMNAME/protocol/openidconnect/token

Headers:

HeaderKey
Content-Typeapplication/vnd.ni-identity.v1+json
Acceptapplication/vnd.ni-identity.v1+json

Body / Form Data:

KeyValue
username[your_username]
password[your_password]
clientidNetwork International_PORTAL_ID
grant_typepassword

Example request (body):

{
  "username": "[your_username]",
  "password": "[your_password]",
  "clientid": "TENANTNAME_PORTAL_ID",
  "grant_type": "password"
}

Example response (body):

{
  "access_token": "eyJhbGciOiJSUzI1N…0eDloZnVRI",
"expires_in": 300,
"refresh_expires_in": 1800,
"refresh_token": "eyJhbGciOi…eDloZnVRIn0",
"token_type": "bearer",
"not-before-policy": 0,
"session_state": "1f2e7d6e-e1f6-41f8-b763-37be5ef747d2",
"scope": ""
}
© Network International LLC. All Rights Reserved.