Integrate Automatic USDT TRC20 Deposits In a Laravel Application

Dec 23, 2023

Are you working on a fresh laravel application or has one already running and you want to integrate USDT TRC20 deposits? Here is a step by step guide to help you start accepting automatic USDT TRC20 deposits in your laravel website.


USDT TRC20 is a version of Tether (USDT) stable coin issued on the TRON blockchain adhering to the TRC20 token standard.

Integrating USDT payments in web applications is becoming a requirement for successful online businesses since it allows users to transact globally without the need of intermediaries like banks which in return reduces transaction fees involved in fiat currency conversions and ensures faster and straight forward transactions.

The ability to handle automatic USDT deposits on your website without relying on any payment gateway keeps you in direct control over your finances.


This documentation expects you to be working with a laravel application that has user authentication and you are looking to integrate automatic USDT TRC20 deposits for the users.

You are also expected to have a tron wallet preferably the Tronlink wallet that allows you to export your private key.

Step 1: Install required Packages

For the start, you need to install the required laravel packages and in this case we need specifically two packages ie;


This is a php package for interacting with the tron blockchain.

        composer require iexbase/tron-api --ignore-platform-reqs

This is a php package for generating qr codes which make it easier for the user to simply scan the qr code for the deposit wallet address from their mobile device.

        composer require simplesoftwareio/simple-qrcode "~4" --ignore-platform-reqs

Step 2: Set Up Tronlink Wallet

If you currently do not have the tronlink wallet app or extension you need to install it from and create a tron wallet.

Step 3: Configuration

Since you already have the laravel project by now, it's time to handle the configuration to add the required models, controller and other required files in the project.

First you need to download and unzip the USDT TRC20 AUTOMATIC DEPOSITS FOR LARAVEL zipped file and its file structure is as shown below.

file structure

Now you have to copy the files into your laravel application in accordance with the file structure.

For some files (app/Console/Kernel.php, app/Models/User.php, routes/web.php) you just have to copy the specified lines of code into the respective files in your laravel application.

Copy files

First, you have to copy the commands to your laravel project


Copy the controller to your project


Copy the three models to your project.


Copy the migration files into your migrations folder.


Also copy the deposit.blade file along with its directory to your views folder.


Copy and paste code


Copy the following code into your schedule() function.


The cron job

To process the deposits and continuously interact with the tron blockchain, the system uses a cron job / task scheduling to run the above scheduled commands. For details on how to handle laravel task scheduling and cron job, check out the laravel docs at Laravel Scheduling

For the purpose of testing can run the schedules buy running the following artisan commands

      php artisan schedule:run

Or you can run the commands directly with the artisan commands below for the check-dops command and check-deposits command.

      php artisan app:check-dops
      php artisan app:check-deposits


Copy the following code into your User Model.

      public function dops(){
        return $this->hasMany(Dop::class);
    public function usdtDeposits(){
        return $this->hasMany(UsdtDeposit::class);
     public function getTotalUsdtDeposits(){
        return $this->usdtDeposits()->sum('amount');


Copy the following code to your routes/web.php file

])->group(function () {
    Route::get('/usdt-deposit', [\App\Http\Controllers\UsdtDepositController::class, 'deposit']);

.env file

You now need to add the following in the env file to set the required minimum deposit amount.


Run the migrations.

It is now time to run the migrations so that they can update and generate the required tables in the database.

Two new tables will be generated ie; dops and usdt_deposits table.

The users table will be updated to add two columns (tron_wallet_address, tron_wallet_key).

Execute the migrations by running the following artisan command below.

php artisan migrate

Export tron wallet address and private key.

The final configuration is to export your tron wallet address and the tron wallet private key and these are going to be added to the system specifically in the Tron.php file.

For a detailed guide on how to export the tron private key, check out my article on How To Export Tron Private Key From Tronlink Wallet


Your tron wallet is going to handle specifically two purposes ie;

  1. First, it is going to be your central wallet that receives all the funds deposited by the users.
  2. Second, it is going to be providing fees in the form of TRX to be used in the transfer of the USDT TRC20 tokens to the central wallet (itself). So make sure to atleast have a minimum balance of 100TRX in the wallet.

Now that you have exported the address and the private key, you are going to fill them in the Tron.php model (app/Models/Tron.php) as directed bellow

      private $deposit_wallet = "wallet address";
      private $deposit_key = "wallet private key";

Step 4: Testing and Running

Now that you have everything set up, it is time to test the deposits.

You can now login and navigate to /usdt-deposit and you should get a simple deposit page with the payment address displayed and it should look like the image below. Feel free to customise the page to meet your ui requirements.


qr code

You can now make a deposit to that displayed wallet address and then run the artisan command below to have the deposit processed by interacting with the tron blockchain on the development environment.

      php artisan app:check-deposits

Now the deposit should be processed and the details filled in the database.

With that said, now you should be able to take it from here and do the final touches such as updating user balances and so on.

Thanks and Best Wishes