Integrations — Tricsoft Pay Documentation

Overview

Business accounts use API keys, while personal accounts use access tokens. Credentials are tied to either the sandbox or live environment and only accept requests from whitelisted IP addresses.

Choose the correct credential

Account type	Credential	Dashboard page
Business	API key ID and API secret	Developers → API Keys or Sandbox
Personal	Personal access token	Developers → Access Tokens

Before generating credentials

Choose the sandbox environment while developing or the live environment when processing real transactions.
Identify every public outbound IP address that will send requests to TricsoftPay.
Complete KYC approval before generating credentials for the live environment.
Prepare a secure password manager or secrets vault because secret values are displayed only when generated.

Generate a sandbox API key

Business users can open Developers → Sandbox, select the API Keys tab, and create a sandbox key.

Sandbox API key steps

Open the Sandbox page and select the API Keys tab.
Select Create Key and enter a descriptive key name.
Add each public outbound IP address that will use the key.
Generate the key, then immediately copy the API key ID, API secret, and webhook secret.

Generate a live API key

Business users with approved KYC can open Developers → API Keys to generate credentials for live transactions.

Live API key steps

Switch the account to the live environment.
Open API Keys and select Create API Key.
Enter a descriptive name and add every public outbound IP address that will use the key.
Select Generate Key and securely save the API key ID, API secret, and webhook secret.

Generate a personal access token

Personal users can open Developers → Access Tokens to generate an environment-specific token.

Personal access token steps

Choose the sandbox or live environment. Live credentials require approved KYC.
Add every public outbound IP address that will use the token.
Enable API access to generate the first token, or rotate the token to replace an existing one.
Immediately copy the personal access token and webhook secret because they will not be shown again.

Save every returned value

Account type	Returned values	Visibility
Business	API key ID, API secret, webhook secret	Secret values are shown once
Personal	Personal access token, webhook secret	Both values are shown once

IP whitelist requirement

At least one public outbound IP address must be added when credentials are generated.

Requests sent from any other address will be rejected with the error: IP address not whitelisted.

If your server's outbound IP changes, update or rotate the affected credentials before sending more requests.

Screenshot placeholders

Add a screenshot of the Sandbox API Keys tab and key creation form.
Add a screenshot of the live API Keys creation dialog.
Add a screenshot of the Access Tokens environment and IP whitelist form.
Add a screenshot of the one-time credential result showing where to copy the webhook secret.