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 credentialsDo 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:
| Header | Key |
|---|---|
| Content-Type | application/vnd.ni-identity.v1+json |
| Accept | application/vnd.ni-identity.v1+json |
Body / Form Data:
| Key | Value |
|---|---|
| username | [your_username] |
| password | [your_password] |
| clientid | Network International_PORTAL_ID |
| grant_type | password |
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": ""
}
