Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt

General FAQs

Expand
limit2
titleDoes the SDK support JAVA/Kotlin?

Yes, CardinalMobileSDK supports both JAVA as well as Kotlin. Code snippet of each programming languages can be found in the documentation.


Expand
limit2
titleDoes the SDK have any third party SDK/Library dependencies?

Yes, CardinalMobileSDK uses Nimbus JOSE+JWT for encryption/ decryption. These need to add in your Gradel dependencies.


Expand
limit2
titleWhat is the size of the SDK?

The downloaded framework file size is 252KB. Once integrated with the app, it adds 190KB to the total size.


Expand
titleCan I download the SDK into my project manually ?

You can also download .aar file directly from Jfrog by navigating into the package and clicking cardinalmobilesdk-*.*.*-*.aar file under Direct Downloads section as shown below.


Expand
limit2
titleErrors on updating the SDK to 2.1.4

Change the import statements as follows :

import com.cardinalcommerce.cardinalmobilesdk.models.response.CardinalActionCode
import com.cardinalcommerce.cardinalmobilesdk.models.response.ValidateResponse

import com.cardinalcommerce.shared.models.parameters.CardinalConfigurationParameters
import com.cardinalcommerce.shared.models.parameters.CardinalEnvironment
import com.cardinalcommerce.shared.models.parameters.CardinalRenderType
import com.cardinalcommerce.shared.models.parameters.CardinalUiType

to 

mport com.cardinalcommerce.cardinalmobilesdk.enums.CardinalEnvironment
import com.cardinalcommerce.cardinalmobilesdk.enums.CardinalRenderType
import com.cardinalcommerce.cardinalmobilesdk.enums.CardinalUiType
import com.cardinalcommerce.cardinalmobilesdk.models.CardinalActionCode
import com.cardinalcommerce.cardinalmobilesdk.models.CardinalConfigurationParameters
import com.cardinalcommerce.cardinalmobilesdk.models.ValidateResponse


Expand
titleError ' Dependency failing: com.nimbusds:nimbus-jose-jwt:5.1 -> net.minidev:json-smart@[1.3.1,2.3] '

Root Cause:

Google started using nimbus library dependencies in its play services with version 4.3.0 ('com.google.gms:google-services:4.3.0') this is causing conflicts with anyone using nimbus library dependencies, google is using net.minidev:json-smart:1.3.1 where the latest version of nimbus library uses 2.3 this is causing conflict when merchants integrating CardinalMobile SDK with required dependencies ( 'com.nimbusds', name: 'nimbus-jose-jwt', version: '7.0.1', 'org.bouncycastle', name: 'bcprov-jdk15on', version: '1.61'). There are couple of ways to resolve this issue which are mentioned below.

Solution 1 : 

When you face conflicts in using dependencies version you can configure Android Studio project to use a specific version.

Add below code to use 2.3 version of json-smart (if you want to use 1.3.1 replace prefer value to 1.3.1)


components.all {
        allVariants {
            withDependencies { deps ->
                deps.each { dep ->
                    if (dep.group == 'net.minidev' && dep.name =='json-smart') {
                        dep.version {
                            prefer "2.3"
                        }
                        dep.because "resolving dependencies issue"
                    }
                }
            }
        }
    }


Solution 2:

The other solution is using an old version of google play service which doesn't use nimbus library which is 'com.google.gms:google-services:4.1.0'


Config FAQs

Expand
limit2
titleCan I test staging credentials in production environment of SDK?

No, if you are using staging credential make sure SDK config is set to Staging Environment and switch back to Production Environment when moving to production. SDK is configured to Production Environment by default.


Expand
limit2
titleCan I customize the Challenge Screens?

Yes, you can customize the certain aspect of Challenge Screen by setting the UICustomization in SDK Config. See  UI Customization v2.1.3 for details.


Expand
limit2
titleHow do I set custom font for UICustomization?

You should verify the following:

  1. Copy your .ttf file to “font” folder under “assets” in the main directory
    1. If you don’t already have an assets file, right click on the main directory | New | Android Resource Directory
      - Directory name: assets
      - Directory type: assets
      - Source Set: main
      - Once the directory is created, right click | New | Android Resource Directory |
      - Directory name: font
      - Directory Type: font
      - Source Set: main
  2.  Once you have verified you have your font in the right place, Pass in fontName as “font/font_name.ttf”
    1. eg. buttonCustomization.setTextFontName(“font/walkwayblack.ttf”);


Expand
limit2
titleCan I get Setup Completion Handler called only after Data Collection is complete?

Yes, you can set enableDFSync to true in SDK Config to get Setup Completion Handler called after Data Collection is complete. enableDFSync is set to false by default.



Setup/Init FAQs

Expand
limit2
titleWhy do I get Invalid JWT Error?

JWT might be invalid if the credentials in the JWT like OrgUnitID, APIKey, APIIdentifiers are invalid or the JWT has expired. Also, make sure the credentials in the JWT point to the correct environment that SDK is set to in the config.


Expand
limit2
titleWill I notified if Device Data Collection fails?

By default, no. If you want Setup to be successful only after Device Data collection is complete, then enable DF Sync in the SDK Config.


Expand
limit2
titleWhat if the device doesn't have internet access during Setup call?

OnValidated handler of the Setup will be called with the corresponding error message. 



ProcessBin FAQs

Expand
limit2
titleWhen does the ProcessBin onComplete Handler doesn't get called?

If you start ProcessBin without successful completion of Setup/Init, then ProcessBin cannot be completed. Please check the console log for error details.



Continue FAQs

Expand
limit2
titleWhen can continue throw an error even without showing a challenge screen?

If the parameter you passed to the continue, like TransactionId or Payload is invalid then, continue will throw an error.


Expand
limit2
titleWhat should be passed as directoryServerID on continue ?
You can use DirectoryServerID.VISA01 in V 2.1.3-X, this method is deprecated in the 2.1.4-X version of the SDK 


Expand
limit2
titleWhy is my Payload from Lookup response Invalid?

Make sure the ThreeDSVersoin of the lookup response matches with what SDK Supports. SDK does not support 1.0 Payload.


Expand
limit2
titleHow can I test different UI in Challenge Screen?

After all initial setup, in continue pass a sample payload of various UI Types to test different UI in Challenge Screens. You can get the sample payload for various UI type from your Client Manager or Implementation Manager.


Expand
limit2
titleDoes Failure ActionCode mean there was an error?

No. It means the authentication failed based on the data user provided.




...