Testing

Gini Pay Deep Link For Your App

In order for banking apps to be able to return the user to your app after the payment has been resolved you need register a scheme for your app to respond to a deep link scheme known by the Gini Bank API.

Info: You should already have a scheme and host from us. Please contact us in case you don’t have them.

The following is an example for the deep link gini-pay://payment-requester:

Testing

An example banking app is available in the Gini Mobile Monorepo iOS repository.

In order to test using our example banking app you need to use development client credentials. This will make sure the Gini Health SDK uses a test payment provider which will open our example banking app. To inject your API credentials into the Bank example app you need to fill in your credentials in Credentials.plist.

End to end testing

The app scheme in our banking example app: ginipay-bank://. Please, specify this scheme LSApplicationQueriesSchemes in your app in Info.plist file.

After you’ve set the client credentials in the example banking app and installed it on your device you can run your app.

Payment component

After following the integration steps above you’ll arrive at the Payment Invoice list screen, which already has integrated the Payment Component. The following screenshot shows a sample list of invoices where the PaymentComponent is shown for each invoice.

Bank Selection Bottom sheet

You should see the Gini-Test-Payment-Provider preselected in every payment component view. By clicking the picker you should see the BankSelectionBottomSheet with the list of available banking apps (including Gini-Test-Payment-Provider and other testing and production apps).

More information and FAQ

By clicking either the more information or the info icon on the Payment Component view you should see the Payment feature Info screen with information about the payment feature and an FAQ section.

Payment Review

By clicking the Pay the invoice button on a Payment Component view you should see the Payment Review screen, which shows the invoice’s pages and the payment information. It also allows editing the payment information. The To the banking app button should have the icon and colors of the banking app, which was selected in the payment component view.

Check that the extractions and the document preview are shown and then press the Pay button:

Execute payment

When clicking the To the banking app button on the payment review you should be redirected to the example banking app where the payment information will be fetched from Gini (including any changes you made on the payment review). Press the “Pay” button to execute a test payment which will mark the payment as paid in the Gini Health API. You should be redirected to the example banking app where the final extractions are shown:

After you press the Pay button the Gini Bank SDK resolves the payment and allows you to return to your app:

Return to your app

After the test payment has been executed, the example banking app should show a “Return to Health app” button which should take you back to your app.

For handling incoming url in your app after redirecting back from the banking app you need to implement to handle the incoming url: The following is an example for the url gini-pay://payment-requester:

    func application(_ app: UIApplication,
                     open url: URL,
                     options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
        if url.host == "payment-requester" {
            // hadle incoming url from the banking app
        }
        return true
    }

With these steps completed you have verified that your app, the Gini Health API, the Gini Health SDK and the Gini Bank SDK work together correctly.

Testing in production

The steps are the same but instead of the development client credentials you will need to use production client credentials. This will make sure the Gini Health SDK receives real payment providers which open real banking apps.

You will also need to install a banking app which uses the Gini Bank SDK. Please contact us in case you don’t know which banking app(s) to install.

Lastly make sure that for production you register the scheme we provided you for deep linking and you are not using gini-pay://payment-requester.