Environments

Overview

This guide walks you through the testing and production environments for a payment system, covering everything from API endpoints to merchant IDs. It also tackles common questions about test accounts, helping you navigate the transition from testing to real-world transactions.

Testing Environment

The testing environment is used to test all transaction cases before moving to production.

To access the testing environment, you'll need to use the test domain and a test merchant account provided by Prahsys. This environment allows you to simulate various transaction scenarios without affecting real funds or accounts.

Ensure that all your test data, including customer information and transaction details, uses mock or synthetic data to avoid any accidental use of real information. Use this environment to thoroughly test all possible transaction cases, error scenarios, and edge cases before moving to production.

  • Name
    API endpoint
    Type
    URL
    Description

    Test domain to simulate real world usage.

API Endpoint

test-lighthouse.prahsys.com
  • Name
    Mechant ID
    Type
    string
    Description

    Use of test merchant accounts (format: TEST{{merchantId}}) This ID follows a specific format to distinguish it from production merchant IDs.

Merchant ID Example

Provided by Prahsys after onboarding
TEST1234

Production Environment

To access the production environment, you'll need to use the provided API endpoint and a real merchant account.

  • Name
    API endpoint
    Type
    URL
    Description

    Use this environment for real transactions with real merchant accounts. Trying to use a test merchant account in this environment will result in an merchant not found error.

API Endpoint

lighthouse.prahsys.com
  • Name
    Mechant ID
    Type
    string
    Description

    To use a production merchant account, it will not have the word TEST in front of it. This merchant ID will only work in the production environment.

Merchant ID Example

Merchant ID provided by Prahsys via webhook
EB1234PR

FAQ

How do I get a test merchant account?

When onboarding with Prahsys, you will receive a test merchant account to use in the testing environment.

Can I use the same merchant account for both testing and production?

No. You will need a separate merchant account for each environment. The test merchant account is only for the testing environment.

Can I test a production merchant's account in the testing environment?

Yes, you can test a production merchant's account in the testing environment by adding TEST in front of the merchant ID.

While this workaround is possible, it's generally not recommended as best practice. It should be used cautiously and only when absolutely necessary, as it involves interacting with the production environment.

  1. Testing Environment: You cannot use a production merchant account in the testing environment (test-lighthouse.prahsys.com).

  2. Production Environment Workaround: You can test a merchant's account on the production URL (lighthouse.prahsys.com) by adding 'TEST' in front of the merchant ID.