PHPackages                             nokimaro/liontech-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. nokimaro/liontech-laravel

ActiveLibrary[Payment Processing](/categories/payments)

nokimaro/liontech-laravel
=========================

Laravel package for LionTech Payment Gateway SDK

v1.3.0(1mo ago)036[2 PRs](https://github.com/nokimaro/liontech-laravel/pulls)MITPHPPHP ^8.3CI passing

Since Apr 4Pushed 1w agoCompare

[ Source](https://github.com/nokimaro/liontech-laravel)[ Packagist](https://packagist.org/packages/nokimaro/liontech-laravel)[ Docs](https://github.com/nokimaro/liontech-laravel)[ RSS](/packages/nokimaro-liontech-laravel/feed)WikiDiscussions master Synced today

READMEChangelog (6)Dependencies (30)Versions (13)Used By (0)

LionTech Laravel
================

[](#liontech-laravel)

[![Latest Version](https://camo.githubusercontent.com/46bec592e3d2766ad364e7659e87a4f37aaed73e349cab48f12a03cecec41b3d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f6b696d61726f2f6c696f6e746563682d6c61726176656c3f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nokimaro/liontech-laravel)[![Tests](https://camo.githubusercontent.com/4c2c371b13335996e50eac8b543c59e5ebf532a6910f85174d972d864a6fd243/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e6f6b696d61726f2f6c696f6e746563682d6c61726176656c2f63692e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265266c6162656c3d7465737473)](https://github.com/nokimaro/liontech-laravel/actions/workflows/ci.yml)[![PHP](https://camo.githubusercontent.com/c55b9100c1ce5e9fbbfffdfe87d57ea6bfbae24b094fb12a25236b89411fd99b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e332532422d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870)](https://camo.githubusercontent.com/c55b9100c1ce5e9fbbfffdfe87d57ea6bfbae24b094fb12a25236b89411fd99b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e332532422d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870)[![Laravel](https://camo.githubusercontent.com/ff3d6774e2c51d3f8358dc17bc5d38e1e0d85b0508ffa917d826f633cf72d80d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312d2d31332d4646324432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c)](https://camo.githubusercontent.com/ff3d6774e2c51d3f8358dc17bc5d38e1e0d85b0508ffa917d826f633cf72d80d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312d2d31332d4646324432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c)[![License](https://camo.githubusercontent.com/ac049ef4e7a0b7196b09add6ac2d4f180e544c0ac779c2b2ac2fd2723a209579/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75653f7374796c653d666c61742d737175617265)](LICENSE.md)

Laravel integration for the [FusionPayments Payment Gateway](https://fusionpayments.io) (formerly LionTech). Wraps [nokimaro/liontech-php-sdk](https://github.com/nokimaro/liontech-php-sdk) with a service provider, facade, and dependency injection support.

> **Note:** This is an unofficial, community-maintained package. LionTech has no official Laravel package.

Features
--------

[](#features)

- **Auto-Discovery**: Zero manual registration — works out of the box
- **Dependency Injection**: All API clients registered as singletons in the container
- **Facade**: Static access to the full SDK via `LionTech::` facade
- **Config Helper**: Environment-based configuration with validation
- **Eager Provider**: All bindings registered upfront for reliable config resolution
- **Secure**: Webhook signature verification and RSA card encryption via the SDK

Requirements
------------

[](#requirements)

- PHP 8.3 or higher
- Laravel 11, 12, or 13

Installation
------------

[](#installation)

```
composer require nokimaro/liontech-laravel
```

The package registers itself automatically via Laravel's package auto-discovery.

Configuration
-------------

[](#configuration)

### Environment Variables

[](#environment-variables)

Add these to your `.env` file:

```
LIONTECH_ACCESS_TOKEN=your_access_token_here
LIONTECH_REFRESH_TOKEN=your_refresh_token_here

# Optional: sandbox mode
LIONTECH_SANDBOX=true
LIONTECH_BASE_URL=https://api.sandbox.fusionpayments.io
LIONTECH_SECURE_URL=https://secure.sandbox.fusionpayments.io

# Optional: pre-loaded public keys (path or PEM content)
LIONTECH_WEBHOOK_PUBLIC_KEY=/path/to/webhook-public.pem
LIONTECH_CARD_ENCRYPTION_PUBLIC_KEY=/path/to/card-public.pem
```

### Publish Configuration (optional)

[](#publish-configuration-optional)

```
php artisan vendor:publish --tag=liontech-config
```

Usage
-----

[](#usage)

### Facade

[](#facade)

```
use Nokimaro\LionTech\Laravel\Facades\LionTech;
use Nokimaro\LionTech\Requests\CreateOrderRequest;
use Nokimaro\LionTech\ValueObjects\Currency;
use Nokimaro\LionTech\ValueObjects\Money;

$order = LionTech::orders()->create(new CreateOrderRequest(
    amount: new Money('100.00', Currency::USD),
    description: 'Order #1234',
    successUrl: 'https://your-site.com/success',
    declineUrl: 'https://your-site.com/decline',
    webhookUrl: 'https://your-site.com/webhook',
));
```

### Dependency Injection

[](#dependency-injection)

Inject the SDK or individual clients directly into your controllers:

```
use Nokimaro\LionTech\Client;
use Nokimaro\LionTech\Clients\PaymentsClient;

class PaymentController extends Controller
{
    // Inject the main client
    public function store(Client $liontech)
    {
        $payment = $liontech->payments()->create($request);
    }

    // Or inject individual clients
    public function index(PaymentsClient $payments)
    {
        return $payments->get($paymentId);
    }
}
```

### Multiple Accounts (Multi-tenant)

[](#multiple-accounts-multi-tenant)

The service provider registers a single `Client` instance from your config — sufficient for most applications. If you need multiple accounts (e.g. each tenant has their own credentials), instantiate the SDK client directly:

```
use Nokimaro\LionTech\Client;

// Create a client for a specific tenant
$client = new Client(
    accessToken: $tenant->liontech_access_token,
    refreshToken: $tenant->liontech_refresh_token,
    baseUrl: config('liontech.base_url'),
    secureUrl: config('liontech.secure_url'),
);

$order = $client->orders()->create($request);
```

This bypasses the container singleton entirely and gives full control over credentials per request or per tenant.

### Webhook Verification

[](#webhook-verification)

```
use Nokimaro\LionTech\Security\WebhookSignatureVerifier;
use Illuminate\Http\Request;

class WebhookController extends Controller
{
    public function handle(Request $request, WebhookSignatureVerifier $verifier)
    {
        if (! $verifier->verify($request->headers->all(), $request->getContent())) {
            abort(403, 'Invalid webhook signature');
        }

        // process webhook...

        return response()->json(['status' => 'ok']);
    }
}
```

### Card Encryption

[](#card-encryption)

```
use Nokimaro\LionTech\Security\CardEncryptor;

class PaymentController extends Controller
{
    public function __construct(private readonly CardEncryptor $encryptor) {}

    public function encrypt()
    {
        $encrypted = $this->encryptor->encryptForPayment([
            'pan' => '4405639704015096',
            'cvv' => '123',
            'exp_month' => 12,
            'exp_year' => 2030,
            'cardHolder' => 'John Doe',
        ]);
    }
}
```

### Config Helper

[](#config-helper)

```
use Nokimaro\LionTech\Laravel\Config\LionTechConfig;

if (LionTechConfig::isConfigured()) {
    // safe to use SDK
}

if (LionTechConfig::isSandbox()) {
    // running in sandbox mode
}
```

Available Clients
-----------------

[](#available-clients)

Access via the `LionTech` facade or dependency injection:

MethodDescription`LionTech::auth()`Token refresh and authentication`LionTech::orders()`Order management`LionTech::payments()`Payment processing`LionTech::refunds()`Refund operations`LionTech::payouts()`Payout management`LionTech::tokens()`Saved payment methods`LionTech::balances()`Account balances`LionTech::transfers()`Transfer operations`LionTech::signature()`Webhook public key retrieval`LionTech::encryptionKey()`Card encryption public key retrievalThe following helpers are registered as singletons and should be used via dependency injection:

ClassDescription`WebhookSignatureVerifier`Webhook signature verification`CardEncryptor`Card data encryptionFor full API documentation, request/response objects, and examples see [nokimaro/liontech-php-sdk](https://github.com/nokimaro/liontech-php-sdk).

Testing
-------

[](#testing)

```
# Run tests
composer test

# Run with coverage
composer test-coverage

# Static analysis
composer phpstan

# Code style
composer ecs
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover a security vulnerability, please review our [Security Policy](SECURITY.md)and report it via [GitHub Security Advisories](https://github.com/nokimaro/liontech-laravel/security/advisories/new). **Do not** open a public issue.

License
-------

[](#license)

The MIT License (MIT). Please see [LICENSE.md](LICENSE.md) for more information.

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance95

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Total

6

Last Release

41d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1027608?v=4)[Nik Dm](/maintainers/nokimaro)[@nokimaro](https://github.com/nokimaro)

---

Top Contributors

[![nokimaro](https://avatars.githubusercontent.com/u/1027608?v=4)](https://github.com/nokimaro "nokimaro (32 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

laravellaravel-packageliontechpaymentpayment-gatewayphplaravelsdklaravel-packagepaymentpayment gatewayliontech

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nokimaro-liontech-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/nokimaro-liontech-laravel/health.svg)](https://phpackages.com/packages/nokimaro-liontech-laravel)
```

###  Alternatives

[linkxtr/laravel-qrcode

A clean, modern, and easy-to-use QR code generator for Laravel

3720.4k](/packages/linkxtr-laravel-qrcode)[musahmusah/laravel-multipayment-gateways

A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless

882.2k1](/packages/musahmusah-laravel-multipayment-gateways)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
