Integrate Instamojo payment gateway in PHP step by step


In this tutorial, I will explain how to integrate the Instamojo payment gateway in PHP step by step. Instamojo is an online selling platform in India and provides APIs for different languages with detailed documentation that are very easy to integrate. The developers can integrate the payment gateways to their application or website with the help of the APIs provided by Instamojo in various programming languages.

Also read, How to send mail in laravel 8 using SMTP Gmail

After successful integration, all the payments will be done. In this tutorial.

Integrate Instamojo payment gateway in PHP step by step

Prerequisite:-

  • PHP latest version and WAMP server should be installed.

Required steps to integrate Instamojo payment gateway in PHP

Step 1:- Sign up for the Instamojo test account.

Step 2:- After the successful signup, go to the left pane of the dashboard and click on API & Plugins as shown below.

Integrate Instamojo payment gateway in PHP step by step

Step 3:- Click on PHP from the supported libraries as shown below.

Integrate Instamojo payment gateway in PHP step by step

Step 4:- Now, download the zip folder from the Github landing page. (https://github.com/Instamojo/instamojo-php) .

Step 5:- Now, create a folder name ‘instamojo’ inside the root folder i.e. www of the local server.

Step 6:- Now, extract the zip folder you have downloaded from Git hub and place it inside the instamojo folder.

Step 7:- Create a database in PHPMyAdmin and table under the database.

DDL information of the table:-

CREATE TABLE instamojo_purchase (
id int(10) unsigned NOT NULL AUTO_INCREMENT,
payment_id varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
amount varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
payment_mode varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
transaction_status varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
buyer_name varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
created_at timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
updated_at timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
PRIMARY KEY (id)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci

Step 9:- Add the below code to index.php

index.php

<html>
<head>
<title>Payment Gateway</title>
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.4.1/css/bootstrap.min.css">
<style>
.container{
    width:50%;
    height:30%;
    padding:20px;
}
</style>

</head>
<body>
   <div class="container">
    <h3 align="center"><u>Instamojo Integration in PHP</u></h3>
    <br/><br/>
    <form class="form-horizontal" action="pay.php" method="post">
              <div class="form-group">
                <label class="control-label col-sm-2" for="email">Email:</label>
                    <div class="col-sm-10">
                      <input type="email" class="form-control" name="email">
                    </div>
               </div>
              <div class="form-group">
                <label class="control-label col-sm-2" for="phone">Phone No*:</label>
                    <div class="col-sm-10">
                      <input type="text" class="form-control" name="phone_no">
                    </div>
               </div>
              <div class="form-group">
                <label class="control-label col-sm-2" for="email">Purpose*:</label>
                    <div class="col-sm-10">
                      <input type="text" class="form-control" name="purpose">
                    </div>
              </div>
              <div class="form-group">
                <label class="control-label col-sm-2" for="pwd">Amount:</label>
                    <div class="col-sm-10">
                      <input type="text" name="amount" class="form-control">
                    </div>
              </div>
              <div class="form-group">
                <div class="col-sm-offset-2 col-sm-10">
                  <button type="submit" class="btn btn-primary btn-sm" name="submit">Pay</button>
                </div>
              </div>
    </form>

</div>
<!-- jQuery library -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>

<!-- Latest compiled JavaScript -->
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.4.1/js/bootstrap.min.js"></script>
</body>
</html>

Step 10:- Add the below code to dbconnect.php to connect to the database.

dbconnect.php

<?php
$servername='localhost';
$username="root";
$password="";
try
{
	$con=new PDO("mysql:host=$servername;dbname=test_db",$username,$password);
	$con->setAttribute(PDO::ATTR_ERRMODE,PDO::ERRMODE_EXCEPTION);
	//echo 'connected';
}
catch(PDOException $e)
{
	echo '<br>'.$e->getMessage();
}
?>


Step 11:- Add the below code to pay.php

pay.php

<?php
require 'instamojo-php-0.4/src/Instamojo.php';
//get the inputs
if(isset($_POST['submit']))
{
	   $email = $_POST['email'];
	   $phone = $_POST['phone_no'];
	   $purpose = $_POST['purpose'];
	   $amount = $_POST['amount'];
			//create the API object
		$api = new Instamojo\Instamojo('test_06edceeb256a4bda7541e6d0d66', 'test_8fed45349a6a816f577afaf205b', 'https://test.instamojo.com/api/1.1/');

		//create the payment request
		try {
		    $response = $api->paymentRequestCreate(array(
		        "purpose" => $purpose,
		        "amount" => $amount,
		        'phone'=> $phone,
		        "send_email" => true,
		        "email" => $email,
		        "redirect_url" => "http://localhost/myprojects/instamojo/success.php",
		        ));
		    /*echo '<pre>';
		    print_r($response);*/
		    $url = $response['longurl'];
		    header("location:$url");
		}
		catch (Exception $e) {
		    print('Error: ' . $e->getMessage());
		}
}

?>

Illustration of pay.php:-

  • we will include the extracted zip folder in which Instamojo.php exists.
  • we will fetch the inputs using the $_POST variable.
  • we will create the API object as shown below
<?php
$api = new Instamojo\Instamojo('test_06edceeb256a4bda7541e6d0d66', 'test_8fed45349a6a816f577afaf205b', 'https://test.instamojo.com/api/1.1/');
?>
  • we will create the payment request using the API with the help of an array as shown below
<?php
//create the payment request
		try {
		    $response = $api->paymentRequestCreate(array(
		        "purpose" => $purpose,
		        "amount" => $amount,
		        'phone'=> $phone,
		        "send_email" => true,
		        "email" => $email,
		        "redirect_url" => "http://localhost/myprojects/instamojo/success.php",
		        ));
		    echo '<pre>';
		    print_r($response);
		}
		catch (Exception $e) {
		    print('Error: ' . $e->getMessage());
		}
?>

The above code will give you a JSON object containing the details of the payment request in the form of an array as shown below.

Integrate Instamojo payment gateway in PHP step by step

From the above array, we will use the ‘longurl’ which redirects us to the Instamojo payment page along with the payment details like purpose, email, phone, amount where we have to enter the buyer name and proceed to buy as shown below.

Integrate Instamojo payment gateway in PHP step by step

Step 12:- Add the below code to success.php

success.php:-

<?php
require 'instamojo-php-0.4/src/Instamojo.php';
require 'dbconnect.php';
//create the API object
$api = new Instamojo\Instamojo('test_06edceeb256a4bda7541e6d0d66', 'test_8fed45349a6a816f577afaf205b', 'https://test.instamojo.com/api/1.1/');
//Get the status of the payment related to your payment request
try {
    $response = $api->paymentRequestPaymentStatus($_GET['payment_request_id'], $_GET['payment_id']);
    $buyer_name = $response['payment']['buyer_name'];
    $amount = $response['payment']['amount'];
    $payment_id = $response['payment']['payment_id'];
    $transaction_status = $response['payment']['status'];
    $payment_mode = $response['payment']['instrument_type'];

    if($response['payment']['status']=='Credit')
    {
        //insert the data in the database
        $sql="INSERT INTO instamojo_purchase(buyer_name,payment_id,amount,transaction_status,payment_mode)
            VALUES('$buyer_name','$payment_id','$amount','$transaction_status','$payment_mode')";
			$stmt=$con->prepare($sql);
			$stmt->execute();

	  if($stmt->rowCount()>0){

	  	 echo '<strong>Success!</strong>Your Order has placed successfully';
	  	 echo '<br>';
	  	 echo 'Payment ID:' .$payment_id.'<br>';
	  	 echo 'Buyer Name:' .$buyer_name.'<br>';
	  	 echo 'Amount:' .$amount.'<br>';
	  	 echo 'Transaction Status:' .$transaction_status;
	  }
    }
    else{

    	echo 'Failed';
    }
}
catch (Exception $e) {
    print('Error: ' . $e->getMessage());
}

?>

Illustration of the success.php

  • Here, we will include the extracted zip folder in which Instamojo.php exists.
  • we will the database connection file i.e. dbconnect.php because we have to enter the payment related data in the database table after successful transaction.
  • Again we will create the API object using the AUTH_KEY and AUTH_TOKEN.
  • Get the payment_request_id and payment_id by printing the $_GET variable on top of the success,php file as shown below. (This is just for checking)
<?php
echo <'pre>';
print_r($_GET);
?>
  • Now, we will get the status of the payment related to the payment request with the help of payment_request_id and payment_id using the $_GET global variable as shown below
try {
    $response = $api->paymentRequestPaymentStatus($_GET['payment_request_id'], $_GET['payment_id']);
    print_r($response);
}
catch (Exception $e) {
    print('Error: ' . $e->getMessage());
}

If you run the above code, you will get the buyer_name, amount, payment_id, payment_mode as instrument_type, transaction_status as status.

If the status is equal to credit then we will insert the above data in the database table we have created before and print the success message with the payment details to the success page as shown below.

<?php
try {
    $response = $api->paymentRequestPaymentStatus($_GET['payment_request_id'], $_GET['payment_id']);
    $buyer_name = $response['payment']['buyer_name'];
    $amount = $response['payment']['amount'];
    $payment_id = $response['payment']['payment_id'];
    $transaction_status = $response['payment']['status'];
    $payment_mode = $response['payment']['instrument_type'];

    if($response['payment']['status']=='Credit')
    {
        //echo 'Done';
        //insert the data in the database
        $sql="INSERT INTO instamojo_purchase(buyer_name,payment_id,amount,transaction_status,payment_mode)
            VALUES('$buyer_name','$payment_id','$amount','$transaction_status','$payment_mode')";
			$stmt=$con->prepare($sql);
			$stmt->execute();

	  if($stmt->rowCount()>0){

	  	 echo '<strong>Success!</strong>Your Order has placed successfully';
	  	 echo '<br>';
	  	 echo 'Payment ID:' .$payment_id.'<br>';
	  	 echo 'Buyer Name:' .$buyer_name.'<br>';
	  	 echo 'Amount:' .$amount.'<br>';
	  	 echo 'Transaction Status:' .$transaction_status;
	  }
    }
    else{

    	echo 'Failed';
    }
}
catch (Exception $e) {
    print('Error: ' . $e->getMessage());
}
?>

If the status is not equal to credit then we will echo ‘Failed’;

Conclusion:- I hope this tutorial will help you to understand the overview of Instamojo integration. If there is any doubt then please leave a comment below.


Leave a Reply

Your email address will not be published. Required fields are marked *

Theme of 96 THEME.