Changelog

Thank you, we'll let you know when we update our APIs.

There was an issue subscribe to the news, please try again later.

This email seems to be invalid, please use a valid email address.

2025-11-17

Deprecation of Trailing Slashes in URLs

Today we are announcing the deprecation of support for API requests that include a trailing slash at the end of the URL. While our documentation has never endorsed this pattern, we identified a small number of clients still relying on it. To ensure a smooth transition, a 2-month grace period will apply before the behavior is fully removed.

Details

Requests using URLs that end with / (e.g., /v0.1/checkouts/) will continue to work during the grace period.
After the grace period ends, these requests will return an error.
Standard, documented URLs without trailing slashes (e.g., /v0.1/checkouts ) remain fully supported.

Timeline

Deprecation announcement: 17.11.2025
Grace period: 2 months
Removal date: 17.01.2026

Required Action

Please consult the API documentation and update any API calls that include a trailing slash. This change typically only requires removing the final / in affected endpoints.

If you run into issues or need help identifying affected requests, please contact our support team.

2025-11-03

Android SDK 6.0.0

Android SDK 6.0.0 has been released.

Offline payments

Introduces Offline payments with Solo lite, please refer to the dedicated section in 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.

Improvements:

Renames package of TransactionInfo: com.sumup.merchant.reader.models.TransactionInfo > com.sumup.checkout.core.models.TransactionInfo
Renames package of SumUpState: import com.sumup.merchant.api.SumUpState > import com.sumup.reader.sdk.api.SumUpState
Miscellaneous bug fixes and enhancements.

Updates about the technical stack:

Minimum supported targetSDK is 35
Minimum Kotlin is upgraded to 1.9.0
Minimum Kotlin Coroutine is upgraded to 1.8.0
Minimum Hilt is upgraded to 2.51.1
Minimum Moshi is upgraded to 1.15.0
Minimum AppCompat is upgraded to 1.7.0
Minimum AndroidX Annotation is upgraded to version 1.8.0
Minimum AndroidX Activity is upgraded to version 1.9.1
Minimum AndroidX Fragment is upgraded to version 1.7.1
Minimum AndroidX Lifecycle is upgraded to version 2.8.1
Minimum AndroidX Browser is upgraded to version 1.4.0
Minimum AndroidX Navigation is upgraded to version 2.7.7
Minimum Material Components is upgraded to 1.12.0
Minimum Play Services Location is upgraded to 21.3.0- Minimum AGP is upgraded to 8.8.0
Building with AGP 8.8.0 and Java 17
Introduces Jetpack Compose BOM version 2023.06.01
Requires desugar_jdk_libs version 2.1.5

2025-10-21

Android Tap-to-Pay 1.0.1

Fixes

Decreased the SDK size by removing unused resources.
Fixed an issue where the testing SDK build would not initialize.

2025-10-13

Rust SDK

We are happy to announce the release of our Rust SDK. The SDK is maintained under sumup/sumup-rs and covers all of SumUp’s public APIs. For full documentation, see https://docs.rs/sumup.

1
use sumup::Client;
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let client = Client::default();
6

7
    let merchant_code = std::env::var("SUMUP_MERCHANT_CODE")
8
        .expect("SUMUP_MERCHANT_CODE environment variable must be set");
9

10
    let readers = client
11
        .readers()
12
        .list(&merchant_code)
13
        .await
14
        .expect("couldn't list merchant's readers");
15

16
    let reader = readers
17
        .items
18
        .first()
19
        .expect("merchant doesn't have any paired card readers");
20

21
    let checkout_reference = format!("checkout-{}", uuid::Uuid::new_v4());
22

23
    println!("Creating checkout with reference: {}", checkout_reference);
24

25
    match client
26
        .readers()
27
        .create_checkout(
28
            &merchant_code,
29
            &reader.id,
30
            sumup::CreateReaderCheckoutRequest {
31
                total_amount: sumup::Money {
32
                    currency: "EUR".into(),
33
                    minor_unit: 2,
34
                    value: 1000,
35
                },
36
                affiliate: None,
37
                card_type: None,
38
                description: Some("sumup-rs card reader checkout example".into()),
39
                installments: None,
40
                return_url: None,
41
                tip_rates: None,
42
                tip_timeout: None,
43
            },
44
        )
45
        .await
46
    {
47
        Ok(_) => {
48
            println!("✓ Checkout created successfully!");
49
        }
50
        Err(e) => {
51
            eprintln!("✗ Failed to create checkout: {}", e);
52
        }
53
    }
54

55
    Ok(())
56
}

