spec release

json/ManagementService-v1.json

@@ -17064,7 +17064,7 @@
                   "type" : "string"
                },
                "passphrase" : {
-                  "description" : "The secure passphrase to protect the shared key.",
+                  "description" : "The secure passphrase to protect the shared key. Must consist of: \n\n* At least 12 characters.\n\n* At least 1 uppercase letter: `[A-Z]`. \n\n* At least 1 lowercase letter: `[a-z]`. \n\n* At least 1 digit: `[0-9]`. \n\n * At least 1 special character. Limited to the following: `~`, `@`, `$`, `%`, `^`, `&`, `*`, `(`, `)`, `_`, `+`, `=`, `}`, `{`, `]`, `[`, `;`, `:`, `?`, `.`, `,`, `>`, `<`. \n\n ",
                   "type" : "string"
                },
                "version" : {
@@ -18245,7 +18245,7 @@
                   "$ref" : "#/components/schemas/SwishInfo"
                },
                "ticket" : {
-                  "description" : "Edenred details.",
+                  "description" : "Edenred (Brazil) details.",
                   "$ref" : "#/components/schemas/TicketInfo"
                },
                "twint" : {
@@ -18581,7 +18581,7 @@
                   "$ref" : "#/components/schemas/SwishInfo"
                },
                "ticket" : {
-                  "description" : "Edenred details.",
+                  "description" : "Edenred (Brazil) details.",
                   "$ref" : "#/components/schemas/TicketInfo"
                },
                "twint" : {
@@ -19508,6 +19508,16 @@
                   "description" : "The payment method condition that defines whether the split logic applies.\n\nPossible values:\n* [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method.\n* **ANY**: Apply the split logic for all available payment methods.",
                   "type" : "string"
                },
+               "regionality" : {
+                  "description" : "",
+                  "enum" : [
+                     "international",
+                     "intraRegional",
+                     "interRegional",
+                     "ANY"
+                  ],
+                  "type" : "string"
+               },
                "ruleId" : {
                   "description" : "The unique identifier of the split configuration rule.",
                   "readOnly" : true,
@@ -21117,6 +21127,10 @@
                   "description" : "The payment method condition that defines whether the split logic applies.\n\nPossible values:\n* [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method.\n* **ANY**: Apply the split logic for all available payment methods.",
                   "type" : "string"
                },
