Looking to hire Laravel developers? Try LaraJobs

laravel-bancard-qr maintained by krugerdavid

Description
Laravel wrapper package for the Bancard QR API
Author
David Kruger
Last update
2026/03/09 21:31 (dev-main)
License
MIT
Links
GitHub - Packagist
Downloads
18
Tags
payments - laravel - qr - paraguay - bancard - krugerdavid

dev-main

Last update
2026/03/09 21:31
License
MIT
Require
  • php ^8.1
  • illuminate/support ^10.0|^11.0
  • guzzlehttp/guzzle ^7.0
v2.0.0

Last update
2026/03/09 21:31
License
MIT
Require
  • php ^8.1
  • illuminate/support ^10.0|^11.0
  • guzzlehttp/guzzle ^7.0
dev-develop

Last update
2023/03/23 22:29
License
MIT
Require
  • php ^8.0
  • guzzlehttp/guzzle ^7.5
v1.0.1

Last update
2023/03/23 22:29
License
MIT
Require
  • php ^8.0
  • guzzlehttp/guzzle ^7.5
v1.0.0

Last update
2023/03/23 22:26
License
MIT
Require
  • php ^8.0
  • guzzlehttp/guzzle ^7.5
v0.0.3

Last update
2023/03/22 21:03
License
MIT
Require
  • php ^8.0
  • guzzlehttp/guzzle ^7.5
v0.0.2

Last update
2023/03/22 18:50
License
MIT
Require
  • php ^8.0
  • guzzlehttp/guzzle ^7.5
v0.0.1

Last update
2023/03/21 18:02
License
MIT
Require
  • php ^8.0
  • guzzlehttp/guzzle ^7.5
Comments
comments powered by Disqus

Bancard QR for Laravel

Latest Stable Version Daily Downloads Monthly Downloads Total Downloads License PHP Version Require

Laravel wrapper package for Bancard QR API. More information about Bancard QR here

What's new in v2.0

  • Manager + Facade: Inyectable BancardQRManager y Facade para mejor testabilidad
  • Dependency injection: Soporte nativo para inyección de dependencias
  • Config mejorada: mergeConfigFrom — la config funciona sin publicar; timeout configurable
  • Manejo de errores: Excepciones en lugar de retornar JSON; logging con Log::error
  • Tests: Suite completa con Pest (Unit + Feature)
  • CI: GitHub Actions para PHP 8.2–8.4 y Laravel 11–12
  • Bugs corregidos: revert() usaba keys de config incorrectos; formatException fallaba sin response

Requirements

  • PHP 8.1 or later
  • Laravel 10, 11 or later

Installation

Fire up Composer and require this package in your project.

composer require krugerdavid/laravel-bancard-qr

That's it.

Publish the config

Run the following command to publish config file,

php artisan vendor:publish --tag=bancardqr-config

Add ENV keys

Add the following keys on your .env file

BANCARDQR_PUBLIC_KEY=
BANCARDQR_PRIVATE_KEY=
BANCARDQR_STAGING=
BANCARDQR_COMMERCE_CODE=
BANCARDQR_COMMERCE_BRANCH=
BANCARDQR_TIMEOUT=30

How to use

Using the Facade (recommended)

use KrugerDavid\LaravelBancardQR\Facades\BancardQR;

$response = BancardQR::generateQr(50000, 'Payment description');
$response = BancardQR::revert($hookAlias);

Using dependency injection

use KrugerDavid\LaravelBancardQR\BancardQRManager;

class PaymentController
{
    public function __construct(
        private BancardQRManager $bancardQR
    ) {}

    public function create()
    {
        $response = $this->bancardQR->generateQr(50000, 'Payment');
    }
}

API estática legacy (retrocompatible)

use KrugerDavid\LaravelBancardQR\BancardQR;

$response = BancardQR::generate_qr(50000, 'Descripción', $promotions);
BancardQR::revert($hook_alias);

Nota: Se recomienda migrar al Facade o inyección de dependencias.

Respuestas de la API

Generate QR — estructura de respuesta

Parameter Type Description
status String Indicates if the qr could be generated or not.
qr_express QR object Element with qr express data.
supported_clients Array List of clients that support payment with QR.

QR Object

Parameter Type Description
amount Number Amount in guaraníes.
hook_alias String Alias of the payment (from the QR)
description String Description of the sale entered by the merchant (Optional, the merchant may not enter a description)
url String URL where the generated QR image is located (in PNG format). This is the image that the store must display in its system.
created_at String Date time of creation of the QR in format dd/mm/yyyy HH:mm:ss
qr_data String QR data in EMVCo format.

Supported Clients List

Parameter Type Description
name String Client name.
logo_url String Client logo url

Revert — estructura de respuesta

Parameter Type Description
status String Indicates if the qr could be reversed or not.
reverse QR object Element with info of the QR reverted
messages Array In case of status error, list of errors

Credits

License

The MIT License (MIT). Please see License File for more information