raziul/shurjopay-php

为PHP应用程序提供ShurjoPay支付网关集成。

v1.0.1 2022-06-16 14:31 UTC

This package is auto-updated.

Last update: 2024-09-16 23:36:01 UTC


README

ShurjoPay payment gateway integration for PHP applications

ShurjoPay PHP库

使用此库,您可以将 ShurjoPay 支付网关集成到您的PHP应用程序中。

如果您遇到任何问题,请创建问题或提交带有您解决方案的PR。

要求

  • PHP 7.3或更高版本
  • curl扩展

安装

使用 Composer 进行安装非常简单。

composer require raziul/shurjopay-php

使用方法

您可以在 示例 目录中查看完整代码。

配置

$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',
];

创建支付

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

您还可以使用如下所示的链式方法

ShurjoPay::create($config)->setCallbackUrl($success_url, $cancel_url)->makePayment($payload);

成功支付后,用户将被重定向到 success_url,URI中包含 order_id 查询参数。

验证支付

// 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();
}

Payment 类中可用的方法。

错误处理

此包在出错时抛出 Raziul\ShurjoPay\ShurjoPayException。您可以使用 try-catch 进行更好的错误处理。

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();
}

建议/问题

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

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

许可证

MIT许可证(MIT)。有关更多信息,请参阅 许可证文件

谢谢

感谢您使用此包。如果您觉得此包有用,请考虑给它一个星标。