+               "regionality" : {
+                  "description" : "",
+                  "type" : "string"
+               },
                "shopperInteraction" : {
                   "description" : "The sales channel condition that defines whether the split logic applies.\n\nPossible values:\n* **Ecommerce**: Online transactions where the cardholder is present.\n* **ContAuth**: Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer).\n* **Moto**: Mail-order and telephone-order transactions where the customer is in contact with the merchant via email or telephone.\n* **POS**: Point-of-sale transactions where the customer is physically present to make a payment using a secure payment terminal.\n* **ANY**: All sales channels.",
                   "type" : "string"

json/ManagementService-v3.json

@@ -11041,6 +11041,9 @@
                         },
                         "patch-stores-splitConfiguration" : {
                            "$ref" : "#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration"
+                        },
+                        "patch-stores-subMerchantData" : {
+                           "$ref" : "#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData"
                         }
                      },
                      "schema" : {
@@ -11079,6 +11082,9 @@
                            },
                            "patch-stores-splitConfiguration" : {
                               "$ref" : "#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration-200"
+                           },
+                           "patch-stores-subMerchantData" : {
+                              "$ref" : "#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData-200"
                            }
                         },
                         "schema" : {
@@ -14095,6 +14101,9 @@
                         },
                         "patch-stores-splitConfiguration" : {
                            "$ref" : "#/components/examples/patch-stores-storeId-patch-stores-splitConfiguration"
+                        },
+                        "patch-stores-subMerchantData" : {
+                           "$ref" : "#/components/examples/patch-stores-storeId-patch-stores-subMerchantData"
                         }
                      },
                      "schema" : {
@@ -14121,6 +14130,9 @@
                         "examples" : {
                            "patch-stores" : {
                               "$ref" : "#/components/examples/patch-stores-storeId-patch-stores-200"
+                           },
+                           "patch-stores-subMerchantData" : {
+                              "$ref" : "#/components/examples/patch-stores-storeId-patch-stores-subMerchantData-200"
                            }
                         },
                         "schema" : {
@@ -17484,7 +17496,7 @@
                   "type" : "string"
                },
                "passphrase" : {
-                  "description" : "The secure passphrase to protect the shared key.",
+                  "description" : "The secure passphrase to protect the shared key. Must consist of: \n\n* At least 12 characters.\n\n* At least 1 uppercase letter: `[A-Z]`. \n\n* At least 1 lowercase letter: `[a-z]`. \n\n* At least 1 digit: `[0-9]`. \n\n * At least 1 special character. Limited to the following: `~`, `@`, `$`, `%`, `^`, `&`, `*`, `(`, `)`, `_`, `+`, `=`, `}`, `{`, `]`, `[`, `;`, `:`, `?`, `.`, `,`, `>`, `<`. \n\n ",
                   "type" : "string"
                },
                "version" : {
@@ -18669,7 +18681,7 @@
                   "$ref" : "#/components/schemas/SwishInfo"
                },
                "ticket" : {
-                  "description" : "Edenred details.",
+                  "description" : "Edenred (Brazil) details.",
                   "$ref" : "#/components/schemas/TicketInfo"
                },
                "twint" : {
@@ -19009,7 +19021,7 @@
                   "$ref" : "#/components/schemas/SwishInfo"
                },
                "ticket" : {
-                  "description" : "Edenred details.",
+                  "description" : "Edenred (Brazil) details.",
                   "$ref" : "#/components/schemas/TicketInfo"
                },
                "twint" : {
@@ -19929,6 +19941,16 @@
                   "description" : "The payment method condition that defines whether the split logic applies.\n\nPossible values:\n* [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method.\n* **ANY**: Apply the split logic for all available payment methods.",
                   "type" : "string"
                },
+               "regionality" : {
+                  "description" : "",
+                  "enum" : [
+                     "international",
+                     "intraRegional",
+                     "interRegional",
+                     "ANY"
+                  ],
+                  "type" : "string"
+               },
                "ruleId" : {
                   "description" : "The unique identifier of the split configuration rule.",
                   "readOnly" : true,
@@ -20058,6 +20080,11 @@
                      "inactive"
                   ],
                   "type" : "string"
+               },
+               "subMerchantData" : {
+                  "x-addedInVersion" : "3",
+                  "description" : "The sub-merchant data relevant for registered payment facilitators transacting on standalone terminals.",
+                  "$ref" : "#/components/schemas/SubMerchantData"
                }
             },
             "type" : "object"
@@ -20121,6 +20148,11 @@
                "splitConfiguration" : {
                   "description" : "Rules for Adyen for Platforms merchants to split the transaction amount and fees.",
                   "$ref" : "#/components/schemas/StoreSplitConfiguration"
+               },
+               "subMerchantData" : {
+                  "x-addedInVersion" : "3",
+                  "description" : "The sub-merchant data relevant for registered payment facilitators transacting on standalone terminals.",
+                  "$ref" : "#/components/schemas/SubMerchantData"
                }
             },
             "required" : [
@@ -20172,6 +20204,11 @@
                "splitConfiguration" : {
                   "description" : "Rules for Adyen for Platforms merchants to split the transaction amount and fees.",
                   "$ref" : "#/components/schemas/StoreSplitConfiguration"
+               },
+               "subMerchantData" : {
+                  "x-addedInVersion" : "3",
+                  "description" : "The sub-merchant data relevant for registered payment facilitators transacting on standalone terminals.",
+                  "$ref" : "#/components/schemas/SubMerchantData"
                }
             },
             "required" : [
@@ -20234,6 +20271,35 @@
             },
             "type" : "object"
          },
