Sign in
Custom payout schedules (sweeps)

Get a sweep

Returns a sweep.

get/balanceAccounts/{balanceAccountId}/sweeps/{sweepId}

Path parameters

balanceAccountIdstring required

The unique identifier of the balance account.

sweepIdstring required

The unique identifier of the sweep.

Response

OK - the request has succeeded.

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

The type of transfer that results from the sweep.

Possible values:

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[]

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.

reason'accountHierarchyNotActive' | 'amountLimitExceeded' | 'approved' | 'counterpartyAccountBlocked' | 'counterpartyAccountClosed' | 'counterpartyAccountNotFound' | 'counterpartyAddressRequired' | 'counterpartyBankTimedOut' | 'counterpartyBankUnavailable' | 'directDebitNotSupported' | 'error' | 'notEnoughBalance' | 'refusedByCounterpartyBank' | 'routeNotFound' | 'transferInstrumentDoesNotExist' | 'unknown'

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.62317

  • v287544766dc8e2See the full diff
    • ○

      api tag Custom payout schedules (sweeps) added

      api-tag-added

    • ○

      api tag Balance accounts removed

      api-tag-removed

  • v20d06f978a8b510See the full diff
    • ○

      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

  • v24cd18d5551af1See the full diff
    • ●

      added the new schemeAdvice enum value to the response property for the response status

      response-property-enum-value-added

  • v2dd6159049c956See 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

  • v29fede8325f6d1See the full diff
    • ●

      added the new approvalExpired enum value to the response property for the response status

      response-property-enum-value-added

  • v2e69e67d2e6921See the full diff
    • ●

      added the new pending enum value to the response property for the response status

      response-property-enum-value-added

  • v261259c9969a51See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • v25c1b264dd7b81See the full diff
    • ●

      added the new refusedByCustomer enum value to the response property for the response status

      response-property-enum-value-added

  • v280dfacd37eec4See 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

  • v2f874764bcf8b1See the full diff
    • ●

      added the new declined enum value to the response property for the response status

      response-property-enum-value-added