PayNowQRSwift

From the author :

Hello! I am a high scool student who just learned to code. This is my first attempt at creating a Swift package. Please let me know how I can improve. Thanks :D

What Is Pay Now ?

PayNow is a peer-to-peer funds transfer service available to the customers of nine participating banks in Singapore. The payer can instantly & securely transfer funds to the beneficiary by scanning the PayNow QR Code with their internet banking app.

It is based on the international MasterCard EMV standard.

Introduction :

This library enables you to generate the following by specifying their parameters :

1. The string value of a Pay Now QR Code
2. The Pay Now QR Code image

Installation :

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

This video eloquently explains how to install Swift Packages.

After installing the Swift package, remember to type in import PayNowQRSwift in your Swift file.

Pay Now QR Code String Generation :

Call the function payNowQRString and pass in your values for the 7 parameters. The function returns a string which can then be stored in a constant / variable

The table below shows you how to fill in the values for the Pay Now QR String.

The String Parameter Table :

The code snippets below show how to store the string in a constant / variable and shows the value of the string with the specified parameters when printed.

let demo1 = payNowQRString(_beneficiaryType: .UEN, _beneficiary: "S62SS0057G", _beneficiaryName: "Singapore Children's Society", amount: 10, reference: "Donation", amountIsEditable: false, _expiryDate: Date.init() )

print("The result of demo1 is : ", demo1)


let demo2 = payNowQRString(_beneficiaryType: .Mobile, _beneficiary: "+6512345678", _beneficiaryName: "John Lee", amount: 10.27, reference: "Mr. Lee Bill", amountIsEditable: true, _expiryDate: nil)

print("The result of demo2 is : ", demo2)

The result of demo1 is : 00020101021226490009SG.PAYNOW010120210S62SS0057G03010040820200817520400005303702540510.005802SG5928Singapore Children's Society6009Singapore62120108Donation630482EB

The result of demo2 is : 00020101021226380009SG.PAYNOW010100211+651234567803011520400005303702540510.275802SG5908John Lee6009Singapore62160112Mr. Lee Bill6304BD9B

Usage :

The string obtained from this framework can then be inputted into a function for creating the QR Code.

The code snippet below shows how you can pass this string into a standard function which generates a QR Code. The QR Code produced is the final Pay Now QR Code.

func generateQRCode(from string: String, with imageView: UIImageView) -> UIImage? {
    
    let data = string.data(using: String.Encoding.ascii)
    
    if let filter = CIFilter(name: "CIQRCodeGenerator") {
        filter.setValue(data, forKey: "inputMessage")

        guard let qrImage = filter.outputImage else {return nil}
        let scaleX = imageView.frame.size.width / qrImage.extent.size.width
        let scaleY = imageView.frame.size.height / qrImage.extent.size.height
        let transform = CGAffineTransform(scaleX: scaleX, y: scaleY)

        
        if let output = filter.outputImage?.transformed(by: transform) {
            return UIImage(ciImage: output)
        }
    }
    return nil
    
}

let demoImageView = UIImageView(frame: CGRect(x: 50, y: 50, width: 100, height: 100))
let qrCodeImage = generateQRCode(from: demo1, with: demoImageView)

The Pay Now QR Code Image generated with the demo1 constant is shown below :

Pay Now QR Code Image Generation :

Aside from returning the string for a Pay Now QR Code, this framework also allows you to quickly create the standard Pay Now QR Code image (with its distinctive purple colour as well as having the Pay Now Logo).

Apart from providing you with an image, the framework also allows you to write some text below the QR Code to convey some information without scanning (this is optional).

To create the image, call the function payNowQRImage and pass in your values for the 9 parameters (The first 7 parameters are the same as for creating the string). The function returns a UIImage.

The table below shows you how to fill in the values for the Pay Now QR Image generation function.

The Image Parameter Table :

Usage :

The code snippets below show how you can pass in different values for the image parameters to create different images.

let qrImage1 = payNowQRImage(_beneficiaryType: .UEN, _beneficiary: "S62SS0057G", _beneficiaryName: "SCS", amount: 11.5, reference: "Monthly Donation", amountIsEditable: false, _expiryDate: Date.init(), qrWidthAndHeight: 257.155, bottomLabelText: "SCS (*057G) $11.5")


let qrImage2 = payNowQRImage(_beneficiaryType: .UEN, _beneficiary: "S62SS0057G", _beneficiaryName: "SCS", amount: 11.5, reference: "Monthly Donation", amountIsEditable: true, _expiryDate: nil, qrWidthAndHeight: 257.155, bottomLabelText: nil)

The above images (qrImage1 and qrImage2) have one major difference. The first image contains a bottom label with the specified text while the second image does not.

After adding the images to an image view and then running it on a simulator, here are the results.

qrImage1 :

qrImage2 :

Note : The Pay Now QR Image generation function returns a clear image when the width / height of the QR code is equal to the width and height of the UIImageView it is added to.