vietqr

package module

v0.0.0-...-f551a54 Latest Latest Go to latest Published: Mar 23, 2025 License: MIT Imports: 3 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/ducnpdev/vietqr

README ¶

VietQR - Golang

thư viện hỗ trợ mã QR để thanh toán thông qua NAPAS với ngôn ngữ lập trình Golang

Napas Document

link document của napas: https://vietqr.net/portal-service/download/documents/QR_Format_T&C_v1.0_VN_092021.pdf

Chức Năng

hỗ trợ tạo ra qr để thanh toán( accountNo, amount, nội dung, ...)

Cài Đặt

go get github.com/ducnpdev/vietqr

Ví Dụ:

package main

import (
	"fmt"

	"github.com/ducnpdev/vietqr"
)

func main() {
	content := vietqr.GenerateViQR(vietqr.RequestGenerateViQR{
		MerchantAccountInformation: vietqr.MerchantAccountInformation{
			AccountNo: "999990335280715",
		},
		TransactionAmount: "505000",

		AdditionalDataFieldTemplate: vietqr.AdditionalDataFieldTemplate{
			Description: "test noi dungtest noi dungtest noi dungtest noi dung",
		},
		Mcc:          "5139",
		ReceiverName: "Cty ABC",
	})

	fmt.Println("content-main:", content)
}

Tách Các Filed Tag

golang vietqr detech qr.

0002
    01
0102
    12
3859
    0010
        A000000727
    0129
        0006
            970437
        0115
            999990335280715
        0208
            QRIBFTTA
5204
    5139
5303
    704
5406
    50500
5802
    VN
6217
    0813
        test noi dung
5907
    Cty ABC
6304
    33C4

detech qr trên mạnh:

0002010102125406930000
3857
    0010
        A000000727
    0127
        0006
            970437
        0113
            QR50317S75UDT
    0208
        QRIBFTTA
5303
    704
5802
    VN
6292
    0325
        TRUONG TIEU HOC NGHIA TAN
    0719
        02770002virtualNONE
    0836
        BYMII0HL5E AD87PI 03 2025 THT SON 4P
6304614A

License

MIT License

Documentation ¶

Index ¶

Variables
func Checksum(data []byte, table *Table) uint16
func Complete(crc uint16, table *Table) uint16
func GenerateViQR(req RequestGenerateViQR) string
func Init(table *Table) uint16
func Update(crc uint16, data []byte, table *Table) uint16
type AdditionalDataFieldTemplate
type Hash16
- func New(t *Table) Hash16
type MerchantAccountInformation
type Params
type RequestGenerateViQR
type Table
- func MakeTable(params Params) *Table

Constants ¶

This section is empty.

Variables ¶

View Source

var (
	CRC16_ARC         = Params{0x8005, 0x0000, true, true, 0x0000, 0xBB3D, "CRC-16/ARC"}
	CRC16_AUG_CCITT   = Params{0x1021, 0x1D0F, false, false, 0x0000, 0xE5CC, "CRC-16/AUG-CCITT"}
	CRC16_BUYPASS     = Params{0x8005, 0x0000, false, false, 0x0000, 0xFEE8, "CRC-16/BUYPASS"}
	CRC16_CCITT_FALSE = Params{0x1021, 0xFFFF, false, false, 0x0000, 0x29B1, "CRC-16/CCITT-FALSE"}
	CRC16_CDMA2000    = Params{0xC867, 0xFFFF, false, false, 0x0000, 0x4C06, "CRC-16/CDMA2000"}
	CRC16_DDS_110     = Params{0x8005, 0x800D, false, false, 0x0000, 0x9ECF, "CRC-16/DDS-110"}
	CRC16_DECT_R      = Params{0x0589, 0x0000, false, false, 0x0001, 0x007E, "CRC-16/DECT-R"}
	CRC16_DECT_X      = Params{0x0589, 0x0000, false, false, 0x0000, 0x007F, "CRC-16/DECT-X"}
	CRC16_DNP         = Params{0x3D65, 0x0000, true, true, 0xFFFF, 0xEA82, "CRC-16/DNP"}
	CRC16_EN_13757    = Params{0x3D65, 0x0000, false, false, 0xFFFF, 0xC2B7, "CRC-16/EN-13757"}
	CRC16_GENIBUS     = Params{0x1021, 0xFFFF, false, false, 0xFFFF, 0xD64E, "CRC-16/GENIBUS"}
	CRC16_MAXIM       = Params{0x8005, 0x0000, true, true, 0xFFFF, 0x44C2, "CRC-16/MAXIM"}
	CRC16_MCRF4XX     = Params{0x1021, 0xFFFF, true, true, 0x0000, 0x6F91, "CRC-16/MCRF4XX"}
	CRC16_RIELLO      = Params{0x1021, 0xB2AA, true, true, 0x0000, 0x63D0, "CRC-16/RIELLO"}
	CRC16_T10_DIF     = Params{0x8BB7, 0x0000, false, false, 0x0000, 0xD0DB, "CRC-16/T10-DIF"}
	CRC16_TELEDISK    = Params{0xA097, 0x0000, false, false, 0x0000, 0x0FB3, "CRC-16/TELEDISK"}
	CRC16_TMS37157    = Params{0x1021, 0x89EC, true, true, 0x0000, 0x26B1, "CRC-16/TMS37157"}
	CRC16_USB         = Params{0x8005, 0xFFFF, true, true, 0xFFFF, 0xB4C8, "CRC-16/USB"}
	CRC16_CRC_A       = Params{0x1021, 0xC6C6, true, true, 0x0000, 0xBF05, "CRC-16/CRC-A"}
	CRC16_KERMIT      = Params{0x1021, 0x0000, true, true, 0x0000, 0x2189, "CRC-16/KERMIT"}
	CRC16_MODBUS      = Params{0x8005, 0xFFFF, true, true, 0x0000, 0x4B37, "CRC-16/MODBUS"}
	CRC16_X_25        = Params{0x1021, 0xFFFF, true, true, 0xFFFF, 0x906E, "CRC-16/X-25"}
	CRC16_XMODEM      = Params{0x1021, 0x0000, false, false, 0x0000, 0x31C3, "CRC-16/XMODEM"}
)

