getsolaris/laravel-tosspayments

一个用于Toss Payments的Laravel包

v1.3.2 2024-09-02 01:22 UTC

This package is auto-updated.

Last update: 2024-09-04 02:09:49 UTC


README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status

这是Toss Payments的Laravel API。

API版本: 2022-11-16

API版本策略

安装

composer require getsolaris/laravel-tosspayments

需要在.env文件中添加以下环境变量。将Toss Payments开发者中心提供的客户端密钥和密钥添加到环境变量中。

TOSS_PAYMENTS_CLIENT_KEY=
TOSS_PAYMENTS_SECRET_KEY=

执行以下命令以创建.config文件。

php artisan vendor:publish --provider="Getsolaris\LaravelTossPayments\TossPaymentsServiceProvider" --tag="config"

使用

参考Toss Payments开发者中心的核心API

在开始使用API之前,准备API密钥并进行认证的文档可以在相应页面上找到。

基本认证方式使用Base64编码的{SECRET_KEY}:的值。

支付 (Payment)

示例查看

交易 (Transaction)

示例查看

自动支付 (Billing)

示例查看

结算 (Settlement)

示例查看

现金收据 (CashReceipt)

示例查看

卡公司优惠查询 (Promotion)

示例查看

设置Webhook

在开始使用Webhook之前,请先在Toss Payments开发者中心的Webhook页面注册Webhook。

在配置文件config/tosspayments.php中检查webhook设置。

'webhook' => [
    'handler' => [
        'controller' => \App\Http\Controllers\WebhookController::class,
        'method' => '__invoke',
    ],
],

通过更改handler设置,可以指定处理Webhook的控制器和方法。

还可以运行以下命令来更改默认路由设置url/webhooks/tosspayments

php artisan vendor:publish --provider="Getsolaris\LaravelTossPayments\TossPaymentsServiceProvider" --tag="webhook"

使用测试代码

通过查看错误代码来确认特定错误是否发生,并处理预期的场景。

use Getsolaris\LaravelTossPayments\TossPayments;
use Getsolaris\LaravelTossPayments\Attributes\Transaction;

$transactions = TossPayments::for(Transaction::class)
    ->startDate('2022-01-01T00:00:00')
    ->endDate('2022-12-31T00:00:00')
    ->testCode('INVALID_CARD_EXPIRATION')
    ->get();

资源

变更日志

请参阅变更日志以获取有关最近更改的更多信息。

许可

MIT许可(MIT)。请参阅许可文件以获取更多信息。