v1.4.0

1.4.0 (2025-11-12)

1.4.0 brings fixes to multiple reported (albeit old) GitHub issues, including but not limited to TLS support on platforms without system-wide support, updates to the documentation, and more.

There's single breaking change: pay_to_email is deprecated and was removed from the SDK. Please use merchant_code to when initiating checkouts.

Features

• add support for api keys (#56) (f5ef00a)
• add user-agent with SDK version string (#69) (9143957)
• cd: add release please setup (#71) (f681dd4)
• setup tests (#68) (59922b6)

Bug Fixes

• 40: Separator has to be first (#41) (fb5f538)
• bundle tls certificates for platforms without system-wide trust store (#66) (3573738)
• utils: fail gracefully if composer.json can't be parsed (#65) (3324d69)
• version in composer.json (#70) (524b21b)

Miscellaneous Chores

• checkouts: replace pay_to_email with the use of merchant_code (#58) (7c6ca69)
• deprecate pay_to_email (#67) (f279890)
• deps: bump actions/checkout from 4.2.2 to 5.0.0 (#59) (a7b4a97)
• deps: bump reviewdog/action-actionlint from 1.65.0 to 1.65.2 (#54) (2af99fe)
• deps: bump reviewdog/action-actionlint from 1.65.2 to 1.68.0 (#63) (6291a02)
• improve error parsing in client (#64) (790a68c)

1.3.0

Minor release, focusing on community files, CI/CD, and linting. Also introduces new findByForeignId function to lookup transactions by foreign transaction id.

What's Changed

• added findByForeignId by @vendra95 in #37
• feat(docs): update community files by @matoous in #49
• feat(tooling): setup formatting with php-cs-fixer by @matoous in #50
• chore: remove duplicate license file by @matoous in #51
• feat(ci): notify on release by @matoous in #53
• Bump reviewdog/action-actionlint from 1.64.1 to 1.65.0 by @dependabot in #52

New Contributors

• @vendra95 made their first contribution in #37
• @matoous made their first contribution in #49
• @dependabot made their first contribution in #52

Full Changelog: 1.2.0...1.3.0

Introduction of redirect_url field of a Checkout

This release introduces a possibility to create a Checkout with the redirect_url field specified. This field defines where a payer to be taken after completing external actions required to complete a payment, such as 3DS authentication.

v1.1.0

• Add PHP 8 Support

v1.0.2

• Fix bug about a problem with autoloader for error Class 'SumUp\Utils\ExceptionMessages' not found
• Fix typos in example code in HowToAuthorize.md
• Add Contributing.md file

v1.0.1

• Improved error handling
• Improved navigation in the documentation

v1.0.0

This is the first stable release of the SumUp's PHP SDK that includes functionality to call every endpoint of its API.

Second Release Candidate

• Improved documentation
• Code optimizations
• Introduce custom service

First Release Candidate

This release contains the basic functionality and documentation needed to integrate with SumUp's API.