Laravel / PHP Integration

Integrate the tzsmm/tzsmmpay package into your Laravel application by following these steps:

Step 1: Install the Package

Run the following command in your terminal to install the package via Composer:

composer require tzsmm/tzsmmpay

Step 2: Usage

Use the package by importing the required classes and initializing the client with your API key. Here's a basic example:

     use Tzsmmpay\TzsmmpayClient;
     use Tzsmmpay\TzsmmpayResponse;
     
     // Initialize the client with your API key
     $apiKey = 'your-api-key'; // Replace with your actual API key
     $tzsmm = new TzsmmpayClient($apiKey);
     
     // Create a payment
     $paymentData = [
         'cus_name' => 'Customer Name',
         'cus_email' => 'customer@example.com',
         'cus_number' => '01700000000',
         'amount' => 100,
         'success_url' => 'https://example.com/success',
         'cancel_url' => 'https://example.com/cancel',
         'callback_url' => 'https://example.com/callback',
     ];
     
     $response = $tzsmm->createPayment($paymentData);
     
     if ($response->isSuccess()) {
         echo "Payment created successfully!";
         echo "Transaction ID: " . $response->getData()['transaction_id'];
         echo "Payment URL: " . $response->getData()['payment_url'];
     } else {
         echo "Error: " . $response->getMessage();
     }
       

Step 3: Verifying a Payment

Verify the status of a payment using its transaction ID:

     $transactionId = 'transaction-id'; // Replace with the actual transaction ID
     
     $response = $tzsmm->verifyPayment($transactionId);
     
     if ($response->isSuccess()) {
      if ($response->getData()['status'] == 'Completed') {
          echo "Payment verified successfully!";
      } else {
          echo 'Your Payment is ' . $response->getData()['status'];
      }
     } else {
         echo "Verification failed: " . $response->getMessage();
     }
       

You're Ready!

Your Laravel application is now equipped to work with the tzsmm/tzsmmpay package. Configure it further based on your application needs to start processing payments seamlessly.

Creating Transaction API

This API allows you to create a new payment transaction and initiate the payment process for your customers. To create a transaction, you need to make a request to the following endpoint:

POST https://tzsmmpay.com/api/payment/create

Required Parameters:

• api_key: Your unique API key for authentication.
• cus_name: The name of the customer.
• cus_email: The email address of the customer.
• cus_number: The customer's phone number.
• success_url: The URL where the customer will be redirected after a successful payment.
• cancel_url: The URL where the customer will be redirected if they cancel the payment.
• callback_url: The URL that will receive a callback with transaction details after payment completion.
• amount: The total amount for the payment.
• currency:(Optional) The currency of you amount will be automatically converted to USD from current rate.
• redirect: (Optional) If set to "true", the user will be redirected directly to the payment page. If omitted, the API will respond with transaction details.

Example Request:

https://tzsmmpay.com/api/payment/create?api_key=YOUR-API-KEY&cus_name=Demo%20User&cus_email=demo@demo.com&cus_number=01700000000&success_url=https://domain.com/success-url&cancel_url=https://domain.com/cancel-url/dashboard&callback_url=https://domain.com/callback-url&amount=1&redirect=true

Response:

If the redirect parameter is not provided or is set to false, the API will return a JSON response with the transaction ID and payment URL:

{
   "success": true,
   "trx_id": "YOUR-TRX-ID",
   "payment_url": "https://tzsmmpay.com/api/payment/YOUR-TRX-ID"
}
     

If the redirect parameter is set to true, the user will be automatically redirected to the payment page:

Redirecting to: https://tzsmmpay.com/api/payment/YOUR-TRX-ID

Use this API to initiate a seamless payment flow for your customers, ensuring they are either redirected to the payment page or provided with a transaction ID and payment URL for manual processing.

Verify Transaction API

This API allows you to verify the status of a transaction using the transaction ID. The request can be made using any HTTP method (GET, POST, etc.). Once verified, the response will provide details about the transaction, including its current status and related information.

Endpoint:

GET / POST https://tzsmmpay.com/api/payment/verify

Required Parameters:

• api_key: Your unique API key for authentication.
• trx_id: The transaction ID to verify.

Response:

The response will return a JSON object containing the status of the transaction along with additional details:

{
   "success": true,
   "trx_id": "YOUR-TRX-ID",
   "status": "Pending",
   "domain": "domain.com",
   "amount": 1,
   "charge": 0.1,
   "total_amount": "1.1",
   "paid": 0,
   "method_trx": null,
   "method_type": null,
   "extra": null,
   "cus_name": "Demo User",
   "cus_email": "demo@demo.com",
   "cus_number": "01700000000",
   "cus_city": null,
   "cus_country": null
}
     

