---
updatedAt: 2026-02-26T13:11:06.000Z
agentTools:
  projectIndex: https://docs.ksa.ngenius-payments.com/llms.txt
---

# Getting started

## Your service account API key and outlet reference

By now, you should have been provided with an **N-Genius Online** Portal login. If you have not been provided with this login, please contact your **N-Genius Online** Portal administrator, which may be someone in your own company.

In order to integrate with the **N-Genius Online** payment APIs, you will need to generate a Service Account API key. To do so, first log-in to the **N-Genius Online** Portal, and navigate to the *Settings > Integration > Service Accounts* section, then click ‘*New*’.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/f36818515aa92c7a81e8ae4a4a89ac3592e1ed6a0b96cb88e6c2eec64345000a-service_account.png",
        "",
        "The screenshot demonstrates the setup of a new service account API key within the N-Genius portal."
      ],
      "align": "center",
      "caption": "Service account API key and reference."
    }
  ]
}
[/block]

You will then be prompted to enter the following details:

* **Name**: a simple, memorable short name for your API key.
* **Description**: a longer description for your API key, useful if you plan on using multiple keys.

Once you have defined a Service Account API key, you should then make a note of the outlet reference for your trading outlet. To find this, navigate to *Settings > Organizational Hierarchy* and select an outlet from the left-hand panel.

Outlets are denoted by a small, unfilled square icon:

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/d14a44e-outlet_icon.PNG",
        "outlet_icon.PNG",
        51
      ],
      "align": "center",
      "sizing": "auto"
    }
  ]
}
[/block]

Once an outlet is selected, the outlet reference will then be displayed in the right-hand panel.

![](https://files.readme.io/dc44f65-outlet_reference.PNG "outlet_reference.PNG")

You will need both the API key and the outlet reference for your N-Genius Online account to proceed with the integration guides contained in this document, so be sure to take a note of them.