sumup · matoous · Mar 11, 2026 · Mar 11, 2026 · Mar 11, 2026
diff --git a/openapi.json b/openapi.json
diff --git a/src/Checkouts/Checkouts.php b/src/Checkouts/Checkouts.php
@@ -46,7 +46,7 @@ class CheckoutsListParams
 class CheckoutsListAvailablePaymentMethodsParams
 {
     /**
-     * The amount for which the payment methods should be eligible, in major units. Note that currency must also be provided when filtering by amount.
+     * The amount for which the payment methods should be eligible, in major units.
      *
      * @var float|null
      */
@@ -121,7 +121,7 @@ public function create(\SumUp\Types\CheckoutCreateRequest|array $body, ?RequestO
             '201' => ['type' => 'class', 'class' => \SumUp\Types\Checkout::class],
         ], [
             '400' => ['type' => 'class', 'class' => \SumUp\Types\ErrorExtended::class],
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '403' => ['type' => 'class', 'class' => \SumUp\Types\ErrorForbidden::class],
             '409' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'POST', $path);
@@ -150,7 +150,7 @@ public function deactivate(string $id, ?RequestOptions $requestOptions = null):
         $response = $this->client->send('DELETE', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\Checkout::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
             '409' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'DELETE', $path);
@@ -179,7 +179,7 @@ public function get(string $id, ?RequestOptions $requestOptions = null): \SumUp\
         $response = $this->client->send('GET', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\CheckoutSuccess::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'GET', $path);
     }