Response Details:

• success: Indicates whether the request was successful (true/false).
• trx_id: The transaction ID that was verified.
• status: The current status of the transaction (e.g., Pending, Completed, etc.).
• domain: The domain associated with the transaction.
• amount: The amount involved in the transaction.
• charge: The transaction charge applied.
• total_amount: The total amount including charges.
• paid: The amount that has been paid (0 if not paid).
• method_trx: The transaction method used (if applicable).
• method_type: The type of payment method (if applicable).
• extra: Any additional information related to the transaction.
• cus_name: The name of the customer.
• cus_email: The email address of the customer.
• cus_number: The phone number of the customer.
• cus_city: The city of the customer (if provided).
• cus_country: The country of the customer (if provided).

This API provides detailed information about the transaction status, allowing you to check the transaction's progress and other associated details.

PHP Code For Creating Transaction

          
  <?php
  // Replace 'your_api_key' with your actual API key
  $api_key = 'your_api_key';
  $url = 'https://tzsmmpay.com/api/payment/create';
  
  $data = [
      'api_key' => $api_key,
      'cus_name' => 'Demo User',
      'cus_email' => 'demo@demo.com',
      'cus_number' => '01700000000',
      'success_url' => 'https://domain.com/success-url',
      'cancel_url' => 'https://domain.com/cancel-url',
      'callback_url' => 'https://domain.com/callback-url',
      'amount' => 1
  ];
  
  $options = [
      'http' => [
          'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
          'method'  => 'POST',
          'content' => http_build_query($data),
      ],
  ];
  
  $context = stream_context_create($options);
  $response = file_get_contents($url, false, $context);
  
  if ($response === FALSE) {
      die('Error occurred while creating transaction.');
  }
  
  $result = json_decode($response, true);
  print_r($result);
  ?>
          
      

PHP Code For Verifying Transaction

          
  <?php
  // Replace 'your_api_key' and 'transaction_id' with actual values
  $api_key = 'your_api_key';
  $trx_id = 'CDBD678f9edf51201';
  $url = "https://tzsmmpay.com/api/payment/verify?api_key={$api_key}&trx_id={$trx_id}";
  
  $response = file_get_contents($url);
  
  if ($response === FALSE) {
      die('Error occurred while verifying transaction.');
  }
  
  $result = json_decode($response, true);
  print_r($result);
  ?>
          
      

React Code For Creating Transaction

        
 import React, { useState } from 'react';
 import axios from 'axios';

 const CreateTransaction = () => {
   const [response, setResponse] = useState(null);

   const createTransaction = async () => {
     const api_key = 'your_api_key';
     const data = {
       api_key,
       cus_name: 'Demo User',
       cus_email: 'demo@demo.com',
       cus_number: '01700000000',
       success_url: 'https://domain.com/success-url',
       cancel_url: 'https://domain.com/cancel-url',
       callback_url: 'https://domain.com/callback-url',
       amount: 1,
     };

     try {
       const res = await axios.post('https://tzsmmpay.com/api/payment/create', data);
       setResponse(res.data);
     } catch (error) {
       console.error('Error creating transaction:', error);
       setResponse({ error: 'Error creating transaction' });
     }
   };

 };

 export default CreateTransaction;
        
      

React Code For Verifying Transaction

        
  import React, { useState } from 'react';
  import axios from 'axios';

  const VerifyTransaction = () => {
    const [response, setResponse] = useState(null);
    const [trxId, setTrxId] = useState('');

    const verifyTransaction = async () => {
      const api_key = 'your_api_key';
      const url = `https://tzsmmpay.com/api/payment/verify?api_key=\${api_key}&trx_id=\${trxId}`;

      try {
        const res = await axios.get(url);
        setResponse(res.data);
      } catch (error) {
        console.error('Error verifying transaction:', error);
        setResponse({ error: 'Error verifying transaction' });
      }
    };

  };
            
  export default VerifyTransaction;
        
      

PHP Guzzle Example For Creating Transaction

       
         <?php
         // Import Guzzle HTTP Client
         use GuzzleHttp\Client;
   
         // Create a new Guzzle client
         $client = new Client();
   
         // API URL
         $url = 'https://tzsmmpay.com/api/payment/create'; 
   
         // Data to send in the request
         $data = [
             'api_key' => 'your_api_key',
             'cus_name' => 'Demo User',
             'cus_email' => 'demo@demo.com',
             'cus_number' => '01700000000',
             'success_url' => 'https://domain.com/success-url',
             'cancel_url' => 'https://domain.com/cancel-url',
             'callback_url' => 'https://domain.com/callback-url',
             'amount' => 1,
             'redirect' => true
         ];
   
         try {
             // Send POST request
             $response = $client->post($url, [
                 'form_params' => $data
             ]);
   
             // Get the response body
             $body = $response->getBody();
             $result = json_decode($body, true);
   
             // Handle the response
             print_r($result);
   
         } catch (Exception $e) {
             // Handle any errors
             echo 'Error: ' . $e->getMessage();
         }
         ?>
       
     

