QR Code Scanning

Some invoices have a QR code that allows the user to get the payment data just by scanning it from the camera screen. If the QR code has a valid format (see supported QR codes), a popup appears pointing out that a QR code has been detected and allowing the user to use it.

Enable QR code scanning

The QR code scanning feature is disabled by default, so in case that you what to use it you just need to enable it in the GiniBankConfiguration, like so:

let giniBankConfiguration = GiniBankConfiguration.shared
...
...
...     
giniBankConfiguration.qrCodeScanningEnabled = true

For activating QR code-only mode without the ability to take images, you need to enable the flag in the GiniBankConfiguration, but also the QR scanning ability, like so: 

let giniBankConfiguration = GiniBankConfiguration.shared
...
...
...        
giniBankConfiguration.qrCodeScanningEnabled = true
giniBankConfiguration.onlyQRCodeScanningEnabled = true

Handle and process the Payment Data

Once the QR code has been detected and the user has tapped the button to use it, the payment data is returned and ready to be analyzed in the API. In order to handle the Payment Data from the QR code, on one hand if you are using the Screen API the GiniQRCodeDocument is received in the delegate method GiniCaptureDelegate.didCapture(document:), where it must be sent to the API as though it was an image or a pdf. On the other hand if you are using the Component API, you will get the GiniQRCodeDocument in the CameraScreenSuccessBlock, where it also must be sent to the API as if it was an image or a pdf.

Customization

It is possible to customize the text label, button and background colors with these parameters:

  • GiniBankConfiguration.qrCodePopupBackgroundColor
  • GiniBankConfiguration.qrCodePopupButtonColor
  • GiniBankConfiguration.qrCodePopupTextColor

Additionally the text from both correct, incorrect and loading label can be customized through the following parameters in your Localizable.strings file:

  • ginicapture.QRscanning.incorrect.title
  • ginicapture.QRscanning.incorrect.description
  • ginicapture.QRscanning.correct
  • ginicapture.QRscanning.loading

Supported QR codes

The supported QR codes are: