PHPackages sumup/sumup-ecom-php-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. sumup/sumup-ecom-php-sdk ActiveLibrary[Payment Processing](/categories/payments) sumup/sumup-ecom-php-sdk ======================== SumUp PHP SDK 1.4.0(6mo ago)51277.1k↓18.3%25[13 issues](https://github.com/sumup/sumup-ecom-php-sdk/issues)[3 PRs](https://github.com/sumup/sumup-ecom-php-sdk/pulls)1Apache-2.0PHPPHP ^5.6|^7.0|^8.0CI passing Since Jan 14Pushed 2mo ago11 watchersCompare [ Source](https://github.com/sumup/sumup-ecom-php-sdk)[ Packagist](https://packagist.org/packages/sumup/sumup-ecom-php-sdk)[ Docs](https://developer.sumup.com)[ RSS](/packages/sumup-sumup-ecom-php-sdk/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (9)Dependencies (2)Versions (22)Used By (1) SumUp Ecommerce PHP SDK ======================= [](#sumup-ecommerce-php-sdk) [![Stars](https://camo.githubusercontent.com/56dfae12efc7aaaed361ef0d009eff2b246b69804b383ac764baff0f0f186f3c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f73756d75702f73756d75702d65636f6d2d7068702d73646b3f7374796c653d736f6369616c)](https://github.com/sumup/sumup-go/)[![Latest Stable Version](https://camo.githubusercontent.com/c819846c843471d66ec93ee1e1f7a2d647d834b4f871914bd383b2ad8be13317/68747470733a2f2f706f7365722e707567782e6f72672f73756d75702f73756d75702d65636f6d2d7068702d73646b2f762f737461626c652e737667)](https://packagist.org/packages/sumup/sumup-ecom-php-sdk)[![Total Downloads](https://camo.githubusercontent.com/01d465a3a1c5b2a068b441051cb6d5e02e59f7bcf99760ff1f8224cd9d922447/68747470733a2f2f706f7365722e707567782e6f72672f73756d75702f73756d75702d65636f6d2d7068702d73646b2f646f776e6c6f6164732e737667)](https://packagist.org/packages/sumup/sumup-ecom-php-sdk)[![License](https://camo.githubusercontent.com/6cfa10a2ec0a137773ea0e83524fba8840cf029c0e029e92da335f39dfa6947b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73756d75702f73756d75702d676f)](./LICENSE)[![Contributor Covenant](https://camo.githubusercontent.com/b9aeaca087579cf993753d79790e77a39229cdd72876bae3f8139d9e4f407999/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e7472696275746f72253230436f76656e616e742d76322e3125323061646f707465642d6666363962342e737667)](https://github.com/sumup/sumup-go/tree/main/CODE_OF_CONDUCT.md) Important `sumup-ecom-php-sdk` is deprecated in favor of our newer [sumup-php](https://github.com/sumup/sumup-php) SDK. Overview -------- [](#overview) This repository contains the open source PHP SDK that allows you to integrate quickly with the SumUp's [API](https://developer.sumup.com/rest-api) endpoints. Installation ------------ [](#installation) The SumUp eCom PHP SDK can be installed with [Composer](https://getcomposer.org/). Run the following command: ``` composer require sumup/sumup-ecom-php-sdk ``` Basic usage ----------- [](#basic-usage) ``` try { $sumup = new \SumUp\SumUp([ 'app_id' => 'YOUR-CLIENT-ID', 'app_secret' => 'YOUR-CLIENT-SECRET', 'code' => 'YOUR-AUTHORIZATION-CODE' ]); $checkoutService = $sumup->getCheckoutService(); $merchantCode = 'YOUR-MERCHANT-CODE'; $checkoutResponse = $checkoutService->create($amount, $currency, $checkoutRef, $merchantCode); $checkoutId = $checkoutResponse->getBody()->id; // pass the $chekoutId to the front-end to be processed } catch (\SumUp\Exceptions\SumUpAuthenticationException $e) { echo 'Authentication error: ' . $e->getMessage(); } catch (\SumUp\Exceptions\SumUpResponseException $e) { echo 'Response error: ' . $e->getMessage(); } catch(\SumUp\Exceptions\SumUpSDKException $e) { echo 'SumUp SDK error: ' . $e->getMessage(); } ``` ### TLS certificates [](#tls-certificates) The SDK now ships with the latest Mozilla CA bundle to prevent `SSL certificate problem: unable to get local issuer certificate` errors on Windows and other environments that do not expose a system-wide trust store. You can override the bundled file by passing the `ca_bundle_path` configuration key: ``` $sumup = new \SumUp\SumUp([ 'app_id' => 'YOUR-CLIENT-ID', 'app_secret' => 'YOUR-CLIENT-SECRET', 'code' => 'YOUR-AUTHORIZATION-CODE', 'ca_bundle_path' => __DIR__ . '/storage/certs/company-ca.pem', ]); ``` If not provided, the bundled `resources/ca-bundle.crt` file is used automatically by both the cURL and Guzzle HTTP clients. API Reference ------------- [](#api-reference) For a full list of classes, see the [API reference page](https://github.com/sumup/sumup-ecom-php-sdk/tree/master/docs). FAQ --- [](#faq) - [How to authorize?](https://github.com/sumup/sumup-ecom-php-sdk/blob/master/docs/HowToAuthorize.md) - [How to handle exceptions?](https://github.com/sumup/sumup-ecom-php-sdk/blob/master/docs/ExceptionsHandling.md) - [How to use my own HTTP client?](https://github.com/sumup/sumup-ecom-php-sdk/blob/master/docs/HowToOverrideHttpClient.md) Roadmap ------- [](#roadmap) VersionStatusPHP Version1.xLatest>= 5.6License ------- [](#license) For information about the license see the [license](https://github.com/sumup/sumup-ecom-php-sdk/blob/master/LICENSE.md) file. Contact us ---------- [](#contact-us) If you have found a bug or you lack some functionality please [open an issue](https://github.com/sumup/sumup-ecom-php-sdk/issues/new). If you have other issues when integrating with SumUp's API you can send an email to . ### Health Score 60 — FairBetter than 99% of packages Maintenance74 Regular maintenance activity Popularity49 Moderate usage in the ecosystem Community26 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~311 days Recently: every ~567 days Total 9 Last Release 187d ago PHP version history (2 changes)1.0.0-rcPHP ^5.6|^7.0 1.1.0PHP ^5.6|^7.0|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/589d21db2c2c967e27550fa21e8b238e7fc0ce1bb6debaf171eade7047514d2d?d=identicon)[matoous](/maintainers/matoous) ![](https://www.gravatar.com/avatar/63459340397a82507555cbb98ad2ac8cbcab09301388b647eab5b75f969a2445?d=identicon)[sumup](/maintainers/sumup) --- Top Contributors [![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 commits)")[![matoous](https://avatars.githubusercontent.com/u/15747583?v=4)](https://github.com/matoous "matoous (17 commits)")[![lyubomir-sumup](https://avatars.githubusercontent.com/u/39481092?v=4)](https://github.com/lyubomir-sumup "lyubomir-sumup (8 commits)")[![avoitovych](https://avatars.githubusercontent.com/u/67743270?v=4)](https://github.com/avoitovych "avoitovych (2 commits)")[![vendra95](https://avatars.githubusercontent.com/u/24313233?v=4)](https://github.com/vendra95 "vendra95 (1 commits)")[![gartner](https://avatars.githubusercontent.com/u/195601?v=4)](https://github.com/gartner "gartner (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")[![joelrose](https://avatars.githubusercontent.com/u/14079302?v=4)](https://github.com/joelrose "joelrose (1 commits)") --- Tags phpsdksumupsdkpayment processingpaymentecommercecheckoutsumup ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/sumup-sumup-ecom-php-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/sumup-sumup-ecom-php-sdk/health.svg)](https://phpackages.com/packages/sumup-sumup-ecom-php-sdk) ``` ### Alternatives [liqpay/liqpay SDK for Liqpay 111678.8k9](/packages/liqpay-liqpay)[cybersource/rest-client-php Client SDK for CyberSource REST APIs 39881.3k6](/packages/cybersource-rest-client-php)[sebdesign/laravel-viva-payments A Laravel package for integrating the Viva Payments gateway 4845.9k](/packages/sebdesign-laravel-viva-payments) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)