New service | **Last updated**: 14 May 2025

Important
This documentation is for preview purposes only.

# Manage balance accounts

Create and manage balance accounts which represent a virtual currency account within Worldpay. We use this to store the party's funds ahead of a payout.

br
You can add a `balanceAccount` in two ways. Either **during** or **after** the creation of a party. This guide focuses on adding a `balanceAccount` **after** the party creation call.


To add a `balanceAccount` **during** [orchestrated party creation call](/access/products/parties/create-party#orchestrated-party-creation), you can use the `https://access.worldpay-bsh.securedataplatform.com/parties` endpoint.

## Create a balance account

**After** a party is created, you can create and add a balance account.


`POST` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/balanceAccount`

br
Note
You can only request creation of one balance account per one currency.

### Request/response example

`POST` `https://access.worldpay-bsh.securedataplatform.com/parties/parTH82wexHglhnBbzd6iJ7P0/balanceAccount`

### Schema

## View a balance account

View information about a balance account, previously created.

`GET` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/balanceAccount/{balanceAccountId`

### Request/response example

You can see the full [schema](#schema) above or in our [API reference](/access/products/parties/openapi/balance-accounts).

## Assigning a payout schedule

Assign a payout schedule to a balance account, to ensure regular payouts to a specified [payout instrument](/access/products/parties/payout-instruments/).

Important
Some regions require you to assign a regular schedule to their balance accounts. Please speak to your Implementation Manager for further details

### Schedule support

* **weekly**
  - for each workday of the week (Monday-Friday)
  - the `payoutInstrument` currency must match the one of the balance account
* **monthly**
  - set the day the of the week (Monday-Friday)
  - define which week of the month (first, second, third. fourth)


## Modify a balance account

You can:

* change the `payoutInstrument`
* day the schedules are paid out to


### Request/response example

`PUT` `https://access.worldpay-bsh.securedataplatform.com/parties/{partyId}/balanceAccount/{balanceAccountId}`

You can see the full [schema](#schema) above or in our [API reference](/access/products/parties/openapi/balance-accounts).

## Delete a balance account

****Coming soon****

**Next steps**

[Add a payout instrument](/access/products/parties/payout-instruments)
[Manage beneficial owners](/access/products/parties/beneficial-owners) or 
[Verify a party](/access/products/parties/verify-parties)