Every Hello Clever integration — whether you are connecting a Shopify store, a WooCommerce site, or a custom API — requires two credentials: an app-id and a secret-key. This page explains how to generate these keys from the Merchant Portal using the Link Site wizard.
You need an active Hello Clever merchant account before you can generate integration keys. If you have not created one yet, see Create Your Hello Clever Merchant Account.

​
Generate your integration keys

1

Open the Link Site wizard

Log in to your Hello Clever Merchant Portal and click the + Link Site button in the top-right corner of the page.This opens the Link Site wizard, where you configure a new site integration and receive your credentials.
2

Select an integration type

In the Link Site wizard, choose the integration type that matches your setup:
  • E-commerce platforms: Shopify, WooCommerce, Magento, and similar platforms.
  • Invoice: For collecting payments via Xero.
  • Physical store: Tyro POS integration for in-store payments.
  • Custom APIs: Payment API or Cashback API for white-label or custom-built checkout integrations.
Select the option that best describes how you plan to use Hello Clever.
3

Enter site details

Fill in the Site Info section:
  • Logo: Upload your store’s logo. Maximum file size is 2 MB.
  • Site name: Enter a name that identifies this integration (for example, your store name).
  • Store URL: Provide your store’s website address.
Once you have filled in the site info, locate the App ID & Key section on the same screen:
  • App ID: A unique identifier automatically generated for this site. This is your app-id.
  • Primary Secret Key: A secure key used to authenticate API requests. This is your secret-key.
You can also add an optional Note to help you identify this integration later — useful if you manage multiple sites.
Treat your secret-key like a password. Do not share it publicly, commit it to version control, or expose it in client-side code. If your key is compromised, generate a new one from the Merchant Portal immediately.
4

Complete setup

Once all required fields are filled in, click Complete.A success screen confirms that your integration is ready. Your app-id and secret-key are now active and can be used to authenticate requests to the Hello Clever API or to configure a plugin.

​
Next steps

With your app-id and secret-key in hand, you are ready to connect Hello Clever to your platform:
  • Plugin integrations: Enter your credentials in the Hello Clever plugin settings for Shopify, WooCommerce, Magento, or other supported platforms.
  • API integrations: Pass your app-id and secret-key as authentication headers in requests to the Hello Clever API. See the API authentication guide for the required format.
If you need separate credentials for testing and production, create one integration in your sandbox account and another in your live account. Each environment generates its own independent set of keys.