Skip to main content

Environments

Sticitt provides two isolated environments for partners. You should develop and test your integration in the Test environment before switching your credentials to Production.

Service Endpoints

The API, Authentication, SDK, and Payment Link services run on specific subdomains depending on the environment.

ServiceTest (Sandbox)Production (Live)
API Base URLhttps://api-test.sticitt.co.zahttps://api.sticitt.co.za
Authenticationhttps://iam-test.sticitt.co.zahttps://iam.sticitt.co.za
JS SDK Sourcehttps://sdk-test.sticitt.co.zahttps://sdk.sticitt.co.za
Payment Linkshttps://link-test.sticitt.co.zahttps://link.sticitt.co.za
Best Practice

We recommend storing these base URLs in your application's environment variables (e.g., .env file) so you can switch between Test and Production without changing your code logic.


Test Environment

The Test environment is a fully functional sandbox that mirrors the behavior of Production. It is designed for development, QA, and integration testing.

Handling Test Funds

Funds in the Test environment have no real-world value. You cannot withdraw them, and they do not represent actual fiat currency.

However, to test payment flows, you often need a positive wallet balance. You can load "play money" into a test wallet using two methods:

  1. Self-Service: Create a wallet using our test Money Portal at https://money-test.sticitt.co.za. Select Load Funds -> Stitch payment method. Follow the on-screen prompts; the test version of Stitch allows you to simulate a successful EFT, which will credit the test wallet.
  2. Manual Request: If you need a specific balance configuration or bulk adjustment, please contact our technology team at technology@sticitt.co.za.

Production Environment

The Production environment is the live system.

Real Money Warning

All transactions in Production involve real money. There is no "test mode" or "flag" available within the Production environment. If you initiate a payment or top up a wallet in Production, actual funds will be deducted from the funding source (Card or Bank Account).

Go-Live Checklist

Before switching your base URLs to Production, ensure:

  • You have tested your integration in the Test environment.
  • You have obtained your Production Client ID and Secret (these differ from your Test credentials).
  • You are pointing to the correct Identity Provider (https://iam.sticitt.co.za) to generate tokens.
  • You have updated your application's environment variables to use the Production base URLs.
  • You have provided production Webhook URLs to our technology team at technology@sticitt.co.za
  • You have completed and signed the third party integration agreement.