Params:
paymentParams*:PaymentParams = payment slip data
settings*:Partial = (optional) validation settings

Returns: HUB 3A 2D barcode string

Data structures

Important notes:
- Iznos - must be formatted with a comma as the decimal separator (e.g., "123,45", not "123.45")
- ModelPlacanja - must contain the "HR" prefix (e.g., "HR00", "HR01", "HR99")
- All fields are strings, including Iznos
- For Croatian alphabet characters (Š, Đ, Č, Ć, Ž), each character counts as 2 bytes

Validation Functions

The library exports several validation functions:
- IsIBANValid(iban: string): boolean - Validates IBAN format using the ibantools library
- IsPaymentModelValid(paymentModel: string): boolean - Validates payment model codes (HR00-HR99)
- IsIntentCodeValid(intentCode: string): boolean - Validates SEPA purpose codes
- IsCalloutNumberValid(calloutNumber: string, paymentModel: string): boolean - ⚠️ NOT IMPLEMENTED - Always returns true. Proper validation by payment model is not yet available.
- ValidatePaymentParams(paymentParams: PaymentParams, settings?: BarcodePaymentSettings): ValidationResult - Validates all payment parameters

Note: The ValidateCalloutNumber setting in BarcodePaymentSettings is available but has no effect since IsCalloutNumberValid is not implemented.

Examples

if(validation_result !== ValidationResult.OK) {
console.log(Payment params are invalid - validation result = ${validation_result});

// You can check for specific errors using bitwise operators
if(validation_result & ValidationResult.IBANInvalid) {
console.log("IBAN is invalid");
}
if(validation_result & ValidationResult.PricePatternInvalid) {
console.log("Price format is invalid");
}
} else {
const hub3a_text = EncodePayment(paymentParams);
// ... pass the generated hub3a_text to a 2D barcode generation library
}

// Option 2: Direct encoding (with automatic validation)
try {
const hub3a_text = EncodePayment(paymentParams, {
ValidateIBAN: true,
ValidateCalloutNumber: false
});

// ... pass the generated hub3a_text to a 2D barcode generation library

} catch(ex: any) {
// EncodePayment validates the payment slip data
// -> if validation fails, an error will be thrown
console.log("Payment slip failed validation:", ex.message);
}

`


Testing

The project uses Jest for unit testing.

Running tests

`bash


Run all tests

All tests are written based on the behavior of the legacy BarcodePayment.js` implementation.