Environment Setup

We provide separate environments for development/testing and production so you can build and test your integration before going live.

1. Production Environment

The Production Environment processes real transactions. Only use it once your integration has been tested and approved.

API Hostname: https://api.vivamo.co/v1

SDK Source: https://sdk.vivamo.co/v1

2. Testing/Sandbox Environment

The Testing/Sandbox Environment lets you simulate transactions without processing real payments.

Note that it is not possible to test all scenarios due to some underlying processor, bank and gateway restrictions.

API Hostname: https://api.test.vivamo.co/v1

SDK Source: https://sdk.test.vivamo.co/v1

3. Switching Between Environments

To switch between the Production and Testing/Sandbox environments, you will need to update the API hostname in your application's configuration. Make sure that you also use the appropriate API keys for each environment, as these will differ.

• Production to Testing: Update your API requests from https://api.vivamo.co/v1 to https://api.test.vivamo.co/v1.

• Testing to Production: Ensure all test cases pass, then update your API requests back to https://api.vivamo.co/v1.

Please note, when initialising the frontend SDK, the environment can be specified using a configuration object. If no environment is specified, Vivamo will default to production.

4. Testing with mock transactions

When your operator is configured with the Vivamo mock processor, you can simulate payment outcomes in the sandbox environment without hitting real payment networks.

The mock processor provides pre-defined tokens that appear alongside any real saved payment methods in the SDK. Each token triggers a specific outcome:

Card tokens

Bank tokens

These tokens are returned automatically by the SDK when the mock processor is active — you do not need to create or configure them. The mock processor simulates a short processing delay (1-2 seconds) to mimic real processor behavior.