larva/laravel-transaction

This package is abandoned and no longer maintained. No replacement package was suggested.

This is a transaction.

3.1.1 2022-04-10 05:38 UTC

Requires

• php: ^8.0.2
• ext-json: *
• illuminate/bus: ^9.0
• illuminate/database: ^9.0
• illuminate/events: ^9.0
• illuminate/http: ^9.0
• illuminate/queue: ^9.0
• illuminate/support: ^9.0
• yansongda/pay: ^3.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.6
• laravel/framework: ^9.0

MIT

• laravel
• transaction
• Larva

README

这是一个内部收单系统，依赖 yansongda/pay 这个组件，本收单系统，统一了调用。 备注，交易单位是分；2.x 和 3.x 版本对外接口一致，只是内部调用的第三方接口版本不同，本扩展拉齐了开发体验；

环境需求

• PHP ^7.4|^8.0

安装

# yansongda/pay 2.x
composer require "larva/laravel-transaction:^2.0"

# yansongda/pay 3.x
composer require "larva/laravel-transaction:^3.0"

事件

\Larva\Transaction\Events\ChargeClosed 交易已关闭
\Larva\Transaction\Events\ChargeFailed 交易失败
\Larva\Transaction\Events\ChargeSucceeded 交易已支付
\Larva\Transaction\Events\RefundFailed 退款失败事件
\Larva\Transaction\Events\RefundSucceeded 退款成功事件
\Larva\Transaction\Events\TransferFailed 付款失败事件
\Larva\Transaction\Events\TransferSucceeded 付款成功事件

AppServiceProvider 的 boot 中注册 路由

\Larva\Transaction\Transaction::routes();

在中间件 App\Http\Middleware\VerifyCsrfToken 排除支付回调相关的路由，如：

protected $except = [
    // ...
    'transaction',
];

你自己的订单关联

/**
 * @property Charge $change
 */
class Order extends Model {

    /**
     * Get the entity's charge.
     * 这里关联付款模型
     * @return \Illuminate\Database\Eloquent\Relations\MorphOne
     */
    public function charge()
    {
        return $this->morphOne(Charge::class, 'order');
    }

    /**
     * 设置交易成功
     */
    public function markSucceeded()
    {
        $this->update(['channel' => $this->charge->trade_channel, 'status' => static::STATUS_PAY_SUCCEEDED, 'succeeded_at' => $this->freshTimestamp()]);
    }

    /**
     * 设置交易失败
     */
    public function markFailed()
    {
        $this->update(['status' => static::STATUS_FAILED]);
    }

    /**
     * 发起退款
     * @param string $reason 退款描述
     * @return Model|Refund
     * @throws Exception
     */
    public function refund(string $reason)
    {
        if ($this->paid && $this->charge->allowRefund) {
            $refund = $this->charge->refund($reason);
            $this->update(['refunded' => true]);
            return $refund;
        }
        throw new Exception ('Not paid, no refund.');
    }
}