Go SDK for generating, decoding, and verifying Bakong KHQR.
go get github.com/ishinvin/go-khqr import khqr "github.com/ishinvin/go-khqr" Static QR (no amount):
data , err := khqr .GenerateIndividual (khqr.IndividualInfo {
BakongAccountID : "ishin_vin@bkrt" ,
MerchantName : "Ishin Vin" ,
})
if err != nil {
log .Fatal (err )
}
fmt .Println (data .QR )Dynamic QR (with amount and expiration):
data , err := khqr .GenerateIndividual (khqr.IndividualInfo {
BakongAccountID : "ishin_vin@bkrt" ,
MerchantName : "Ishin Vin" ,
Currency : khqr .USD ,
Amount : 5.00 ,
ExpirationTimestamp : time .Now ().Add (5 * time .Minute ).UnixMilli (),
BillNumber : "INV-2026-001" ,
MobileNumber : "85512345678" ,
})
if err != nil {
log .Fatal (err )
}
fmt .Println (data .QR )
fmt .Println (data .MD5 ())With alternate language:
data , err := khqr .GenerateIndividual (khqr.IndividualInfo {
BakongAccountID : "ishin_vin@bkrt" ,
MerchantName : "Ishin Vin" ,
Currency : khqr .KHR ,
Amount : 50000 ,
ExpirationTimestamp : time .Now ().Add (10 * time .Minute ).UnixMilli (),
AltLanguagePreference : "km" ,
AltMerchantName : "វិន អ៊ីស៊ីន" ,
AltMerchantCity : "ភ្នំពេញ" ,
})
if err != nil {
log .Fatal (err )
}
fmt .Println (data .QR )Static QR:
data , err := khqr .GenerateMerchant (khqr.MerchantInfo {
BakongAccountID : "ishin_vin@bkrt" ,
MerchantName : "Ishin Coffee" ,
MerchantCity : "Phnom Penh" ,
MerchantID : "123456" ,
AcquiringBank : "Bakong" ,
})
if err != nil {
log .Fatal (err )
}
fmt .Println (data .QR )Dynamic QR (with amount and additional data):
data , err := khqr .GenerateMerchant (khqr.MerchantInfo {
BakongAccountID : "ishin_vin@bkrt" ,
MerchantName : "Ishin Coffee" ,
MerchantCity : "Phnom Penh" ,
MerchantID : "123456" ,
AcquiringBank : "Bakong" ,
Currency : khqr .USD ,
Amount : 10.50 ,
ExpirationTimestamp : time .Now ().Add (5 * time .Minute ).UnixMilli (),
BillNumber : "INV-2026-001" ,
StoreLabel : "Main Branch" ,
TerminalLabel : "Cashier_1" ,
Purpose : "Coffee" ,
})
if err != nil {
log .Fatal (err )
}
fmt .Println (data .QR )
fmt .Println (data .MD5 ())decoded , err := khqr .Decode (qrString )
if err != nil {
log .Fatal (err )
}
fmt .Println (decoded .BakongAccountID )
fmt .Println (decoded .MerchantName )
fmt .Println (decoded .TransactionAmount )if err := khqr .Verify (qrString ); err != nil {
log .Fatal (err )
}
Function
Description
GenerateIndividual(IndividualInfo) (*Data, error)Generate a KHQR string for an individual payment
GenerateMerchant(MerchantInfo) (*Data, error)Generate a KHQR string for a merchant payment
Decode(string) (*DecodedData, error)Parse a KHQR string into structured data
Verify(string) errorValidate CRC and structure of a KHQR string
Field
Type
Max Length
Description
BakongAccountIDstring32
Must contain @ (e.g. "user@bank")
MerchantNamestring25
Name of the individual
Optional Fields with Defaults
Field
Type
Default
Description
CurrencyCurrencyKHRkhqr.KHR or khqr.USD
MerchantCitystring"Phnom Penh"Max 15 characters
MerchantCategoryCodestring"5999"1-4 digit numeric code
Field
Type
Description
Amountfloat640 = static QR; KHR must be whole number, USD up to 2 decimals
ExpirationTimestampint64Unix milliseconds, required when Amount > 0
Field
Type
Max Length
Description
AcquiringBankstring32
Acquiring bank name
AccountInfostring32
Additional account information
UPIAccountInfostring99
UPI account info (not supported with USD)
BillNumberstring25
Bill/invoice number
StoreLabelstring25
Store identifier
TerminalLabelstring25
Terminal identifier
MobileNumberstring25
Mobile number
Purposestring25
Purpose of transaction
AltLanguagePreferencestring2
ISO 639-1 code (e.g. "km"); requires AltMerchantName
AltMerchantNamestring25
Required when AltLanguagePreference is set
AltMerchantCitystring15
Alternate language city name
Field
Type
Max Length
Description
BakongAccountIDstring32
Must contain @ (e.g. "merchant@bank")
MerchantNamestring25
Name of the merchant
MerchantCitystring15
City of the merchant
MerchantIDstring32
Merchant identifier
AcquiringBankstring32
Acquiring bank name
Optional Fields with Defaults
Field
Type
Default
Description
CurrencyCurrencyKHRkhqr.KHR or khqr.USD
MerchantCategoryCodestring"5999"1-4 digit numeric code
Field
Type
Description
Amountfloat640 = static QR; KHR must be whole number, USD up to 2 decimals
ExpirationTimestampint64Unix milliseconds, required when Amount > 0
Field
Type
Max Length
Description
UPIAccountInfostring99
UPI account info (not supported with USD)
BillNumberstring25
Bill/invoice number
StoreLabelstring25
Store identifier
TerminalLabelstring25
Terminal identifier
MobileNumberstring25
Mobile number
Purposestring25
Purpose of transaction
AltLanguagePreferencestring2
ISO 639-1 code (e.g. "km"); requires AltMerchantName
AltMerchantNamestring25
Required when AltLanguagePreference is set
AltMerchantCitystring15
Alternate language city name
Static QR (Amount = 0): No amount encoded, reusable for multiple payments.Dynamic QR (Amount > 0): Includes a specific amount and requires an ExpirationTimestamp (unix milliseconds).
Constant
ISO 4217 Code
Rules
khqr.KHR116
Whole numbers only
khqr.USD840
Up to 2 decimal places
All errors are of type *khqr.Error with a Code and Message. Use errors.Is for comparison:
if errors .Is (err , khqr .ErrAccountIDRequired ) {
// handle missing account ID
}MIT