Account holders7

Authorized card users4

Balance accounts5

Balances5

Bank account validation1

Card orders2

Custom payout schedules (sweeps)5

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

Custom payout schedules (sweeps)

Create a sweep

Creates a sweep that results in moving funds from or to a balance account.

A sweep pulls in or pushes out funds based on a defined schedule, amount, currency, and a source or a destination.

post/balanceAccounts/{balanceAccountId}/sweeps

Path parameters

balanceAccountIdstring required

The unique identifier of the balance account.

Request body

category'bank' | 'internal' | 'platformPayment'

The type of transfer that results from the sweep.

Possible values:

bank: Sweep to a transfer instrument.
internal: Transfer to another balance account within your platform.

Required when setting priorities.

currencystring required

The three-character ISO currency code in uppercase. For example, EUR.

The sweep currency must match any of the balances currencies.

descriptionstring

The message that will be used in the sweep transfer's description body with a maximum length of 140 characters.

If the message is longer after replacing placeholders, the message will be cut off at 140 characters.

prioritiesstring[]

The list of priorities for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. You can provide multiple priorities, ordered by your preference. Adyen will try to pay out using the priorities in the given order. If the first priority is not currently supported or enabled for your platform, the system will try the next one, and so on.

The request will be accepted as long as at least one of the provided priorities is valid (i.e., supported by Adyen and activated for your platform). For example, if you provide ["wire","regular"], and wire is not supported but regular is, the request will still be accepted and processed.

Possible values:

regular: For normal, low-value transactions.
fast: A faster way to transfer funds, but the fees are higher. Recommended for high-priority, low-value transactions.
wire: The fastest way to transfer funds, but this has the highest fees. Recommended for high-priority, high-value transactions.
instant: For instant funds transfers within the United States and in SEPA locations.
crossBorder: For high-value transfers to a recipient in a different country.
internal: For transfers to an Adyen-issued business bank account (by bank account number/IBAN).

Set category to bank. For more details, see optional priorities setup for marketplaces or platforms.

The reason for disabling the sweep.

reasonDetailstring

The human readable reason for disabling the sweep.

referencestring

Your reference for the sweep configuration.

referenceForBeneficiarystring

The reference sent to or received from the counterparty. Only alphanumeric characters are allowed.

status'active' | 'inactive'

The status of the sweep. If not provided, by default, this is set to active.

Possible values:

active: the sweep is enabled and funds will be pulled in or pushed out based on the defined configuration.
inactive: the sweep is disabled and cannot be triggered.

type'pull' | 'push'

The direction of sweep, whether pushing out or pulling in funds to the balance account. If not provided, by default, this is set to push.

Possible values:

push: push out funds to a destination balance account or transfer instrument.
pull: pull in funds from a source merchant account, transfer instrument, or balance account.

Response

OK - the request has succeeded.

category'bank' | 'internal' | 'platformPayment'

The type of transfer that results from the sweep.

Possible values:

bank: Sweep to a transfer instrument.
internal: Transfer to another balance account within your platform.

Required when setting priorities.

currencystring required

The three-character ISO currency code in uppercase. For example, EUR.

The sweep currency must match any of the balances currencies.

descriptionstring

The message that will be used in the sweep transfer's description body with a maximum length of 140 characters.

If the message is longer after replacing placeholders, the message will be cut off at 140 characters.

idstring required

The unique identifier of the sweep.

prioritiesstring[]

Possible values:

regular: For normal, low-value transactions.
fast: A faster way to transfer funds, but the fees are higher. Recommended for high-priority, low-value transactions.
wire: The fastest way to transfer funds, but this has the highest fees. Recommended for high-priority, high-value transactions.
instant: For instant funds transfers within the United States and in SEPA locations.
crossBorder: For high-value transfers to a recipient in a different country.
internal: For transfers to an Adyen-issued business bank account (by bank account number/IBAN).

Set category to bank. For more details, see optional priorities setup for marketplaces or platforms.

The reason for disabling the sweep.

reasonDetailstring

The human readable reason for disabling the sweep.

referencestring

Your reference for the sweep configuration.

referenceForBeneficiarystring

The reference sent to or received from the counterparty. Only alphanumeric characters are allowed.

status'active' | 'inactive'

The status of the sweep. If not provided, by default, this is set to active.

Possible values:

active: the sweep is enabled and funds will be pulled in or pushed out based on the defined configuration.
inactive: the sweep is disabled and cannot be triggered.

type'pull' | 'push'

The direction of sweep, whether pushing out or pulling in funds to the balance account. If not provided, by default, this is set to push.

Possible values:

push: push out funds to a destination balance account or transfer instrument.
pull: pull in funds from a source merchant account, transfer instrument, or balance account.

Changes

Changed in 14 of the 51 revisions of this API.72345

May 19, 2026v287544766dc8e2See the full diff
- ○
  api tag Custom payout schedules (sweeps) added
  api-tag-added
- ○
  api tag Balance accounts removed
  api-tag-removed
Jan 21, 2026v20d06f978a8b520See the full diff
- ○
  removed the enum value approvalExpired of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value balanceAccountTemporarilyBlockedByTransactionRule of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value declined of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value declinedByTransactionRule of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value pending of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value pendingApproval of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value pendingExecution of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value refusedByCustomer of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value scaFailed of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the enum value schemeAdvice of the request read-only property reason
  request-read-only-property-enum-value-removed
- ○
  removed the approvalExpired enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the balanceAccountTemporarilyBlockedByTransactionRule enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the declined enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the declinedByTransactionRule enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the pending enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the pendingApproval enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the pendingExecution enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the refusedByCustomer enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the scaFailed enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the schemeAdvice enum value from the response property for the response status
  response-property-enum-value-removed
Nov 19, 2025v24cd18d5551af11See the full diff
- ●
  added the new schemeAdvice enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new schemeAdvice enum value to the request property
  request-property-enum-value-added
Sep 9, 2025v2dd6159049c9563See the full diff
- ▲
  the / response property's maxLength was unset from 3 for the response status
  response-property-max-length-unset
- ▲
  the / response property's maxLength was unset from 3 for the response status
  response-property-max-length-unset
- ▲
  the / response property's maxLength was unset from 3 for the response status
  response-property-max-length-unset
- ▲
  the / response property's minLength was decreased from 3 to 0 for the response status
  response-property-min-length-decreased
- ▲
  the / response property's minLength was decreased from 3 to 0 for the response status
  response-property-min-length-decreased
- ▲
  the / response property's minLength was decreased from 3 to 0 for the response status
  response-property-min-length-decreased
- ○
  the / request property's minLength was decreased from 3 to 0
  request-property-min-length-decreased
- ○
  the / request property's minLength was decreased from 3 to 0
  request-property-min-length-decreased
- ○
  the / request property's minLength was decreased from 3 to 0
  request-property-min-length-decreased
Jul 29, 2025v29fede8325f6d11See the full diff
- ●
  added the new approvalExpired enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new approvalExpired enum value to the request property
  request-property-enum-value-added
Mar 20, 2025v2e69e67d2e69211See the full diff
- ●
  added the new pending enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new pending enum value to the request property
  request-property-enum-value-added
Nov 20, 2024v261259c9969a51See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
Nov 13, 2024v25c1b264dd7b811See the full diff
- ●
  added the new refusedByCustomer enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new refusedByCustomer enum value to the request property
  request-property-enum-value-added
Oct 10, 2024v280dfacd37eec44See the full diff
- ●
  added the new accountHierarchyNotActive enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new directDebitNotSupported enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new pendingExecution enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new transferInstrumentDoesNotExist enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new accountHierarchyNotActive enum value to the request property
  request-property-enum-value-added
- ○
  added the new directDebitNotSupported enum value to the request property
  request-property-enum-value-added
- ○
  added the new pendingExecution enum value to the request property
  request-property-enum-value-added
- ○
  added the new transferInstrumentDoesNotExist enum value to the request property
  request-property-enum-value-added
Jun 20, 2024v2f874764bcf8b11See the full diff
- ●
  added the new declined enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new declined enum value to the request property
  request-property-enum-value-added

Full history (14 revisions)