From 4104533025d3ad0d24c411565a13551a6337e272 Mon Sep 17 00:00:00 2001
From: appscisumup <null>
Date: Tue, 31 Mar 2026 06:47:51 +0000
Subject: [PATCH 1/2] chore: synced local 'openapi.json' with remote
 'specs/openapi.json'

---
 openapi.json | 221 +++++++++++++++++++++++++++++++++------------------
 1 file changed, 143 insertions(+), 78 deletions(-)

diff --git a/openapi.json b/openapi.json
index 4153d4a..e2bd9d5 100755
--- a/openapi.json
+++ b/openapi.json
@@ -2148,7 +2148,7 @@
             "schema": {
               "type": "array",
               "items": {
-                "$ref": "#/components/schemas/EntryModeFilter"
+                "$ref": "#/components/schemas/EntryMode"
               }
             }
           },
@@ -5959,7 +5959,7 @@
         "schema": {
           "type": "array",
           "items": {
-            "$ref": "#/components/schemas/EntryModeFilter"
+            "$ref": "#/components/schemas/EntryMode"
           }
         }
       },
@@ -6474,7 +6474,9 @@
               "boleto",
               "ideal",
               "blik",
-              "bancontact"
+              "bancontact",
+              "google_pay",
+              "apple_pay"
             ]
           },
           "installments": {
@@ -6489,6 +6491,50 @@
           "card": {
             "$ref": "#/components/schemas/Card"
           },
+          "google_pay": {
+            "description": "Raw `PaymentData` object received from Google Pay. Send the Google Pay response payload as-is.",
+            "type": "object",
+            "example": {
+              "apiVersionMinor": 0,
+              "apiVersion": 2,
+              "paymentMethodData": {
+                "description": "Visa •••• 1111",
+                "tokenizationData": {
+                  "type": "PAYMENT_GATEWAY",
+                  "token": "token-data"
+                },
+                "type": "CARD",
+                "info": {
+                  "cardNetwork": "VISA",
+                  "cardDetails": "1111"
+                }
+              }
+            }
+          },
+          "apple_pay": {
+            "description": "Raw payment token object received from Apple Pay. Send the Apple Pay response payload as-is.",
+            "type": "object",
+            "example": {
+              "token": {
+                "paymentData": {
+                  "data": "si2xuT2ArQo689SfE-long-token",
+                  "signature": "MIAGCSqGSIb3DQEHA-long-signature",
+                  "header": {
+                    "publicKeyHash": "PWfjDi3TSwgZ20TY/A7f3V6J/1rhHyRDCspbeljM0io=",
+                    "ephemeralPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEaBtz7UN2MNV0qInJVEEhXy10PU0KfO6KxFjXm93oKWL6lCsxZZGDl/EKioUHVSlKgpsKGin0xvgldfxeJVgy0g==",
+                    "transactionId": "62e0568bc9258e9d0e059d745650fc8211d05ef7a7a1589a6411bf9b12cdfd04"
+                  },
+                  "version": "EC_v1"
+                },
+                "paymentMethod": {
+                  "displayName": "MasterCard 8837",
+                  "network": "MasterCard",
+                  "type": "debit"
+                },
+                "transactionIdentifier": "62E0568BC9258E9D0E059D745650FC8211D05EF7A7A1589A6411BF9B12CDFD04"
+              }
+            }
+          },
           "token": {
             "description": "__Required when using a tokenized card to process a checkout.__ Unique token identifying the saved payment card for a customer.",
             "type": "string"
@@ -7202,6 +7248,21 @@
         },
         "title": "Receipt Card"
       },