@@ -221,7 +221,7 @@ public function list(?CheckoutsListParams $queryParams = null, ?RequestOptions $
         return ResponseDecoder::decodeOrThrow($response, [
             '200' => ['type' => 'array', 'items' => ['type' => 'class', 'class' => \SumUp\Types\CheckoutSuccess::class]],
         ], [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'GET', $path);
     }
 
@@ -265,7 +265,6 @@ public function listAvailablePaymentMethods(string $merchantCode, ?CheckoutsList
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Services\CheckoutsListAvailablePaymentMethodsResponse::class, [
             '400' => ['type' => 'class', 'class' => \SumUp\Types\DetailsError::class],
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'GET', $path);
     }
 
@@ -298,7 +297,7 @@ public function process(string $id, \SumUp\Types\ProcessCheckout|array $body, ?R
             '202' => ['type' => 'class', 'class' => \SumUp\Types\CheckoutAccepted::class],
         ], [
             '400' => ['type' => 'mixed'],
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
             '409' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'PUT', $path);

diff --git a/src/Customers/Customers.php b/src/Customers/Customers.php
@@ -94,7 +94,8 @@ public function create(\SumUp\Types\Customer|array $body, ?RequestOptions $reque
         return ResponseDecoder::decodeOrThrow($response, [
             '201' => ['type' => 'class', 'class' => \SumUp\Types\Customer::class],
         ], [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '400' => ['type' => 'mixed'],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '403' => ['type' => 'class', 'class' => \SumUp\Types\ErrorForbidden::class],
             '409' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'POST', $path);
@@ -126,7 +127,8 @@ public function deactivatePaymentInstrument(string $customerId, string $token, ?
         return ResponseDecoder::decodeOrThrow($response, [
             '204' => ['type' => 'void'],
         ], [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '400' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '403' => ['type' => 'class', 'class' => \SumUp\Types\ErrorForbidden::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'DELETE', $path);
@@ -155,7 +157,7 @@ public function get(string $customerId, ?RequestOptions $requestOptions = null):
         $response = $this->client->send('GET', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\Customer::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '403' => ['type' => 'class', 'class' => \SumUp\Types\ErrorForbidden::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'GET', $path);
@@ -186,7 +188,7 @@ public function listPaymentInstruments(string $customerId, ?RequestOptions $requ
         return ResponseDecoder::decodeOrThrow($response, [
             '200' => ['type' => 'array', 'items' => ['type' => 'class', 'class' => \SumUp\Types\PaymentInstrumentResponse::class]],
         ], [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '403' => ['type' => 'class', 'class' => \SumUp\Types\ErrorForbidden::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'GET', $path);
@@ -217,7 +219,7 @@ public function update(string $customerId, CustomersUpdateRequest|array $body, ?
         $response = $this->client->send('PUT', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\Customer::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '403' => ['type' => 'class', 'class' => \SumUp\Types\ErrorForbidden::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'PUT', $path);

diff --git a/src/Payouts/Payouts.php b/src/Payouts/Payouts.php
@@ -176,7 +176,8 @@ public function list(string $merchantCode, ?PayoutsListParams $queryParams = nul
         return ResponseDecoder::decodeOrThrow($response, [
             '200' => ['type' => 'array', 'items' => ['type' => 'object']],
         ], [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '400' => ['type' => 'array', 'items' => ['type' => 'class', 'class' => \SumUp\Types\ErrorExtended::class]],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'GET', $path);
     }
 
@@ -231,7 +232,8 @@ public function listDeprecated(?PayoutsListDeprecatedParams $queryParams = null,
         return ResponseDecoder::decodeOrThrow($response, [
             '200' => ['type' => 'array', 'items' => ['type' => 'object']],
         ], [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '400' => ['type' => 'array', 'items' => ['type' => 'class', 'class' => \SumUp\Types\ErrorExtended::class]],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'GET', $path);
     }
 }
diff --git a/src/Readers/Readers.php b/src/Readers/Readers.php
@@ -192,12 +192,10 @@ public function createCheckout(string $merchantCode, string $readerId, \SumUp\Ty
         return ResponseDecoder::decodeOrThrow($response, [
             '201' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderCheckoutResponse::class],
         ], [
-            '400' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderCheckoutError::class],
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderCheckoutError::class],
-            '422' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderCheckoutUnprocessableEntity::class],
-            '500' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderCheckoutError::class],
-            '502' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderCheckoutError::class],
-            '504' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderCheckoutError::class],
+            '400' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '404' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '422' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'POST', $path);
     }
 
@@ -283,12 +281,9 @@ public function getStatus(string $merchantCode, string $readerId, ?RequestOption
         $response = $this->client->send('GET', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\StatusResponse::class, [
-            '400' => ['type' => 'class', 'class' => \SumUp\Types\BadRequest::class],
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Unauthorized::class],
-            '404' => ['type' => 'class', 'class' => \SumUp\Types\NotFound::class],
-            '500' => ['type' => 'class', 'class' => \SumUp\Types\InternalServerError::class],
-            '502' => ['type' => 'class', 'class' => \SumUp\Types\BadGateway::class],
-            '504' => ['type' => 'class', 'class' => \SumUp\Types\GatewayTimeout::class],
+            '400' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '404' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'GET', $path);
     }
 
@@ -347,12 +342,10 @@ public function terminateCheckout(string $merchantCode, string $readerId, Reader
         return ResponseDecoder::decodeOrThrow($response, [
             '202' => ['type' => 'void'],
         ], [
-            '400' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderTerminateError::class],
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderTerminateError::class],
-            '422' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderTerminateUnprocessableEntity::class],
-            '500' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderTerminateError::class],
-            '502' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderTerminateError::class],
-            '504' => ['type' => 'class', 'class' => \SumUp\Types\CreateReaderTerminateError::class],
+            '400' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '404' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '422' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'POST', $path);
     }
 

diff --git a/src/Receipts/Receipts.php b/src/Receipts/Receipts.php
@@ -107,7 +107,8 @@ public function get(string $id, ?ReceiptsGetParams $queryParams = null, ?Request
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\Receipt::class, [
             '400' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
+            '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'GET', $path);
     }
 }
diff --git a/src/Transactions/Transactions.php b/src/Transactions/Transactions.php
@@ -184,7 +184,7 @@ class TransactionsListParams
      *
      * @var string[]|null
      */
-    public ?array $statuses = null;
+    public ?array $statusesList = null;
 
     /**
      * Filters the returned results by the specified list of payment types used for the transactions.
@@ -284,7 +284,7 @@ class TransactionsListDeprecatedParams
      *
      * @var string[]|null
      */
-    public ?array $statuses = null;
+    public ?array $statusesList = null;
 
     /**
      * Filters the returned results by the specified list of payment types used for the transactions.
@@ -418,7 +418,7 @@ public function get(string $merchantCode, ?TransactionsGetParams $queryParams =
         $response = $this->client->send('GET', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\TransactionFull::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'GET', $path);
     }
@@ -466,7 +466,7 @@ public function getDeprecated(?TransactionsGetDeprecatedParams $queryParams = nu
         $response = $this->client->send('GET', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Types\TransactionFull::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
             '404' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
         ], 'GET', $path);
     }
@@ -501,8 +501,8 @@ public function list(string $merchantCode, ?TransactionsListParams $queryParams
             if (isset($queryParams->users)) {
                 $queryParamsData['users'] = $queryParams->users;
             }
-            if (isset($queryParams->statuses)) {
-                $queryParamsData['statuses'] = $queryParams->statuses;
+            if (isset($queryParams->statusesList)) {
+                $queryParamsData['statuses[]'] = $queryParams->statusesList;
             }
             if (isset($queryParams->paymentTypes)) {
                 $queryParamsData['payment_types'] = $queryParams->paymentTypes;
@@ -543,7 +543,8 @@ public function list(string $merchantCode, ?TransactionsListParams $queryParams
         $response = $this->client->send('GET', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Services\TransactionsListResponse::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '400' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'GET', $path);
     }
 
@@ -578,8 +579,8 @@ public function listDeprecated(?TransactionsListDeprecatedParams $queryParams =
             if (isset($queryParams->users)) {
                 $queryParamsData['users'] = $queryParams->users;
             }
-            if (isset($queryParams->statuses)) {
-                $queryParamsData['statuses'] = $queryParams->statuses;
+            if (isset($queryParams->statusesList)) {
+                $queryParamsData['statuses[]'] = $queryParams->statusesList;
             }
             if (isset($queryParams->paymentTypes)) {
                 $queryParamsData['payment_types'] = $queryParams->paymentTypes;
@@ -617,7 +618,8 @@ public function listDeprecated(?TransactionsListDeprecatedParams $queryParams =
         $response = $this->client->send('GET', $path, $payload, $headers, $requestOptions);
 
         return ResponseDecoder::decodeOrThrow($response, \SumUp\Services\TransactionsListDeprecatedResponse::class, [
-            '401' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '400' => ['type' => 'class', 'class' => \SumUp\Types\Error::class],
+            '401' => ['type' => 'class', 'class' => \SumUp\Types\Problem::class],
         ], 'GET', $path);
     }
 

diff --git a/src/Types/BadGateway.php b/src/Types/BadGateway.php
diff --git a/src/Types/CheckoutSuccess.php b/src/Types/CheckoutSuccess.php
@@ -4,6 +4,9 @@
 
 namespace SumUp\Types;
 
+/**
+ * Checkout response returned after a successful processing attempt.
+ */
 class CheckoutSuccess
 {
     /**

diff --git a/src/Types/Customer.php b/src/Types/Customer.php
@@ -4,6 +4,9 @@
 
 namespace SumUp\Types;
 
+/**
+ * Saved customer details.
+ */
 class Customer
 {
     /**

diff --git a/src/Types/DetailsError.php b/src/Types/DetailsError.php
@@ -31,6 +31,7 @@ class DetailsError
     public ?float $status = null;
 
     /**
+     * List of violated validation constraints.
      *
      * @var array<string, mixed>[]|null
      */

diff --git a/src/Types/Device.php b/src/Types/Device.php
@@ -4,6 +4,9 @@
 
 namespace SumUp\Types;
 
+/**
+ * Details of the device used to create the transaction.
+ */
 class Device
 {
     /**

diff --git a/src/Types/ElvCardAccount.php b/src/Types/ElvCardAccount.php
@@ -4,6 +4,9 @@
 
 namespace SumUp\Types;
 
+/**
+ * Details of the ELV card account associated with the transaction.
+ */
 class ElvCardAccount
 {
     /**

diff --git a/src/Types/ErrorExtended.php b/src/Types/ErrorExtended.php
@@ -4,6 +4,9 @@
 
 namespace SumUp\Types;
 
+/**
+ * Error payload with the invalid parameter reference.
+ */
 class ErrorExtended
 {
     /**

diff --git a/src/Types/Event.php b/src/Types/Event.php
@@ -4,6 +4,9 @@
 
 namespace SumUp\Types;
 
+/**
+ * Transaction event details.
+ */
 class Event
 {
     /**

diff --git a/src/Types/GatewayTimeout.php b/src/Types/GatewayTimeout.php
diff --git a/src/Types/InternalServerError.php b/src/Types/InternalServerError.php
-Original file line number
+Diff line change
@@ Expand Up / @@ -4,6 +4,9 @@ @@
     namespace SumUp\Types;
+    /**
+     * Checkout response returned after a successful processing attempt.
+     */
     class CheckoutSuccess
     {
         /**
@@ Expand Down @@