ShurjoPay PHP Library
Using this library you can integrate ShurjoPay payment gateway into your PHP applications.
If you face any problem then create issues or make a PR with your solution.
Requirement
- PHP 7.3 or Later
- curl extension
Installation
The installation is pretty easy using Composer
composer require raziul/shurjopay-php
Usage
You can check the examples directory for full code.
Configuration
$config = [
// set this to false if you are running in live mode
'sandbox_mode' => true,
// ShurjoPay credentials [Change these with your details]
'username' => 'sp_sandbox',
'password' => 'pyyk97hu&6u6',
'prefix' => 'NOK',
];
Creating a payment
require __DIR__ . '/vendor/autoload.php';
// create ShurjoPay instance
$sp = new \Raziul\ShurjoPay\ShurjoPay($config);
// set callback url
$sp->setCallbackUrl($success_url, $cancel_url);
// make payment
$sp->makePayment($payload); // it will redirect to the payment page
You can also use method chaining like below
ShurjoPay::create($config)->setCallbackUrl($success_url, $cancel_url)->makePayment($payload);
After making a successfull payment, user will be redirected to the success_url with
order_idquery parameter in the URI.
Verify Payment
// retrieve order id from the URI
$order_id = $_GET['order_id'];
// verify payment
$payment = $sp->verify($order_id);
// check success status
if ($payment->success()) {
// show the payment method
echo $payment->paymentMethod();
}
Available methods in the Payment class.
| Method | Description |
|---|---|
| $payment->success() | Return payment success status |
| $payment->failed() | Return payment failed status |
| $payment->message() | Get the success/error message |
| $payment->orderId() | Get the order ID |
| $payment->currency() | Get currency code |
| $payment->amount() | Get the amount |
| $payment->customerOrderId() | Get customer order ID |
| $payment->paymentMethod() | Get the payment method name |
| $payment->dateTime() | Get the transaction date time |
| $payment->toArray() | Get all the data as array |
Error Handling
This package throws Raziul\ShurjoPay\ShurjoPayException on error. You can use try-catch for better error handling.
try {
// making payment
ShurjoPay::create($config)
->setCallbackUrl($success_url, $cancel_url)
->makePayment($payload);
// also for verfication
ShurjoPay::create($config)
->verify($order_id);
} catch (Raziul\ShurjoPay\ShurjoPayException $e) {
echo $e->getMessage();
}
Suggestion/Issues
If you found any issues or have any suggestion then please create an issue.
You can also submit PR regarding any issues.
License
The MIT License (MIT). Please see License File for more information.
Thank You
Thanks for using this package and If you foound this package useful then consider giving it a star.
3 Dec 7, 2021
2 Apr 17, 2022
2 Oct 5, 2022
2 Oct 9, 2022
6 Nov 18, 2022
95 Jan 3, 2023
45 Dec 26, 2022
1 Oct 26, 2022
1.7k Dec 27, 2022
3 May 31, 2022
3 Dec 11, 2021
6 Sep 24, 2022
6 Jun 7, 2023
5.7k Dec 30, 2022
1 Feb 11, 2022
3 Mar 15, 2022
1 Oct 26, 2021
3 Dec 7, 2021