+      "ReceiptReader": {
+        "description": "Card reader details displayed on the receipt.",
+        "type": "object",
+        "properties": {
+          "code": {
+            "description": "Reader serial number.",
+            "type": "string"
+          },
+          "type": {
+            "description": "Reader type.",
+            "type": "string"
+          }
+        },
+        "title": "Receipt Reader"
+      },
       "ReceiptMerchantData": {
         "description": "Receipt merchant data",
         "type": "object",
@@ -7217,15 +7278,30 @@
               "business_name": {
                 "type": "string"
               },
+              "company_registration_number": {
+                "type": "string"
+              },
+              "vat_id": {
+                "type": "string"
+              },
+              "website": {
+                "type": "string"
+              },
               "email": {
                 "type": "string"
               },
+              "language": {
+                "type": "string"
+              },
               "address": {
                 "type": "object",
                 "properties": {
                   "address_line1": {
                     "type": "string"
                   },
+                  "address_line2": {
+                    "type": "string"
+                  },
                   "city": {
                     "type": "string"
                   },
@@ -7238,6 +7314,9 @@
                   "country_native_name": {
                     "type": "string"
                   },
+                  "region_name": {
+                    "type": "string"
+                  },
                   "post_code": {
                     "type": "string"
                   },
@@ -7263,6 +7342,13 @@
             "description": "Transaction code.",
             "type": "string"
           },
+          "transaction_id": {
+            "$ref": "#/components/schemas/TransactionID"
+          },
+          "merchant_code": {
+            "description": "Merchant code.",
+            "type": "string"
+          },
           "amount": {
             "description": "Transaction amount.",
             "type": "string"
@@ -7300,6 +7386,9 @@
             "description": "Cardholder verification method.",
             "type": "string"
           },
+          "card_reader": {
+            "$ref": "#/components/schemas/ReceiptReader"
+          },
           "card": {
             "$ref": "#/components/schemas/ReceiptCard"
           },
@@ -7307,6 +7396,15 @@
             "description": "Number of installments.",
             "type": "integer"
           },
+          "process_as": {
+            "description": "Debit/Credit.",
+            "type": "string",
+            "example": "CREDIT",
+            "enum": [
+              "CREDIT",
+              "DEBIT"
+            ]
+          },
           "products": {
             "description": "Products",
             "type": "array",
@@ -7318,6 +7416,10 @@
                   "type": "string",
                   "example": "Coffee"
                 },
+                "description": {
+                  "description": "Product description",
+                  "type": "string"
+                },
                 "price": {
                   "description": "Product price",
                   "type": "string",
@@ -7657,33 +7759,33 @@
         "description": "Entry mode of the payment details.",
         "type": "string",
         "enum": [
-          "none",
-          "magstripe",
-          "chip",
-          "manual entry",
-          "customer entry",
-          "magstripe fallback",
-          "contactless",
-          "moto",
-          "contactless magstripe",
-          "boleto",
-          "direct debit",
-          "sofort",
-          "ideal",
-          "bancontact",
-          "eps",
-          "mybank",
-          "satispay",
-          "blik",
-          "p24",
-          "giropay",
-          "pix",
-          "qr code pix",
-          "apple pay",
-          "google pay",
-          "paypal",
-          "twint",
-          "na"
+          "BOLETO",
+          "SOFORT",
+          "IDEAL",
+          "BANCONTACT",
+          "EPS",
+          "MYBANK",
+          "SATISPAY",
+          "BLIK",
+          "P24",
+          "GIROPAY",
+          "PIX",
+          "QR_CODE_PIX",
+          "APPLE_PAY",
+          "GOOGLE_PAY",
+          "PAYPAL",
+          "TWINT",
+          "NONE",
+          "CHIP",
+          "MANUAL_ENTRY",
+          "CUSTOMER_ENTRY",
+          "MAGSTRIPE_FALLBACK",
+          "MAGSTRIPE",
+          "DIRECT_DEBIT",
+          "CONTACTLESS",
+          "MOTO",
+          "CONTACTLESS_MAGSTRIPE",
+          "N/A"
         ],
         "title": "Entry Mode"
       },
@@ -8734,7 +8836,7 @@
               "avatar": {
                 "description": "A user-facing small-format logo for use in dashboards and other user-facing applications. For customer-facing branding see `merchant.business_profile.branding`.\n",
                 "type": "string",
-                "format": "url"
+                "format": "uri"
               },
               "alias": {
                 "description": "A user-facing name of the merchant account for use in dashboards and other user-facing applications. For customer-facing business name see `merchant.business_profile`.\n",
@@ -8792,7 +8894,8 @@
             "description": "The company's legal name.",
             "type": "string",
             "example": "Gin & Doughnuts Bar GmbH",
-            "maxLength": 512
+            "maxLength": 150,
+            "minLength": 1
           },
           "merchant_category_code": {
             "description": "The merchant category code for the account as specified by [ISO18245](https://www.iso.org/standard/33365.html). MCCs are used to classify businesses based on the goods or services they provide.\n",
@@ -8818,6 +8921,7 @@
           "website": {
             "description": "HTTP(S) URL of the company's website.\n",
             "type": "string",
+            "format": "uri",
             "examples": [
               "https://www.sumup.com"
             ],
@@ -8850,26 +8954,29 @@
             "description": "The customer-facing business name.",
             "type": "string",
             "example": "Example Coffee",
-            "maxLength": 512
+            "maxLength": 150,
+            "minLength": 1
           },
           "dynamic_descriptor": {
             "description": "The descriptor is the text that your customer sees on their bank account statement.\nThe more recognisable your descriptor is, the less risk you have of receiving disputes (e.g. chargebacks).\n",
             "type": "string",
             "example": "Example Coffee",
             "maxLength": 30,
+            "minLength": 1,
             "pattern": "^[a-zA-Z0-9 \\-+\\'_.]{0,30}$"
           },
           "website": {
             "description": "The business's publicly available website.",
             "type": "string",
+            "format": "uri",
             "example": "https://example.com",
-            "maxLength": 512
+            "maxLength": 255
           },
           "email": {
             "description": "A publicly available email address.",
             "type": "string",
             "example": "contact@example.com",
-            "maxLength": 256
+            "maxLength": 255
           },
           "phone_number": {
             "$ref": "#/components/schemas/PhoneNumber"
@@ -8893,7 +9000,7 @@
         "description": "A publicly available phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format.\n",
         "type": "string",
         "example": "+420123456789",
-        "maxLength": 64
+        "maxLength": 16
       },
       "Branding": {
         "description": "Settings used to apply the Merchant's branding to email receipts, invoices, checkouts, and other products.",
@@ -9932,10 +10039,6 @@
             "description": "Country ISO 3166-1 code",
             "type": "string"
           },
-          "region_id": {
-            "description": "Country region id",
-            "type": "number"
-          },
           "region_name": {
             "description": "Country region name",
             "type": "string"
@@ -10023,10 +10126,6 @@
             "description": "Country ISO 3166-1 code",
             "type": "string"
           },
-          "region_id": {
-            "description": "Country region id",
-            "type": "number"
-          },
           "region_name": {
             "description": "Region name",
             "type": "string"
@@ -10439,40 +10538,6 @@
           }
         },
         "title": "Personal Profile Legacy"
-      },
-      "EntryModeFilter": {
-        "description": "Entry mode value accepted by the `entry_modes[]` filter.",
-        "type": "string",
-        "enum": [
-          "BOLETO",
-          "SOFORT",
-          "IDEAL",
-          "BANCONTACT",
-          "EPS",
-          "MYBANK",
-          "SATISPAY",
-          "BLIK",
-          "P24",
-          "GIROPAY",
-          "PIX",
-          "QR_CODE_PIX",
-          "APPLE_PAY",
-          "GOOGLE_PAY",
-          "PAYPAL",
-          "TWINT",
-          "NONE",
-          "CHIP",
-          "MANUAL_ENTRY",
-          "CUSTOMER_ENTRY",
-          "MAGSTRIPE_FALLBACK",
-          "MAGSTRIPE",
-          "DIRECT_DEBIT",
-          "CONTACTLESS",
-          "MOTO",
-          "CONTACTLESS_MAGSTRIPE",
-          "N/A"
-        ],
-        "title": "Entry Mode Filter"
       }
     },
     "examples": {

From 203ef359eb18f996397c2f231dbb5b2519f8c78f Mon Sep 17 00:00:00 2001
From: "sumup-bot[bot]" <241716704+sumup-bot[bot]@users.noreply.github.com>
Date: Tue, 31 Mar 2026 06:49:20 +0000
Subject: [PATCH 2/2] chore: generate code

---
 src/Types/ProcessCheckout.php                 | 14 +++++
 src/Types/ProcessCheckoutPaymentType.php      |  2 +
 src/Types/ReceiptReader.php                   | 26 +++++++++
 src/Types/ReceiptTransaction.php              | 28 ++++++++++
 src/Types/ReceiptTransactionProcessAs.php     | 14 +++++
 .../TransactionCheckoutInfoEntryMode.php      | 54 +++++++++----------
 6 files changed, 111 insertions(+), 27 deletions(-)
 create mode 100644 src/Types/ReceiptReader.php
 create mode 100644 src/Types/ReceiptTransactionProcessAs.php

diff --git a/src/Types/ProcessCheckout.php b/src/Types/ProcessCheckout.php
index 8889c1b..28df31e 100644
--- a/src/Types/ProcessCheckout.php
+++ b/src/Types/ProcessCheckout.php
@@ -37,6 +37,20 @@ class ProcessCheckout
      */
     public ?Card $card = null;
 
+    /**
+     * Raw `PaymentData` object received from Google Pay. Send the Google Pay response payload as-is.
+     *
+     * @var array<string, mixed>|null
+     */
+    public ?array $googlePay = null;
+
+    /**
+     * Raw payment token object received from Apple Pay. Send the Apple Pay response payload as-is.
+     *
+     * @var array<string, mixed>|null
+     */
+    public ?array $applePay = null;
+
     /**
      * __Required when using a tokenized card to process a checkout.__ Unique token identifying the saved payment card for a customer.
      *
diff --git a/src/Types/ProcessCheckoutPaymentType.php b/src/Types/ProcessCheckoutPaymentType.php
index eb3007a..58481a4 100644
--- a/src/Types/ProcessCheckoutPaymentType.php
+++ b/src/Types/ProcessCheckoutPaymentType.php
@@ -14,4 +14,6 @@ enum ProcessCheckoutPaymentType: string
     case IDEAL = 'ideal';
     case BLIK = 'blik';
     case BANCONTACT = 'bancontact';
+    case GOOGLE_PAY = 'google_pay';
+    case APPLE_PAY = 'apple_pay';
 }
diff --git a/src/Types/ReceiptReader.php b/src/Types/ReceiptReader.php
new file mode 100644
index 0000000..5b10470
--- /dev/null
+++ b/src/Types/ReceiptReader.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Card reader details displayed on the receipt.
+ */
+class ReceiptReader
+{
+    /**
+     * Reader serial number.
+     *
+     * @var string|null
+     */
+    public ?string $code = null;
+
+    /**
+     * Reader type.
+     *
+     * @var string|null
+     */
+    public ?string $type = null;
+
+}
diff --git a/src/Types/ReceiptTransaction.php b/src/Types/ReceiptTransaction.php
index 3f03245..663afbd 100644
--- a/src/Types/ReceiptTransaction.php
+++ b/src/Types/ReceiptTransaction.php
@@ -16,6 +16,20 @@ class ReceiptTransaction
      */
     public ?string $transactionCode = null;
 
+    /**
+     * Unique ID of the transaction.
+     *
+     * @var string|null
+     */
+    public ?string $transactionId = null;
+
+    /**
+     * Merchant code.
+     *
+     * @var string|null
+     */
+    public ?string $merchantCode = null;
+
     /**
      * Transaction amount.
      *
@@ -79,6 +93,13 @@ class ReceiptTransaction
      */
     public ?string $verificationMethod = null;
 
+    /**
+     * Card reader details displayed on the receipt.
+     *
+     * @var ReceiptReader|null
+     */
+    public ?ReceiptReader $cardReader = null;
+
     /**
      * Payment card details displayed on the receipt.
      *
@@ -93,6 +114,13 @@ class ReceiptTransaction
      */
     public ?int $installmentsCount = null;
 
+    /**
+     * Debit/Credit.
+     *
+     * @var ReceiptTransactionProcessAs|null
+     */
+    public ?ReceiptTransactionProcessAs $processAs = null;
+
     /**
      * Products
      *
diff --git a/src/Types/ReceiptTransactionProcessAs.php b/src/Types/ReceiptTransactionProcessAs.php
new file mode 100644
index 0000000..f70e351
--- /dev/null
+++ b/src/Types/ReceiptTransactionProcessAs.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Debit/Credit.
+ */
+enum ReceiptTransactionProcessAs: string
+{
+    case CREDIT = 'CREDIT';
+    case DEBIT = 'DEBIT';
+}
diff --git a/src/Types/TransactionCheckoutInfoEntryMode.php b/src/Types/TransactionCheckoutInfoEntryMode.php
index a2749a9..b5f3043 100644
--- a/src/Types/TransactionCheckoutInfoEntryMode.php
+++ b/src/Types/TransactionCheckoutInfoEntryMode.php
@@ -9,31 +9,31 @@
  */
 enum TransactionCheckoutInfoEntryMode: string
 {
-    case NONE = 'none';
-    case MAGSTRIPE = 'magstripe';
-    case CHIP = 'chip';
-    case MANUAL_ENTRY = 'manual entry';
-    case CUSTOMER_ENTRY = 'customer entry';
-    case MAGSTRIPE_FALLBACK = 'magstripe fallback';
-    case CONTACTLESS = 'contactless';
-    case MOTO = 'moto';
-    case CONTACTLESS_MAGSTRIPE = 'contactless magstripe';
-    case BOLETO = 'boleto';
-    case DIRECT_DEBIT = 'direct debit';
-    case SOFORT = 'sofort';
-    case IDEAL = 'ideal';
-    case BANCONTACT = 'bancontact';
-    case EPS = 'eps';
-    case MYBANK = 'mybank';
-    case SATISPAY = 'satispay';
-    case BLIK = 'blik';
-    case P_24 = 'p24';
-    case GIROPAY = 'giropay';
-    case PIX = 'pix';
-    case QR_CODE_PIX = 'qr code pix';
-    case APPLE_PAY = 'apple pay';
-    case GOOGLE_PAY = 'google pay';
-    case PAYPAL = 'paypal';
-    case TWINT = 'twint';
-    case NA = 'na';
+    case BOLETO = 'BOLETO';
+    case SOFORT = 'SOFORT';
+    case IDEAL = 'IDEAL';
+    case BANCONTACT = 'BANCONTACT';
+    case EPS = 'EPS';
+    case MYBANK = 'MYBANK';
+    case SATISPAY = 'SATISPAY';
+    case BLIK = 'BLIK';
+    case P_24 = 'P24';
+    case GIROPAY = 'GIROPAY';
+    case PIX = 'PIX';
+    case QR_CODE_PIX = 'QR_CODE_PIX';
+    case APPLE_PAY = 'APPLE_PAY';
+    case GOOGLE_PAY = 'GOOGLE_PAY';
+    case PAYPAL = 'PAYPAL';
+    case TWINT = 'TWINT';
+    case NONE = 'NONE';
+    case CHIP = 'CHIP';
+    case MANUAL_ENTRY = 'MANUAL_ENTRY';
+    case CUSTOMER_ENTRY = 'CUSTOMER_ENTRY';
+    case MAGSTRIPE_FALLBACK = 'MAGSTRIPE_FALLBACK';
+    case MAGSTRIPE = 'MAGSTRIPE';
+    case DIRECT_DEBIT = 'DIRECT_DEBIT';
+    case CONTACTLESS = 'CONTACTLESS';
+    case MOTO = 'MOTO';
+    case CONTACTLESS_MAGSTRIPE = 'CONTACTLESS_MAGSTRIPE';
+    case N_A = 'N/A';
 }