---
title: "Update a payout schedule"
description: "Update a merchant's payout schedule."
url: "https://docs.adyen.com/account-management-api/manage-bank-accounts-and-payouts/updatepayoutschedule"
source_url: "https://docs.adyen.com/account-management-api/manage-bank-accounts-and-payouts/updatepayoutschedule.md"
canonical: "https://docs.adyen.com/account-management-api/manage-bank-accounts-and-payouts/updatepayoutschedule"
last_modified: "2026-05-25T12:55:01+02:00"
language: "en"
---

# Update a payout schedule

Update a merchant's payout schedule.

[View source](/account-management-api/manage-bank-accounts-and-payouts/updatepayoutschedule.md)

## Request parameters

To update the payout schedule for a merchant, make a POST `/updatePayoutSchedule` specifying:

| Name                 | Type   | Required                                                                                    | Description                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ------ | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `merchantCode`       | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A merchant code string holds a value to identify a merchant.Format:- Either: `MerchantAccount.Merchant_Code`
- Or: `Merchant_Code`                                                                                                                                                                                                             |
| `payoutScheduleDays` | Int    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Number of payout days per week. Defines how often you want to plan a payout on a weekly basis. For example, once a week, twice a week, and so on.Allowed values: *1, 2, 3, 5*.- *1*: on Tuesday at 00:00 CET
- *2*: on Tuesday, Friday at 00:00 CET
- *3*: on Tuesday, Thursday, Friday at 00:00 CET
- *5*: from Monday to Friday at 00:00 CET |

## Response parameters

If there are no errors in the request, the call returns a `pspReference.`If any issues occur during the process, the call returns one or more warning or error messages.

| Name           | Type   | Returned by default                                                                         | Description                                                                                         |
| -------------- | ------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `pspReference` | String | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A reference to uniquely identify the request.                                                       |
| `warnings`     | String | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | List containing one or more warning messages. Returned when the request is not correctly processed. |
| `errors`       | String | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | List containing one or more error messages. Returned when the request fails.                        |

## Examples

### Request

#### JSON

```json
{  
  "merchantCode":"TestMerchant",
  "payoutScheduleDays":1
}
```

#### Soap

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <updatePayoutSchedule xmlns="http://caaccount.services.adyen.com">
      <request>
        <merchantCode>TestMerchant</merchantCode>
        <payoutScheduleDays>1</payoutScheduleDays>
      </request>
    </updatePayoutSchedule>
  </soap:Body>
</soap:Envelope>
```

### Response

#### JSON

```json
{  
   "pspReference":"9914140718370613"
}
```

#### Soap

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns0="http://caaccount.services.adyen.com" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <ns0:updatePayoutScheduleResponse>
      <ns0:response>
        <ns0:pspReference>9914140718370613</ns0:pspReference>
      </ns0:response>
    </ns0:updatePayoutScheduleResponse>
  </soap:Body>
</soap:Envelope>
```

### Response in case of an error or warning

#### JSON

```json
{  
  "pspReference":"9914526950450289",
  "warnings":[  
    "8_006 accountKey is deprecated, please use merchantCode instead"
  ]
}
```

#### Soap

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns0="http://caaccount.services.adyen.com" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <ns0:updatePayoutScheduleResponse>
      <ns0:response>
        <ns0:pspReference>9914526950450289</ns0:pspReference>
        <ns0:warnings>
      <ns0:string>8_006 accountKey is deprecated, please use merchantCode instead</ns0:string>
   </ns0:warnings>
      </ns0:response>
    </ns0:updatePayoutScheduleResponse>
  </soap:Body>
</soap:Envelope>
```