Predefined CRC-16 algorithms. List of algorithms with their parameters borrowed from here - http://reveng.sourceforge.net/crc-catalogue/16.htm

The variables can be used to create Table for the selected algorithm.

Functions ¶

func Checksum ¶

func Checksum(data []byte, table *Table) uint16

Checksum returns CRC checksum of data using scpecified algorithm represented by the Table.

func Complete ¶

func Complete(crc uint16, table *Table) uint16

Complete returns the result of CRC calculation and post-calculation processing of the crc.

func GenerateViQR ¶

func GenerateViQR(req RequestGenerateViQR) string

func Init ¶

func Init(table *Table) uint16

Init returns the initial value for CRC register corresponding to the specified algorithm.

func Update ¶

func Update(crc uint16, data []byte, table *Table) uint16

Update returns the result of adding the bytes in data to the crc.

Types ¶

type AdditionalDataFieldTemplate ¶

type AdditionalDataFieldTemplate struct {
	Description string `json:"description"`
}

type Hash16 ¶

type Hash16 interface {
	hash.Hash
	Sum16() uint16
}

func New ¶

func New(t *Table) Hash16

New creates a new CRC16 digest for the given table.

type MerchantAccountInformation ¶

type MerchantAccountInformation struct {
	// mặc định là ngân hàng HDBank: 970437
	AcqID     string `json:"acqID"`
	AccountNo string `json:"accountNo"`
}

type Params ¶

type Params struct {
	Poly   uint16
	Init   uint16
	RefIn  bool
	RefOut bool
	XorOut uint16
	Check  uint16
	Name   string
}

Params represents parameters of CRC-16 algorithms. More information about algorithms parametrization and parameter descriptions can be found here - http://www.zlib.net/crc_v3.txt

type RequestGenerateViQR ¶

type RequestGenerateViQR struct {
	// Phiên bản dữ liệu: tag 00
	PayloadFormatIndicator string `json:"payloadFormatIndicator"`

	// Phương thức khởi tạo, phân biệt QR động vào QR tĩnh: tag 01
	// mặc định là QR động: 010212
	PointInitiationMethod string `json:"pointInitiationMethod"`

	// Thông tin định danh ĐVCNTT: tag
	MerchantAccountInformation `json:"merchantAccountInformation"`

	// Merchant Category Code MCC: tag 52
	// identity merchant type
	// apply different fee base on mcc
	Mcc string `json:"mcc"`

	// Mã tiền tệ: tag 53
	// mặc định là VND: 704
	TransactionCurrency string `json:"transactionCurrency"`

	// Số tiền GD: tag 54
	TransactionAmount string `json:"transactionAmount"`

	// Mã quốc gia: tag 58
	// mặc định là VN
	CountryCode string `json:"countryCode"`

	// Merchant Reciever Name: tag 59
	ReceiverName string `json:"recieveName"`

	// Thông tin bổ sung: tag 62
	AdditionalDataFieldTemplate `json:"additionalDataFieldTemplate"`
}

type Table ¶

type Table struct {
	// contains filtered or unexported fields
}

Table is a 256-word table representing polinomial and algorithm settings for efficient processing.

func MakeTable ¶

func MakeTable(params Params) *Table

MakeTable returns the Table constructed from the specified algorithm.

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
example

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL