v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-3196247792.5 KB

Recurring top ups

Update a RecurringTopUp

Update the configuration of an existing recurring top up.

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

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

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

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'

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.