human-incubator / all-payment-helper
一个用于简化所有支付操作的支付库。
dev-master
2022-03-21 03:38 UTC
This package is not auto-updated.
Last update: 2024-09-30 15:21:28 UTC
README
一个Laravel包,可以在客户端站点中使用,以简化所有支付操作。
安装
您可以通过运行以下命令在您的Laravel应用程序中安装此包:composer require human-incubator/all-payment-helper
成功安装包后,运行 php artisan vendor:publish 以设置包的服务提供程序并将提取所有必要的配置文件。当列出多个选项时,请只选择 HumanIncubator\AllPaymentHelper\AllpaymentServiceProvider。
此包期望您的应用程序在.env文件中提供ALLPAYMENT_API_URL和ALLPAYMENT_TOKEN。如果尚未设置,请进行设置。
- ALLPAYMENT_API_URL = 为您当前环境(测试或生产环境)指定的allpayment URL。
- ALLPAYMENT_TOKEN = 为您的应用程序访问allpayment提供的客户端API密钥。
基本用法
向Allpayment创建发票
在控制器中,将库类包含为use HumanIncubator\AllPaymentHelper\AllPayment;
然后,您可以通过以下简单命令处理发票创建操作
return AllPayment::create_invoice(130, 'https://google.com');
其中130是发票的总金额,https://google.com是回调URL。
create_invoice方法接受三个参数。
- 金额 - 发票的总金额
- 回调URL - 您应用程序中可以发送allpayment处理结果的URL。
- 客户端发票ID - 客户端应用程序中记录的发票ID。(可以是空的)
支付取消
在控制器中,将库类包含为use HumanIncubator\AllPaymentHelper\AllPayment;
我们可以通过两种方式在allpayment中取消支付并退还已支付的金额。一种是使用Allpayment发票ID,另一种是使用GMO订单ID作为参考。这就是为什么在成功创建发票后立即保存这两种数据之一是必要的。
return AllPayment::cancel(1);
其中1是参考Allpayment的发票ID。
此方法接受两个参数。
- ID - 这可以是Allpayment发票ID或GMO订单ID,具体取决于第二个参数设置的值。
- 通过发票ID取消 - 此参数的默认值为true,表示通过发票ID取消。如果设置为false,则期望第一个参数是取消将通过GMO订单ID作为参考的GMO订单ID的值。