Skip to main content

Authentication Errors

Updated

Table of Contents

  1. Overview
  2. Understanding Authentication Errors
  3. Troubleshooting Steps
  4. Conclusion

Overview

Authentication errors can pose challenges when interacting with the Payment API, often stemming from issues verifying the authenticity of user requests. This article delves into common authentication errors, providing insights and troubleshooting steps to address these issues before reaching out to support.

Understanding Authentication Errors

Authentication errors manifest as a failure in verifying the authenticity of user requests submitted to the Payment API. These errors include:

  1. Authentication Failed
  2. User Not Found
  3. 404 Not Found
  4. Specified API Key Not Found

For the purpose of this article, the focus will be on authentication-based errors.

Troubleshooting Steps

Authentication errors may have various causes, each requiring specific resolutions. This article guides you through troubleshooting steps for authentication errors to empower integrators to address issues independently.

1. Incorrect Credentials

When utilizing a Security Key or a username and password pair for API authentication, authentication errors may occur due to:

  • Incorrect Security Key or one sourced from a different Merchant Gateway Account.
  • Use of a malformed or redacted version of the Security Key.
  • Incorrect username and password pair, sourced from a different User Account.
  • Recent password change associated with the User Account.
  • Lack of URL encoding in the API request.

For these errors, review the mentioned common issues and verify credentials.

2. IP Restrictions

Authentication errors can stem from IP restrictions enabled through the Merchant Gateway Account. To address this:

  • Check IP Restriction settings in the Merchant Gateway Account.
  • Allow any IP addresses submitting Payment API requests.
  • Confirm whether the IP being used is allowed within the Merchant's Gateway Account.

3. Confirming the API Endpoint

Submitting API requests to the incorrect endpoint can result in authentication errors. To resolve:

  • Submit a POST request to the proper API endpoint.
  • Log in to the Merchant's Gateway Account, go to Help, and select Integration Portal.
  • Navigate to the Payment API documentation to confirm and correct the appropriate endpoint.

Conclusion

Authentication errors, while common, can be effectively addressed through systematic troubleshooting. By understanding the potential causes and following the recommended steps, integrators can resolve issues independently, ensuring a smooth and secure interaction with the Payment API. Before reaching out to support, consider these troubleshooting steps to streamline the resolution process.