README

ShurjoPay支付网关集成Laravel

这是一个用于在您的Laravel应用程序中集成ShurjoPay支付网关的Laravel包。

特性

• 易于使用。
• 友好的简单界面。
• Laravel Facade。

安装

使用Composer将依赖项添加到您的Laravel项目中

composer require raziul/shurjopay-laravel

注意：此包支持Laravel自动发现。您无需手动添加服务提供者。

配置

您可以在.env文件中添加ShurjoPay商户凭证，如下所示

# ShurjoPay merchant credentials
SHURJOPAY_SANDBOX_MODE=false
SHURJOPAY_MERCHANT_USERNAME="<your-merchant-username>"
SHURJOPAY_MERCHANT_PASSWORD="<your-merchant-password>"
SHURJOPAY_MERCHANT_PREFIX="<your-merchant-prefix>"

或者您可以将配置文件发布

php artisan vendor:publish --provider="Raziul\Shurjopay\ShurjopayServiceProvider"

它应该将配置文件复制到项目的config/shurjopay.php中。

使用指南

每当您需要使用ShurjoPay支付网关时，只需使用Shurjopay Facade。

use Raziul\Shurjopay\Facades\Shurjopay;

进行支付

在您的控制器中

// The payload will be passed to Shurjopay.
$payload = [
    // order info
    // customer info
    // custom values
];

// set the callback url
Shurjopay::setCallbackUrl($success_url, $cancel_url);

// Make a payment
Shurjopay::makePayment($payload);

// OR use methond chaining like below:
Shurjopay::setCallbackUrl($success_url, $cancel_url)->makePayment($payload);

验证支付

注意：您需要在回调URL中调用此方法。在查询字符串中将有order_id。

$payment = Shurjopay::verifyPayment($order_id);

if ($payment->success()) {
    // payment success
} else {
    // payment failed
}

Shurjopay::verifyPayment返回一个Raziul\Shurjopay\Data\Payment实例。

在Payment类中可用的方法。

错误处理

为了更好的错误处理，您可以捕获Raziul\Shurjopay\Exceptions\ShurjopayException。

try {
	// making payment
	Shurjopay::setCallbackUrl($success_url, $cancel_url)
		->makePayment($payload);

	// or verfication
	Shurjopay::verifyPayment($order_id);

} catch (Raziul\Shurjopay\Exceptions\ShurjopayException $e) {
	return $e->getMessage();
}

建议/问题

如果您发现任何问题或有任何建议，请创建一个问题。

您还可以提交有关任何问题的PR。

许可证

MIT许可证（MIT）。有关更多信息，请参阅许可证文件。

感谢

感谢您使用此包，如果您认为此包很有用，请考虑给它一个星标。