PHPackages                             paybysquare/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. paybysquare/laravel

ActiveLibrary[Payment Processing](/categories/payments)

paybysquare/laravel
===================

Laravel integration for paybysquare/php: config defaults, facade, and Blade QR component.

v0.1.0(yesterday)012↑2650%MITPHP >=8.2

Since Jul 22Compare

[ Source](https://github.com/usmansher/paybysquare-laravel)[ Packagist](https://packagist.org/packages/paybysquare/laravel)[ RSS](/packages/paybysquare-laravel/feed)WikiDiscussions Synced today

READMEChangelogDependencies (5)Versions (2)Used By (0)

paybysquare/laravel
===================

[](#paybysquarelaravel)

Laravel integration for [`paybysquare/php`](../php), the Pay By Square (Slovak payment QR standard) payload generator. Provides config-driven defaults, a facade, and a Blade component for rendering QR codes as inline SVG.

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

[](#requirements)

- PHP >= 8.2
- Laravel 11, 12, or 13

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

[](#installation)

```
composer require paybysquare/laravel
```

The service provider is auto-discovered.

SVG rendering (the `qrSvg()` method and the Blade component) additionally requires [bacon/bacon-qr-code](https://github.com/Bacon/BaconQrCode):

```
composer require bacon/bacon-qr-code
```

If you only generate payload strings (e.g. to feed a front-end QR library), you do not need it.

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

[](#configuration)

Publish the config file:

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

`config/paybysquare.php` defines defaults applied when the caller omits them:

KeyEnv variableDefault`currency``PAYBYSQUARE_CURRENCY``EUR``iban``PAYBYSQUARE_IBAN``null``swift``PAYBYSQUARE_SWIFT``''``beneficiary_name``PAYBYSQUARE_BENEFICIARY_NAME``null`With `iban` and `beneficiary_name` configured, generating a payment payload only needs an amount.

Usage
-----

[](#usage)

### Facade

[](#facade)

```
use PayBySquare\Laravel\Facades\PayBySquare;

// Payload string to feed into any QR code renderer:
$payload = PayBySquare::payload([
    'amount' => 12.34,
    'iban' => 'SK7700000000000000000000',
    'beneficiaryName' => 'Example s.r.o.',
    'variableSymbol' => '123',
]);

// Inline SVG QR code (requires bacon/bacon-qr-code):
$svg = PayBySquare::qrSvg(['amount' => 12.34], size: 200);
```

`payload()` and `qrSvg()` also accept a `PayBySquare\Payment` instance. Config defaults are only merged into array input; invalid input throws `PayBySquare\ValidationException` (its `field` property names the offending key).

### Blade component

[](#blade-component)

```

```

Outputs the QR code as inline SVG. Requires bacon/bacon-qr-code.

Testing
-------

[](#testing)

```
composer install
composer test
```

License
-------

[](#license)

MIT

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance100

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

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

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5562387?v=4)[Usman Sher](/maintainers/usmansher)[@usmansher](https://github.com/usmansher)

---

Tags

qrlaravelpaymentpay by squareslovakiabysquare

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[linkxtr/laravel-qrcode

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

3720.4k](/packages/linkxtr-laravel-qrcode)[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4851.0k](/packages/sebdesign-laravel-viva-payments)

PHPackages © 2026

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