laraditz/2c2p

2C2P 支付网关的简单 Laravel 扩展包

1.0.1 2022-07-14 16:19 UTC

This package is auto-updated.

Last update: 2024-09-17 05:43:16 UTC


README

Latest Version on Packagist Total Downloads License

2C2P 支付网关的简单 Laravel 扩展包。

安装

您可以通过 composer 安装此包

composer require laraditz/2c2p

开始之前

在您的 .env 文件中配置您的变量(推荐),或者您可以发布配置文件并在此处进行更改。

2C2P_MERCHANT_ID=<your_merchant_id_here>
2C2P_MERCHANT_SECRET=<your_merchant_secret_key_here>
2C2P_CURRENCY_CODE=<your_default_currency_code>
2C2P_SANDBOX_MODE=true # true or false for sandbox mode

(可选)您可以通过以下命令发布配置文件

php artisan vendor:publish --provider="Laraditz\Twoc2p\Twoc2pServiceProvider" --tag="config"

运行迁移命令以创建必要的数据库表。

php artisan migrate

可用方法

以下是在此包下可用的所有方法。

用法

您可以使用服务容器或外观。

// Using service container
app('Twoc2p')->createPayment($data);

// Using facade
\Twoc2p::createPayment($data);

创建支付

创建支付并获取要重定向到的支付 URL。

示例如下

app('Twoc2p')->createPayment([
    'invoiceNo' => '1523953661',   
    'description' => 'item 1',
    'amount' => 100.00,
    'frontendReturnUrl' => 'http://domain.test/your-return-url',
]);

返回示例

array:2 [
  "id" => "94a19a34-965a-4e11-acd2-7acb02696f18"
  "payment_url" => "https://sandbox-pgw-ui.2c2p.com/payment/4.1/#/token/kSAops9Zwhos8hSTSeLTUxxx"
]

重定向到 payment_url 以继续到 2C2P 支付页面。完成后,您将被重定向到 frontendReturnUrl。以下是一个示例响应。

{
	"invoiceNo": "280520075921",
	"channelCode": "CC",
	"respCode": "2000",
	"respDesc": "Transaction is completed, please do payment inquiry request for full payment information."
}

支付查询

查询支付详情。

示例如下

app('Twoc2p')->paymentInquiry('94a11139-df90-438a-8705-8d88aaa9719e');

事件

此包还提供一些事件,允许您的应用程序监听它。您可以创建您的监听器并将其注册在以下事件下。

变更日志

有关最近更改的更多信息,请参阅 CHANGELOG

贡献

有关详细信息,请参阅 CONTRIBUTING

安全性

如果您发现任何与安全性相关的问题,请通过电子邮件发送到 raditzfarhan@gmail.com,而不是使用问题跟踪器。

鸣谢

许可证

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

参考