About shurjomukhi/shurjopay-plugin-php

shurjomukhi/shurjopay-plugin-php is a Laravel package for shurjopay is a online payment gateway and easy payment solution. It currently has 14 GitHub stars and 1.124 downloads on Packagist (latest version 0.1.1). Install it with composer require shurjomukhi/shurjopay-plugin-php. Discover more Laravel packages by shurjomukhi or browse all Laravel packages to compare alternatives.

Last updated August 9, 2026

PHP plugin package

NPM

Official shurjoPay PHP plugin for merchants or service providers to connect with shurjoPay Payment Gateway v2.1 developed and maintained by ShurjoMukhi Limited.

This plugin package can be used with any PHP application or framework (e.g. Laravel, Lumen, CodeIgniter, Symfony, CakePHP, Yii etc). Use this plugin in your CMS (Wordpress, Magento, Joomla, OpenCart, Drupal etc) projects or checkour our dedicated plugins for the renowned CMS. It makes it easy for developers to integrate with shurjoPay v2.1 with just three API calls:

authenticate: Authenticate merchants and generate token
makePayment: Create and send payment request
verifyPayment: Verify payment status at shurjoPay

Also reduces many of the things that you had to do manually

Handles http request and errors
Log generation at your prefarable path
Authentication during checkout and verification of payments

Audience

This document is intended for the developers and technical personnel of merchants and service providers who want to integrate the shurjoPay online payment gateway using PHP.

How to use this shurjoPay Plugin

To integrate the shurjoPay Payment Gateway in your PHP project do the following tasks sequentially.

Add the shurjopay-plugin-php as your project dependency.

$ composer require shurjomukhi/shurjopay-plugin-php

Setup parameters for shurjopay plugin correctly in your application in a config file as shown below.

# shurjopay merchant username
SP_USERNAME='sp_sandbox'
# shurjopay merchant password
SP_PASSWORD='pyyk97hu&6u6'
# Merchant prefix used to generate order id
SP_PREFIX='NOK'
# shurjopay payment gateway API endpoint
SHURJOPAY_API='https://sandbox.shurjopayment.com'
# URL to redirect after completion of a payment. Sample: https://sandbox.shurjopayment.com/response
SP_CALLBACK='http://localhost/your-php-app/return.php'
# Log location of shurjopay php plugin
SP_LOG_LOCATION='/var/log/shurjopay'
# CURLOPT_SSL_VERIFYPEER=0 only for local and non-SSL environment 
CURLOPT_SSL_VERIFYPEER=1

Note: Remember to use live credentials in config file before going in production.

Now, create instance of `Shurjopay` with `ShurjopayConfig`. To read the parameters from config or env file, you may use the `ShurjopayEnvReader`.

Check out test class to view an example.

$env = new ShurjopayEnvReader(__DIR__ . '/_env');
$sp_instance = new Shurjopay($env->getConfig());

After that, initiate a payment request to shurjoPay using our plugin in your application. Below is a basic example code snippet.

$request = new PaymentRequest();
# All the data will come from user end.
$request->currency = 'BDT';
$request->amount = 100;
$request->discountAmount = 0;
$request->discPercent = 0;
$request->customerName = 'Abdul Mannan';
$request->customerPhone = '01712345678';
$request->customerEmail = '[email protected]';
$request->customerAddress = 'Dhaka';
$request->customerCity = 'Dhaka';
$request->customerState = 'Dhaka';
$request->customerPostcode = '1209';
$request->customerCountry = 'Bangladesh';
$request->shippingAddress = 'Sirajganj';
$request->shippingCity = 'Dhaka';
$request->shippingCountry = 'Bangladesh';
$request->receivedPersonName = 'Jalil Mia';
$request->shippingPhoneNumber = '01712345678';
# Custom data can be sent using these value[1-4] fields which will be returned back to you in response. Any type of data can be passed on; e.g. string, integer, array etc.
$request->value1 = array("val1", "val2", "val3");
$request->value2 = 'value2';
$request->value3 = 'value3';
$request->value4 = 'value4';

$sp_instance->makePayment($request);

Payment verification can be done after each transaction with shurjopay order id.

$sp_instance->verifyPayment($order_id);

Check our documentation on verify for more details.

References

PHP sample project showing usage of the PHP plugin.
Laravel sample project using PHP plugin to get your feet wet with shurjopay.
OpenCart plugin
OpenCart sample project
Sample applications and projects in many different languages and frameworks showing shurjopay integration.
shurjoPay Postman site illustrating the request and response flow using the sandbox system.
shurjopay Plugins home page on github

License

This code is under the MIT open source License.

Please contact with shurjoPay team for more detail.

Comments