Replacing the transaction confirmation UI

By default, the App SDK displays the transaction confirmation text when authorizing a transaction.

There are two ways to modify this UI, you can either suppress its display or replace it.

Suppress the display of the transaction confirmation UI

There may be circumstances when you want your application to display the transaction confirmation text before starting the transaction. In this case, you want to suppress the display within the SDK.

1. To prevent the display of the default UI, create the extension data:

extension.id = "noknok.showTransaction";

extension.data = "false";

extension.fail_if_unknown  = false;

2. Pass the extension data via Extras to the AdaptiveUI.getAuthenticationFragment() method.

Working Example in Tutorial App

• Refer to how the variable inAppTcd is used in TransactionFragment.kt.

Replace the transaction UI

You can control the transaction UI by specifying a callback function that displays the transaction text and records the user’s approval or rejection. You can programmatically change the transaction UI by replacing the default transaction UI factory.

TutorialApp contains an example of how to replace the transaction UI factory. This example sets TransactionUIFactory, which overrides the createTransactionUIInstance function. To test this functionality, set the following value to true in the TutorialAppPlus class.

const val replaceTransactionUI = true

Then the following code replaces the factory class with a custom factory:

// Setup the factory to create the TutorialTransactionUI object
TransactionUIFactory.setInstance(object : TransactionUIFactory() {
    override fun createTransactionUIInstance(): ITransactionUI {
        return TutorialPlusTransactionUI()
    }
})

See the Client API Docs for more information on ITransactionUI protocol.

Working example in Tutorial App

• Refer to TutorialPlusTransactionUI.kt as a sample of overriding transaction UI.