Virtual Accounts Reference Data

Ultimate Beneficial Owners (UBOs)

UBO Fields Required

All fields have a maximum length of 35 characters.

Order	Field	Description	Required
1	CompanyNumber	Company number of the account owner. Example: 000012345 (always 9 digits)	Yes
2	VirtualAccountNumber	Virtual Account number for customer details assignment. Example: 0099876543 (always 10 digits)	Yes
3	CustomerIdentifier	Your internal customer reference identifier	No
4	CustomerType	Account holder type: 'P' (Private) or 'C' (Company)	Yes
5	Name	Legal name of the account holder	Yes
6	Address1	First line of address	Yes
7	Address2	Second line of address	Yes
8	Address3	Must contain the ISO-2 Alpha-2 country code (e.g., 'GB', 'DE'). This is a regulatory requirement for compliance and risk management. See country codes	Yes
9	UBOfirstname1	First name of primary UBO	Yes
10	UBOlastname1	Last name of primary UBO	Yes
11	UBOfirstname2	First name of second UBO	No
12	UBOlastname2	Last name of second UBO	No
13	UBOfirstname3	First name of third UBO	No
14	UBOlastname3	Last name of third UBO	No
15	UBOfirstname4	First name of fourth UBO	No
16	UBOlastname4	Last name of fourth UBO	No
17	UBOfirstname5	First name of fifth UBO	No
18	UBOlastname5	Last name of fifth UBO	No

CSV File Format Example

When providing customer details via CSV file, use the following format:

CompanyNumber,VirtualAccountNumber,CustomerIdentifier,CustomerType,Name,Address1,Address2,Address3,UBOfirstname1,UBOlastname1,UBOfirstname2,UBOlastname2,UBOfirstname3,UBOlastname3,UBOfirstname4,UBOlastname4,UBOfirstname5,UBOlastname5
000012345,0099876543,Ania1,P,Ania,Address1,Address2,GB,UbOfirstname1,UbOlastname1,UbOfirstname2,UbOlastname2,UbOfirstname3,UbOlastname3,UbOfirstname4,UbOlastname4,UbOfirstname5,UbOlastname5

Note:

All header fields must be included in the CSV file, even if you don't provide data for the optional fields

The Address3 field must contain a valid ISO-2 Alpha-2 country code for regulatory compliance

Allowed Characters

The following characters are allowed in all Virtual Account fields:

a b c d e f g h i j k l m n o p q r s t u v w x y z  
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z  
0 1 2 3 4 5 6 7 8 9  
/ - ? : ( ) . ' 
Space (except leading spaces)

Notes

All fields are limited to 35 characters
Up to 5 UBOs can be specified per Virtual Account
Customer details can only be set once and cannot be modified after submission
Bulk operations are limited to 1,000 Virtual Accounts per request
Address3 must contain the country code in ISO-2 Alpha-2 format for regulatory and compliance requirements

Closing a Virtual Account

Closure Reason Codes

When closing a Virtual Account, one of the following reason codes must be specified:

Code	Description
C01	Merchant has been off-boarded
C02	Due to AML/risk appetite/fraud reasons
C03	Client request (merchant not being offboarded)

Notes

The reason code must be specified for each Virtual Account
The reason code must be one of the allowed codes
The reason code must be provided before the Virtual Account can be closed
Bulk operations are limited to 1,000 Virtual Accounts per request

CSV File Format Example

When providing closure reason codes via CSV file, use the following format:

VirtualAccountNumber,ReasonCode
0099394118,C01
0099394117,C02