diff --git a/openapi.json b/openapi.json index f514d26..8f2f661 100644 --- a/openapi.json +++ b/openapi.json @@ -243,7 +243,7 @@ "post": { "operationId": "CreateCheckout", "summary": "Create a checkout", - "description": "Creates a new payment checkout resource. The unique `checkout_reference` created by this request, is used for further manipulation of the checkout.\n\nFor 3DS checkouts, add the `redirect_url` parameter to your request body schema.\nTo use the [Hosted Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) page, set the `hosted_checkout.enabled` to `true`.\n\nFollow by processing a checkout to charge the provided payment instrument.", + "description": "Creates a payment checkout for the specified merchant, amount, and currency. Supply a `checkout_reference` to identify the payment attempt in your own systems. Creating a checkout does not charge a payment instrument.\n\nSet `hosted_checkout.enabled` to `true` to receive a [Hosted Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) URL where the customer can complete the payment.\nUse `redirect_url` for redirect-based payment and 3DS flows. If `return_url` is provided, SumUp sends processing updates to that backend callback URL.\n\nComplete the payment through [Hosted Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) or the [Payment Widget](https://developer.sumup.com/online-payments/checkouts/card-widget).", "tags": [ "Checkouts" ], @@ -746,7 +746,7 @@ "patch": { "operationId": "UpdateCheckout", "summary": "Update a checkout", - "description": "Updates an identified checkout resource.", + "description": "Updates the amount, currency, description, reference, expiration, or customer associated with an existing checkout. Only the supplied fields are updated.\n\nThis request changes the checkout details; it does not charge a payment instrument. Process the checkout separately to attempt a payment.", "tags": [ "Checkouts" ], @@ -3443,28 +3443,30 @@ "type": "string" } }, + { + "name": "resource.id", + "in": "query", + "description": "Filter memberships by the ID of the resource the membership is in.", + "schema": { + "type": "string" + } + }, { "name": "resource.parent.id", "in": "query", - "description": "Filter memberships by the parent of the resource the membership is in.\nWhen filtering by parent both `resource.parent.id` and `resource.parent.type` must be present. Pass explicit null to filter for resources without a parent.", + "allowEmptyValue": true, + "description": "Filter memberships by the parent of the resource the membership is in.\nOmit both `resource.parent.id` and `resource.parent.type` to skip parent filtering. When filtering by parent, both parameters must be present. To select resources without a parent, set each parameter to an empty value. Otherwise, both parameters must identify a parent.", "schema": { - "type": [ - "string", - "null" - ] + "type": "string" } }, { "name": "resource.parent.type", "in": "query", - "description": "Filter memberships by the parent of the resource the membership is in.\nWhen filtering by parent both `resource.parent.id` and `resource.parent.type` must be present. Pass explicit null to filter for resources without a parent.", + "allowEmptyValue": true, + "description": "Filter memberships by the parent of the resource the membership is in.\nOmit both `resource.parent.id` and `resource.parent.type` to skip parent filtering. When filtering by parent, both parameters must be present. To select resources without a parent, set each parameter to an empty value. Otherwise, both parameters must identify a parent.", "schema": { - "allOf": [ - { - "$ref": "#/components/schemas/ResourceType" - } - ], - "type": "null" + "$ref": "#/components/schemas/ResourceType" } }, { @@ -3603,19 +3605,6 @@ "example": "245b2ead-85bf-45ff-856f-311a88a5d454" } }, - { - "name": "user.type", - "in": "query", - "description": "Filter the returned members by user type. Repeat this parameter to include multiple user types.", - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/UserType" - } - }, - "style": "form", - "explode": true - }, { "name": "status", "in": "query", @@ -3730,7 +3719,7 @@ "post": { "operationId": "CreateMerchantMember", "summary": "Create a member", - "description": "Create a merchant member.", + "description": "Adds a member to the merchant account with the specified roles.\n\nBy default, sends an invitation email to the provided address. The recipient must accept the invitation to join the account.\nWhen `is_managed_user` is `true`, creates a managed user with the provided password and optional nickname and assigns the roles directly, without sending an invitation.", "tags": [ "Members" ], @@ -3795,6 +3784,7 @@ "roles": { "type": "array", "description": "List of roles to assign to the new member.", + "minItems": 1, "maxItems": 124, "items": { "type": "string", @@ -3978,7 +3968,7 @@ }, "put": { "summary": "Update a member", - "description": "Update the merchant member.", + "description": "Updates a merchant member and returns the updated member.\n\nProviding `roles` replaces the member's assigned roles and can grant or revoke access. Providing `metadata` replaces the entire metadata object.\nFor managed users, `user.nickname` changes the display name and `user.password` replaces the password. Updating the password also enables the managed user account.", "tags": [ "Members" ], @@ -4017,6 +4007,7 @@ "properties": { "roles": { "type": "array", + "minItems": 1, "maxItems": 124, "items": { "type": "string", @@ -4392,6 +4383,7 @@ "permissions": { "type": "array", "description": "User's permissions.", + "minItems": 1, "maxItems": 100, "items": { "type": "string" @@ -4652,7 +4644,7 @@ "patch": { "operationId": "UpdateMerchantRole", "summary": "Update a role", - "description": "Update a custom role.", + "description": "Updates a custom role's name, description, or permissions and returns the updated role.\n\nProviding `permissions` replaces the role's permission list and changes the access granted to members assigned to that role. Omitted fields remain unchanged.", "tags": [ "Roles" ], @@ -4696,6 +4688,7 @@ "permissions": { "type": "array", "description": "User's permissions.", + "minItems": 1, "maxItems": 100, "items": { "type": "string" @@ -5438,7 +5431,7 @@ }, "patch": { "summary": "Update a Reader", - "description": "Update a Reader.", + "description": "Updates a reader's name or metadata and returns the updated reader.\n\nProviding `metadata` replaces the entire metadata object; include all entries that should be retained. Omitted fields remain unchanged.", "operationId": "UpdateReader", "tags": [ "Readers" @@ -8923,17 +8916,6 @@ } } }, - "UserType": { - "type": "string", - "description": "Type of the user account.", - "enum": [ - "user", - "managed_user", - "service_account", - "system_account" - ], - "example": "user" - }, "Metadata": { "description": "Set of user-defined key-value pairs attached to the object. Partial updates are not supported. When updating, always submit whole metadata. Maximum of 64 parameters are allowed in the object.", "type": "object", @@ -8947,6 +8929,17 @@ "example": {}, "additionalProperties": true }, + "UserType": { + "type": "string", + "description": "Type of the user account.", + "enum": [ + "user", + "managed_user", + "service_account", + "system_account" + ], + "example": "user" + }, "Address": { "externalDocs": { "description": "Address documentation", diff --git a/src/main/java/com/sumup/sdk/clients/CheckoutsAsyncClient.java b/src/main/java/com/sumup/sdk/clients/CheckoutsAsyncClient.java index bef0ab9..c4f99b3 100644 --- a/src/main/java/com/sumup/sdk/clients/CheckoutsAsyncClient.java +++ b/src/main/java/com/sumup/sdk/clients/CheckoutsAsyncClient.java @@ -43,12 +43,15 @@ public CheckoutsAsyncClient(ApiClient apiClient) { /** * Create a checkout * - *

Creates a new payment checkout resource. The unique `checkout_reference` created by this - * request, is used for further manipulation of the checkout. For 3DS checkouts, add the - * `redirect_url` parameter to your request body schema. To use the [Hosted - * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) page, set the - * `hosted_checkout.enabled` to `true`. Follow by processing a checkout to charge the provided - * payment instrument. + *

Creates a payment checkout for the specified merchant, amount, and currency. Supply a + * `checkout_reference` to identify the payment attempt in your own systems. Creating a checkout + * does not charge a payment instrument. Set `hosted_checkout.enabled` to `true` to receive a + * [Hosted Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) URL + * where the customer can complete the payment. Use `redirect_url` for redirect-based payment and + * 3DS flows. If `return_url` is provided, SumUp sends processing updates to that backend callback + * URL. Complete the payment through [Hosted + * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) or the + * [Payment Widget](https://developer.sumup.com/online-payments/checkouts/card-widget). * *

Operation ID: CreateCheckout * @@ -66,12 +69,15 @@ public CompletableFuture create( /** * Create a checkout * - *

Creates a new payment checkout resource. The unique `checkout_reference` created by this - * request, is used for further manipulation of the checkout. For 3DS checkouts, add the - * `redirect_url` parameter to your request body schema. To use the [Hosted - * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) page, set the - * `hosted_checkout.enabled` to `true`. Follow by processing a checkout to charge the provided - * payment instrument. + *

Creates a payment checkout for the specified merchant, amount, and currency. Supply a + * `checkout_reference` to identify the payment attempt in your own systems. Creating a checkout + * does not charge a payment instrument. Set `hosted_checkout.enabled` to `true` to receive a + * [Hosted Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) URL + * where the customer can complete the payment. Use `redirect_url` for redirect-based payment and + * 3DS flows. If `return_url` is provided, SumUp sends processing updates to that backend callback + * URL. Complete the payment through [Hosted + * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) or the + * [Payment Widget](https://developer.sumup.com/online-payments/checkouts/card-widget). * *

Operation ID: CreateCheckout * @@ -477,7 +483,10 @@ public CompletableFuture process( /** * Update a checkout * - *

Updates an identified checkout resource. + *

Updates the amount, currency, description, reference, expiration, or customer associated + * with an existing checkout. Only the supplied fields are updated. This request changes the + * checkout details; it does not charge a payment instrument. Process the checkout separately to + * attempt a payment. * *

Operation ID: UpdateCheckout * @@ -496,7 +505,10 @@ public CompletableFuture update( /** * Update a checkout * - *

Updates an identified checkout resource. + *

Updates the amount, currency, description, reference, expiration, or customer associated + * with an existing checkout. Only the supplied fields are updated. This request changes the + * checkout details; it does not charge a payment instrument. Process the checkout separately to + * attempt a payment. * *

Operation ID: UpdateCheckout * diff --git a/src/main/java/com/sumup/sdk/clients/CheckoutsClient.java b/src/main/java/com/sumup/sdk/clients/CheckoutsClient.java index 8f66982..bce1bc3 100644 --- a/src/main/java/com/sumup/sdk/clients/CheckoutsClient.java +++ b/src/main/java/com/sumup/sdk/clients/CheckoutsClient.java @@ -42,12 +42,15 @@ public CheckoutsClient(ApiClient apiClient) { /** * Create a checkout * - *

Creates a new payment checkout resource. The unique `checkout_reference` created by this - * request, is used for further manipulation of the checkout. For 3DS checkouts, add the - * `redirect_url` parameter to your request body schema. To use the [Hosted - * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) page, set the - * `hosted_checkout.enabled` to `true`. Follow by processing a checkout to charge the provided - * payment instrument. + *

Creates a payment checkout for the specified merchant, amount, and currency. Supply a + * `checkout_reference` to identify the payment attempt in your own systems. Creating a checkout + * does not charge a payment instrument. Set `hosted_checkout.enabled` to `true` to receive a + * [Hosted Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) URL + * where the customer can complete the payment. Use `redirect_url` for redirect-based payment and + * 3DS flows. If `return_url` is provided, SumUp sends processing updates to that backend callback + * URL. Complete the payment through [Hosted + * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) or the + * [Payment Widget](https://developer.sumup.com/online-payments/checkouts/card-widget). * *

Operation ID: CreateCheckout * @@ -65,12 +68,15 @@ public com.sumup.sdk.models.Checkout create(com.sumup.sdk.models.CheckoutCreateR /** * Create a checkout * - *

Creates a new payment checkout resource. The unique `checkout_reference` created by this - * request, is used for further manipulation of the checkout. For 3DS checkouts, add the - * `redirect_url` parameter to your request body schema. To use the [Hosted - * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) page, set the - * `hosted_checkout.enabled` to `true`. Follow by processing a checkout to charge the provided - * payment instrument. + *

Creates a payment checkout for the specified merchant, amount, and currency. Supply a + * `checkout_reference` to identify the payment attempt in your own systems. Creating a checkout + * does not charge a payment instrument. Set `hosted_checkout.enabled` to `true` to receive a + * [Hosted Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) URL + * where the customer can complete the payment. Use `redirect_url` for redirect-based payment and + * 3DS flows. If `return_url` is provided, SumUp sends processing updates to that backend callback + * URL. Complete the payment through [Hosted + * Checkout](https://developer.sumup.com/online-payments/checkouts/hosted-checkout/) or the + * [Payment Widget](https://developer.sumup.com/online-payments/checkouts/card-widget). * *

Operation ID: CreateCheckout * @@ -465,7 +471,10 @@ public com.sumup.sdk.models.CheckoutSuccess2 process( /** * Update a checkout * - *

Updates an identified checkout resource. + *

Updates the amount, currency, description, reference, expiration, or customer associated + * with an existing checkout. Only the supplied fields are updated. This request changes the + * checkout details; it does not charge a payment instrument. Process the checkout separately to + * attempt a payment. * *

Operation ID: UpdateCheckout * @@ -484,7 +493,10 @@ public com.sumup.sdk.models.Checkout update( /** * Update a checkout * - *

Updates an identified checkout resource. + *

Updates the amount, currency, description, reference, expiration, or customer associated + * with an existing checkout. Only the supplied fields are updated. This request changes the + * checkout details; it does not charge a payment instrument. Process the checkout separately to + * attempt a payment. * *

Operation ID: UpdateCheckout * diff --git a/src/main/java/com/sumup/sdk/clients/MembersAsyncClient.java b/src/main/java/com/sumup/sdk/clients/MembersAsyncClient.java index 710ef1b..2dfa09e 100644 --- a/src/main/java/com/sumup/sdk/clients/MembersAsyncClient.java +++ b/src/main/java/com/sumup/sdk/clients/MembersAsyncClient.java @@ -32,7 +32,10 @@ public MembersAsyncClient(ApiClient apiClient) { /** * Create a member * - *

Create a merchant member. + *

Adds a member to the merchant account with the specified roles. By default, sends an + * invitation email to the provided address. The recipient must accept the invitation to join the + * account. When `is_managed_user` is `true`, creates a managed user with the provided password + * and optional nickname and assigns the roles directly, without sending an invitation. * *

Operation ID: CreateMerchantMember * @@ -52,7 +55,10 @@ public CompletableFuture create( /** * Create a member * - *

Create a merchant member. + *

Adds a member to the merchant account with the specified roles. By default, sends an + * invitation email to the provided address. The recipient must accept the invitation to join the + * account. When `is_managed_user` is `true`, creates a managed user with the provided password + * and optional nickname and assigns the roles directly, without sending an invitation. * *

Operation ID: CreateMerchantMember * @@ -266,7 +272,11 @@ public CompletableFuture list( /** * Update a member * - *

Update the merchant member. + *

Updates a merchant member and returns the updated member. Providing `roles` replaces the + * member's assigned roles and can grant or revoke access. Providing `metadata` replaces the + * entire metadata object. For managed users, `user.nickname` changes the display name and + * `user.password` replaces the password. Updating the password also enables the managed user + * account. * *

Operation ID: UpdateMerchantMember * @@ -289,7 +299,11 @@ public CompletableFuture update( /** * Update a member * - *

Update the merchant member. + *

Updates a merchant member and returns the updated member. Providing `roles` replaces the + * member's assigned roles and can grant or revoke access. Providing `metadata` replaces the + * entire metadata object. For managed users, `user.nickname` changes the display name and + * `user.password` replaces the password. Updating the password also enables the managed user + * account. * *

Operation ID: UpdateMerchantMember * @@ -407,19 +421,6 @@ public ListMerchantMembersQueryParams userId(java.util.UUID value) { return this; } - /** - * Sets the user.type query parameter. - * - * @param value Filter the returned members by user type. Repeat this parameter to include - * multiple user types. - * @return This ListMerchantMembersQueryParams instance. - */ - public ListMerchantMembersQueryParams userType( - java.util.List value) { - this.values.put("user.type", Objects.requireNonNull(value, "userType")); - return this; - } - /** * Converts query parameters to a map understood by ApiClient. * diff --git a/src/main/java/com/sumup/sdk/clients/MembersClient.java b/src/main/java/com/sumup/sdk/clients/MembersClient.java index 45b871c..372495f 100644 --- a/src/main/java/com/sumup/sdk/clients/MembersClient.java +++ b/src/main/java/com/sumup/sdk/clients/MembersClient.java @@ -31,7 +31,10 @@ public MembersClient(ApiClient apiClient) { /** * Create a member * - *

Create a merchant member. + *

Adds a member to the merchant account with the specified roles. By default, sends an + * invitation email to the provided address. The recipient must accept the invitation to join the + * account. When `is_managed_user` is `true`, creates a managed user with the provided password + * and optional nickname and assigns the roles directly, without sending an invitation. * *

Operation ID: CreateMerchantMember * @@ -51,7 +54,10 @@ public com.sumup.sdk.models.Member create( /** * Create a member * - *

Create a merchant member. + *

Adds a member to the merchant account with the specified roles. By default, sends an + * invitation email to the provided address. The recipient must accept the invitation to join the + * account. When `is_managed_user` is `true`, creates a managed user with the provided password + * and optional nickname and assigns the roles directly, without sending an invitation. * *

Operation ID: CreateMerchantMember * @@ -258,7 +264,11 @@ public com.sumup.sdk.models.ListMerchantMembersResponse list( /** * Update a member * - *

Update the merchant member. + *

Updates a merchant member and returns the updated member. Providing `roles` replaces the + * member's assigned roles and can grant or revoke access. Providing `metadata` replaces the + * entire metadata object. For managed users, `user.nickname` changes the display name and + * `user.password` replaces the password. Updating the password also enables the managed user + * account. * *

Operation ID: UpdateMerchantMember * @@ -281,7 +291,11 @@ public com.sumup.sdk.models.Member update( /** * Update a member * - *

Update the merchant member. + *

Updates a merchant member and returns the updated member. Providing `roles` replaces the + * member's assigned roles and can grant or revoke access. Providing `metadata` replaces the + * entire metadata object. For managed users, `user.nickname` changes the display name and + * `user.password` replaces the password. Updating the password also enables the managed user + * account. * *

Operation ID: UpdateMerchantMember * @@ -399,19 +413,6 @@ public ListMerchantMembersQueryParams userId(java.util.UUID value) { return this; } - /** - * Sets the user.type query parameter. - * - * @param value Filter the returned members by user type. Repeat this parameter to include - * multiple user types. - * @return This ListMerchantMembersQueryParams instance. - */ - public ListMerchantMembersQueryParams userType( - java.util.List value) { - this.values.put("user.type", Objects.requireNonNull(value, "userType")); - return this; - } - /** * Converts query parameters to a map understood by ApiClient. * diff --git a/src/main/java/com/sumup/sdk/clients/MembershipsAsyncClient.java b/src/main/java/com/sumup/sdk/clients/MembershipsAsyncClient.java index 3fbf31d..759c07c 100644 --- a/src/main/java/com/sumup/sdk/clients/MembershipsAsyncClient.java +++ b/src/main/java/com/sumup/sdk/clients/MembershipsAsyncClient.java @@ -150,6 +150,17 @@ public ListMembershipsQueryParams resourceAttributesSandbox(Boolean value) { return this; } + /** + * Sets the resource.id query parameter. + * + * @param value Filter memberships by the ID of the resource the membership is in. + * @return This ListMembershipsQueryParams instance. + */ + public ListMembershipsQueryParams resourceId(String value) { + this.values.put("resource.id", Objects.requireNonNull(value, "resourceId")); + return this; + } + /** * Sets the resource.name query parameter. * @@ -164,9 +175,10 @@ public ListMembershipsQueryParams resourceName(String value) { /** * Sets the resource.parent.id query parameter. * - * @param value Filter memberships by the parent of the resource the membership is in. When - * filtering by parent both `resource.parent.id` and `resource.parent.type` must be present. - * Pass explicit null to filter for resources without a parent. + * @param value Filter memberships by the parent of the resource the membership is in. Omit both + * `resource.parent.id` and `resource.parent.type` to skip parent filtering. When filtering + * by parent, both parameters must be present. To select resources without a parent, set + * each parameter to an empty value. Otherwise, both parameters must identify a parent. * @return This ListMembershipsQueryParams instance. */ public ListMembershipsQueryParams resourceParentId(String value) { @@ -177,12 +189,13 @@ public ListMembershipsQueryParams resourceParentId(String value) { /** * Sets the resource.parent.type query parameter. * - * @param value Filter memberships by the parent of the resource the membership is in. When - * filtering by parent both `resource.parent.id` and `resource.parent.type` must be present. - * Pass explicit null to filter for resources without a parent. + * @param value Filter memberships by the parent of the resource the membership is in. Omit both + * `resource.parent.id` and `resource.parent.type` to skip parent filtering. When filtering + * by parent, both parameters must be present. To select resources without a parent, set + * each parameter to an empty value. Otherwise, both parameters must identify a parent. * @return This ListMembershipsQueryParams instance. */ - public ListMembershipsQueryParams resourceParentType(java.util.Map value) { + public ListMembershipsQueryParams resourceParentType(String value) { this.values.put("resource.parent.type", Objects.requireNonNull(value, "resourceParentType")); return this; } diff --git a/src/main/java/com/sumup/sdk/clients/MembershipsClient.java b/src/main/java/com/sumup/sdk/clients/MembershipsClient.java index 813b2a3..d7775fb 100644 --- a/src/main/java/com/sumup/sdk/clients/MembershipsClient.java +++ b/src/main/java/com/sumup/sdk/clients/MembershipsClient.java @@ -145,6 +145,17 @@ public ListMembershipsQueryParams resourceAttributesSandbox(Boolean value) { return this; } + /** + * Sets the resource.id query parameter. + * + * @param value Filter memberships by the ID of the resource the membership is in. + * @return This ListMembershipsQueryParams instance. + */ + public ListMembershipsQueryParams resourceId(String value) { + this.values.put("resource.id", Objects.requireNonNull(value, "resourceId")); + return this; + } + /** * Sets the resource.name query parameter. * @@ -159,9 +170,10 @@ public ListMembershipsQueryParams resourceName(String value) { /** * Sets the resource.parent.id query parameter. * - * @param value Filter memberships by the parent of the resource the membership is in. When - * filtering by parent both `resource.parent.id` and `resource.parent.type` must be present. - * Pass explicit null to filter for resources without a parent. + * @param value Filter memberships by the parent of the resource the membership is in. Omit both + * `resource.parent.id` and `resource.parent.type` to skip parent filtering. When filtering + * by parent, both parameters must be present. To select resources without a parent, set + * each parameter to an empty value. Otherwise, both parameters must identify a parent. * @return This ListMembershipsQueryParams instance. */ public ListMembershipsQueryParams resourceParentId(String value) { @@ -172,12 +184,13 @@ public ListMembershipsQueryParams resourceParentId(String value) { /** * Sets the resource.parent.type query parameter. * - * @param value Filter memberships by the parent of the resource the membership is in. When - * filtering by parent both `resource.parent.id` and `resource.parent.type` must be present. - * Pass explicit null to filter for resources without a parent. + * @param value Filter memberships by the parent of the resource the membership is in. Omit both + * `resource.parent.id` and `resource.parent.type` to skip parent filtering. When filtering + * by parent, both parameters must be present. To select resources without a parent, set + * each parameter to an empty value. Otherwise, both parameters must identify a parent. * @return This ListMembershipsQueryParams instance. */ - public ListMembershipsQueryParams resourceParentType(java.util.Map value) { + public ListMembershipsQueryParams resourceParentType(String value) { this.values.put("resource.parent.type", Objects.requireNonNull(value, "resourceParentType")); return this; } diff --git a/src/main/java/com/sumup/sdk/clients/ReadersAsyncClient.java b/src/main/java/com/sumup/sdk/clients/ReadersAsyncClient.java index 7073934..bdd1764 100644 --- a/src/main/java/com/sumup/sdk/clients/ReadersAsyncClient.java +++ b/src/main/java/com/sumup/sdk/clients/ReadersAsyncClient.java @@ -605,7 +605,9 @@ public CompletableFuture terminateCheckout( /** * Update a Reader * - *

Update a Reader. + *

Updates a reader's name or metadata and returns the updated reader. Providing `metadata` + * replaces the entire metadata object; include all entries that should be retained. Omitted + * fields remain unchanged. * *

Operation ID: UpdateReader * @@ -626,7 +628,9 @@ public CompletableFuture update( /** * Update a Reader * - *

Update a Reader. + *

Updates a reader's name or metadata and returns the updated reader. Providing `metadata` + * replaces the entire metadata object; include all entries that should be retained. Omitted + * fields remain unchanged. * *

Operation ID: UpdateReader * diff --git a/src/main/java/com/sumup/sdk/clients/ReadersClient.java b/src/main/java/com/sumup/sdk/clients/ReadersClient.java index d3af542..983f09b 100644 --- a/src/main/java/com/sumup/sdk/clients/ReadersClient.java +++ b/src/main/java/com/sumup/sdk/clients/ReadersClient.java @@ -588,7 +588,9 @@ public void terminateCheckout( /** * Update a Reader * - *

Update a Reader. + *

Updates a reader's name or metadata and returns the updated reader. Providing `metadata` + * replaces the entire metadata object; include all entries that should be retained. Omitted + * fields remain unchanged. * *

Operation ID: UpdateReader * @@ -609,7 +611,9 @@ public com.sumup.sdk.models.Reader update( /** * Update a Reader * - *

Update a Reader. + *

Updates a reader's name or metadata and returns the updated reader. Providing `metadata` + * replaces the entire metadata object; include all entries that should be retained. Omitted + * fields remain unchanged. * *

Operation ID: UpdateReader * diff --git a/src/main/java/com/sumup/sdk/clients/RolesAsyncClient.java b/src/main/java/com/sumup/sdk/clients/RolesAsyncClient.java index 151408c..dee9c44 100644 --- a/src/main/java/com/sumup/sdk/clients/RolesAsyncClient.java +++ b/src/main/java/com/sumup/sdk/clients/RolesAsyncClient.java @@ -239,7 +239,9 @@ public CompletableFuture list( /** * Update a role * - *

Update a custom role. + *

Updates a custom role's name, description, or permissions and returns the updated role. + * Providing `permissions` replaces the role's permission list and changes the access granted to + * members assigned to that role. Omitted fields remain unchanged. * *

Operation ID: UpdateMerchantRole * @@ -260,7 +262,9 @@ public CompletableFuture update( /** * Update a role * - *

Update a custom role. + *

Updates a custom role's name, description, or permissions and returns the updated role. + * Providing `permissions` replaces the role's permission list and changes the access granted to + * members assigned to that role. Omitted fields remain unchanged. * *

Operation ID: UpdateMerchantRole * diff --git a/src/main/java/com/sumup/sdk/clients/RolesClient.java b/src/main/java/com/sumup/sdk/clients/RolesClient.java index a3fb557..4da6f66 100644 --- a/src/main/java/com/sumup/sdk/clients/RolesClient.java +++ b/src/main/java/com/sumup/sdk/clients/RolesClient.java @@ -232,7 +232,9 @@ public com.sumup.sdk.models.ListMerchantRolesResponse list( /** * Update a role * - *

Update a custom role. + *

Updates a custom role's name, description, or permissions and returns the updated role. + * Providing `permissions` replaces the role's permission list and changes the access granted to + * members assigned to that role. Omitted fields remain unchanged. * *

Operation ID: UpdateMerchantRole * @@ -253,7 +255,9 @@ public com.sumup.sdk.models.Role update( /** * Update a role * - *

Update a custom role. + *

Updates a custom role's name, description, or permissions and returns the updated role. + * Providing `permissions` replaces the role's permission list and changes the access granted to + * members assigned to that role. Omitted fields remain unchanged. * *

Operation ID: UpdateMerchantRole *