PHP Guzzle Example For Verifying Transaction

       
         <?php
         // Import Guzzle HTTP Client
         use GuzzleHttp\Client;
   
         // Create a new Guzzle client
         $client = new Client();
   
         // API URL for verifying transaction
         $api_key = 'your_api_key';
         $trx_id = 'transaction_id_example'; 
         $url = 'https://tzsmmpay.com/api/payment/verify?api_key=' . $api_key . '&trx_id=' . $trx_id;
   
         try {
             // Send GET request
             $response = $client->get($url);
   
             // Get the response body
             $body = $response->getBody();
             $result = json_decode($body, true);
   
             // Handle the response
             print_r($result);
   
         } catch (Exception $e) {
             // Handle any errors
             echo 'Error: ' . $e->getMessage();
         }
         ?>
       
     

JavaScript Code For Creating Transaction

      
        {
        
  
        // Function to create a transaction
        function createTransaction() {
            const api_key = 'your_api_key';
            const data = {
                api_key: api_key,
                cus_name: 'Demo User',
                cus_email: 'demo@demo.com',
                cus_number: '01700000000',
                success_url: 'https://domain.com/success-url',
                cancel_url: 'https://domain.com/cancel-url',
                callback_url: 'https://domain.com/callback-url',
                amount: 1,
                redirect: true
            };
  
            fetch('https://tzsmmpay.com/api/payment/create', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                },
                body: JSON.stringify(data)
            })
            .then(response => response.json())
            .then(result => {
                console.log('Transaction Created:', result);
                // Handle the result here
            })
            .catch(error => {
                console.error('Error:', error);
            });
        }
  
        createTransaction();
        }
      
    

JavaScript Code For Verifying Transaction

      
        {
  
        function verifyTransaction(trxId) {
            const api_key = 'your_api_key';
            const url = `https://tzsmmpay.com/api/payment/verify?api_key=\${api_key}&trx_id=\${trxId}`;
  
            fetch(url)
                .then(response => response.json())
                .then(result => {
                    console.log('Transaction Verification Result:', result);
                    // Handle the result here
                })
                .catch(error => {
                    console.error('Error:', error);
                });
        }
  
        // Call the function to verify a transaction with a given transaction ID
        const trxId = 'CDBD678f9edf51201';  // Replace with actual transaction ID
        verifyTransaction(trxId);
        }
      
    

Python Code For Creating Transaction

     
    {

    import requests

    def create_transaction():
        api_key = 'your_api_key'
        url = 'https://tzsmmpay.com/api/payment/create'  # Replace with your actual API URL

        data = {
            'api_key': api_key,
            'cus_name': 'Demo User',
            'cus_email': 'demo@demo.com',
            'cus_number': '01700000000',
            'success_url': 'https://domain.com/success-url',
            'cancel_url': 'https://domain.com/cancel-url',
            'callback_url': 'https://domain.com/callback-url',
            'amount': 1,
            'redirect': True
        }

        response = requests.post(url, json=data)

        if response.status_code == 200:
            result = response.json()
            print('Transaction Created:', result)
        else:
            print('Error creating transaction:', response.text)

    # Call the function to create a transaction
    create_transaction()
    }
     
   

Python Code For Verifying Transaction

     
       {
 
       import requests
 
       def verify_transaction(trx_id):
           api_key = 'your_api_key'
           url = f'https://tzsmmpay.com/api/payment/verify?api_key={api_key}&trx_id={trx_id}'  # Replace with your actual API URL
 
           response = requests.get(url)
 
           if response.status_code == 200:
               result = response.json()
               print('Transaction Verification Result:', result)
           else:
               print('Error verifying transaction:', response.text)
 
       # Call the function to verify a transaction with a given transaction ID
       trx_id = 'CDBD678f9edf51201'  # Replace with actual transaction ID
       verify_transaction(trx_id)
       }
     
   

WHMCS Module

Integrate our payment gateway seamlessly into your WHMCS setup. With our module, you can easily accept payments from your customers, manage invoices, and track transactions effortlessly. Get started with just a few clicks!

WordPress WooCommerce Plugin

Seamlessly integrate our payment gateway into your WooCommerce store. With our plugin, you can easily accept payments, manage transactions, and track orders effortlessly. Get started in just a few clicks!