README

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

QR Object

Supported Clients List

Revert — estructura de respuesta

Credits

• David Krüger

License

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