Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Page Properties
hiddentrue

Status

Status
colourGreen
titleapproved

Approver

Nadzeya Karaban

To use the capture flow, do the followingIn order to launch Gini Capture SDK, follow these steps:

  1. Request camera access via configuring Info.plist in your project.

  2. Configure GiniBankConfigurationGiniConfiguration.shared. The Here is an implementation example can be found here.

  3. Present the UIViewController. You can find the example here Here is an example.

  4. Handle the extraction results .
    For handling the extraction results you need to implement GiniCaptureResultsDelegate. Further below you can find by implementing GiniCaptureResultsDelegate. There are more details about the delegate methods later and here you can find the is an implementation example.

  5. Cleanup configuration and resources while also providing the required extraction feedback to improve future extraction accuracy. Follow the recommendations belowSend the final transfer summary values to Gini by calling GiniConfiguration.shared.sendTransferSummary()method which will be used to improve the future extraction accuracy

  6. Clean up the SDK by calling GiniConfiguration.shared.cleanup() which will release the resources used by SDK.

Follow these recommendations:

Note
  • Provide values for all necessary fields, including those that were not extracted.

  • Provide the final data approved by the user (and not the initially extracted only).

  • Do cleanup Send transfer summary only after TAN verification.

You don’t need to implement any extra steps.

Code Block
languageswift
   GiniBankConfigurationGiniConfiguration.shared.cleanupsendTransferSummary(paymentRecipient: "Payment Recipient",
                                   paymentReference: "Payment Reference",
                                   paymentPurpose: "Payment Purpose",
                                   iban: "IBAN",
                                   bic: "BIC",
                                   amountToPay: ExtractionAmount(value: 10.242, currency: .EUR))
                                   
   GiniConfiguration.shared.cleanup()
Info

Check out

...

an example app to see what an integration

...

can look like.

...

The diagram below shows the interaction between your app and the SDK:

Drawio
mVer2
zoom1
simple0
inComment0
custContentId12288218
pageId11796779
lbox1
diagramDisplayNameUntitled Diagram-1683895916012.drawio
contentVer34
revision34
baseUrlhttps://gini.atlassian.net/wiki
diagramNameUntitled Diagram-1683895916012.drawio
pCenter0
width860
links
tbstyle
height379.5

The Gini Capture SDK can return returns one of results by invoking the following GiniCaptureResultsDelegate methods:

  • GiniCaptureResultsDelegate.giniCaptureAnalysisDidFinishWith(result: AnalysisResult)

    A document was analyzed and the extractions are available in the properties of the AnalysisResult object.

  • GiniCaptureResultsDelegate.giniCaptureDidCancelAnalysis()

    The user has canceled Gini Capture SDK.

  • GiniCaptureResultsDelegate.giniCaptureDidEnterManually()

    The document analysis finished with no results/an error and the user clicked the Enter manually button on either the No Results Screen or the Error Screen. To enable manual entry of payment information, you should close Gini Capture SDK, allowing letting your app to prompt users for manual input.