See the repository for more examples and don’t hesitate to let us know if you have any questions.

SDK
Rust

2025-10-02

Android Tap-to-Pay 1.0.0

New Features

Added support of Online Pin SCA (Strong Customer Authentication).
Added card data to PaymentEvent.TransactionDone event: card type, card scheme, last four digits, and merchant code.
Transparent attestation process. The SDK now returns error details if attestation fails in PaymentEvent.TransactionFailed event. This helps developers understand and resolve attestation issues more effectively.
API changes to make it more concise. Now TapToPay.startPayment() function returns Flow<PaymentEvent> instead of Flow<Result<PaymentEvent>>.

2025-09-09

Android Tap-to-Pay 0.18.0

New Features

Added Products to TapToPay.startPayment method.
Enabled periodic monitoring and attestation.
Now SDK uses Google Trusted Time API.

2025-08-26

Android Tap-to-Pay 0.17.4

Fixes

Fixed a crash that occurred when attempting to make a payment without explicitly setting skipSuccessScreen parameter.
Fixed a bug in Pixel 8 and Pixel 9 devices with Android 16 where the payment would immediately fail a transaction with timeout error.

2025-08-15

Android Tap-to-Pay 0.17.3

Fixes

Fixed a bug with payment availability when using OkHttp 5.0.0 or higher.

2025-08-02

Python SDK

We are happy to announce the release of our Python SDK. The SDK is maintained under sumup/sumup-py and covers all of SumUp’s public APIs. sumup-py support both synchronous and asynchronous calling convention.

1
import os
2
import asyncio
3

4
from sumup import AsyncSumup
5
from sumup.readers.resource import CreateReaderCheckoutBody, CreateReaderCheckoutBodyTotalAmount
6

7

8
async def main():
9
    client = AsyncSumup()
10
    merchant_code = os.environ["SUMUP_MERCHANT_CODE"]
11

12
    readers = await client.readers.list(merchant_code)
13
    reader = readers.items[0]
14

15
    checkout = await client.readers().create_checkout(
16
        merchant_code,
17
        reader.id,
18
        CreateReaderCheckoutBody(
19
            total_amount=CreateReaderCheckoutBodyTotalAmount(
20
                currency="EUR",
21
                minor_unit=2,
22
                value=1000,
23
            ),
24
            description="sumup-py card reader checkout example",
25
        ),
26
    )
27

28
    print(checkout)
29

30

31
if __name__ == "__main__":
32
    asyncio.run(main())

See the repository for more examples and don’t hesitate to let us know if you have any questions.

SDK
Python

2025-07-17

Android Tap-to-Pay 0.17.2

Fixes

Miscellaneous bug and crash fixes

2025-07-15

Android Tap-to-Pay 0.17.1

Fixes

NoBeanFoundDefinitionError exception that occurred in some cases when starting a payment
Miscellaneous bug and crash fixes

2025-07-02

Android Tap-to-Pay 0.17.0

New Features

Faster Transactions – Reduced latency when initiating transactions, resulting in faster checkout.
Mitigated Threats Filter – Attestation now excludes resolved threats for smoother processing and less transaction failures.
Affiliate Key Support – Added support for affiliate key integration.
Success Screen Skip Flag – New flag to bypass the success screen.
Support for targetSDK 35
Client-Side Certificate Verification – Enhanced security with device certificate checks during attestation.
Pre-PIN Attestation – Attestation is initiated before displaying the PIN screen to enhance security.

Fixes

Resolved an issue during TapToPay initialization.

2025-06-22

TypeScript / JavaScript SDK

We are happy to announce the release of our TypeScript / JavaScript SDK. The SDK is maintained under sumup/sumup-ts and covers all of SumUp’s public APIs.

The SDK provides easy access to SumUp APIs:

1
import SumUp from "@sumup/sdk";
2

3
const client = new SumUp({
4
  apiKey: process.env.SUMUP_API_KEY,
5
});
6

7
async function main() {
8
  const merchantCode = process.env.SUMUP_MERCHANT_CODE;
9
  if (!merchantCode) {
10
    console.warn(
11
      "Missing merchant code, please specify merchant code using SUMUP_MERCHANT_CODE env variable.",
12
    );
13
    return;
14
  }
15

16
  const { items: readers } = await client.readers.list(merchantCode);
17
  if (!readers.length) {
18
    console.warn("No readers found, please pair a card reader first.");
19
    return;
20
  }
21

22
  const reader = readers[0];
23

24
  const checkout = client.readers.createCheckout(merchantCode, reader.id, {
25
    total_amount: {
26
      // Must match the currency of your merchant account
27
      currency: "EUR",
28
      minor_unit: 100,
29
      value: 500,
30
    },
31
  });
32

33
  console.info({ checkout });
34
}
35

