You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 5
Next »
General FAQs
Does 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.
Does 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.
What 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.
Can 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.
Errors 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
Config FAQs
Can 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.
Can 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.
How do I set custom font for UICustomization?
You should verify the following:
- Copy your .ttf file to “font” folder under “assets” in the main directory
- 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
- Once you have verified you have your font in the right place, Pass in fontName as “font/font_name.ttf”
- eg. buttonCustomization.setTextFontName(“font/walkwayblack.ttf”);
Can 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
Why 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.
Will 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.
What 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
When 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
When 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.
What 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
Why 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.
How 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 Sample Payload for Various UI Types.
Does Failure ActionCode mean there was an error?
No. It means the authentication failed based on the data user provided.