Skip to content
SumUp Developer

Breaking change Changelog

Go SDK flat structure refactor

We have refactored the Go SDK into a flat package structure to simplify imports and make the public API easier to discover. This is a breaking change.

What Changed

  • Types and services previously nested under subpackages are now exported directly from github.com/sumup/sumup-go.
  • Import paths that referenced nested modules need to be updated.

Migration

Update your imports and type references to use the root package. For example:

// Before
import "github.com/sumup/sumup-go/checkouts"


// After
import "github.com/sumup/sumup-go"

If you run into issues, please open a ticket or let us know.

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.