Account holders7

Authorized card users4

Balance accounts5

Balances5

Bank account validation1

Card orders2

Custom payout schedules (sweeps)6

Direct debit mandates4

Grant accounts1

Grant offers2

Manage card PIN3

Manage SCA devices6

Managed payout schedules8

Network tokens2

Payment instrument groups3

Payment instruments9

Platform3

Recurring top ups4

SCA association management3

SCA device management4

Transaction rules4

Transfer limits - balance account level6

Transfer limits - balance platform level4

Transfer routes1

Recurring top ups

Update a RecurringTopUp

Changed on Oct 21, 2026

Update the configuration of an existing recurring top up.

For more information, refer to Manage recurring top-ups.

patch/balanceAccounts/{balanceAccountId}/recurringTopUps/{topUpId}

Request

Base URL
https://balanceplatform-api-test.adyen.com/bcl/v2
URL
https://balanceplatform-api-test.adyen.com/bcl/v2/balanceAccounts/{balanceAccountId}/recurringTopUps/{topUpId}
Auth
none declared

Path parameters

balanceAccountIdstring required

The unique identifier of the balance account.

topUpIdstring required

The unique identifier of the recurring top-up you want to update.

Request body

descriptionstring

Your description for the recurring top-up.

Maximum length is 140 characters. If you set a longer description, it will be cut off at 140 characters.

referenceForBeneficiarystring nullable

A reference that is sent to the recipient. This reference is also sent in all webhooks related to the transfer, so you can use it to track statuses for both parties involved in the funds movement.

Supported characters: a-z, A-Z, 0-9.

status'active' | 'inactive' nullable

The status of the recurring top-up. If not provided, by default, this is set to active.

Possible values:

active: the top up is enabled and funds will be pulled in.
inactive: the top up is disabled and cannot be triggered.

Response

OK - the request has succeeded.

descriptionstring required

Your description for the recurring top-up.

Maximum length is 140 characters. If you set a longer description, it will be cut off at 140 characters.

idstring required

The unique identifier of the top up.

referenceForBeneficiarystring