Merge pull request #25 from PAYONE-GmbH/release/1.4.0

Release/1.4.0

Author: Blackfaded

.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Test Android Library
+
+on:
+  push:
+    branches:
+      - main # Trigger on push to the main branch
+  pull_request:
+    branches: ['main', 'develop']
+  workflow_dispatch: # Allows manual triggering from the Actions tab
+
+jobs:
+  publish:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Make gradlew executable
+        run: chmod +x ./gradlew
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'zulu'
+
+      - name: Cache Gradle dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.gradle/caches
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle
+
+      - name: Build Android library
+        run: ./run_test.sh

README.md

@@ -21,6 +21,8 @@ Welcome to the PAYONE Commerce Platform Client Android SDK for the PAYONE Commer
         - [5. Host and load the HTML page](#5-host-and-load-the-html-page)
         - [6. Initialize the Tokenizer](#6-initialize-the-tokenizer)
         - [7. Customization and Callbacks](#7-customization-and-callbacks)
+            - [Custom Validation Icons (v1.4)](#custom-validation-icons-v14)
+            - [Click to Pay / CTP (v1.4)](#click-to-pay--ctp-v14)
         - [8. PCI DSS & Security](#8-pci-dss--security)
         - [9. Migration Note](#9-migration-note)
     - [Fingerprint Tokenizer](#fingerprint-tokenizer)
@@ -56,7 +58,7 @@ In order to use the SDK your minimum SDK Version needs to be at least API 34.
 
 ```kotlin
 dependencies {
-    implementation("io.github.payone-gmbh:pcp-client-android-sdk:1.3.0")
+    implementation("io.github.payone-gmbh:pcp-client-android-sdk:1.4.0")
 }
 ```
 
@@ -307,7 +309,69 @@ supportFragmentManager.beginTransaction().replace(R.id.fragment_container, fragm
 - `submitButton`: Provide a selector or element for the submit button.
 - `tokenizationSuccessCallback`: Handle the token and card details on success.
 - `tokenizationFailureCallback`: Handle errors on failure.
-- `environment`: Choose "test" or "live" for the SDK environment.
+- `mode`: Choose `"test"` or `"live"` for the SDK environment.
+- `allowedCardSchemes`: Limit accepted card brands (e.g. `listOf("visa", "mastercard")`). All brands accepted when omitted.
+- `customTextConfig`: Override labels, placeholders, aria-labels and validation error messages per locale key (e.g. `"en"`, `"de"`).
+
+##### Custom Validation Icons (v1.4)
+
+Provide your own success/error icons for input validation. Supported formats: SVG, PNG, JPEG, WebP.
+
+```kotlin
+import com.payone.pcp_client_android_sdk.cctokenizer.CustomIconsConfig
+
+val config = CreditcardTokenizerConfig(
+    // ... other fields ...
+    customIconsConfig = CustomIconsConfig(
+        useCustomValidationIcons = true,
+        showCardBrandIcons = false,   // true = show detected card brand instead of validation icon
+        successIcon = "/validIcon.svg",
+        errorIcon = "/invalidIcon.svg"
+    ),
+    // ...
+)
+```
+
+##### Click to Pay / CTP (v1.4)
+
+Enable Click to Pay (wallet-based payment by card schemes). Requires onboarding with PAYONE for Visa and/or Mastercard credentials.
+
+```kotlin
+import com.payone.pcp_client_android_sdk.cctokenizer.CTPConfig
+import com.payone.pcp_client_android_sdk.cctokenizer.SchemeConfig
+import com.payone.pcp_client_android_sdk.cctokenizer.VisaConfig
+import com.payone.pcp_client_android_sdk.cctokenizer.MastercardConfig
+import com.payone.pcp_client_android_sdk.cctokenizer.TransactionAmount
+import com.payone.pcp_client_android_sdk.cctokenizer.CTPUiConfig
+
+val config = CreditcardTokenizerConfig(
+    // ... other fields ...
+    ctpConfig = CTPConfig(
+        enableCTP = true,
+        enableCustomerOnboarding = true,
+        schemeConfig = SchemeConfig(
+            merchantPresentationName = "YourMerchantName",
+            visaConfig = VisaConfig(
+                srcInitiatorId = "YOUR_VISA_INITIATOR_ID",
+                srcDpaId = "YOUR_VISA_DPA_ID",
+                encryptionKey = "YOUR_ENCRYPTION_KEY",
+                nModulus = "YOUR_N_MODULUS"
+            ),
+            mastercardConfig = MastercardConfig(
+                srcInitiatorId = "YOUR_MC_INITIATOR_ID",
+                srcDpaId = "YOUR_MC_DPA_ID"
+            )
+        ),
+        transactionAmount = TransactionAmount(amount = "100", currencyCode = "EUR"),
+        uiConfig = CTPUiConfig(
+            buttonStyle = "solid",
+            buttonAndBadgeColor = "#3B82F6",
+            fontFamily = "Sansation"
+        )
+    ),
+    // ...
+)
+```
 
 #### 8. PCI DSS & Security
 

app/build.gradle.kts

@@ -35,8 +35,10 @@ android {
         sourceCompatibility = JavaVersion.VERSION_1_8
         targetCompatibility = JavaVersion.VERSION_1_8
     }
-    kotlinOptions {
-        jvmTarget = "1.8"
+    kotlin {
+        compilerOptions {
+            jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8)
+        }
     }
     buildFeatures {
         compose = true

app/src/main/assets/invalidIcon.svg

@@ -6,6 +6,7 @@ import com.payone.pcp_client_android_sdk.cctokenizer.CardNumberErrors
 import com.payone.pcp_client_android_sdk.cctokenizer.CardholderNameErrors
 import com.payone.pcp_client_android_sdk.cctokenizer.CreditcardTokenizerConfig
 import com.payone.pcp_client_android_sdk.cctokenizer.CreditcardTokenizerFragment
+import com.payone.pcp_client_android_sdk.cctokenizer.CustomIconsConfig
 import com.payone.pcp_client_android_sdk.cctokenizer.ExpiryDateErrors
 import com.payone.pcp_client_android_sdk.cctokenizer.IframeConfig
 import com.payone.pcp_client_android_sdk.cctokenizer.LocaleTextAriaLabels
@@ -145,6 +146,12 @@ class CCTokenizerActivity : BaseActivity() {
         mode = "test",
         token = token,
         customTextConfig = customTextConfig,
+        customIconsConfig = CustomIconsConfig(
+            useCustomValidationIcons = true,
+            showCardBrandIcons = false,
+            successIcon = "/validIcon.svg",
+            errorIcon = "/invalidIcon.svg"
+        ),
         tokenizationSuccessCallback = { statusCode, token, cardDetails, inputMode ->
             android.util.Log.d("CC Success", "Tokenized card successfully")
             android.util.Log.d("CC Success", "Status: $statusCode")

app/src/main/assets/validIcon.svg

@@ -1,6 +1,6 @@
 [versions]
 agp = "8.4.2"
-kotlin = "2.2.0"
+kotlin = "2.3.0"
 compose-plugin = "1.8.2"
 coreKtx = "1.13.1"
 junit = "4.13.2"

app/src/main/java/com/payone/pcpclientandroiddemo/CCTokenizerActivity.kt

@@ -4,7 +4,7 @@ plugins {
     alias(libs.plugins.android.library)
     alias(libs.plugins.jetbrains.kotlin.android)
     alias(libs.plugins.sonar)
-    kotlin("plugin.serialization") version "2.1.0"
+    kotlin("plugin.serialization") version libs.versions.kotlin.get()
     alias(libs.plugins.maven.publish)
 }
 
@@ -32,8 +32,10 @@ android {
         sourceCompatibility = JavaVersion.VERSION_1_8
         targetCompatibility = JavaVersion.VERSION_1_8
     }
-    kotlinOptions {
-        jvmTarget = "1.8"
+    kotlin {
+        compilerOptions {
+            jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8)
+        }
     }
 }
 
@@ -46,6 +48,8 @@ dependencies {
     implementation(libs.kotlinx.serialization)
     testImplementation(libs.junit)
     testImplementation(libs.mockito.core)
+    testImplementation("org.robolectric:robolectric:4.11.1")
+    testImplementation("androidx.test:core:1.5.0")
     androidTestImplementation(libs.mockito.android)
     androidTestImplementation(libs.androidx.junit)
     androidTestImplementation(libs.androidx.runner)
@@ -58,7 +62,7 @@ mavenPublishing {
 
     signAllPublications()
 
-    coordinates("io.github.payone-gmbh", "pcp-client-android-sdk", "1.3.0")
+    coordinates("io.github.payone-gmbh", "pcp-client-android-sdk", "1.4.0")
 
     pom {
         name.set("PCP-CLIENT-SDK-ANDROID")