Integration Guides

Introduction

Welcome to the API documentation!

To begin using tZero Pay, you’ll first need to complete an integration.

Your initial setup will be done in a sandbox environment, where you can safely test all the tools and features. Once testing is complete, we’ll provide you with a live account for real transactions and financial operations.

After switching to your live account, your system will be ready to accept real payments.



Steps required to integrate with tZero Pay.


Sandbox Integration

Follow these steps to set up your Sandbox Merchant Account with tZero Pay:

1. Share Contact Details

Your website representative provides us with your technical specialist’s details:

  • Full name
  • Email address
  • Mobile number

2. Receive Login Credentials

Your technical specialist will receive an email containing:

  • Login username
  • Link to the Sandbox Merchant Account
  • First-time login instructions

3. Set Permanent Password

Your technical specialist logs in and sets a permanent password for the Sandbox Merchant Account.

4. Access API Integration Parameters

Inside the Sandbox Merchant Account, you’ll find the API integration parameters under the Developers section.

📘

Please confirm the integration status with your Account Manager.

5. Receive API Keys

Your technical specialist will receive the following keys:

  • Secret Key
  • Public Key

Test cards

Use our test cards to simulate different payment flows, to ensure your integration is set up correctly and behaving as expected.

SchemeCard Number
MasterCard5555555555554444
Visa4242424242424242

Live Integration

Follow these steps to set up your Production (Live) Merchant Account with tZero Pay:

1. Share Contact Details

Provide us with the contact information of a business representative to support the integration:

  • Full name
  • Email address
  • Mobile number

2. Receive Login Credentials

Your business representative will receive an email containing:

  • Login username
  • Link to the Production Merchant Account
  • First-time login instructions

3. Set Permanent Password

Your representative logs in and sets a personal permanent password for the Production Merchant Account.

4. Access API Integration Parameters

Inside the Production Merchant Account, you’ll find all necessary API integration parameters.

📘

Confirm the integration status with your Account Manager.

5. Replace Sandbox Credentials

Your business representative or technical specialist should replace the existing Sandbox credentials with the live values received from tZero Pay.

6. Go Live

👍

Once the credentials are updated, your system is fully ready to accept live payments!