Keys and Credentials

Super issues several credentials, and which ones you need depends on how you integrate. This page lists all of them in one place.

Which Credentials Do I Need?

Any of these can receive webhooks. Each endpoint you create has its own Webhook signing key, used to verify the request came from Super.

Creating a Brand

A brand is the identity your customers see at checkout, and it carries its own payment methods and cash reward settings. Every Brand ID and payment initiator ID belongs to a brand, so create your brand before you go looking for those.

Brands live in the Business Portal under Settings → Brand settings, which lists your existing brands with their cash reward, expiry and last updated date.

Step 1: Brand Details

Select Add a new brand, then fill in:

A preview panel on the right shows what a payment on your store would look like as you type.

Select Next - Cash reward to continue.

Step 2: Cash Reward

A cash reward is optional. To run the brand without one, select Enter a custom amount and set it to 0%.

To offer a reward, choose 2%, 4%, 5%, 6% or 8%, or enter your own percentage as a custom amount. 5% is marked Most popular.

Set Expiration to choose how long a reward stays usable, from 1 to 12 months.

Creating a Super Key

1. Log in to the Business Portal and select Developers in the sidebar.
2. Open the API Keys tab.
3. Choose the version you are integrating against from the API version selector.
4. Next to Super Keys, select Show.
5. Select Add Super Key and store the new key securely.

Your publishable key is listed under Publishable API Keys - select Show to reveal it, then use the copy button. There is a single publishable key per API version, so there is nothing to create.

Finding Your Brand ID and Payment Initiator ID

Your payment initiator ID is passed in the request body when you create a payment. Your Brand ID is required when creating payment links via the API. Both are listed in the same panel.

1. Log in to the Business Portal and select Developers in the sidebar.
2. Open the API Keys tab and scroll to Brand payment initiators and IDs.
3. Select Show next to the brand you want.

Your Brand ID is shown at the top of the panel. Beneath it, a payment initiator ID is listed for each integration on that brand, shown under the integration's website URL.

If no payment initiator ID is listed, the brand has no custom integration yet. Create one under Developers → Integrations → Create new integration.

Things Worth Knowing

The plugin API key is shown once

Your PSK_ key is displayed only at the moment you generate it. Copy it straight into your e-commerce platform before generating another. Your Confirmation ID stays the same for the life of the integration.

Keys are issued per API version

Super keys and publishable keys are tied to an API version. Use the API version selector on the API Keys page to see the keys for the version you are integrating against. See Authentication.

Test credentials are separate

Your sandbox uses its own credentials, and a live key will not work in the sandbox. See Sandbox Environment.

Next Steps