diff --git a/codegen/pkg/generator/collect.go b/codegen/pkg/generator/collect.go
index c5a59de..be48f87 100644
--- a/codegen/pkg/generator/collect.go
+++ b/codegen/pkg/generator/collect.go
@@ -10,6 +10,7 @@ import (
 )
 
 type schemaUsage struct {
+	name   string
 	schema *base.SchemaProxy
 	tags   map[string]struct{}
 }
@@ -23,79 +24,28 @@ func (g *Generator) collectSchemaUsage() map[string]*schemaUsage {
 
 	for path, pathItem := range g.spec.Paths.PathItems.FromOldest() {
 		for method, op := range pathItem.GetOperations().FromOldest() {
-			c := make(schemaProxyCollection, 0, 16)
-			c.collectSchemasInResponse(op)
-			c.collectSchemasInParams(op)
-			c.collectSchemasInRequest(op)
-
-			for _, schema := range c {
-				if schema == nil {
-					continue
-				}
-
-				if schema.GetReference() == "" {
-					continue
-				}
-
-				name := schemaClassName(schema)
-				entry, ok := usage[name]
-				if !ok {
-					entry = &schemaUsage{
-						schema: schema,
-						tags:   make(map[string]struct{}),
-					}
-					usage[name] = entry
-				}
-
-				if len(op.Tags) == 0 {
-					slog.Warn("operation without tags; skipping schema assignment",
-						slog.String("path", path),
-						slog.String("method", method),
-						slog.String("schema", name),
-					)
-					continue
-				}
-
-				for _, tag := range op.Tags {
-					entry.tags[normalizeTagKey(tag)] = struct{}{}
-				}
+			opTags := make([]string, 0, len(op.Tags))
+			for _, tag := range op.Tags {
+				opTags = append(opTags, normalizeTagKey(tag))
 			}
-		}
-	}
-
-	return usage
-}
-
-func (g *Generator) assignSchemasToTags(usage map[string]*schemaUsage) (map[string][]*base.SchemaProxy, map[string]string) {
-	result := make(map[string][]*base.SchemaProxy)
-	namespaceBySchema := make(map[string]string)
-
-	for schemaName, info := range usage {
-		targetTag := typesTagKey
 
-		// Skip schemas that are additionalProperties-only (they'll be treated as arrays)
-		if schemaIsAdditionalPropertiesOnly(info.schema) {
-			continue
-		}
+			g.collectSchemaUsageInResponse(op, opTags, usage)
+			g.collectSchemaUsageInParams(op, opTags, usage)
+			g.collectSchemaUsageInRequest(op, opTags, usage)
 
-		if schemaIsObject(info.schema) {
-			result[targetTag] = append(result[targetTag], info.schema)
-			namespaceBySchema[schemaName] = g.namespaceForTag(targetTag)
+			if len(op.Tags) == 0 {
+				slog.Warn("operation without tags; skipping schema assignment",
+					slog.String("path", path),
+					slog.String("method", method),
+				)
+			}
 		}
 	}
 
-	for tag := range result {
-		slices.SortFunc(result[tag], func(a, b *base.SchemaProxy) int {
-			return strings.Compare(schemaClassName(a), schemaClassName(b))
-		})
-	}
-
-	return result, namespaceBySchema
+	return usage
 }
 
-type schemaProxyCollection []*base.SchemaProxy
-
-func (c *schemaProxyCollection) collectSchemasInResponse(op *v3.Operation) {
+func (g *Generator) collectSchemaUsageInResponse(op *v3.Operation, tags []string, usage map[string]*schemaUsage) {
 	if op == nil || op.Responses == nil || op.Responses.Codes.Len() == 0 {
 		return
 	}
@@ -106,64 +56,178 @@ func (c *schemaProxyCollection) collectSchemasInResponse(op *v3.Operation) {
 		}
 
 		for _, mediaType := range response.Content.FromOldest() {
-			c.collectReferencedSchemas(mediaType.Schema)
+			g.collectSchemaUsageFromSchema(mediaType.Schema, tags, usage, make(map[*base.SchemaProxy]struct{}), "")
 		}
 	}
 }
 
-func (c *schemaProxyCollection) collectSchemasInParams(op *v3.Operation) {
+func (g *Generator) collectSchemaUsageInParams(op *v3.Operation, tags []string, usage map[string]*schemaUsage) {
 	if op == nil {
 		return
 	}
 
 	for _, param := range op.Parameters {
-		c.collectReferencedSchemas(param.Schema)
+		g.collectSchemaUsageFromSchema(param.Schema, tags, usage, make(map[*base.SchemaProxy]struct{}), "")
 	}
 }
 
-func (c *schemaProxyCollection) collectSchemasInRequest(op *v3.Operation) {
+func (g *Generator) collectSchemaUsageInRequest(op *v3.Operation, tags []string, usage map[string]*schemaUsage) {
 	if op == nil || op.RequestBody == nil {
 		return
 	}
 
 	for _, mediaType := range op.RequestBody.Content.FromOldest() {
-		c.collectReferencedSchemas(mediaType.Schema)
+		g.collectSchemaUsageFromSchema(mediaType.Schema, tags, usage, make(map[*base.SchemaProxy]struct{}), "")
 	}
 }
 
-func (c *schemaProxyCollection) collectReferencedSchemas(schema *base.SchemaProxy) {
+func (g *Generator) collectSchemaUsageFromSchema(schema *base.SchemaProxy, tags []string, usage map[string]*schemaUsage, stack map[*base.SchemaProxy]struct{}, suggestedName string) {
 	if schema == nil {
 		return
 	}
 
+	if _, ok := stack[schema]; ok {
+		return
+	}
+	stack[schema] = struct{}{}
+	defer delete(stack, schema)
+
 	spec := schema.Schema()
 	if spec == nil {
 		return
 	}
 
-	if slices.Contains(spec.Type, "object") {
-		for _, prop := range spec.Properties.FromOldest() {
-			c.collectReferencedSchemas(prop)
+	name := g.registerSchemaUsage(schema, suggestedName, tags, usage)
+	parentName := name
+	if parentName == "" {
+		parentName = suggestedName
+	}
+
+	if spec.Properties != nil {
+		for propName, propSchema := range spec.Properties.FromOldest() {
+			childName := g.inlinePropertyClassName(parentName, propName, propSchema)
+			g.collectSchemaUsageFromSchema(propSchema, tags, usage, stack, childName)
 		}
 	}
 
-	if slices.Contains(spec.Type, "array") && spec.Items != nil {
-		c.collectReferencedSchemas(spec.Items.A)
+	if hasSchemaType(spec, "array") && spec.Items != nil && spec.Items.A != nil {
+		itemName := g.inlineArrayItemClassName(parentName, spec.Items.A)
+		g.collectSchemaUsageFromSchema(spec.Items.A, tags, usage, stack, itemName)
 	}
 
-	for _, one := range spec.AnyOf {
-		c.collectReferencedSchemas(one)
+	for _, composite := range spec.AllOf {
+		g.collectSchemaUsageFromSchema(composite, tags, usage, stack, parentName)
 	}
+	for _, composite := range spec.AnyOf {
+		g.collectSchemaUsageFromSchema(composite, tags, usage, stack, parentName)
+	}
+	for _, composite := range spec.OneOf {
+		g.collectSchemaUsageFromSchema(composite, tags, usage, stack, parentName)
+	}
+}
 
-	for _, one := range spec.AllOf {
-		c.collectReferencedSchemas(one)
+func (g *Generator) registerSchemaUsage(schema *base.SchemaProxy, suggestedName string, tags []string, usage map[string]*schemaUsage) string {
+	if schema == nil {
+		return ""
+	}
+
+	name := g.classNameForSchema(schema)
+	if name == "" {
+		if suggestedName == "" || !schemaIsObject(schema) || schemaIsAdditionalPropertiesOnly(schema) {
+			return ""
+		}
+		name = suggestedName
+		g.inlineSchemaNames[schema] = name
 	}
 
-	for _, one := range spec.OneOf {
-		c.collectReferencedSchemas(one)
+	entry, ok := usage[name]
+	if !ok {
+		entry = &schemaUsage{
+			name:   name,
+			schema: schema,
+			tags:   make(map[string]struct{}),
+		}
+		usage[name] = entry
 	}
 
-	if !slices.Contains(*c, schema) {
-		*c = append(*c, schema)
+	for _, tag := range tags {
+		entry.tags[tag] = struct{}{}
 	}
+
+	return name
+}
+
+func (g *Generator) assignSchemasToTags(usage map[string]*schemaUsage) (map[string][]*base.SchemaProxy, map[string]string) {
+	result := make(map[string][]*base.SchemaProxy)
+	namespaceBySchema := make(map[string]string)
+
+	for schemaName, info := range usage {
+		targetTag := typesTagKey
+
+		// Skip schemas that are additionalProperties-only (they'll be treated as arrays)
+		if schemaIsAdditionalPropertiesOnly(info.schema) {
+			continue
+		}
+
+		if schemaIsObject(info.schema) {
+			result[targetTag] = append(result[targetTag], info.schema)
+			namespaceBySchema[schemaName] = g.namespaceForTag(targetTag)
+		}
+	}
+
+	for tag := range result {
+		slices.SortFunc(result[tag], func(a, b *base.SchemaProxy) int {
+			return strings.Compare(g.classNameForSchema(a), g.classNameForSchema(b))
+		})
+	}
+
+	return result, namespaceBySchema
+}
+
+func (g *Generator) classNameForSchema(schema *base.SchemaProxy) string {
+	if schema == nil {
+		return ""
+	}
+
+	if ref := schema.GetReference(); ref != "" {
+		return schemaClassName(schema)
+	}
+
+	if name, ok := g.inlineSchemaNames[schema]; ok {
+		return name
+	}
+
+	return ""
+}
+
+func (g *Generator) inlinePropertyClassName(parentName string, propertyName string, schema *base.SchemaProxy) string {
+	if parentName == "" || schema == nil {
+		return ""
+	}
+
+	if schema.GetReference() != "" {
+		return ""
+	}
+
+	if !schemaIsObject(schema) || schemaIsAdditionalPropertiesOnly(schema) {
+		return ""
+	}
+
+	return phpInlineObjectName(parentName, propertyName)
+}
+
+func (g *Generator) inlineArrayItemClassName(parentName string, schema *base.SchemaProxy) string {
+	if parentName == "" || schema == nil {
+		return ""
+	}
+
+	if schema.GetReference() != "" {
+		return ""
+	}
+
+	if !schemaIsObject(schema) || schemaIsAdditionalPropertiesOnly(schema) {
+		return ""
+	}
+
+	return parentName + "Item"
 }
diff --git a/codegen/pkg/generator/generator.go b/codegen/pkg/generator/generator.go
index 10dbc31..4122fbb 100644
--- a/codegen/pkg/generator/generator.go
+++ b/codegen/pkg/generator/generator.go
@@ -37,6 +37,9 @@ type Generator struct {
 
 	tagLookup map[string]*base.Tag
 
+	// inlineSchemaNames tracks deterministic generated names for inline object schemas.
+	inlineSchemaNames map[*base.SchemaProxy]string
+
 	// schemasByTag maps normalized tag names to schemas they own.
 	schemasByTag map[string][]*base.SchemaProxy
 
@@ -62,7 +65,8 @@ type enumDefinition struct {
 // New creates a new Generator instance.
 func New(cfg Config) *Generator {
 	return &Generator{
-		cfg: cfg,
+		cfg:               cfg,
+		inlineSchemaNames: make(map[*base.SchemaProxy]string),
 	}
 }
 
@@ -265,7 +269,7 @@ func (g *Generator) buildPHPClass(name string, schema *base.SchemaProxy, current
 
 	fmt.Fprintf(&buf, "class %s\n{\n", name)
 
-	properties := g.schemaProperties(schema, currentNamespace)
+	properties := g.schemaProperties(schema, currentNamespace, name)
 	if len(properties) == 0 {
 		buf.WriteString("}\n")
 		return buf.String()
@@ -430,7 +434,11 @@ func (g *Generator) collectEnumsFromSchema(schema *base.SchemaProxy, tagKey stri
 			}
 
 			if len(propSpec.Enum) > 0 {
-				enumName := phpEnumName(schemaClassName(schema), propName)
+				schemaName := g.classNameForSchema(schema)
+				if schemaName == "" {
+					continue
+				}
+				enumName := phpEnumName(schemaName, propName)
 				if _, seen := enumsSeen[enumName]; seen {
 					continue
 				}
diff --git a/codegen/pkg/generator/names.go b/codegen/pkg/generator/names.go
index 1e7899e..c81fb06 100644
--- a/codegen/pkg/generator/names.go
+++ b/codegen/pkg/generator/names.go
@@ -53,6 +53,15 @@ func phpEnumName(schemaName, propertyName string) string {
 	return schemaName + baseName
 }
 
+func phpInlineObjectName(schemaName, propertyName string) string {
+	propertyName = strings.TrimSpace(propertyName)
+	propertyName = strings.ReplaceAll(propertyName, "-", "_")
+	propertyName = strings.ReplaceAll(propertyName, ".", "_")
+
+	baseName := strcase.ToCamel(propertyName)
+	return schemaName + baseName
+}
+
 func phpEnumCaseName(value string) string {
 	value = strings.TrimSpace(value)
 
diff --git a/codegen/pkg/generator/properties.go b/codegen/pkg/generator/properties.go
index a23c41b..78b971e 100644
--- a/codegen/pkg/generator/properties.go
+++ b/codegen/pkg/generator/properties.go
@@ -18,13 +18,12 @@ type phpProperty struct {
 	Description    string
 }
 
-func (g *Generator) schemaProperties(schema *base.SchemaProxy, currentNamespace string) []phpProperty {
+func (g *Generator) schemaProperties(schema *base.SchemaProxy, currentNamespace string, currentClassName string) []phpProperty {
 	propertySpecs := g.collectSchemaPropertyEntries(schema)
 	if len(propertySpecs) == 0 {
 		return nil
 	}
 
-	schemaName := schemaClassName(schema)
 	props := make([]phpProperty, 0, len(propertySpecs))
 	for _, spec := range propertySpecs {
 		prop := phpProperty{
@@ -37,7 +36,7 @@ func (g *Generator) schemaProperties(schema *base.SchemaProxy, currentNamespace
 			prop.Description = spec.Schema.Schema().Description
 		}
 
-		prop.Type, prop.DocType = g.resolvePHPType(spec.Schema, currentNamespace, schemaName, spec.Name)
+		prop.Type, prop.DocType = g.resolvePHPType(spec.Schema, currentNamespace, currentClassName, spec.Name)
 		props = append(props, prop)
 	}
 
@@ -203,7 +202,7 @@ func (g *Generator) resolvePHPType(schema *base.SchemaProxy, currentNamespace st
 
 	if ref := schema.GetReference(); ref != "" {
 		if !schemaIsObject(schema) {
-			return g.resolvePHPTypeFromSpec(schema.Schema(), currentNamespace, parentSchemaName, propertyName)
+			return g.resolvePHPTypeFromSpec(schema, schema.Schema(), currentNamespace, parentSchemaName, propertyName)
 		}
 
 		// Check if this is an additionalProperties-only schema - treat as array
@@ -211,7 +210,7 @@ func (g *Generator) resolvePHPType(schema *base.SchemaProxy, currentNamespace st
 			return "array", "array<string, mixed>"
 		}
 
-		name := schemaClassName(schema)
+		name := g.classNameForSchema(schema)
 		namespace := g.schemaNamespaces[name]
 		if namespace == "" {
 			return name, name
@@ -225,10 +224,10 @@ func (g *Generator) resolvePHPType(schema *base.SchemaProxy, currentNamespace st
 		return typeName, typeName
 	}
 
-	return g.resolvePHPTypeFromSpec(schema.Schema(), currentNamespace, parentSchemaName, propertyName)
+	return g.resolvePHPTypeFromSpec(schema, schema.Schema(), currentNamespace, parentSchemaName, propertyName)
 }
 
-func (g *Generator) resolvePHPTypeFromSpec(spec *base.Schema, currentNamespace string, parentSchemaName string, propertyName string) (string, string) {
+func (g *Generator) resolvePHPTypeFromSpec(schema *base.SchemaProxy, spec *base.Schema, currentNamespace string, parentSchemaName string, propertyName string) (string, string) {
 	if spec == nil {
 		return "mixed", "mixed"
 	}
@@ -268,6 +267,19 @@ func (g *Generator) resolvePHPTypeFromSpec(spec *base.Schema, currentNamespace s
 		}
 		return "array", itemDoc + "[]"
 	case hasSchemaType(spec, "object"):
+		if schema != nil && !schemaIsAdditionalPropertiesOnly(schema) {
+			typeName := g.classNameForSchema(schema)
+			if typeName == "" && parentSchemaName != "" && propertyName != "" {
+				typeName = phpInlineObjectName(parentSchemaName, propertyName)
+			}
+			if typeName != "" {
+				namespace := g.schemaNamespaces[typeName]
+				if namespace != "" && namespace != currentNamespace {
+					typeName = fmt.Sprintf("\\%s\\%s", namespace, typeName)
+				}
+				return typeName, typeName
+			}
+		}
 		return "array", "array<string, mixed>"
 	default:
 	}
diff --git a/codegen/pkg/generator/services.go b/codegen/pkg/generator/services.go
index 5879d84..2123f80 100644
--- a/codegen/pkg/generator/services.go
+++ b/codegen/pkg/generator/services.go
@@ -28,16 +28,10 @@ func (g *Generator) buildServiceBlock(tagKey string, operations []*operation) st
 	buf.WriteString("use SumUp\\SdkInfo;\n\n")
 
 	inlineResponseSchemas := collectInlineResponseSchemas(operations)
-	if len(inlineResponseSchemas) > 0 {
-		inlineNames := make([]string, 0, len(inlineResponseSchemas))
-		for name := range inlineResponseSchemas {
-			inlineNames = append(inlineNames, name)
-		}
-		slices.Sort(inlineNames)
-		for _, name := range inlineNames {
-			buf.WriteString(g.buildPHPClass(name, inlineResponseSchemas[name], "SumUp\\Services"))
-			buf.WriteString("\n")
-		}
+	serviceInlineSchemas := make(map[string]*base.SchemaProxy)
+	for name, schema := range inlineResponseSchemas {
+		serviceInlineSchemas[name] = schema
+		g.collectNestedInlineServiceSchemas(name, schema, serviceInlineSchemas, make(map[*base.SchemaProxy]struct{}))
 	}
 
 	seenRequestBodies := make(map[string]struct{})
@@ -56,6 +50,10 @@ func (g *Generator) buildServiceBlock(tagKey string, operations []*operation) st
 		op.BodyType = requestClass
 		op.BodyDocType = requestClass
 
+		if op.BodySchema != nil {
+			g.collectNestedInlineServiceSchemas(requestClass, op.BodySchema, serviceInlineSchemas, make(map[*base.SchemaProxy]struct{}))
+		}
+
 		if op.BodySchema != nil {
 			buf.WriteString(g.buildPHPClass(requestClass, op.BodySchema, "SumUp\\Services"))
 		} else {
@@ -64,6 +62,18 @@ func (g *Generator) buildServiceBlock(tagKey string, operations []*operation) st
 		buf.WriteString("\n")
 	}
 
+	if len(serviceInlineSchemas) > 0 {
+		inlineNames := make([]string, 0, len(serviceInlineSchemas))
+		for name := range serviceInlineSchemas {
+			inlineNames = append(inlineNames, name)
+		}
+		slices.Sort(inlineNames)
+		for _, name := range inlineNames {
+			buf.WriteString(g.buildPHPClass(name, serviceInlineSchemas[name], "SumUp\\Services"))
+			buf.WriteString("\n")
+		}
+	}
+
 	seenParams := make(map[string]struct{})
 	for _, op := range operations {
 		if op == nil || !op.HasQuery {
@@ -466,6 +476,61 @@ func collectInlineResponseSchema(rt *responseType, acc map[string]*base.SchemaPr
 	}
 }
 
+func (g *Generator) collectNestedInlineServiceSchemas(parentName string, schema *base.SchemaProxy, acc map[string]*base.SchemaProxy, stack map[*base.SchemaProxy]struct{}) {
+	if parentName == "" || schema == nil {
+		return
+	}
+
+	if _, ok := stack[schema]; ok {
+		return
+	}
+	stack[schema] = struct{}{}
+	defer delete(stack, schema)
+
+	spec := schema.Schema()
+	if spec == nil {
+		return
+	}
+
+	if spec.Properties != nil {
+		for propName, propSchema := range spec.Properties.FromOldest() {
+			name := g.inlinePropertyClassName(parentName, propName, propSchema)
+			if name != "" {
+				if _, ok := acc[name]; !ok {
+					acc[name] = propSchema
+				}
+				g.inlineSchemaNames[propSchema] = name
+				g.collectNestedInlineServiceSchemas(name, propSchema, acc, stack)
+			} else {
+				g.collectNestedInlineServiceSchemas(parentName, propSchema, acc, stack)
+			}
+		}
+	}
+
+	if hasSchemaType(spec, "array") && spec.Items != nil && spec.Items.A != nil {
+		itemName := g.inlineArrayItemClassName(parentName, spec.Items.A)
+		if itemName != "" {
+			if _, ok := acc[itemName]; !ok {
+				acc[itemName] = spec.Items.A
+			}
+			g.inlineSchemaNames[spec.Items.A] = itemName
+			g.collectNestedInlineServiceSchemas(itemName, spec.Items.A, acc, stack)
+		} else {
+			g.collectNestedInlineServiceSchemas(parentName, spec.Items.A, acc, stack)
+		}
+	}
+
+	for _, composite := range spec.AllOf {
+		g.collectNestedInlineServiceSchemas(parentName, composite, acc, stack)
+	}
+	for _, composite := range spec.AnyOf {
+		g.collectNestedInlineServiceSchemas(parentName, composite, acc, stack)
+	}
+	for _, composite := range spec.OneOf {
+		g.collectNestedInlineServiceSchemas(parentName, composite, acc, stack)
+	}
+}
+
 func renderResponseTypeDescriptor(rt *responseType) string {
 	if rt == nil {
 		return "['type' => 'mixed']"
diff --git a/codegen/pkg/generator/types.go b/codegen/pkg/generator/types.go
index 63568c1..0c0d91f 100644
--- a/codegen/pkg/generator/types.go
+++ b/codegen/pkg/generator/types.go
@@ -46,7 +46,7 @@ func (g *Generator) writeTypeModels(schemas []*base.SchemaProxy) error {
 	}
 
 	for _, schema := range schemas {
-		className := schemaClassName(schema)
+		className := g.classNameForSchema(schema)
 		filename := filepath.Join(dir, fmt.Sprintf("%s.php", className))
 		f, err := os.OpenFile(filename, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0o644)
 		if err != nil {
diff --git a/src/Checkouts/Checkouts.php b/src/Checkouts/Checkouts.php
index 98bc9df..f3a9486 100644
--- a/src/Checkouts/Checkouts.php
+++ b/src/Checkouts/Checkouts.php
@@ -16,12 +16,23 @@ class CheckoutsListAvailablePaymentMethodsResponse
 {
     /**
      *
-     * @var array<string, mixed>[]|null
+     * @var CheckoutsListAvailablePaymentMethodsResponseItem[]|null
      */
     public ?array $availablePaymentMethods = null;
 
 }
 
+class CheckoutsListAvailablePaymentMethodsResponseItem
+{
+    /**
+     * The ID of the payment method.
+     *
+     * @var string
+     */
+    public string $id;
+
+}
+
 /**
  * Query parameters for CheckoutsListParams.
  *
diff --git a/src/Members/Members.php b/src/Members/Members.php
index 896a288..377759e 100644
--- a/src/Members/Members.php
+++ b/src/Members/Members.php
@@ -12,22 +12,6 @@
 use SumUp\ResponseDecoder;
 use SumUp\SdkInfo;
 
-class MembersListResponse
-{
-    /**
-     *
-     * @var \SumUp\Types\Member[]
-     */
-    public array $items;
-
-    /**
-     *
-     * @var int|null
-     */
-    public ?int $totalCount = null;
-
-}
-
 class MembersCreateRequest
 {
     /**
@@ -118,9 +102,9 @@ class MembersUpdateRequest
     /**
      * Allows you to update user data of managed users.
      *
-     * @var array<string, mixed>|null
+     * @var MembersUpdateRequestUser|null
      */
-    public ?array $user = null;
+    public ?MembersUpdateRequestUser $user = null;
 
     /**
      * Create request DTO from an associative array.
@@ -136,6 +120,43 @@ public function __construct(array $data = [])
 
 }
 
+class MembersListResponse
+{
+    /**
+     *
+     * @var \SumUp\Types\Member[]
+     */
+    public array $items;
+
+    /**
+     *
+     * @var int|null
+     */
+    public ?int $totalCount = null;
+
+}
+
+/**
+ * Allows you to update user data of managed users.
+ */
+class MembersUpdateRequestUser
+{
+    /**
+     * User's preferred name. Used for display purposes only.
+     *
+     * @var string|null
+     */
+    public ?string $nickname = null;
+
+    /**
+     * Password of the member to add. Only used if `is_managed_user` is true.
+     *
+     * @var string|null
+     */
+    public ?string $password = null;
+
+}
+
 /**
  * Query parameters for MembersListParams.
  *
diff --git a/src/Readers/Readers.php b/src/Readers/Readers.php
index d9c8f86..8817cf7 100644
--- a/src/Readers/Readers.php
+++ b/src/Readers/Readers.php
@@ -12,16 +12,6 @@
 use SumUp\ResponseDecoder;
 use SumUp\SdkInfo;
 
-class ReadersListResponse
-{
-    /**
-     *
-     * @var \SumUp\Types\Reader[]
-     */
-    public array $items;
-
-}
-
 class ReadersCreateRequest
 {
     /**
@@ -98,6 +88,16 @@ public function __construct(array $data = [])
 
 }
 
+class ReadersListResponse
+{
+    /**
+     *
+     * @var \SumUp\Types\Reader[]
+     */
+    public array $items;
+
+}
+
 /**
  * Class Readers
  *
diff --git a/src/Roles/Roles.php b/src/Roles/Roles.php
index 83d460f..d5279b4 100644
--- a/src/Roles/Roles.php
+++ b/src/Roles/Roles.php
@@ -12,16 +12,6 @@
 use SumUp\ResponseDecoder;
 use SumUp\SdkInfo;
 
-class RolesListResponse
-{
-    /**
-     *
-     * @var \SumUp\Types\Role[]
-     */
-    public array $items;
-
-}
-
 class RolesCreateRequest
 {
     /**
@@ -103,6 +93,16 @@ public function __construct(array $data = [])
 
 }
 
+class RolesListResponse
+{
+    /**
+     *
+     * @var \SumUp\Types\Role[]
+     */
+    public array $items;
+
+}
+
 /**
  * Class Roles
  *
diff --git a/src/Subaccounts/Subaccounts.php b/src/Subaccounts/Subaccounts.php
index d0ba328..83da5c5 100644
--- a/src/Subaccounts/Subaccounts.php
+++ b/src/Subaccounts/Subaccounts.php
@@ -34,9 +34,9 @@ class SubaccountsCreateSubAccountRequest
 
     /**
      *
-     * @var array<string, mixed>|null
+     * @var SubaccountsCreateSubAccountRequestPermissions|null
      */
-    public ?array $permissions = null;
+    public ?SubaccountsCreateSubAccountRequestPermissions $permissions = null;
 
     /**
      * Create request DTO from an associative array.
@@ -80,9 +80,9 @@ class SubaccountsUpdateSubAccountRequest
 
     /**
      *
-     * @var array<string, mixed>|null
+     * @var SubaccountsUpdateSubAccountRequestPermissions|null
      */
-    public ?array $permissions = null;
+    public ?SubaccountsUpdateSubAccountRequestPermissions $permissions = null;
 
     /**
      * Create request DTO from an associative array.
@@ -98,6 +98,62 @@ public function __construct(array $data = [])
 
 }
 
+class SubaccountsCreateSubAccountRequestPermissions
+{
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $createMotoPayments = null;
+
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $createReferral = null;
+
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $fullTransactionHistoryView = null;
+
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $refundTransactions = null;
+
+}
+
+class SubaccountsUpdateSubAccountRequestPermissions
+{
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $createMotoPayments = null;
+
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $createReferral = null;
+
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $fullTransactionHistoryView = null;
+
+    /**
+     *
+     * @var bool|null
+     */
+    public ?bool $refundTransactions = null;
+
+}
+
 /**
  * Query parameters for SubaccountsListSubAccountsParams.
  *
diff --git a/src/Transactions/Transactions.php b/src/Transactions/Transactions.php
index fdcc785..8ac547e 100644
--- a/src/Transactions/Transactions.php
+++ b/src/Transactions/Transactions.php
@@ -12,23 +12,33 @@
 use SumUp\ResponseDecoder;
 use SumUp\SdkInfo;
 
-class TransactionsListDeprecatedResponse
+/**
+ * Optional amount for partial refunds of transactions.
+ */
+class TransactionsRefundRequest
 {
     /**
+     * Amount to be refunded. Eligible amount can't exceed the amount of the transaction and varies based on country and currency. If you do not specify a value, the system performs a full refund of the transaction.
      *
-     * @var \SumUp\Types\TransactionHistory[]|null
+     * @var float|null
      */
-    public ?array $items = null;
+    public ?float $amount = null;
 
     /**
+     * Create request DTO from an associative array.
      *
-     * @var \SumUp\Types\TransactionsHistoryLink[]|null
+     * @param array<string, mixed> $data
      */
-    public ?array $links = null;
+    public function __construct(array $data = [])
+    {
+        if ($data !== []) {
+            \SumUp\Hydrator::hydrate($data, self::class, $this);
+        }
+    }
 
 }
 
-class TransactionsListResponse
+class TransactionsListDeprecatedResponse
 {
     /**
      *
@@ -44,29 +54,19 @@ class TransactionsListResponse
 
 }
 
-/**
- * Optional amount for partial refunds of transactions.
- */
-class TransactionsRefundRequest
+class TransactionsListResponse
 {
     /**
-     * Amount to be refunded. Eligible amount can't exceed the amount of the transaction and varies based on country and currency. If you do not specify a value, the system performs a full refund of the transaction.
      *
-     * @var float|null
+     * @var \SumUp\Types\TransactionHistory[]|null
      */
-    public ?float $amount = null;
+    public ?array $items = null;
 
     /**
-     * Create request DTO from an associative array.
      *
-     * @param array<string, mixed> $data
+     * @var \SumUp\Types\TransactionsHistoryLink[]|null
      */
-    public function __construct(array $data = [])
-    {
-        if ($data !== []) {
-            \SumUp\Hydrator::hydrate($data, self::class, $this);
-        }
-    }
+    public ?array $links = null;
 
 }
 
diff --git a/src/Types/BadRequest.php b/src/Types/BadRequest.php
index 4095310..448a2c5 100644
--- a/src/Types/BadRequest.php
+++ b/src/Types/BadRequest.php
@@ -11,8 +11,8 @@ class BadRequest
 {
     /**
      *
-     * @var array<string, mixed>
+     * @var BadRequestErrors
      */
-    public array $errors;
+    public BadRequestErrors $errors;
 
 }
diff --git a/src/Types/BadRequestErrors.php b/src/Types/BadRequestErrors.php
new file mode 100644
index 0000000..24321d5
--- /dev/null
+++ b/src/Types/BadRequestErrors.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class BadRequestErrors
+{
+    /**
+     * Fuller message giving context to error
+     *
+     * @var string|null
+     */
+    public ?string $detail = null;
+
+    /**
+     * Key indicating type of error
+     *
+     * @var BadRequestErrorsType
+     */
+    public BadRequestErrorsType $type;
+
+}
diff --git a/src/Types/ModelType.php b/src/Types/BadRequestErrorsType.php
similarity index 90%
rename from src/Types/ModelType.php
rename to src/Types/BadRequestErrorsType.php
index 94bb70c..de9b1be 100644
--- a/src/Types/ModelType.php
+++ b/src/Types/BadRequestErrorsType.php
@@ -7,7 +7,7 @@
 /**
  * Key indicating type of error
  */
-enum ModelType: string
+enum BadRequestErrorsType: string
 {
     case INVALID_BEARER_TOKEN = 'INVALID_BEARER_TOKEN';
     case INVALID_USER_AGENT = 'INVALID_USER_AGENT';
diff --git a/src/Types/CheckoutAccepted.php b/src/Types/CheckoutAccepted.php
index 0c806b6..eab40ce 100644
--- a/src/Types/CheckoutAccepted.php
+++ b/src/Types/CheckoutAccepted.php
@@ -12,8 +12,8 @@ class CheckoutAccepted
     /**
      * Required action processing 3D Secure payments.
      *
-     * @var array<string, mixed>|null
+     * @var CheckoutAcceptedNextStep|null
      */
-    public ?array $nextStep = null;
+    public ?CheckoutAcceptedNextStep $nextStep = null;
 
 }
diff --git a/src/Types/CheckoutAcceptedNextStep.php b/src/Types/CheckoutAcceptedNextStep.php
new file mode 100644
index 0000000..335187b
--- /dev/null
+++ b/src/Types/CheckoutAcceptedNextStep.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Required action processing 3D Secure payments.
+ */
+class CheckoutAcceptedNextStep
+{
+    /**
+     * Where the end user is redirected.
+     *
+     * @var string|null
+     */
+    public ?string $url = null;
+
+    /**
+     * Method used to complete the redirect.
+     *
+     * @var string|null
+     */
+    public ?string $method = null;
+
+    /**
+     * Refers to a url where the end user is redirected once the payment processing completes.
+     *
+     * @var string|null
+     */
+    public ?string $redirectUrl = null;
+
+    /**
+     * Indicates allowed mechanisms for redirecting an end user. If both values are provided to ensure a redirect takes place in either.
+     *
+     * @var string[]|null
+     */
+    public ?array $mechanism = null;
+
+    /**
+     * Contains parameters essential for form redirection. Number of object keys and their content can vary.
+     *
+     * @var CheckoutAcceptedNextStepPayload|null
+     */
+    public ?CheckoutAcceptedNextStepPayload $payload = null;
+
+}
diff --git a/src/Types/CheckoutAcceptedNextStepPayload.php b/src/Types/CheckoutAcceptedNextStepPayload.php
new file mode 100644
index 0000000..ce0f9fc
--- /dev/null
+++ b/src/Types/CheckoutAcceptedNextStepPayload.php
@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Contains parameters essential for form redirection. Number of object keys and their content can vary.
+ */
+class CheckoutAcceptedNextStepPayload
+{
+    /**
+     *
+     * @var mixed|null
+     */
+    public mixed $paReq = null;
+
+    /**
+     *
+     * @var mixed|null
+     */
+    public mixed $md = null;
+
+    /**
+     *
+     * @var mixed|null
+     */
+    public mixed $termUrl = null;
+
+}
diff --git a/src/Types/CheckoutSuccess.php b/src/Types/CheckoutSuccess.php
index 2cbb2fa..72f143b 100644
--- a/src/Types/CheckoutSuccess.php
+++ b/src/Types/CheckoutSuccess.php
@@ -131,8 +131,8 @@ class CheckoutSuccess
     /**
      * Object containing token information for the specified payment instrument
      *
-     * @var array<string, mixed>|null
+     * @var CheckoutSuccessPaymentInstrument|null
      */
-    public ?array $paymentInstrument = null;
+    public ?CheckoutSuccessPaymentInstrument $paymentInstrument = null;
 
 }
diff --git a/src/Types/CheckoutSuccessPaymentInstrument.php b/src/Types/CheckoutSuccessPaymentInstrument.php
new file mode 100644
index 0000000..51a43f9
--- /dev/null
+++ b/src/Types/CheckoutSuccessPaymentInstrument.php
@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Object containing token information for the specified payment instrument
+ */
+class CheckoutSuccessPaymentInstrument
+{
+    /**
+     * Token value
+     *
+     * @var string|null
+     */
+    public ?string $token = null;
+
+}
diff --git a/src/Types/CreateReaderCheckoutError.php b/src/Types/CreateReaderCheckoutError.php
index fd50dca..a49351f 100644
--- a/src/Types/CreateReaderCheckoutError.php
+++ b/src/Types/CreateReaderCheckoutError.php
@@ -11,8 +11,8 @@ class CreateReaderCheckoutError
 {
     /**
      *
-     * @var array<string, mixed>
+     * @var CreateReaderCheckoutErrorErrors
      */
-    public array $errors;
+    public CreateReaderCheckoutErrorErrors $errors;
 
 }
diff --git a/src/Types/CreateReaderCheckoutErrorErrors.php b/src/Types/CreateReaderCheckoutErrorErrors.php
new file mode 100644
index 0000000..3ba10f4
--- /dev/null
+++ b/src/Types/CreateReaderCheckoutErrorErrors.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class CreateReaderCheckoutErrorErrors
+{
+    /**
+     * Error message
+     *
+     * @var string|null
+     */
+    public ?string $detail = null;
+
+    /**
+     * Error code
+     *
+     * @var string
+     */
+    public string $type;
+
+}
diff --git a/src/Types/CreateReaderCheckoutRequest.php b/src/Types/CreateReaderCheckoutRequest.php
index e318c93..34df644 100644
--- a/src/Types/CreateReaderCheckoutRequest.php
+++ b/src/Types/CreateReaderCheckoutRequest.php
@@ -13,17 +13,17 @@ class CreateReaderCheckoutRequest
      * Optional object containing data for transactions from ERP integrators in Greece that comply with the AADE 1155 protocol.
      * When such regulatory/business requirements apply, this object must be provided and contains the data needed to validate the transaction with the AADE signature provider.
      *
-     * @var array<string, mixed>|null
+     * @var CreateReaderCheckoutRequestAade|null
      */
-    public ?array $aade = null;
+    public ?CreateReaderCheckoutRequestAade $aade = null;
 
     /**
      * Affiliate metadata for the transaction.
      * It is a field that allow for integrators to track the source of the transaction.
      *
-     * @var array<string, mixed>|null
+     * @var CreateReaderCheckoutRequestAffiliate|null
      */
-    public ?array $affiliate = null;
+    public ?CreateReaderCheckoutRequestAffiliate $affiliate = null;
 
     /**
      * The card type of the card used for the transaction.
@@ -83,9 +83,9 @@ class CreateReaderCheckoutRequest
      * The amount is represented as an integer value altogether with the currency and the minor unit.
      * For example, EUR 1.00 is represented as value 100 with minor unit of 2.
      *
-     * @var array<string, mixed>
+     * @var CreateReaderCheckoutRequestTotalAmount
      */
-    public array $totalAmount;
+    public CreateReaderCheckoutRequestTotalAmount $totalAmount;
 
     /**
      * Create request DTO from an associative array.
diff --git a/src/Types/CreateReaderCheckoutRequestAade.php b/src/Types/CreateReaderCheckoutRequestAade.php
new file mode 100644
index 0000000..929e5a0
--- /dev/null
+++ b/src/Types/CreateReaderCheckoutRequestAade.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Optional object containing data for transactions from ERP integrators in Greece that comply with the AADE 1155 protocol.
+ * When such regulatory/business requirements apply, this object must be provided and contains the data needed to validate the transaction with the AADE signature provider.
+ *
+ */
+class CreateReaderCheckoutRequestAade
+{
+    /**
+     * The identifier of the AADE signature provider.
+     *
+     * @var string
+     */
+    public string $providerId;
+
+    /**
+     * The base64 encoded signature of the transaction data.
+     *
+     * @var string
+     */
+    public string $signature;
+
+    /**
+     * The string containing the signed transaction data.
+     *
+     * @var string
+     */
+    public string $signatureData;
+
+}
diff --git a/src/Types/CreateReaderCheckoutRequestAffiliate.php b/src/Types/CreateReaderCheckoutRequestAffiliate.php
new file mode 100644
index 0000000..26b5d50
--- /dev/null
+++ b/src/Types/CreateReaderCheckoutRequestAffiliate.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Affiliate metadata for the transaction.
+ * It is a field that allow for integrators to track the source of the transaction.
+ *
+ */
+class CreateReaderCheckoutRequestAffiliate
+{
+    /**
+     * Application ID of the affiliate.
+     * It is a unique identifier for the application and should be set by the integrator in the [Affiliate Keys](https://developer.sumup.com/affiliate-keys) page.
+     *
+     * @var string
+     */
+    public string $appId;
+
+    /**
+     * Foreign transaction ID of the affiliate.
+     * It is a unique identifier for the transaction.
+     * It can be used later to fetch the transaction details via the [Transactions API](https://developer.sumup.com/api/transactions/get).
+     *
+     * @var string
+     */
+    public string $foreignTransactionId;
+
+    /**
+     * Key of the affiliate.
+     * It is a unique identifier for the key  and should be generated by the integrator in the [Affiliate Keys](https://developer.sumup.com/affiliate-keys) page.
+     *
+     * @var string
+     */
+    public string $key;
+
+    /**
+     * Additional metadata for the transaction.
+     * It is key-value object that can be associated with the transaction.
+     *
+     * @var array<string, mixed>|null
+     */
+    public ?array $tags = null;
+
+}
diff --git a/src/Types/CreateReaderCheckoutRequestTotalAmount.php b/src/Types/CreateReaderCheckoutRequestTotalAmount.php
new file mode 100644
index 0000000..ae2fd13
--- /dev/null
+++ b/src/Types/CreateReaderCheckoutRequestTotalAmount.php
@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Amount structure.
+ *
+ * The amount is represented as an integer value altogether with the currency and the minor unit.
+ *
+ * For example, EUR 1.00 is represented as value 100 with minor unit of 2.
+ *
+ */
+class CreateReaderCheckoutRequestTotalAmount
+{
+    /**
+     * Currency ISO 4217 code
+     *
+     * @var string
+     */
+    public string $currency;
+
+    /**
+     * The minor units of the currency.
+     * It represents the number of decimals of the currency. For the currencies CLP, COP and HUF, the minor unit is 0.
+     *
+     * @var int
+     */
+    public int $minorUnit;
+
+    /**
+     * Integer value of the amount.
+     *
+     * @var int
+     */
+    public int $value;
+
+}
diff --git a/src/Types/CreateReaderCheckoutResponse.php b/src/Types/CreateReaderCheckoutResponse.php
index a70ef26..b5262b6 100644
--- a/src/Types/CreateReaderCheckoutResponse.php
+++ b/src/Types/CreateReaderCheckoutResponse.php
@@ -8,8 +8,8 @@ class CreateReaderCheckoutResponse
 {
     /**
      *
-     * @var array<string, mixed>
+     * @var CreateReaderCheckoutResponseData
      */
-    public array $data;
+    public CreateReaderCheckoutResponseData $data;
 
 }
diff --git a/src/Types/CreateReaderCheckoutResponseData.php b/src/Types/CreateReaderCheckoutResponseData.php
new file mode 100644
index 0000000..2158152
--- /dev/null
+++ b/src/Types/CreateReaderCheckoutResponseData.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class CreateReaderCheckoutResponseData
+{
+    /**
+     * The client transaction ID is a unique identifier for the transaction that is generated for the client.
+     * It can be used later to fetch the transaction details via the [Transactions API](https://developer.sumup.com/api/transactions/get).
+     *
+     * @var string
+     */
+    public string $clientTransactionId;
+
+}
diff --git a/src/Types/CreateReaderTerminateError.php b/src/Types/CreateReaderTerminateError.php
index e7d803c..f308157 100644
--- a/src/Types/CreateReaderTerminateError.php
+++ b/src/Types/CreateReaderTerminateError.php
@@ -11,8 +11,8 @@ class CreateReaderTerminateError
 {
     /**
      *
-     * @var array<string, mixed>
+     * @var CreateReaderTerminateErrorErrors
      */
-    public array $errors;
+    public CreateReaderTerminateErrorErrors $errors;
 
 }
diff --git a/src/Types/CreateReaderTerminateErrorErrors.php b/src/Types/CreateReaderTerminateErrorErrors.php
new file mode 100644
index 0000000..f5092d1
--- /dev/null
+++ b/src/Types/CreateReaderTerminateErrorErrors.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class CreateReaderTerminateErrorErrors
+{
+    /**
+     * Error message
+     *
+     * @var string|null
+     */
+    public ?string $detail = null;
+
+    /**
+     * Error code
+     *
+     * @var string
+     */
+    public string $type;
+
+}
diff --git a/src/Types/FinancialPayoutsItem.php b/src/Types/FinancialPayoutsItem.php
new file mode 100644
index 0000000..0d46949
--- /dev/null
+++ b/src/Types/FinancialPayoutsItem.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class FinancialPayoutsItem
+{
+    /**
+     *
+     * @var float|null
+     */
+    public ?float $amount = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $currency = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $date = null;
+
+    /**
+     *
+     * @var float|null
+     */
+    public ?float $fee = null;
+
+    /**
+     *
+     * @var int|null
+     */
+    public ?int $id = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $reference = null;
+
+    /**
+     *
+     * @var FinancialPayoutsItemStatus|null
+     */
+    public ?FinancialPayoutsItemStatus $status = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $transactionCode = null;
+
+    /**
+     *
+     * @var FinancialPayoutsItemType|null
+     */
+    public ?FinancialPayoutsItemType $type = null;
+
+}
diff --git a/src/Types/FinancialPayoutsItemStatus.php b/src/Types/FinancialPayoutsItemStatus.php
new file mode 100644
index 0000000..aebed95
--- /dev/null
+++ b/src/Types/FinancialPayoutsItemStatus.php
@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+enum FinancialPayoutsItemStatus: string
+{
+    case SUCCESSFUL = 'SUCCESSFUL';
+    case FAILED = 'FAILED';
+}
diff --git a/src/Types/FinancialPayoutsItemType.php b/src/Types/FinancialPayoutsItemType.php
new file mode 100644
index 0000000..25b899e
--- /dev/null
+++ b/src/Types/FinancialPayoutsItemType.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+enum FinancialPayoutsItemType: string
+{
+    case PAYOUT = 'PAYOUT';
+    case CHARGE_BACK_DEDUCTION = 'CHARGE_BACK_DEDUCTION';
+    case REFUND_DEDUCTION = 'REFUND_DEDUCTION';
+    case DD_RETURN_DEDUCTION = 'DD_RETURN_DEDUCTION';
+    case BALANCE_DEDUCTION = 'BALANCE_DEDUCTION';
+}
diff --git a/src/Types/NotFound.php b/src/Types/NotFound.php
index eba646d..3e41c3f 100644
--- a/src/Types/NotFound.php
+++ b/src/Types/NotFound.php
@@ -11,8 +11,8 @@ class NotFound
 {
     /**
      *
-     * @var array<string, mixed>
+     * @var NotFoundErrors
      */
-    public array $errors;
+    public NotFoundErrors $errors;
 
 }
diff --git a/src/Types/NotFoundErrors.php b/src/Types/NotFoundErrors.php
new file mode 100644
index 0000000..80ef380
--- /dev/null
+++ b/src/Types/NotFoundErrors.php
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class NotFoundErrors
+{
+    /**
+     * Fuller message giving context to error
+     *
+     * @var string
+     */
+    public string $detail;
+
+}
diff --git a/src/Types/PaymentInstrumentResponse.php b/src/Types/PaymentInstrumentResponse.php
index a02f44c..98758b9 100644
--- a/src/Types/PaymentInstrumentResponse.php
+++ b/src/Types/PaymentInstrumentResponse.php
@@ -33,9 +33,9 @@ class PaymentInstrumentResponse
     /**
      * Details of the payment card.
      *
-     * @var array<string, mixed>|null
+     * @var PaymentInstrumentResponseCard|null
      */
-    public ?array $card = null;
+    public ?PaymentInstrumentResponseCard $card = null;
 
     /**
      * Created mandate
diff --git a/src/Types/PaymentInstrumentResponseCard.php b/src/Types/PaymentInstrumentResponseCard.php
new file mode 100644
index 0000000..1faa856
--- /dev/null
+++ b/src/Types/PaymentInstrumentResponseCard.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Details of the payment card.
+ */
+class PaymentInstrumentResponseCard
+{
+    /**
+     * Last 4 digits of the payment card number.
+     *
+     * @var string|null
+     */
+    public ?string $last4Digits = null;
+
+    /**
+     * Issuing card network of the payment card used for the transaction.
+     *
+     * @var PaymentInstrumentResponseCardType|null
+     */
+    public ?PaymentInstrumentResponseCardType $type = null;
+
+}
diff --git a/src/Types/PaymentInstrumentResponseCardType.php b/src/Types/PaymentInstrumentResponseCardType.php
new file mode 100644
index 0000000..06ddd68
--- /dev/null
+++ b/src/Types/PaymentInstrumentResponseCardType.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Issuing card network of the payment card used for the transaction.
+ */
+enum PaymentInstrumentResponseCardType: string
+{
+    case ALELO = 'ALELO';
+    case AMEX = 'AMEX';
+    case CONECS = 'CONECS';
+    case CUP = 'CUP';
+    case DINERS = 'DINERS';
+    case DISCOVER = 'DISCOVER';
+    case EFTPOS = 'EFTPOS';
+    case ELO = 'ELO';
+    case ELV = 'ELV';
+    case GIROCARD = 'GIROCARD';
+    case HIPERCARD = 'HIPERCARD';
+    case INTERAC = 'INTERAC';
+    case JCB = 'JCB';
+    case MAESTRO = 'MAESTRO';
+    case MASTERCARD = 'MASTERCARD';
+    case PLUXEE = 'PLUXEE';
+    case SWILE = 'SWILE';
+    case TICKET = 'TICKET';
+    case VISA = 'VISA';
+    case VISA_ELECTRON = 'VISA_ELECTRON';
+    case VISA_VPAY = 'VISA_VPAY';
+    case VPAY = 'VPAY';
+    case VR = 'VR';
+    case UNKNOWN = 'UNKNOWN';
+}
diff --git a/src/Types/ProcessCheckout.php b/src/Types/ProcessCheckout.php
index 28df31e..3ca6355 100644
--- a/src/Types/ProcessCheckout.php
+++ b/src/Types/ProcessCheckout.php
@@ -40,16 +40,16 @@ class ProcessCheckout
     /**
      * Raw `PaymentData` object received from Google Pay. Send the Google Pay response payload as-is.
      *
-     * @var array<string, mixed>|null
+     * @var ProcessCheckoutGooglePay|null
      */
-    public ?array $googlePay = null;
+    public ?ProcessCheckoutGooglePay $googlePay = null;
 
     /**
      * Raw payment token object received from Apple Pay. Send the Apple Pay response payload as-is.
      *
-     * @var array<string, mixed>|null
+     * @var ProcessCheckoutApplePay|null
      */
-    public ?array $applePay = null;
+    public ?ProcessCheckoutApplePay $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/ProcessCheckoutApplePay.php b/src/Types/ProcessCheckoutApplePay.php
new file mode 100644
index 0000000..6288f10
--- /dev/null
+++ b/src/Types/ProcessCheckoutApplePay.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Raw payment token object received from Apple Pay. Send the Apple Pay response payload as-is.
+ */
+class ProcessCheckoutApplePay
+{
+}
diff --git a/src/Types/ProcessCheckoutGooglePay.php b/src/Types/ProcessCheckoutGooglePay.php
new file mode 100644
index 0000000..f16fa22
--- /dev/null
+++ b/src/Types/ProcessCheckoutGooglePay.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Raw `PaymentData` object received from Google Pay. Send the Google Pay response payload as-is.
+ */
+class ProcessCheckoutGooglePay
+{
+}
diff --git a/src/Types/Receipt.php b/src/Types/Receipt.php
index 232c9cd..8980503 100644
--- a/src/Types/Receipt.php
+++ b/src/Types/Receipt.php
@@ -26,15 +26,15 @@ class Receipt
     /**
      * EMV-specific metadata returned for card-present payments.
      *
-     * @var array<string, mixed>|null
+     * @var ReceiptEmvData|null
      */
-    public ?array $emvData = null;
+    public ?ReceiptEmvData $emvData = null;
 
     /**
      * Acquirer-specific metadata related to the card authorization.
      *
-     * @var array<string, mixed>|null
+     * @var ReceiptAcquirerData|null
      */
-    public ?array $acquirerData = null;
+    public ?ReceiptAcquirerData $acquirerData = null;
 
 }
diff --git a/src/Types/ReceiptAcquirerData.php b/src/Types/ReceiptAcquirerData.php
new file mode 100644
index 0000000..de84a42
--- /dev/null
+++ b/src/Types/ReceiptAcquirerData.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Acquirer-specific metadata related to the card authorization.
+ */
+class ReceiptAcquirerData
+{
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $tid = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $authorizationCode = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $returnCode = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $localTime = null;
+
+}
diff --git a/src/Types/ReceiptEmvData.php b/src/Types/ReceiptEmvData.php
new file mode 100644
index 0000000..075a928
--- /dev/null
+++ b/src/Types/ReceiptEmvData.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * EMV-specific metadata returned for card-present payments.
+ */
+class ReceiptEmvData
+{
+}
diff --git a/src/Types/ReceiptMerchantData.php b/src/Types/ReceiptMerchantData.php
index a1d08cc..467a6fd 100644
--- a/src/Types/ReceiptMerchantData.php
+++ b/src/Types/ReceiptMerchantData.php
@@ -12,9 +12,9 @@ class ReceiptMerchantData
     /**
      * Merchant profile details displayed on the receipt.
      *
-     * @var array<string, mixed>|null
+     * @var ReceiptMerchantDataMerchantProfile|null
      */
-    public ?array $merchantProfile = null;
+    public ?ReceiptMerchantDataMerchantProfile $merchantProfile = null;
 
     /**
      * Locale used for rendering localized receipt fields.
diff --git a/src/Types/ReceiptMerchantDataMerchantProfile.php b/src/Types/ReceiptMerchantDataMerchantProfile.php
new file mode 100644
index 0000000..58e17cd
--- /dev/null
+++ b/src/Types/ReceiptMerchantDataMerchantProfile.php
@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Merchant profile details displayed on the receipt.
+ */
+class ReceiptMerchantDataMerchantProfile
+{
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $merchantCode = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $businessName = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $companyRegistrationNumber = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $vatId = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $website = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $email = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $language = null;
+
+    /**
+     *
+     * @var ReceiptMerchantDataMerchantProfileAddress|null
+     */
+    public ?ReceiptMerchantDataMerchantProfileAddress $address = null;
+
+}
diff --git a/src/Types/ReceiptMerchantDataMerchantProfileAddress.php b/src/Types/ReceiptMerchantDataMerchantProfileAddress.php
new file mode 100644
index 0000000..f734bab
--- /dev/null
+++ b/src/Types/ReceiptMerchantDataMerchantProfileAddress.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class ReceiptMerchantDataMerchantProfileAddress
+{
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $addressLine1 = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $addressLine2 = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $city = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $country = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $countryEnName = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $countryNativeName = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $regionName = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $postCode = null;
+
+    /**
+     *
+     * @var string|null
+     */
+    public ?string $landline = null;
+
+}
diff --git a/src/Types/StatusResponse.php b/src/Types/StatusResponse.php
index 58de44d..a29abba 100644
--- a/src/Types/StatusResponse.php
+++ b/src/Types/StatusResponse.php
@@ -11,8 +11,8 @@ class StatusResponse
 {
     /**
      *
-     * @var array<string, mixed>
+     * @var StatusResponseData
      */
-    public array $data;
+    public StatusResponseData $data;
 
 }
diff --git a/src/Types/StatusResponseData.php b/src/Types/StatusResponseData.php
new file mode 100644
index 0000000..67e1e4a
--- /dev/null
+++ b/src/Types/StatusResponseData.php
@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class StatusResponseData
+{
+    /**
+     * Battery level percentage
+     *
+     * @var float|null
+     */
+    public ?float $batteryLevel = null;
+
+    /**
+     * Battery temperature in Celsius
+     *
+     * @var int|null
+     */
+    public ?int $batteryTemperature = null;
+
+    /**
+     * Type of connection used by the device
+     *
+     * @var StatusResponseDataConnectionType|null
+     */
+    public ?StatusResponseDataConnectionType $connectionType = null;
+
+    /**
+     * Firmware version of the device
+     *
+     * @var string|null
+     */
+    public ?string $firmwareVersion = null;
+
+    /**
+     * Timestamp of the last activity from the device
+     *
+     * @var string|null
+     */
+    public ?string $lastActivity = null;
+
+    /**
+     * Latest state of the device
+     *
+     * @var StatusResponseDataState|null
+     */
+    public ?StatusResponseDataState $state = null;
+
+    /**
+     * Status of a device
+     *
+     * @var StatusResponseDataStatus
+     */
+    public StatusResponseDataStatus $status;
+
+}
diff --git a/src/Types/ModelConnectionType.php b/src/Types/StatusResponseDataConnectionType.php
similarity index 85%
rename from src/Types/ModelConnectionType.php
rename to src/Types/StatusResponseDataConnectionType.php
index 1312b31..3ccbdb3 100644
--- a/src/Types/ModelConnectionType.php
+++ b/src/Types/StatusResponseDataConnectionType.php
@@ -7,7 +7,7 @@
 /**
  * Type of connection used by the device
  */
-enum ModelConnectionType: string
+enum StatusResponseDataConnectionType: string
 {
     case BTLE = 'btle';
     case EDGE = 'edge';
diff --git a/src/Types/ModelState.php b/src/Types/StatusResponseDataState.php
similarity index 90%
rename from src/Types/ModelState.php
rename to src/Types/StatusResponseDataState.php
index cc638bd..02dfb8f 100644
--- a/src/Types/ModelState.php
+++ b/src/Types/StatusResponseDataState.php
@@ -7,7 +7,7 @@
 /**
  * Latest state of the device
  */
-enum ModelState: string
+enum StatusResponseDataState: string
 {
     case IDLE = 'IDLE';
     case SELECTING_TIP = 'SELECTING_TIP';
diff --git a/src/Types/ModelStatus.php b/src/Types/StatusResponseDataStatus.php
similarity index 79%
rename from src/Types/ModelStatus.php
rename to src/Types/StatusResponseDataStatus.php
index 4f5c662..57fb333 100644
--- a/src/Types/ModelStatus.php
+++ b/src/Types/StatusResponseDataStatus.php
@@ -7,7 +7,7 @@
 /**
  * Status of a device
  */
-enum ModelStatus: string
+enum StatusResponseDataStatus: string
 {
     case ONLINE = 'ONLINE';
     case OFFLINE = 'OFFLINE';
diff --git a/src/Types/TransactionFull.php b/src/Types/TransactionFull.php
index b0bb29a..f8322e6 100644
--- a/src/Types/TransactionFull.php
+++ b/src/Types/TransactionFull.php
@@ -201,16 +201,16 @@ class TransactionFull
     /**
      * Simple name of the payment type.
      *
-     * @var string|null
+     * @var TransactionFullSimplePaymentType|null
      */
-    public ?string $simplePaymentType = null;
+    public ?TransactionFullSimplePaymentType $simplePaymentType = null;
 
     /**
      * Verification method used for the transaction.
      *
-     * @var string|null
+     * @var TransactionFullVerificationMethod|null
      */
-    public ?string $verificationMethod = null;
+    public ?TransactionFullVerificationMethod $verificationMethod = null;
 
     /**
      * Details of the payment card.
@@ -243,16 +243,16 @@ class TransactionFull
     /**
      * Payout type for the transaction.
      *
-     * @var string|null
+     * @var TransactionFullPayoutType|null
      */
-    public ?string $payoutType = null;
+    public ?TransactionFullPayoutType $payoutType = null;
 
     /**
      * Debit/Credit.
      *
-     * @var string|null
+     * @var TransactionFullProcessAs|null
      */
-    public ?string $processAs = null;
+    public ?TransactionFullProcessAs $processAs = null;
 
     /**
      * List of products from the merchant's catalogue for which the transaction serves as a payment.
@@ -278,9 +278,9 @@ class TransactionFull
     /**
      * Status generated from the processing status and the latest transaction state.
      *
-     * @var string|null
+     * @var TransactionFullSimpleStatus|null
      */
-    public ?string $simpleStatus = null;
+    public ?TransactionFullSimpleStatus $simpleStatus = null;
 
     /**
      * List of hyperlinks for accessing related resources.
@@ -299,9 +299,9 @@ class TransactionFull
     /**
      * Details of the payment location as received from the payment terminal.
      *
-     * @var array<string, mixed>|null
+     * @var TransactionFullLocation|null
      */
-    public ?array $location = null;
+    public ?TransactionFullLocation $location = null;
 
     /**
      * Indicates whether tax deduction is enabled for the transaction.
diff --git a/src/Types/TransactionFullLocation.php b/src/Types/TransactionFullLocation.php
new file mode 100644
index 0000000..619063d
--- /dev/null
+++ b/src/Types/TransactionFullLocation.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Details of the payment location as received from the payment terminal.
+ */
+class TransactionFullLocation
+{
+    /**
+     * Latitude value from the coordinates of the payment location (as received from the payment terminal reader).
+     *
+     * @var float|null
+     */
+    public ?float $lat = null;
+
+    /**
+     * Longitude value from the coordinates of the payment location (as received from the payment terminal reader).
+     *
+     * @var float|null
+     */
+    public ?float $lon = null;
+
+    /**
+     * Indication of the precision of the geographical position received from the payment terminal.
+     *
+     * @var float|null
+     */
+    public ?float $horizontalAccuracy = null;
+
+}
diff --git a/src/Types/ModelPayoutType.php b/src/Types/TransactionFullPayoutType.php
similarity index 82%
rename from src/Types/ModelPayoutType.php
rename to src/Types/TransactionFullPayoutType.php
index a893723..99dba61 100644
--- a/src/Types/ModelPayoutType.php
+++ b/src/Types/TransactionFullPayoutType.php
@@ -7,7 +7,7 @@
 /**
  * Payout type for the transaction.
  */
-enum ModelPayoutType: string
+enum TransactionFullPayoutType: string
 {
     case BANK_ACCOUNT = 'BANK_ACCOUNT';
     case PREPAID_CARD = 'PREPAID_CARD';
diff --git a/src/Types/ModelProcessAs.php b/src/Types/TransactionFullProcessAs.php
similarity index 78%
rename from src/Types/ModelProcessAs.php
rename to src/Types/TransactionFullProcessAs.php
index c197d62..1ea4faa 100644
--- a/src/Types/ModelProcessAs.php
+++ b/src/Types/TransactionFullProcessAs.php
@@ -7,7 +7,7 @@
 /**
  * Debit/Credit.
  */
-enum ModelProcessAs: string
+enum TransactionFullProcessAs: string
 {
     case CREDIT = 'CREDIT';
     case DEBIT = 'DEBIT';
diff --git a/src/Types/ModelSimplePaymentType.php b/src/Types/TransactionFullSimplePaymentType.php
similarity index 92%
rename from src/Types/ModelSimplePaymentType.php
rename to src/Types/TransactionFullSimplePaymentType.php
index b056858..940be99 100644
--- a/src/Types/ModelSimplePaymentType.php
+++ b/src/Types/TransactionFullSimplePaymentType.php
@@ -7,7 +7,7 @@
 /**
  * Simple name of the payment type.
  */
-enum ModelSimplePaymentType: string
+enum TransactionFullSimplePaymentType: string
 {
     case CASH = 'CASH';
     case CC_SIGNATURE = 'CC_SIGNATURE';
diff --git a/src/Types/ModelSimpleStatus.php b/src/Types/TransactionFullSimpleStatus.php
similarity index 92%
rename from src/Types/ModelSimpleStatus.php
rename to src/Types/TransactionFullSimpleStatus.php
index 497db5a..62b16ed 100644
--- a/src/Types/ModelSimpleStatus.php
+++ b/src/Types/TransactionFullSimpleStatus.php
@@ -7,7 +7,7 @@
 /**
  * Status generated from the processing status and the latest transaction state.
  */
-enum ModelSimpleStatus: string
+enum TransactionFullSimpleStatus: string
 {
     case SUCCESSFUL = 'SUCCESSFUL';
     case PAID_OUT = 'PAID_OUT';
diff --git a/src/Types/ModelVerificationMethod.php b/src/Types/TransactionFullVerificationMethod.php
similarity index 87%
rename from src/Types/ModelVerificationMethod.php
rename to src/Types/TransactionFullVerificationMethod.php
index e0897d5..53a94b0 100644
--- a/src/Types/ModelVerificationMethod.php
+++ b/src/Types/TransactionFullVerificationMethod.php
@@ -7,7 +7,7 @@
 /**
  * Verification method used for the transaction.
  */
-enum ModelVerificationMethod: string
+enum TransactionFullVerificationMethod: string
 {
     case NONE = 'none';
     case SIGNATURE = 'signature';
diff --git a/src/Types/TransactionHistory.php b/src/Types/TransactionHistory.php
index 9a62504..6340405 100644
--- a/src/Types/TransactionHistory.php
+++ b/src/Types/TransactionHistory.php
@@ -117,16 +117,16 @@ class TransactionHistory
     /**
      * Type of the transaction for the registered user specified in the `user` property.
      *
-     * @var string|null
+     * @var TransactionHistoryType|null
      */
-    public ?string $type = null;
+    public ?TransactionHistoryType $type = null;
 
     /**
      * Issuing card network of the payment card used for the transaction.
      *
-     * @var string|null
+     * @var TransactionHistoryCardType|null
      */
-    public ?string $cardType = null;
+    public ?TransactionHistoryCardType $cardType = null;
 
     /**
      * Payout date (if paid out at once).
@@ -138,9 +138,9 @@ class TransactionHistory
     /**
      * Payout type.
      *
-     * @var string|null
+     * @var TransactionHistoryPayoutType|null
      */
-    public ?string $payoutType = null;
+    public ?TransactionHistoryPayoutType $payoutType = null;
 
     /**
      * Total refunded amount.
diff --git a/src/Types/ModelCardType.php b/src/Types/TransactionHistoryCardType.php
similarity index 95%
rename from src/Types/ModelCardType.php
rename to src/Types/TransactionHistoryCardType.php
index 6f41abe..8c5a4f8 100644
--- a/src/Types/ModelCardType.php
+++ b/src/Types/TransactionHistoryCardType.php
@@ -7,7 +7,7 @@
 /**
  * Issuing card network of the payment card used for the transaction.
  */
-enum ModelCardType: string
+enum TransactionHistoryCardType: string
 {
     case ALELO = 'ALELO';
     case AMEX = 'AMEX';
diff --git a/src/Types/TransactionHistoryPayoutType.php b/src/Types/TransactionHistoryPayoutType.php
new file mode 100644
index 0000000..f677dfd
--- /dev/null
+++ b/src/Types/TransactionHistoryPayoutType.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Payout type.
+ */
+enum TransactionHistoryPayoutType: string
+{
+    case BANK_ACCOUNT = 'BANK_ACCOUNT';
+    case PREPAID_CARD = 'PREPAID_CARD';
+}
diff --git a/src/Types/TransactionHistoryType.php b/src/Types/TransactionHistoryType.php
new file mode 100644
index 0000000..85cfeb1
--- /dev/null
+++ b/src/Types/TransactionHistoryType.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Type of the transaction for the registered user specified in the `user` property.
+ */
+enum TransactionHistoryType: string
+{
+    case PAYMENT = 'PAYMENT';
+    case REFUND = 'REFUND';
+    case CHARGE_BACK = 'CHARGE_BACK';
+}
diff --git a/src/Types/Unauthorized.php b/src/Types/Unauthorized.php
index 22d3870..e23fbd1 100644
--- a/src/Types/Unauthorized.php
+++ b/src/Types/Unauthorized.php
@@ -11,8 +11,8 @@ class Unauthorized
 {
     /**
      *
-     * @var array<string, mixed>
+     * @var UnauthorizedErrors
      */
-    public array $errors;
+    public UnauthorizedErrors $errors;
 
 }
diff --git a/src/Types/UnauthorizedErrors.php b/src/Types/UnauthorizedErrors.php
new file mode 100644
index 0000000..ccbbe15
--- /dev/null
+++ b/src/Types/UnauthorizedErrors.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+class UnauthorizedErrors
+{
+    /**
+     * Fuller message giving context to error
+     *
+     * @var string
+     */
+    public string $detail;
+
+    /**
+     * Key indicating type of error. Present only for typed 401 responses (e.g. invalid token, invalid password). Absent for generic unauthorized responses.
+     *
+     * @var UnauthorizedErrorsType|null
+     */
+    public ?UnauthorizedErrorsType $type = null;
+
+}
diff --git a/src/Types/UnauthorizedErrorsType.php b/src/Types/UnauthorizedErrorsType.php
new file mode 100644
index 0000000..817bdc8
--- /dev/null
+++ b/src/Types/UnauthorizedErrorsType.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SumUp\Types;
+
+/**
+ * Key indicating type of error. Present only for typed 401 responses (e.g. invalid token, invalid password). Absent for generic unauthorized responses.
+ */
+enum UnauthorizedErrorsType: string
+{
+    case INVALID_ACCESS_TOKEN = 'INVALID_ACCESS_TOKEN';
+    case INVALID_PASSWORD = 'INVALID_PASSWORD';
+}
diff --git a/tests/TypesRequestConstructorTest.php b/tests/TypesRequestConstructorTest.php
index cacd3f2..d884fbc 100644
--- a/tests/TypesRequestConstructorTest.php
+++ b/tests/TypesRequestConstructorTest.php
@@ -5,6 +5,10 @@
 use PHPUnit\Framework\TestCase;
 use SumUp\Types\CheckoutCreateRequest;
 use SumUp\Types\CheckoutCreateRequestCurrency;
+use SumUp\Types\CreateReaderCheckoutRequest;
+use SumUp\Types\CreateReaderCheckoutRequestAade;
+use SumUp\Types\CreateReaderCheckoutRequestAffiliate;
+use SumUp\Types\CreateReaderCheckoutRequestTotalAmount;
 
 class TypesRequestConstructorTest extends TestCase
 {
@@ -44,4 +48,41 @@ public function testCheckoutCreateRequestAllowsPartialInput(): void
 
         $this->assertSame('ref-123', $request->checkoutReference);
     }
+
+    public function testCreateReaderCheckoutRequestHydratesInlineObjectProperties(): void
+    {
+        $request = new CreateReaderCheckoutRequest([
+            'aade' => [
+                'provider_id' => 'provider-123',
+                'signature' => 'base64-signature',
+                'signature_data' => 'signed-data',
+            ],
+            'affiliate' => [
+                'app_id' => 'com.example.app',
+                'foreign_transaction_id' => 'txn-123',
+                'key' => 'key-123',
+                'tags' => [
+                    'source' => 'sdk-test',
+                ],
+            ],
+            'total_amount' => [
+                'currency' => 'EUR',
+                'minor_unit' => 2,
+                'value' => 100,
+            ],
+        ]);
+
+        $this->assertInstanceOf(CreateReaderCheckoutRequestAade::class, $request->aade);
+        $this->assertSame('provider-123', $request->aade->providerId);
+        $this->assertSame('signed-data', $request->aade->signatureData);
+
+        $this->assertInstanceOf(CreateReaderCheckoutRequestAffiliate::class, $request->affiliate);
+        $this->assertSame('com.example.app', $request->affiliate->appId);
+        $this->assertSame(['source' => 'sdk-test'], $request->affiliate->tags);
+
+        $this->assertInstanceOf(CreateReaderCheckoutRequestTotalAmount::class, $request->totalAmount);
+        $this->assertSame('EUR', $request->totalAmount->currency);
+        $this->assertSame(2, $request->totalAmount->minorUnit);
+        $this->assertSame(100, $request->totalAmount->value);
+    }
 }