unusualify/payable

v0.1.1.1 2024-08-29 11:30 UTC

README

概览

这个Laravel包提供了一个灵活且可扩展的解决方案,用于将各种支付网关集成到您的Laravel应用程序中。它提供了一个统一的接口来处理不同的支付服务,使得在项目中管理多个支付提供者变得更容易。

主要特性

  • 轻松与多个支付网关集成
  • 统一接口,用于常见支付操作(支付、取消、退款)
  • 为每个支付服务提供可定制的配置
  • 内置模型用于存储支付记录
  • 可扩展的架构,用于添加新的支付服务

安装

要在Laravel项目中安装此包,请运行以下命令

composer require unusualify/payable

配置

安装后,发布配置文件

php artisan vendor:publish --provider="Unusualify\Payable\LaravelServiceProvider"

这将在您的config目录中创建一个名为payable.php的配置文件。

使用方法

基本用法

要使用支付服务

use Unusualify\Payable\Payable;

$payable = new Payable('gateway_slug');
$result = $payable->pay($params);

'gateway_slug'替换为您想要的支付网关的别名(例如,'stripe', 'paypal')。

可用方法

  • pay($params):处理支付
  • cancel($params):取消支付
  • refund($params):退款
  • formatPrice($price):根据网关要求格式化价格
  • formatAmount($amount):根据网关要求格式化金额

存储支付记录

该包包含一个用于存储支付记录的Payment模型。您可以像访问其他Eloquent模型一样访问它

use Unusualify\Payable\Models\Payment;

$payment = Payment::create([
    'payment_gateway' => 'paypal',
    'order_id' => '12345',
    'amount' => 1000,
    'currency_id' => 'USD',
    'status' => 'pending',
    'email' => 'customer@example.com',
    // ... other fields
]);

故障排除

(此部分通常会包括常见问题和解决方案。)

贡献

(贡献指南将在这里。)

许可证

MIT许可证版权(c)2024 Unusualify。特此授予任何获得此软件及其相关文档副本(“软件”)的人,免费使用软件的权利,不受限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利,并允许向软件提供副本的个人这样做,前提是以下条件:上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。软件按“原样”提供,不提供任何明示或暗示的保证,包括但不限于适销性、适用于特定用途和非侵权保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任承担责任,无论是基于合同、侵权或其他原因,由此软件或使用或操作软件引起、产生或与之有关。