Best Practices

Please follow the Android Studio guidelines for writing code, this can be found using this link.

Error Handling:

val parsedAmount = parseAmount(street) ?: run {
    Toast.makeText(this, "Invalid amount", Toast.LENGTH_SHORT).show()
    return
}val parsedAmount = parseAmount(street) ?: run {
    Toast.makeText(this, "Invalid amount", Toast.LENGTH_SHORT).show()
    return
}

Logging

Log.d("SDK", "Sending transaction: $request")Log.d("SDK", "Sending transaction: $request")

Threading

Always update UI with runOnUiThread { }

Project Structure Example

app/
├── build.gradle.kts
├── src/
│   └── main/
│       ├── java/        // Kotlin source code
│       ├── res/         // JSON/xml resources
│       └── aidl/        // AIDL interface files from SDK
├── libs/
│   └── tnsi-sdk.aar     // Payment SDK binaryapp/
├── build.gradle.kts
├── src/
│   └── main/
│       ├── java/        // Kotlin source code
│       ├── res/         // JSON/xml resources
│       └── aidl/        // AIDL interface files from SDK
├── libs/
│   └── tnsi-sdk.aar     // Payment SDK binary

Key Notes

• Validation: Ensure amount, currency, and readerType match business rules before sending the request.
• Error Handling: The SDK should provide exceptions or status codes for invalid input (e.g., missing msgType).
• Security: Sensitive data (e.g., agreementID, jsonMsg) should be encrypted if transmitted outside the app.
• Logging: Debug logs can track invoiceNbr and origTransNo for auditing.
• Validation: Always validate parsing results (?.takeIf { it > 0 }).
• Default Values: invoiceNbr and currency are hardcoded (USD).
• Tokenization: If tokenRequest is checked, agreementID and agreementType are included.

Disclaimers / Consent

The app/merchant should allow for the display of disclaimers/collect consent whenever applicable. eg. during Tokenization.

If requesting a token for a cardholder, you need to ensure the merchant collects consent from the customer to allow the merchant to store the card token information and to perform future transactions

.