Release 7.0.0

Author: HeyPouya

CHANGELOG.md

@@ -1,8 +1,18 @@
 # Changelog
 
 For more information, see the [README](https://github.com/sumup/Android-MerchantSDK/blob/master/README.md)
+## Version 7.0.0
+* [ADDED] `successScreenTimeout` in the payment builder to configure the duration of the success screen.
+* [ADDED] `getSavedCardReaderDetails()` to retrieve details of the saved card reader (serial number, type, and battery percentage).
+* [ADDED] `isCardReaderConnected()` to check if a card reader is currently connected.
+* [IMPROVEMENT] Offline transaction V2
+    * Changes the API and behavior about how offline transactions work.
+    * Explicit APIs to start and stop the offline session.
+    * Removal of Security Patch Validity API.
+    * [OFFLINE_PAYMENTS_V2.md](https://github.com/sumup/sumup-android-sdk/blob/master/OFFLINE_PAYMENTS_V2.md) for more information.
+
 ## Version 6.0.0
-* [ADDED] Introduces Offline payments with Solo lite, please refer to the dedicated section in [OFFLINE_PAYMENTS.md](https://github.com/sumup/sumup-android-sdk/blob/master/OFFLINE_PAYMENTS.md) for more information.
+* [ADDED] Introduces Offline payments with Solo lite, please refer to the dedicated section in [OFFLINE_PAYMENTS_V1.md](https://github.com/sumup/sumup-android-sdk/blob/master/OFFLINE_PAYMENTS.md) for more information.
     * Please contact integrations@sumup.com for enabling offline payments on your SumUp merchant account.
 * [ADDED] Payment intent now also returns the card reader model and firmware version in new response fields `SumUpAPI.Response.CARD_READER_MODEL` and `SumUpAPI.Response.CARD_READER_FIRMWARE_VERSION` at the end of every transaction.
 * [IMPROVEMENT] Updates about the technical stack:

OFFLINE_PAYMENTS.md OFFLINE_PAYMENTS_V1.mdOFFLINE_PAYMENTS.md renamed to OFFLINE_PAYMENTS_V1.md

@@ -3,7 +3,7 @@
 # SumUp Android SDK
 
 [![Platform](https://img.shields.io/badge/Platform-Android-brightgreen.svg)](http://developer.android.com/index.html)
-[![API](https://img.shields.io/badge/API-16%2B-orange.svg)](https://developer.android.com/about/versions/android-4.1.html)
+[![API](https://img.shields.io/badge/API-26%2B-orange.svg)](https://developer.android.com/about/versions/oreo/android-8.0)
 [![Documentation][docs-badge]](https://developer.sumup.com)
 [![License](https://img.shields.io/github/license/sumup/sumup-android-sdk)](./LICENSE)
 
@@ -22,7 +22,7 @@ For more information about SumUp developer products, please refer to <a href="ht
 3. Created an Affiliate Key in [SumUp Dashboard](https://developer.sumup.com/terminal-payments/sdks/android-sdk)
 4. SumUp SDK requires `minSdkVersion` 26 or later
 5. SumUp SDK ensures support for
-   - `targetSDK` 35 or later
+   - `targetSDK` 35
    - AGP 8.8.0 or later
    - Kotlin version 1.9.0 or later
    - Java 17 and later 
@@ -52,7 +52,7 @@ allprojects {
 Add the dependency to a module:
 
 ```groovy
-implementation 'com.sumup:merchant-sdk:6.0.0'
+implementation 'com.sumup:merchant-sdk:7.0.0'
 ```
 
 
@@ -107,6 +107,8 @@ Once logged in, you can start using the SumUp SDK to accept card payments. If no
             .foreignTransactionId(UUID.randomUUID().toString())  // can not exceed 128 chars
 	    // optional: skip the success screen
 	    .skipSuccessScreen()
+        // optional: time out for the success screen
+        .successScreenTimeout(3)
 	    // optional: skip the failed screen
             .skipFailedScreen()
             .build();
@@ -125,7 +127,7 @@ Once logged in, you can start using the SumUp SDK to accept card payments. If no
 ```
 
 ### 6. Offline payments
-* For offline payments support, please refer to the [Offline payments](https://github.com/sumup/sumup-android-sdk/blob/master/OFFLINE_PAYMENTS.md) documentation.
+* For offline payments support, please refer to the [Offline payments](https://github.com/sumup/sumup-android-sdk/blob/master/OFFLINE_PAYMENTS_V2.md) documentation.
 
 ## II. Additional features
 
@@ -247,6 +249,9 @@ If there are connectivity issues and the transaction status can not be retrieved
 The `foreignTransactionID` identifier will be associated with the transaction and can be used to retrieve details related to the transaction. See [API documentation](https://developer.sumup.com/rest-api/#tag/Transactions) for details. Please make sure that this ID is unique within the scope of the SumUp merchant account and sub-accounts. It must not be longer than 128 characters.
 The foreignTransactionID is available when the callback activity is called: `SumUpAPI.Param.FOREIGN_TRANSACTION_ID`
 
+#### Timeout on success screen
+Use `.successScreenTimeout(int seconds)` to configure the success screen duration (must be > 0), which automatically dismisses the screen after the specified time if the user has not closed it manually.
+
 #### Skip success screen
 To skip the success screen shown at the end of a successful transaction, the `skipSuccessScreen` parameter can be used. When using this parameter  your application is responsible for displaying the transaction result to the customer. In combination with the Receipts API your application can also send your own receipts, see [API documentation](https://developer.sumup.com/rest-api/#tag/Receipts) for details. Please note success screens will still be shown when using the SumUp Air Lite readers.
 
@@ -278,13 +283,31 @@ If a merchant account is currently logged in, it is possible to retrieve the dat
 	}
 ```
 
-### 7. Log out SumUp account
+### 7. Retrieve connected card reader's data
+
+You can use the following methods to check the connection status and retrieve details about the saved card reader:
+
+*   **`isCardReaderConnected()`**: Returns a `boolean` indicating if a card reader is currently connected.
+*   **`getSavedCardReaderDetails()`**: Returns an object containing the reader's serial number, type, and last known battery percentage.
+
+#### Supported Reader Types
+The reader type will be one of the following constants:
+*   `SOLO`
+*   `SOLO_LITE`
+*   `AIR`
+*   `THREE_G`
+*   `PIN_PLUS`
+*   `UNKNOWN` (Returned only if the SDK encounters an issue and cannot identify the reader type)
+
+> **Note on Battery Level:** The `lastKnownBatteryPercentage` is **not** real-time. It reflects the battery level recorded during the last transaction performed. As a result, this value is an approximation and may not match the current battery level exactly if the reader has been idle or charged since the last payment.
+
+### 8. Log out SumUp account
  ```java
  	SumUpAPI.logout();
  ```
 
 
-### 8. Enable ProGuard
+### 9. Enable ProGuard
 ```groovy
    buildTypes {
         release {
@@ -295,7 +318,7 @@ If a merchant account is currently logged in, it is possible to retrieve the dat
     }
 ```
 
-### 9. Use Google Location Services
+### 10. Use Google Location Services
        
 The SDK supports Google Location Services, to improve location accuracy and reduce power consumption.
 

OFFLINE_PAYMENTS_V2.md

@@ -2,14 +2,14 @@ apply plugin: 'com.android.application'
 
 android {
     namespace "com.sumup.sdksampleapp"
-    compileSdkVersion 35
+    compileSdk 35
 
     defaultConfig {
         applicationId "com.sumup.sdksampleapp"
         minSdkVersion 26
         targetSdkVersion 35
         versionCode 1
-        versionName "6.0.0"
+        versionName "7.0.0"
     }
 
     packagingOptions {
@@ -36,7 +36,7 @@ android {
 dependencies {
     implementation 'com.google.android.gms:play-services-location:21.3.0'
 
-    implementation 'com.sumup:merchant-sdk:6.0.0'
+    implementation 'com.sumup:merchant-sdk:7.0.0'
 
     coreLibraryDesugaring "com.android.tools:desugar_jdk_libs:2.1.5"
 }

README.md

@@ -14,7 +14,7 @@
 import com.sumup.merchant.reader.api.SumUpAPI;
 import com.sumup.merchant.reader.api.SumUpLogin;
 import com.sumup.merchant.reader.api.SumUpPayment;
-import com.sumup.merchant.reader.offline.OfflineSessionResult;
+import com.sumup.merchant.reader.offline.OfflineSessionState;
 import com.sumup.merchant.reader.offline.OfflineUploadFailureReasons;
 import com.sumup.merchant.reader.offline.callbacks.OfflineSessionCallback;
 import com.sumup.merchant.reader.offline.callbacks.SecurityPatchUpdateCallback;
@@ -88,7 +88,6 @@ public void onClick(View v) {
                         .configureRetryPolicy(2000, 60000, true)
                         // optional: foreign transaction ID, must be unique!
                         .foreignTransactionId(UUID.randomUUID().toString()) // can not exceed 128 chars
-                        .optInOfflinePayments()
                         .build();
 
                 SumUpAPI.checkout(MainActivity.this, payment, REQUEST_CODE_PAYMENT);
@@ -182,11 +181,11 @@ public void run() {
             public void onClick(View v) {
                 SumUpAPI.fetchCurrentOfflineSession(new OfflineSessionCallback() {
                     @Override
-                    public void onSessionInfoReceived(@NonNull OfflineSessionResult offlineSessionResult) {
+                    public void onSessionInfoReceived(@NonNull OfflineSessionState offlineSessionState) {
                         runOnUiThread(new Runnable() {
                             @Override
                             public void run() {
-                                mOfflineSessionInfo.setText(offlineSessionResult.toString());
+                                mOfflineSessionInfo.setText(offlineSessionState.toString());
                             }
                         });
 

app/build.gradle

@@ -2,20 +2,18 @@
 
 buildscript {
     repositories {
-        jcenter()
+        mavenCentral()
         google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.8.0'
+        classpath 'com.android.tools.build:gradle:8.8.2'
     }
 }
 
 allprojects {
     repositories {
         google()
         mavenCentral()
-
         maven { url 'https://maven.sumup.com/releases' }
-        jcenter()
     }
 }

app/src/main/java/com/sumup/sdksampleapp/MainActivity.java

@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.4-bin.zip