**Last updated**: 14 May 2025 | [**Change log**](/access/products/balance/changelog/)

# Account Payouts

Execute a single Account Payout to a nominated beneficiary bank account.


```
Authorization: {your_credentials}
Content-Type: application/vnd.worldpay.account-payouts-v2+json
```

## Standard payout

### Payout request

`POST` `https://try.access.worldpay.com/payouts/accounts/single`

### Payout request body


```json
{
    "requester": {
        "instructingTreasuryId": "000055",
        "entity": "000055",
        "apiRequestReference": "TestReference123"
    },
    "transactionReference": "123456",
    "countryCode": "GB",
    "sourceCurrency": "GBP",
    "sourceAmount": 0,
    "targetCurrency": "GBP",
    "targetAmount": 10,
    "narrative": "Ref: 123456",
    "purposeOfPaymentCode": "WPPAYR",
    "fastPayment": "Y",
    "purposeOfPaymentNarrative": "Salary payment",
    "transactionTypeCode": "TT04",
    "channel": "WIRE",
    "quoteId": "",
    "scheduleDate": "2022-12-31",
    "expandableKeyValuePairs": {
        "RemitterSourceOfIncome": "salary",
        "BeneficiaryNationality": "British"
    },
    "bankDetails": {
        "beneficiaryAccountTypeCode": "AC01",
        "beneficiaryAccountNumber": "12345677",
        "iban": "GB29NWBK60161331926819",
        "branchCode": "300",
        "bankCode": "404433",
        "swiftBic": "BUKBGB22",
        "bankName": "Bank of Sale",
        "address": {
            "street": "3 Rock Lane",
            "additionalAddressLine": "An Area",
            "city": "Sale",
            "state": "Cheshire",
            "postCodeOrZipCode": "P55 T1B",
            "countryCode": "GB"
        }
    },
    "parties": [
        {
            "partyId": "",
            "customerPartyId": "customer123",
            "partyTypeCode": "PT03",
            "personalDetails": {
                "typeCode": "PD02",
                "titleCode": "TI01",
                "firstName": "John",
                "middleName": "Johno",
                "lastName": "Johnson",
                "dateOfBirth": "1993-12-31",
                "email": "john@domain.com",
                "telephony": [
                    {
                        "phoneNumber": "01375841159",
                        "prefix": "44"
                    }
                ],
                "identity": [
                    {
                        "identityTypeCode": "ID01",
                        "identityNumber": "123456789",
                        "issuingInstitution": "IPS",
                        "issuingCountry": "GB",
                        "startDate": "2013-05-22",
                        "endDate": "2014-05-21"
                    }
                ]
            },
            "address": {
                "street": "1 Some Street",
                "additionalAddressLine": "Some Neighborhood",
                "city": "Some City",
                "state": "Some State",
                "postCodeOrZipCode": "S14 T4R",
                "countryCode": "GB",
                "addressTypeCode": "AD01",
                "residentialStatusCode": "RS01"
            }
        },
        {
            "partyId": "",
            "customerPartyId": "",
            "partyTypeCode": "PT01",
            "personalDetails": {
                "typeCode": "PD01",
                "companyName": "testCompanyInc",
                "dateOfBirth": "1993-12-31",
                "email": "john@domain.com",
                "telephony": [
                    {
                        "phoneNumber": "01375841159",
                        "prefix": "44"
                    }
                ],
                "identity": [
                    {
                        "identityTypeCode": "ID01",
                        "identityNumber": "123456789",
                        "issuingInstitution": "IPS",
                        "issuingCountry": "GB",
                        "startDate": "2013-05-22",
                        "endDate": "2014-05-21"
                    }
                ]
            },
            "address": {
                "street": "1 Some Street",
                "additionalAddressLine": "Some Neighborhood",
                "city": "Some City",
                "state": "Some State",
                "postCodeOrZipCode": "S14 T4R",
                "countryCode": "GB",
                "addressTypeCode": "AD01",
                "residentialStatusCode": "RS01"
            }
        }
    ]
}
```

## Parameters

Permitted special characters for appropriate fields, as well as preset values for specific fields are listed in the Appendix.

## Response:

### Successful response example


```json
{
    "ubr": "PZ000EC4",
    "apiRequestReference": "UniqueCustomerReference",
    "instructingTreasuryId": "001948"
}
```

### Successful response schema

See our full schema in our [API reference](/access/products/account-payouts/v2/openapi).

## Schema validation responses

You can view a list of potential [schema validation responses](/access/products/account-payouts/v2/appendix) in our appendix.