36
main();

See the repository for more examples and don’t hesitate to let us know if you have any questions.

SDK
Node.js

2025-06-11

Android Tap-to-Pay 0.15.2

Fixes

Fixed the class duplication issue occurring after obfuscation.

2025-06-11

Android Tap-to-Pay 0.15.2

Fixes

Mitigated threats are now filtered out during attestation. If a threat has "mitigated": true, it is excluded from the threat list that is used to determine whether the COTS is attested.

2025-04-09

Android Tap-to-Pay 0.15.0

New Features

New events of the payment process: card requested, card presented, CVM requested, CVM presented - New PaymentException types

Fixes

Cleanup PAN data from memory
Disable NFC for other apps during the payment process. - Handling empty candidates list in payment processing

2023-11-27

Go SDK

We are happy to announce the beta release of our Go SDK. The SDK is maintained under sumup/sumup-go with its acompanying documentation at pkg.go.dev.

The Go SDK provides easy access to SumUp APIs:

1
package main
2

3
import (
4
  "context"
5
  "log"
6
  "os"
7

8
  "github.com/sumup/sumup-go"
9
)
10

11
func main() {
12
  ctx := context.Background()
13
  client := sumup.NewClient().WithAuth(os.Getenv("SUMUP_KEY"))
14

15
  checkout, err := client.Checkouts.Create(ctx, sumup.CreateCheckoutBody{
16
    Amount:            123,
17
    CheckoutReference: "TX000001",
18
    Currency:          "EUR",
19
    MerchantCode:      "MK0001",
20
  })
21
  if err != nil {
22
    log.Printf("[ERROR] create checkout: %v", err)
23
    return
24
  }
25

26
  log.Printf("[INFO] checkout created: id=%q, amount=%v, currency=%q", *checkout.Id, *checkout.Amount, string(*checkout.Currency))
27

28
  checkoutSuccess, err := client.Checkouts.Process(ctx, *checkout.Id, sumup.ProcessCheckoutBody{
29
    Card: &sumup.Card{
30
      Cvv:         "123",
31
      ExpiryMonth: "12",
32
      ExpiryYear:  "2023",
33
      Name:        "Boaty McBoatface",
34
      Number:      "4200000000000042",
35
    },
36
    PaymentType: sumup.ProcessCheckoutBodyPaymentTypeCard,
37
  })
38
  if err != nil {
39
    log.Printf("[ERROR] process checkout: %v", err)
40
    return
41
  }
42

43
  log.Printf("[INFO] checkout processed: id=%q, transaction_id=%q", *checkoutSuccess.Id, string(*(*checkoutSuccess.Transactions)[0].Id))
44
}

See the repository for more examples and don’t hesitate to let us know if you have any questions.

2023-09-20

Android SDK 4.3.0

Android SDK 4.3.0 has been released.

Solo USB (Beta)

The Solo card reader now supports connecting and transacting over USB cable. The minimum required Solo software version that supports the USB mode is 3.3.17.2.

If this version (3.3.17.2) is not yet available on your Solo when connected via Bluetooth, you can switch it to standalone mode (Menu -> Connection -> WiFi), login directly on the Solo, and update it to the latest version.

Solo USB is under beta phase which means that the feature still requires some optimization to ensure full stability.

Known limitations: currently, if the USB cable is unplugged, the USB permission on the mobile device will need to be regranted. As of now, Solo is not able to wake up automatically from sleep mode. A connection needs to be reestablished from

Removed:

Dropping support for Android 7 (API 25) and below

2023-09-12

WooCommerce Plugin Update

New features:

Accept payments with alternative payment methods (Follow guides for enabling in your account)
Accept card payments with installments in BR.
Accept payments with Apple Pay.
Support for WooCommerce stock management feature
New user experience configuration: merchant can choose to open the payment option in a pop-up instead of the checkout page.

Improvements:

Easier reconciliation of orders between WooCommerce and SumUp dashboard:
Display WooCommerce order Id on SumUp Sales History.
Added transaction code to order description on WooCommerce
Added checkout_id in order notes to improve customer support
New settings screen for easier setup
Multiple code maintenance improvements.
Support for Wordpress 6.3
Require PHP version 7.2 or greater.

Bugs fixed:

Errors during checkout that caused duplicated payment.
Issues loading payment methods on checkout.
Fixed issue with customer creation during checkout that caused duplicated payment.