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

Important
This documentation is for preview purposes only.

# Add payout instrument

A payout instrument represents a single reference to store the details for a payout to your party.

Note
We currently only support bank account details.
Cards and e-wallets are coming soon.

br
A `payoutInstrument` is created in two ways. Either **during** or **after** the creation of a party. This guide focuses on the creation of a payout instrument **after** the party creation call.


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

## Create a payout instrument

**After** a party is created, you can add a `payoutInstrument` to it.

br
`POST` `https://access.worldpay.com/parties/{partyId}/payoutInstrument`

br
Note
We verify the details sent against a template for a particular country-currency pair. You can view the  specific country requirements in our [coverage guide](/products/marketplaces/coverage/bank).

### Request/response example

### Schema

## View a payout instrument

View information of a payout instrument, previously created, using the `payoutInstrumentId` received in your payout instrument creation response.

`GET` `https://access.worldpay.com/parties/{partyId}/payoutInstrument/{payoutInstrumentId}`

br
### Request/response example

See full [schema](/products/parties/openapi/payout-instruments/getpayoutinstrument) to view your payout instrument.

## Modify a payout instrument

You can modify certain payout instrument information previously created. Data entered will again be verified and saved if verification is successful.

`PUT` `https://access.worldpay.com/parties/parTH82wexHglhnBbzd6iJ7P0/payoutInstrument/{payoutInstrumentId}`

### Request/response example

See full [schema](/products/parties/openapi/payout-instruments/updatepayoutinstruments) to modify your payout instrument.

## Delete a payout instrument

**Coming soon**

#### Next steps

[Manage beneficial owners](/products/parties/beneficial-owners)
[Add balance accounts](/products/parties/balance-accounts) or 
[Verify a party](/products/parties/verify-parties)