# Parameters to Update a Recurring Donation Setup
source: https://developer.mastercard.com/donations/documentation/parameters/manage-recur-donation-param/update-recur-donation-param/index.md

## Method to Update a Recurring Donation Setup {#method-to-update-a-recurring-donation-setup}

| Method |                                                                       Endpoint                                                                        |
|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| PUT    | **Deprecated:** ~~/donations/donors/{donor_id}/setups/{donation_setup_id}~~ **New:** /donations/donors/{donor_id}/donation-setups/{donation_setup_id} |

## Path parameters {#path-parameters}

|       Parameter       |  Type  |                                   Description                                    |
|-----------------------|--------|----------------------------------------------------------------------------------|
| **donorId**           | string | Unique ID generated by Mastercard when a new donor is enrolled.                  |
| **donation_setup_id** | string | Unique ID generated by Mastercard when a donor sets up a new recurring-donation. |

## Request Parameters {#request-parameters}

|    Name    |  Type  |                                        Description                                        |                                                           Notes                                                           |
|------------|--------|-------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|
| **amount** | string | The amount of the recurring donation to be updated as an input                            | **Required** **Note** required for monthly and micro-donations not for roundup. **(Conditional)**                         |
| **maxCap** | string | The maximum amount allowed for donations each month. Used for Micro \& Roundup donations. | **Required** **Note** This field required for round-up and micro-donations not for monthly. (Conditional)**Conditional**. |

### Child Attributes {#child-attributes}

#### authpayerresponse {#authpayerresponse}

|        Name        |  Type  |               Description                |                   Notes                   |
|--------------------|--------|------------------------------------------|-------------------------------------------|
| **authentication** | object | Contains details of 3DS and 3DS2 Objects | **Required** If authPayerResponse is used |

#### authentication {#authentication}

|   Name   |  Type  |                                                                                    Description                                                                                     |    Notes     |
|----------|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------|
| **3ds**  | object | Contains SCA details like acsEci, authenticationToken, transactionId. Note : 3ds has nothing to do with version of 3ds , it is format in which payment gateway accepts SCA fields. | **Required** |
| **3ds2** | object | Contains SCA details like transactionStatus, protocolVersion. Note : 3ds has nothing to do with version of 3ds2 , it is format in which payment gateway accepts SCA fields.        | **Required** |

#### 3ds {#3ds}

|          Name           |            Type            |                                      Description                                       |                    Notes                    |
|-------------------------|----------------------------|----------------------------------------------------------------------------------------|---------------------------------------------|
| **acsEci**              | String                     | Value returned by Issuers indicating the outcome of authentication on 3DS transactions | Optional for MPGS , **Required** for Stripe |
| **version**             | String                     | Version returned by issuer to authenticate 3DS payments                                | **Required** only for Stripe                |
| **authenticationToken** | String                     | Value returned by Issuers to authenticate 3DS transactions                             | **Required**                                |
| **transactionId**       | String (valid UUID String) | A unique Identifier of each 3DS transaction                                            | **Required**                                |

#### 3ds2 {#3ds2}

The 3ds2 parameter is required only for MPGS.

|         Name          |  Type  |                                              Description                                               |    Notes     |
|-----------------------|--------|--------------------------------------------------------------------------------------------------------|--------------|
| **transactionStatus** | String | Value retuned by issuer showing status of transaction. Permissible values -(Y,N)                       | **Required** |
| **protocolVersion**   | String | Version returned by issuer to authenticate 3DS payments. Permissible value - #.#.# where # is numeric. | Optional     |

## Response Parameters {#response-parameters}

A successful request returns the `HTTP 201 Created` status code and a JSON response body that includes a unique donation setup Id.

|        Name         |                                                       Description                                                       |
|---------------------|-------------------------------------------------------------------------------------------------------------------------|
| **donorId**         | Unique ID generated by Mastercard when a new donor is enrolled.                                                         |
| **setupStatus**     | Indicates the status of the set-up. Can be **INITIATED** , **INACTIVE** , **ACTIVE** , **FAILED** and **DELETED**.      |
| **donationSetupId** | The unique identifier of the monthly donation configuration generated by Mastercard at the time the donation was setup. |