+         "SubMerchantData" : {
+            "additionalProperties" : false,
+            "properties" : {
+               "email" : {
+                  "description" : "The email associated with the sub-merchant's account.",
+                  "maxLength" : 320,
+                  "type" : "string"
+               },
+               "id" : {
+                  "description" : "A unique identifier that you create for the sub-merchant, used by schemes to identify the sub-merchant.\n* Format: Alphanumeric\n* Maximum length: 15 characters",
+                  "type" : "string"
+               },
+               "mcc" : {
+                  "description" : "The sub-merchant's 4-digit Merchant Category Code (MCC).\n* Format: Numeric\n* Fixed length: 4 digits",
+                  "type" : "string"
+               },
+               "name" : {
+                  "description" : "The name of the sub-merchant. Based on scheme specifications, this value will overwrite the shopper statement that will appear in the card statement.\n* Format: Alphanumeric\n* Maximum length: 22 characters",
+                  "type" : "string"
+               }
+            },
+            "required" : [
+               "id",
+               "name",
+               "mcc",
+               "email"
+            ],
+            "type" : "object"
+         },
          "SupportedCardTypes" : {
             "additionalProperties" : false,
             "properties" : {
@@ -21662,6 +21728,10 @@
                   "description" : "The payment method condition that defines whether the split logic applies.\n\nPossible values:\n* [Payment method variant](https://docs.adyen.com/development-resources/paymentmethodvariant): Apply the split logic for a specific payment method.\n* **ANY**: Apply the split logic for all available payment methods.",
                   "type" : "string"
                },
+               "regionality" : {
+                  "description" : "",
+                  "type" : "string"
+               },
                "shopperInteraction" : {
                   "description" : "The sales channel condition that defines whether the split logic applies.\n\nPossible values:\n* **Ecommerce**: Online transactions where the cardholder is present.\n* **ContAuth**: Card on file and/or subscription transactions, where the cardholder is known to the merchant (returning customer).\n* **Moto**: Mail-order and telephone-order transactions where the customer is in contact with the merchant via email or telephone.\n* **POS**: Point-of-sale transactions where the customer is physically present to make a payment using a secure payment terminal.\n* **ANY**: All sales channels.",
                   "type" : "string"
@@ -21712,6 +21782,11 @@
                      "inactive"
                   ],
                   "type" : "string"
+               },
+               "subMerchantData" : {
+                  "x-addedInVersion" : "3",
+                  "description" : "The sub-merchant data relevant for registered payment facilitators transacting on standalone terminals.",
+                  "$ref" : "#/components/schemas/SubMerchantData"
                }
             },
             "type" : "object"
@@ -27226,6 +27301,51 @@
                }
             }
          },
+         "patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData" : {
+            "summary" : "Add sub-merchant data to store",
+            "description" : "Example request to add a sub-merchant data to the store",
+            "value" : {
+               "subMerchantData" : {
+                  "id" : "12345",
+                  "name" : "Test Merchant",
+                  "mcc" : "7999",
+                  "email" : "test@email.com"
+               }
+            }
+         },
+         "patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData-200" : {
+            "summary" : "Sub-merchant data added to store",
+            "description" : "Example response after adding a sub-merchant data to the store",
+            "value" : {
+               "id" : "YOUR_STORE_ID",
+               "address" : {
+                  "country" : "US",
+                  "line1" : "1776 West Pinewood Avenue",
+                  "line2" : "Heartland Building",
+                  "line3" : "",
+                  "city" : "Springfield",
+                  "stateOrProvince" : "NY",
+                  "postalCode" : "20251"
+               },
+               "description" : "City centre store",
+               "merchantId" : "YOUR_MERCHANT_ACCOUNT_ID",
+               "shopperStatement" : "Springfield Shop",
+               "phoneNumber" : "+13123456789",
+               "reference" : "Spring_store_2",
+               "subMerchantData" : {
+                  "id" : "12345",
+                  "name" : "Test Merchant",
+                  "mcc" : "7999",
+                  "email" : "test@email.com"
+               },
+               "status" : "active",
+               "_links" : {
+                  "self" : {
+                     "href" : "https://management-test.adyen.com/v1/stores/YOUR_STORE_ID"
+                  }
+               }
+            }
+         },
          "patch-merchants-merchantId-terminalLogos-remove-logo" : {
             "summary" : "Remove logo to restore the logo from a higher level",
             "description" : "Example request to remove the payment terminal logo configured at the current level, and inherit the logo from a higher level",
@@ -27768,6 +27888,51 @@
                }
             }
          },
