Authentication

The authentication process allows you to interact with our API services.

Account environments

Your Notch Pay account has two different modes of operation:

  • Live Mode: This mode involves real transactions with actual money and effects. Prior to switching to this mode, we advise thoroughly testing your integration.

  • Test Mode: This mode does not involve real money and can only make use of our test credentialss. Despite the absence of real money, we still send webhooks and email notifications, and most API functions are retained.

Switching between Live and Test modes is a simple task, facilitated by the toggle button located at the header. Upon toggling between modes, the displayed API keys will swap correspondingly.

API Keys

When a user creates a Notch Pay account, they are provided with three categories of API keys:

  1. Public Sanbox key, which is use for test environment.

  2. Public key, which is employed for "public" scenarios like in front-end JavaScript code.

  3. Private key, which is exclusively used with high risk endpoint sush as transfer. Therefore great caution should be exercised to ensure that it is never exposed to the public.

To obtain your keys, follow these steps:

  1. Log in to your Notch Pay dashboard.

  2. Proceed to Settings.

  3. Go to Developer Settings.

  4. Select the API Keys option

Authorizing API calls

Every API call made on Notch Pay is duly authenticated. If API requests are made without proper authorization, it will result in a failure with the HTTP status code 401: Unauthorized.

To ensure authorization of API calls from your server, it is necessary to pass your public key as a autorization value. This can be accomplished by passing an Authorization header with a value of "YOUR_PUBLIC_KEY".

For example, an API call could look like.

This endpoint allows you to retrieve your merchant information's.

  • Name
    Authorization : PUBLIC_KEY
    Type
    Description

Ping

GET
/
curl --location --request GET 'https://api.notchpay.co' \
--header 'Authorization: PUBLIC_KEY'

Response

{
    "code": "200",
    "message": "OK",
    "greeting": "Hello from Notch Pay",
    "merchant": "Shopperlabs",
    "env": "production"
}