PHPackages                             cuongnm/viet\_qr\_pay - 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. cuongnm/viet\_qr\_pay

ActiveLibrary[Payment Processing](/categories/payments)

cuongnm/viet\_qr\_pay
=====================

VietQR Pay Package

V1.0.2(1y ago)177MITPHPPHP >=8.2

Since Mar 11Pushed 1y ago1 watchersCompare

[ Source](https://github.com/cuongjpitdnu/vietqr-pay)[ Packagist](https://packagist.org/packages/cuongnm/viet_qr_pay)[ Docs](https://github.com/endroid/qr-code)[ RSS](/packages/cuongnm-viet-qr-pay/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

Introduction
------------

[](#introduction)

Library supporting QR code encoding/decoding of VietQR & VNPayQR

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

[](#installation)

Use [Composer](https://getcomposer.org/) to install the library. Also make sure you have enabled and configured the [GD extension](https://www.php.net/manual/en/book.image.php) if you want to generate images.

```
composer require cuongnm/viet_qr_pay
```

Import lib
----------

[](#import-lib)

```
{
  "require": {
    "cuongnm/viet_qr_pay": "^1.0"
  }
}
```

Tạo mã VietQR
-------------

[](#tạo-mã-vietqr)

```
use cuongnm\viet_qr_pay\QRPay;

      $bankBin = '970418';
      $bankNumber = '257678859'; // Số tài khoản
      $amount = '10000'; // Số tiền
      $purpose = 'Chuyen tien'; // Nội dung chuyển tiền
      $qrPay = QRPay::initVietQR(
        $bankBin,
        $bankNumber,
        $amount,
        $purpose
      );
      $content = $qrPay->build();

      echo $content;
      // 00020101021138530010A0000007270123000697041601092576788590208QRIBFTTA53037045802VN6304AE9F
```

Tạo mã VNPay
------------

[](#tạo-mã-vnpay)

```
use cuongnm\viet_qr_pay\QRPay;

      $merchantId = '0102154778';
      $merchantName = 'TUGIACOMPANY';
      $store = 'TU GIA COMPUTER';
      $terminal = 'TUGIACO1';
      $qrPay = QRPay::initVNPayQR(
        $merchantId,
        $merchantName,
        $terminal,
        $terminal
      );
      $content = $qrPay->build();

      echo $content;
      // 00020101021126280010A0000007750110010531314453037045408210900005802VN5910CELLPHONES62600312CPSHN ONLINE0517021908061613127850705ONLHN0810CellphoneS63047685
```

Decode mã QR
------------

[](#decode-mã-qr)

```
use cuongnm\viet_qr_pay\QRPay;

    $qrContent = '00020101021238530010A0000007270123000697041601092576788590208QRIBFTTA5303704540410005802VN62150811Chuyen tien6304BBB8'
    $qrPay = new QRPay($qrContent);
    $response = array(
        'error_code' => '00',
        'message' => 'Success',
        'data' => [
            'bankBin' => $qrPay->consumer->getBankBin(),
            'bankNumber' => $qrPay->consumer->getBankNumber(),
            'amount' => $qrPay->amount,
            'remark' => $qrPay->additionalData->getPurpose(),
        ]
    );
    echo json_encode($response);
```

Tạo mã VietQR Image (base64)
----------------------------

[](#tạo-mã-vietqr-image-base64)

```
use cuongnm\viet_qr_pay\QRPay;

      $bankBin = '970418';
        $bankNumber = '9631242004503530058'; // Số tài khoản
        $amount = '10000'; // Số tiền
        $purpose = 'Chuyen tien HSV'; // Nội dung chuyển tiền
        $qrPay = QRPay::initVietQR(
            $bankBin,
            $bankNumber,
            $amount,
            $purpose
        );
        $content = $qrPay->generate_image();

        // Debug output
        echo "\nGenerated VietQR Image: " . $content . "\n";

        return $content;
```

`QRPay` class
-------------

[](#qrpay-class)

NameTypeDescription`isValid``boolean`Kiểm tra tính hợp lệ của mã QR`initMethod``string`Phương thức khởi tạo (`11` - QR Tĩnh, `12` - QR động)`provider``Provider`Thông tin nhà cung cấp`merchant``Merchant`Thông tin merchant`consumer``Consumer`Thông tin người thanh toán`amount``string`Số tiền giao dịch`currency``string`Mã tiền tệ (VNĐ: 704)`nation``string`Mã quốc gia`additionalData``AdditionalData`Thông tin bổ sung`crc``string`Mã kiểm tra`build()``method`Tạo lại mã QR mới### `Provider` class

[](#provider-class)

Thông tin đơn vị cung cấp mã QR (VietQR, VNPay)

NameTypeDescription`guid``string`Mã định danh toàn cầu`name``string`Tên nhà cung cấp### `Merchant` class

[](#merchant-class)

Thông tin merchant (Đơn vị chấp nhận thanh toán)

NameTypeDescription`id``string`Mã định danh đơn vị CNTT`name``string`Tên đơn vị CNTT### `Consumer` class

[](#consumer-class)

Thông tin người thanh toán

NameTypeDescription`bankBin``string`Mã ngân hàng`bankNumber``string`Số tài khoản### `AdditionalData` class

[](#additionaldata-class)

Thông tin bổ sung

NameTypeDescription`billNumber``string`Số hóa đơn`mobileNumber``string`Số điện thoại di động`store``string`Tên cửa hàng`loyaltyNumber``string`Mã khách hàng thân thiết`reference``string`Mã Tham chiếu`customerLabel``string`Mã khách hàng`terminal``string`Tên điểm bản`purpose``string`Nội dung giao dịch### `build()` method

[](#build-method)

Trả về nội dung mã QR mới

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance46

Moderate activity, may be stable

Popularity12

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

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 ~6 days

Total

3

Last Release

414d ago

PHP version history (2 changes)V1.0.0PHP >=7.4

V1.0.2PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/4df2f28699f152f4a732310721278121bb19128b8fd1fc662df51977d185e663?d=identicon)[cuongjpitdnu](/maintainers/cuongjpitdnu)

---

Tags

phpqrcodeqrcodevietqrcuongnm

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cuongnm-viet-qr-pay/health.svg)

```
[![Health](https://phpackages.com/badges/cuongnm-viet-qr-pay/health.svg)](https://phpackages.com/packages/cuongnm-viet-qr-pay)
```

###  Alternatives

[endroid/qr-code

Endroid QR Code

4.8k67.6M348](/packages/endroid-qr-code)[endroid/qr-code-bundle

Endroid QR Code Bundle

32110.6M17](/packages/endroid-qr-code-bundle)[amirezaeb/heroqr

A Powerful QR Code Management Library For PHP

9510.3k](/packages/amirezaeb-heroqr)[dfridrich/qr-platba

Generování QR Plateb a QR Faktur v PHP.

47270.8k1](/packages/dfridrich-qr-platba)

PHPackages © 2026

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