+         "patch-stores-storeId-patch-stores-subMerchantData" : {
+            "summary" : "Add sub-merchant data to store",
+            "description" : "Example request to add a sub-merchant data to the store",
+            "value" : {
+               "subMerchantData" : {
+                  "id" : "12345",
+                  "name" : "Test Merchant",
+                  "mcc" : "7999",
+                  "email" : "test@email.com"
+               }
+            }
+         },
+         "patch-stores-storeId-patch-stores-subMerchantData-200" : {
+            "summary" : "Sub-merchant data added to store",
+            "description" : "Example response after adding a sub-merchant data to the store",
+            "value" : {
+               "id" : "YOUR_STORE_ID",
+               "address" : {
+                  "country" : "US",
+                  "line1" : "1776 West Pinewood Avenue",
+                  "line2" : "Heartland Building",
+                  "line3" : "",
+                  "city" : "Springfield",
+                  "stateOrProvince" : "NY",
+                  "postalCode" : "20251"
+               },
+               "description" : "City centre store",
+               "merchantId" : "YOUR_MERCHANT_ACCOUNT_ID",
+               "shopperStatement" : "Springfield Shop",
+               "phoneNumber" : "+13123456789",
+               "reference" : "Spring_store_2",
+               "subMerchantData" : {
+                  "id" : "12345",
+                  "name" : "Test Merchant",
+                  "mcc" : "7999",
+                  "email" : "test@email.com"
+               },
+               "status" : "active",
+               "_links" : {
+                  "self" : {
+                     "href" : "https://management-test.adyen.com/v1/stores/YOUR_STORE_ID"
+                  }
+               }
+            }
+         },
          "patch-stores-storeId-terminalLogos-remove-logo" : {
             "summary" : "Remove logo to restore the logo from a higher level",
             "description" : "Example request to remove the payment terminal logo configured at the current level, and inherit the logo from a higher level",

yaml/ManagementService-v1.yaml

@@ -11847,7 +11847,12 @@ components:
           description: The unique identifier of the shared key.
           type: string
         passphrase:
-          description: The secure passphrase to protect the shared key.
+          description: "The secure passphrase to protect the shared key. Must consist\
+            \ of: \n\n* At least 12 characters.\n\n* At least 1 uppercase letter:\
+            \ `[A-Z]`. \n\n* At least 1 lowercase letter: `[a-z]`. \n\n* At least\
+            \ 1 digit: `[0-9]`. \n\n * At least 1 special character. Limited to the\
+            \ following: `~`, `@`, `$`, `%`, `^`, `&`, `*`, `(`, `)`, `_`, `+`, `=`,\
+            \ `}`, `{`, `]`, `[`, `;`, `:`, `?`, `.`, `,`, `>`, `<`. \n\n "
           type: string
         version:
           description: The version number of the shared key.
@@ -12841,7 +12846,7 @@ components:
             \ with Swish.\n"
           $ref: '#/components/schemas/SwishInfo'
         ticket:
-          description: Edenred details.
+          description: Edenred (Brazil) details.
           $ref: '#/components/schemas/TicketInfo'
         twint:
           description: Twint details.
@@ -13146,7 +13151,7 @@ components:
             \ with Swish.\n"
           $ref: '#/components/schemas/SwishInfo'
         ticket:
-          description: Edenred details.
+          description: Edenred (Brazil) details.
           $ref: '#/components/schemas/TicketInfo'
         twint:
           description: Twint details.
@@ -14094,6 +14099,14 @@ components:
 
             * **ANY**: Apply the split logic for all available payment methods.'
           type: string
+        regionality:
+          description: ''
+          enum:
+          - international
+          - intraRegional
+          - interRegional
+          - ANY
+          type: string
         ruleId:
           description: The unique identifier of the split configuration rule.
           readOnly: true
@@ -15720,6 +15733,9 @@ components:
 
             * **ANY**: Apply the split logic for all available payment methods.'
           type: string
+        regionality:
+          description: ''
+          type: string
         shopperInteraction:
           description: 'The sales channel condition that defines whether the split
             logic applies.

yaml/ManagementService-v3.yaml

@@ -7239,6 +7239,8 @@ paths:
                 $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores'
               patch-stores-splitConfiguration:
                 $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration'
+              patch-stores-subMerchantData:
+                $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData'
             schema:
               $ref: '#/components/schemas/UpdateStoreRequest'
       parameters:
@@ -7263,6 +7265,8 @@ paths:
                   $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-200'
                 patch-stores-splitConfiguration:
                   $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-splitConfiguration-200'
+                patch-stores-subMerchantData:
+                  $ref: '#/components/examples/patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData-200'
               schema:
                 $ref: '#/components/schemas/Store'
           description: OK - the request has succeeded.
@@ -9252,6 +9256,8 @@ paths:
                 $ref: '#/components/examples/patch-stores-storeId-patch-stores'
               patch-stores-splitConfiguration:
                 $ref: '#/components/examples/patch-stores-storeId-patch-stores-splitConfiguration'
+              patch-stores-subMerchantData:
+                $ref: '#/components/examples/patch-stores-storeId-patch-stores-subMerchantData'
             schema:
               $ref: '#/components/schemas/UpdateStoreRequest'
       parameters:
@@ -9268,6 +9274,8 @@ paths:
               examples:
                 patch-stores:
                   $ref: '#/components/examples/patch-stores-storeId-patch-stores-200'
+                patch-stores-subMerchantData:
+                  $ref: '#/components/examples/patch-stores-storeId-patch-stores-subMerchantData-200'
               schema:
                 $ref: '#/components/schemas/Store'
           description: OK - the request has succeeded.
@@ -12126,7 +12134,12 @@ components:
           description: The unique identifier of the shared key.
           type: string
         passphrase:
-          description: The secure passphrase to protect the shared key.
+          description: "The secure passphrase to protect the shared key. Must consist\
+            \ of: \n\n* At least 12 characters.\n\n* At least 1 uppercase letter:\
+            \ `[A-Z]`. \n\n* At least 1 lowercase letter: `[a-z]`. \n\n* At least\
+            \ 1 digit: `[0-9]`. \n\n * At least 1 special character. Limited to the\
+            \ following: `~`, `@`, `$`, `%`, `^`, `&`, `*`, `(`, `)`, `_`, `+`, `=`,\
+            \ `}`, `{`, `]`, `[`, `;`, `:`, `?`, `.`, `,`, `>`, `<`. \n\n "
           type: string
         version:
           description: The version number of the shared key.
@@ -13123,7 +13136,7 @@ components:
             \ with Swish.\n"
           $ref: '#/components/schemas/SwishInfo'
         ticket:
-          description: Edenred details.
+          description: Edenred (Brazil) details.
           $ref: '#/components/schemas/TicketInfo'
         twint:
           description: Twint details.
@@ -13431,7 +13444,7 @@ components:
             \ with Swish.\n"
           $ref: '#/components/schemas/SwishInfo'
         ticket:
-          description: Edenred details.
+          description: Edenred (Brazil) details.
           $ref: '#/components/schemas/TicketInfo'
         twint:
           description: Twint details.
@@ -14373,6 +14386,14 @@ components:
 
             * **ANY**: Apply the split logic for all available payment methods.'
           type: string
+        regionality:
+          description: ''
+          enum:
+          - international
+          - intraRegional
+          - interRegional
+          - ANY
+          type: string
         ruleId:
           description: The unique identifier of the split configuration rule.
           readOnly: true
@@ -14530,6 +14551,11 @@ components:
           - closed
           - inactive
           type: string
+        subMerchantData:
+          x-addedInVersion: '3'
+          description: The sub-merchant data relevant for registered payment facilitators
+            transacting on standalone terminals.
+          $ref: '#/components/schemas/SubMerchantData'
       type: object
     StoreAndForward:
       additionalProperties: false
@@ -14608,6 +14634,11 @@ components:
           description: Rules for Adyen for Platforms merchants to split the transaction
             amount and fees.
           $ref: '#/components/schemas/StoreSplitConfiguration'
+        subMerchantData:
+          x-addedInVersion: '3'
+          description: The sub-merchant data relevant for registered payment facilitators
+            transacting on standalone terminals.
+          $ref: '#/components/schemas/SubMerchantData'
       required:
       - description
       - shopperStatement
@@ -14676,6 +14707,11 @@ components:
           description: Rules for Adyen for Platforms merchants to split the transaction
             amount and fees.
           $ref: '#/components/schemas/StoreSplitConfiguration'
+        subMerchantData:
+          x-addedInVersion: '3'
+          description: The sub-merchant data relevant for registered payment facilitators
+            transacting on standalone terminals.
+          $ref: '#/components/schemas/SubMerchantData'
       required:
       - description
       - shopperStatement
@@ -14726,6 +14762,43 @@ components:
           description: The unique identifier of the [split configuration profile](https://docs.adyen.com/platforms/automatic-split-configuration/create-split-configuration/).
           type: string
       type: object
+    SubMerchantData:
+      additionalProperties: false
+      properties:
+        email:
+          description: The email associated with the sub-merchant's account.
+          maxLength: 320
+          type: string
+        id:
+          description: 'A unique identifier that you create for the sub-merchant,
+            used by schemes to identify the sub-merchant.
+
+            * Format: Alphanumeric
+
+            * Maximum length: 15 characters'
+          type: string
+        mcc:
+          description: 'The sub-merchant''s 4-digit Merchant Category Code (MCC).
+
+            * Format: Numeric
+
+            * Fixed length: 4 digits'
+          type: string
+        name:
+          description: 'The name of the sub-merchant. Based on scheme specifications,
+            this value will overwrite the shopper statement that will appear in the
+            card statement.
+
+            * Format: Alphanumeric
+
+            * Maximum length: 22 characters'
+          type: string
+      required:
+      - id
+      - name
+      - mcc
+      - email
+      type: object
     SupportedCardTypes:
       additionalProperties: false
       properties:
@@ -16165,6 +16238,9 @@ components:
 
             * **ANY**: Apply the split logic for all available payment methods.'
           type: string
+        regionality:
+          description: ''
+          type: string
         shopperInteraction:
           description: 'The sales channel condition that defines whether the split
             logic applies.
@@ -16247,6 +16323,11 @@ components:
           - closed
           - inactive
           type: string
+        subMerchantData:
+          x-addedInVersion: '3'
+          description: The sub-merchant data relevant for registered payment facilitators
+            transacting on standalone terminals.
+          $ref: '#/components/schemas/SubMerchantData'
       type: object
     UploadAndroidAppResponse:
       additionalProperties: false
@@ -20307,6 +20388,42 @@ components:
         _links:
           self:
             href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID
+    patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData:
+      summary: Add sub-merchant data to store
+      description: Example request to add a sub-merchant data to the store
+      value:
+        subMerchantData:
+          id: '12345'
+          name: Test Merchant
+          mcc: '7999'
+          email: test@email.com
+    patch-merchants-merchantId-stores-storeId-patch-stores-subMerchantData-200:
+      summary: Sub-merchant data added to store
+      description: Example response after adding a sub-merchant data to the store
+      value:
+        id: YOUR_STORE_ID
+        address:
+          country: US
+          line1: 1776 West Pinewood Avenue
+          line2: Heartland Building
+          line3: ''
+          city: Springfield
+          stateOrProvince: NY
+          postalCode: '20251'
+        description: City centre store
+        merchantId: YOUR_MERCHANT_ACCOUNT_ID
+        shopperStatement: Springfield Shop
+        phoneNumber: '+13123456789'
+        reference: Spring_store_2
+        subMerchantData:
+          id: '12345'
+          name: Test Merchant
+          mcc: '7999'
+          email: test@email.com
+        status: active
+        _links:
+          self:
+            href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID
     patch-merchants-merchantId-terminalLogos-remove-logo:
       summary: Remove logo to restore the logo from a higher level
       description: Example request to remove the payment terminal logo configured
@@ -20730,6 +20847,42 @@ components:
         splitConfiguration:
           balanceAccountId: BA3227C223222H5HQ2XX77VVH
           splitConfigurationId: SCNF4224P22322585HPCX384JV6JGX
+    patch-stores-storeId-patch-stores-subMerchantData:
+      summary: Add sub-merchant data to store
+      description: Example request to add a sub-merchant data to the store
+      value:
+        subMerchantData:
+          id: '12345'
+          name: Test Merchant
+          mcc: '7999'
+          email: test@email.com
+    patch-stores-storeId-patch-stores-subMerchantData-200:
+      summary: Sub-merchant data added to store
+      description: Example response after adding a sub-merchant data to the store
+      value:
+        id: YOUR_STORE_ID
+        address:
+          country: US
+          line1: 1776 West Pinewood Avenue
+          line2: Heartland Building
+          line3: ''
+          city: Springfield
+          stateOrProvince: NY
+          postalCode: '20251'
+        description: City centre store
+        merchantId: YOUR_MERCHANT_ACCOUNT_ID
+        shopperStatement: Springfield Shop
+        phoneNumber: '+13123456789'
+        reference: Spring_store_2
+        subMerchantData:
+          id: '12345'
+          name: Test Merchant
+          mcc: '7999'
+          email: test@email.com
+        status: active
+        _links:
+          self:
+            href: https://management-test.adyen.com/v1/stores/YOUR_STORE_ID
     patch-stores-storeId-terminalLogos-remove-logo:
       summary: Remove logo to restore the logo from a higher level
       description: Example request to remove the payment terminal logo configured