--- title: "Update a managed payout schedule on a balance account" method: PATCH path: "/balanceAccounts/{balanceAccountId}/payoutSchedules/{id}" tags: ["Managed payout schedules"] --- # Update a managed payout schedule on a balance account `PATCH /balanceAccounts/{balanceAccountId}/payoutSchedules/{id}` Update a managed payout schedule applied to a balance account. If an optional parameter is not included in the request, it remains unchanged. ## Path parameters - `balanceAccountId` string, required - `id` string, required ## Request body - BalanceAccountConfigurationUpdate - `description` string, nullable — The description used for all payouts initiated by this payout schedule. Maximum length: 140 characters. If your description is longer, it may be truncated. Default value: The `defaultDescription` from the balance platform schedule that you are applying. - `enabled` boolean, nullable — Specifies whether the payout schedule is enabled immediately after it is created. - `frequency` 'daily' | 'weekly' | 'weekdays' | 'monthly' — The frequency of payouts initiated by this payout schedule. Possible values: * daily * weekdays * weekly * monthly Default value: The `defaultFrequency` from the balance platform schedule that you are applying. - `frequencyValue` integer, nullable — The date of the month or day of the week when payouts are initiated. Allowed only if `frequency` is **monthly** or **weekly**. Possible values if `frequency` is **monthly**: **[1 - 31]**. * If your specified date happens on a weekend, the payout is initiated on the next business day. * If your specified date (**29**, **30**, or **31**) does not exist in a month, the payout is initiated on the last day of that month. Possible values if `frequency` is **weekly**: **[1 - 5]**. Default value: The `defaultFrequencyValue` from the balance platform schedule that you are applying. - `maxPayoutAmount` integer, nullable — The maximum amount that can be paid out from balance accounts that use this payout schedule. Default value: **0** - `minPayoutAmount` integer, nullable — The minimum amount that can be paid out from balance accounts that use this payout schedule. Default value: **0** - `reference` string, nullable — The merchant reference that will be shown only in the schedule. - `referenceForBeneficiary` string, nullable — The reference for beneficiary used for all payouts initiated by this payout schedule. This reference is sent to the recipient of the transfer and is included in all webhooks related to the payout. Supported characters: **a-z**, **A-Z**, **0-9**, **-** and space. Spaces might be replaced with **-** if the recipient bank or payment infrastructure does not allow spaces. Default value: The `defaultReferenceForBeneficiary` from the balance platform schedule that you are applying. - `retainedAmount` integer, nullable — The amount of funds that must remain available in the balance account after an execution of the payout schedule. If the funds in the balance account are less than the retained amount, the execution is not initiated. Default value: **0** - `salesDayClosingTime` string — The time of day when the sales day is closed in balance account time zone. The sales day closing time can be between 00:00 to 07:00. Format: **HH:mm:ss** - `transferInstrumentId` string — The unique identifier of the transfer instrument to which the funds are paid out. ## Response `200` OK - The request has succeeded. - BalanceAccountConfiguration - `balanceAccountId` string, required — The unique identifier of the balance account to which you apply the payout schedule. - `balancePlatformPayoutScheduleId` string, required — The unique identifier of the balance platform payout schedule that is applied to the balance account. - `createdAt` string, date-time, required — The date and time when the payout schedule was created. - `currency` string — The three-character [ISO code](https://docs.adyen.com/development-resources/currency-codes) of the currency used for this schedule. - `description` string — The description used for all payouts initiated by this payout schedule. Maximum length: 140 characters. If your description is longer, it may be truncated. Default value: The `defaultDescription` from the balance platform schedule that you are applying. - `enabled` boolean — Specifies whether the payout schedule is active. - `frequency` string - `frequencyValue` integer — The date of the month or day of the week when payouts are initiated. Allowed only if `frequency` is **monthly** or **weekly**. Possible values if `frequency` is **monthly**: **[1 - 31]**. * If your specified date happens on a weekend, the payout is initiated on the next business day. * If your specified date (**29**, **30**, or **31**) does not exist in a month, the payout is initiated on the last day of that month. Possible values if `frequency` is **weekly**: **[1 - 5]**. Default value: The `defaultFrequencyValue` from the balance platform schedule that you are applying. - `id` string — The unique identifier of the payout schedule for the balance account. - `maxPayoutAmount` integer — The maximum amount that can be paid out from balance accounts that use this payout schedule. Default value: **0** - `minPayoutAmount` integer — The minimum amount that can be paid out from balance accounts that use this payout schedule. Default value: **0** - `reference` string — Your reference for the payout schedule. This reference does not appear on statements of payouts initiated by the payout schedule. - `referenceForBeneficiary` string — The reference for beneficiary used for all payouts initiated by this payout schedule. This reference is sent to the recipient of the payout and is included in all webhooks related to the payout. Supported characters: **a-z**, **A-Z**, **0-9**. Default value: The `defaultReferenceForBeneficiary` from the balance platform schedule that you are applying. - `retainedAmount` integer — The amount of funds that must remain available in the balance account after an execution of the payout schedule. If the funds in the balance account are less than the retained amount, the execution is not initiated. Default value: **0** - `salesDayClosingTime` string — The time of day when the sales day is closed in balance account time zone. The sales day closing time can be between 00:00 to 07:00. Format: **HH:mm:ss** - `transferInstrumentId` string, required — The unique identifier of the transfer instrument to which the funds are paid out. - `updatedAt` string, date-time — The date and time when the payout schedule was updated. ## Other responses - `401` — Unauthorized - authentication required. - `403` — Forbidden - insufficient permissions to process the request. - `404` — Not Found - the resource was not found - `422` — Unprocessable Entity - a request validation error. - `500` — Internal Server Error - the server could not process the request. --- [API](https://skmtc.net/adyen/apis/balanceplatformservice.md) · [All operations](https://skmtc.net/adyen/apis/balanceplatformservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/balanceplatformservice/revisions/8761ac1a9aab/schema)