New service | Last updated: 09 October 2025
Verify a beneficiary's bank details to ensure the payout is going to the intended account.
POST https://try.access.worldpay-bsh.securedataplatform.com/accountVerifications
- Test (Try)https://try.access.worldpay-bsh.securedataplatform.com/accountVerifications
- Livehttps://access.worldpay-bsh.securedataplatform.com/accountVerifications
- Payload
- curl
- Python
- Java
- Node.js
- Go
- PHP
- Ruby
- C#
import java.net.*;
import java.net.http.*;
import java.util.*;
public class App {
public static void main(String[] args) throws Exception {
var httpClient = HttpClient.newBuilder().build();
var payload = String.join("\n"
, "{"
, " \"merchant\": {"
, " \"entity\": \"default\""
, " },"
, " \"instructions\": ["
, " {"
, " \"party\": {"
, " \"type\": \"beneficiary\","
, " \"payoutInstrument\": {"
, " \"type\": \"bankAccount\","
, " \"currency\": \"GBP\","
, " \"iban\": \"GB41CITI18500818404062\","
, " \"accountHolderName\": \"John Smith\","
, " \"accountNumber\": \"123456\","
, " \"bankCode\": \"184758\","
, " \"bankName\": \"Demo Bank\","
, " \"branchCode\": \"1234\","
, " \"swiftBic\": \"DBbic01\","
, " \"accountType\": \"checking\","
, " \"address\": {"
, " \"type\": \"personal\","
, " \"address1\": \"Main Bvd\","
, " \"address2\": \"No 1\","
, " \"city\": \"London\","
, " \"postalCode\": \"012345\","
, " \"countryCode\": \"GB\""
, " }"
, " },"
, " \"personalDetails\": {"
, " \"type\": \"personal\","
, " \"title\": \"Mr\","
, " \"firstName\": \"John\","
, " \"middleName\": \"\","
, " \"lastName\": \"Smith\","
, " \"dateOfBirth\": \"2000-01-01\","
, " \"companyName\": \"Co Name\","
, " \"dateOfIncorporation\": \"2025-01-01\","
, " \"email\": \"john@domain.com\","
, " \"phones\": ["
, " {"
, " \"number\": \"7777777777\","
, " \"prefix\": \"44\""
, " }"
, " ]"
, " }"
, " },"
, " \"expandableKeyValuePairs\": {"
, " \"key\": \"value\""
, " }"
, " }"
, " ]"
, "}"
);
var host = "https://try.access.worldpay-bsh.securedataplatform.com";
var pathname = "/accountVerifications";
var request = HttpRequest.newBuilder()
.POST(HttpRequest.BodyPublishers.ofString(payload))
.uri(URI.create(host + pathname ))
.header("Content-Type", "application/json")
.header("WP-Api-Version", "2025-01-01")
.header("WP-CorrelationId", "15cd16b2-7b82-41cb-9b11-21be9dacad88")
.header("Authorization", "Basic " + Base64.getEncoder().encodeToString(("<username>:<password>").getBytes()))
.build();
var response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}Note: View our bank coverage guide for country specific requirements.
Your entity reference created as part of on-boarding. Used to route the request in Access Worldpay.
Note: Currently only one instruction is accepted.
The type of this party. Only beneficiary type is accepted.
An object that holds details of your payout instrument.
The type of the payoutInstrument.
The currency in ISO 4217 currency format.
Beneficiary IBAN. You must either provide iban or accountNumber.
Full name of the beneficiary. accountHolderName is a mandatory element of the request body when firstName and lastName are missing.
Type of the account bank.
The code of the bank which must be exactly six digits.
Identifies the type of this address.
The address. Must consist of at least two letters, two words, and one number.
Line two of the address.
The city of this address.
The postal code of this address.
The country code specified in <a href="/products/reference/supported-countries-currencies#iso-country-currencies">ISO 3166-1 Alpha-2 country code</a>.
What the party represents: personal - an individual company - a corporation or partnership with multiple owners..
The title for this person.
First name of the beneficiary. firstName and lastName are mandatory elements of the request body when accountHolderName is missing.
Middle name name of the beneficiary.
Last name name of the beneficiary.
The date the person was born.
Company name. companyName must be provided if accountHolderName is not present and type is company.
The incorporation date for the company.
An email address for this party.
A list of phone numbers associated with this party.
JSON object of key-value pairs used to supply additional data. The keys and values that you might need to process an account payout to a specific destination, are communicated during the on-boarding process. Duplicate key names are not allowed.
{
"outcome": "fullMatch",
"message": "Account Details Matched",
"actualAccountHolderName": ""
}For a full list of outcomes and errors see our API Reference.
Next steps