How to Set Up USDT Payment?

Setting up a USDT payment gateway is straightforward using Metamask or any compatible wallet. Metamask is available as a mobile and web wallet, so choose the version that suits you best. Additionally, you'll need an Etherscan API key.

Steps to Locate Your Ethereum Wallet Address :

1.  Install Metamask Wallet:

  • Add the Metamask extension to your browser.

2. Set Up the Account:

  • You can either import an existing wallet or create a new one.

3.  Configure the Wallet: 

 Select the network type. We provide two options on the settings page: a test network and a production network.

  • After configuring your wallet, you will obtain a wallet address. Enter this address in the WHMCS settings page and select the USDT option for it to appear during checkout and on the payment type selection page.

  • Next, select the network type in your Metamask wallet as outlined below. Then, set the same network in the WHMCS settings page.


  • We offer two network options: the Sepolia test network for testing the gateway, and the Ethereum Mainnet network for actual USDT payments on your site.

Why is an Etherscan API key needed, and what is its purpose?

The Etherscan API key allows programmatic access to Ethereum blockchain data, enabling tasks such as retrieving transaction details, account balances, and smart contract information. It ensures secure authentication, rate limiting, and access control for developers integrating blockchain data into their applications. To get an API key, sign up on Etherscan, request a key, and choose a usage plan based on your needs.

How to Set Up  the Etherscan API

1. Visit Etherscan: 

  • Go to the Etherscan website and click on "Sign Up" to create a new account.
  • Complete the registration process by providing the necessary information.

2  Generate an API Key

  • Log in to your Etherscan account and navigate to the dashboard.
  • Click on the "API-KEYs" tab.
  • Select the "Add" option to generate a new API key. Note that each account can create up to three keys.

3. Enter the API Key 

  • Copy the generated API key.
  • Go to the settings page of the WHMCS plugin and enter the API key in the designated field.
  • Save the settings to apply the changes.

How the USDT Payment Will Appear on Your Store Website ? 

1. Payment Option Display:

  •  Once the settings are saved in WHMCS, customers will see the USDT payment option on the checkout page.

2 Selecting USDT :

  • When customers select the USDT option, they will be directed to a payment page specifically for USDT transactions.

3. Connect Wallet:

  • On the USDT payment page, customers need to click on the "Connect Wallet" button.
  • This will prompt them to connect their browser-installed wallet (e.g., Metamask) to the payment gateway.

4. Making a Payment: : 

  • After the wallet is connected, customers can proceed to complete the payment.
  • The payment page will display the transaction details and allow customers to authorize the payment through their connected wallet.

Following these detailed steps will ensure a smooth and successful setup of USDT payments on your website, providing your customers with a seamless and secure payment experience.

How can I test a USDT payment store on the Sepolia network before deploying it?

1. Select the network type

  •  On the settings page, select the network type "Sepolia" in the WHMCS plugin. In the dropdown options, there are two types of networks: Mainnet and Sepolia. Select "Sepolia" for testing purposes.

2. Add the USDT address and Etherscan API Key

  • Follow the steps mentioned in the sections "How to Set Up the Etherscan API" and "Configure the Wallet" to set up the Etherscan API and the USDT address.


3. Making payment using sepolia network

  • Once you enable the USDT payment option, which looks like the image below, go to your website and select USDT as the payment option.
  •  Then go to your website and select the payment option as USDT
  •  Make sure you are using the same network type in the wallet as in the settings page of the plugin, or else you will get an error message: "Please change the wallet network." It will connect to the wallet, but you cannot make a payment. The Sepolia network is just for testing purposes and is used to test the end-to-end payment gateway, allowing users to get comfortable with the payment process before actually making a payment.

  • Once you select the Sepolia network, it will show the "Pay Now" button. You can click on it, and after clicking on the confirm button in the wallet, the payment will be made.

  • During the payment process, you will be redirected to the invoice page, where all the payment details will be displayed in an invoice format.

  • As a merchant, you can see the background job status in the module log, which will provide you with a clear idea of the payment process and any errors that may have occurred during the background process.

  • Once the payment is done successfully, the customer will be redirected to the page shown below.