PHPackages krugerdavid/laravel-bancard-qr - 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. krugerdavid/laravel-bancard-qr ActiveLibrary[Payment Processing](/categories/payments) krugerdavid/laravel-bancard-qr ============================== Laravel wrapper package for the Bancard QR API v2.0.0(2mo ago)9181MITPHPPHP ^8.1CI passing Since Mar 21Pushed 2mo ago2 watchersCompare [ Source](https://github.com/krugerdavid/laravel-bancard-qr)[ Packagist](https://packagist.org/packages/krugerdavid/laravel-bancard-qr)[ RSS](/packages/krugerdavid-laravel-bancard-qr/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (6)Versions (8)Used By (0) Bancard QR for Laravel ====================== [](#bancard-qr-for-laravel) [![Latest Stable Version](https://camo.githubusercontent.com/e9de3f0fdd70f29a02bf0885df6ec8777d7bfe688ce34eecf031bb69a61d47f9/687474703a2f2f706f7365722e707567782e6f72672f6b727567657264617669642f6c61726176656c2d62616e636172642d71722f76)](https://packagist.org/packages/krugerdavid/laravel-bancard-qr)[![Daily Downloads](https://camo.githubusercontent.com/f6c79b700f47d6e955e61d570bfa13ff38b55bcd8e0e526280fce79ada76a554/687474703a2f2f706f7365722e707567782e6f72672f6b727567657264617669642f6c61726176656c2d62616e636172642d71722f642f6461696c79)](https://packagist.org/packages/krugerdavid/laravel-bancard-qr)[![Monthly Downloads](https://camo.githubusercontent.com/1d6e12b1bae4247c8cdd8556013b7267bd3be7016d34f888e2db12e1b02a6fb2/687474703a2f2f706f7365722e707567782e6f72672f6b727567657264617669642f6c61726176656c2d62616e636172642d71722f642f6d6f6e74686c79)](https://packagist.org/packages/krugerdavid/laravel-bancard-qr)[![Total Downloads](https://camo.githubusercontent.com/7f5dcbd8098834b028d8f9265935557cd1a9db98c169e7611d9e52fc10dfac80/687474703a2f2f706f7365722e707567782e6f72672f6b727567657264617669642f6c61726176656c2d62616e636172642d71722f646f776e6c6f616473)](https://packagist.org/packages/krugerdavid/laravel-bancard-qr)[![License](https://camo.githubusercontent.com/80a9101eb22642e879124f90b5f6828cb0904e4ad321109b3c380637c535f879/687474703a2f2f706f7365722e707567782e6f72672f6b727567657264617669642f6c61726176656c2d62616e636172642d71722f6c6963656e7365)](https://packagist.org/packages/krugerdavid/laravel-bancard-qr)[![PHP Version Require](https://camo.githubusercontent.com/af5368f2e008da57a7e3d7514b121429d25a91abb02f5b4a7acbfea411636026/687474703a2f2f706f7365722e707567782e6f72672f6b727567657264617669642f6c61726176656c2d62616e636172642d71722f726571756972652f706870)](https://packagist.org/packages/krugerdavid/laravel-bancard-qr) Laravel wrapper package for Bancard QR API. More information about Bancard QR [here](https://www.bancard.com.py/pagos-qr) What's new in v2.0 ------------------ [](#whats-new-in-v20) - **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 ------------ [](#requirements) - PHP 8.1 or later - Laravel 10, 11 or later Installation ------------ [](#installation) Fire up Composer and require this package in your project. ``` composer require krugerdavid/laravel-bancard-qr ``` That's it. Publish the config ------------------ [](#publish-the-config) Run the following command to publish config file, ``` php artisan vendor:publish --tag=bancardqr-config ``` Add ENV keys ------------ [](#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 ---------- [](#how-to-use) ### Using the Facade (recommended) [](#using-the-facade-recommended) ``` use KrugerDavid\LaravelBancardQR\Facades\BancardQR; $response = BancardQR::generateQr(50000, 'Payment description'); $response = BancardQR::revert($hookAlias); ``` ### Using dependency injection [](#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) [](#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 -------------------- [](#respuestas-de-la-api) ### Generate QR — estructura de respuesta [](#generate-qr--estructura-de-respuesta) ParameterTypeDescription`status`StringIndicates if the qr could be generated or not.`qr_express`QR objectElement with qr express data.`supported_clients`ArrayList of clients that support payment with QR.*QR Object* ParameterTypeDescription`amount`NumberAmount in guaraníes.`hook_alias`StringAlias of the payment (from the QR)`description`StringDescription of the sale entered by the merchant (Optional, the merchant may not enter a description)`url`StringURL where the generated QR image is located (in PNG format). This is the image that the store must display in its system.`created_at`StringDate time of creation of the QR in format dd/mm/yyyy HH:mm:ss`qr_data`StringQR data in EMVCo format.*Supported Clients List* ParameterTypeDescription`name`StringClient name.`logo_url`StringClient logo url### Revert — estructura de respuesta [](#revert--estructura-de-respuesta) ParameterTypeDescription`status`StringIndicates if the qr could be reversed or not.`reverse`QR objectElement with info of the QR reverted`messages`ArrayIn case of `status` error, list of errorsCredits ------- [](#credits) - [David Krüger](https://github.com/krugerdavid) License ------- [](#license) The MIT License (MIT). Please see [License](LICENSE.md) File for more information ### Health Score 44 — FairBetter than 92% of packages Maintenance87 Actively maintained with recent releases Popularity13 Limited adoption so far Community9 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~217 days Recently: every ~271 days Total 6 Last Release 65d ago Major Versions v0.0.3 → v1.0.02023-03-23 v1.0.1 → v2.0.02026-03-09 PHP version history (2 changes)v0.0.1PHP ^8.0 v2.0.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/3e44a40fb1e7a42ce4e7003b78613218769a1078e14cadbf079bb922f69d97d7?d=identicon)[davidkruger](/maintainers/davidkruger) --- Top Contributors [![krugerdavid](https://avatars.githubusercontent.com/u/467435?v=4)](https://github.com/krugerdavid "krugerdavid (16 commits)") --- Tags bancardlaravelpayment-integrationqrqrlaravelpaymentsParaguaykrugerdavidbancard ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/krugerdavid-laravel-bancard-qr/health.svg) ``` [![Health](https://phpackages.com/badges/krugerdavid-laravel-bancard-qr/health.svg)](https://phpackages.com/packages/krugerdavid-laravel-bancard-qr) ``` ### Alternatives [musahmusah/laravel-multipayment-gateways A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless 852.2k1](/packages/musahmusah-laravel-multipayment-gateways)[itsmurumba/laravel-mpesa Laravel Package for Mpesa Daraja API 191.6k](/packages/itsmurumba-laravel-mpesa) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)