Add Customer Details & UBO information via the BCC UI

How do you add Customer Details & UBO information to Virtual Accounts?

Virtual Accounts can be assigned to your customers via our "Payment on Behalf of" or "Collection on Behalf of" (POBO/COBO) Virtual Accounts. You must submit the customer details for each POBO/COBO Virtual Account type if it has not already been added at the creation of the Virtual Account.

You can do this via the Virtual Account API (details can be found here), or via the Client Portal *found here by uploading a .csv file by following path Virtual Banking > Virtual Accounts > Add Customer Details. The format for the .csv file can be found here below:

.csv text example for upload via the UI:

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,Address3,UbOfirstname1,UbOlastname1,UbOfirstname2,UbOlastname2,UbOfirstname3,UbOlastname3,UbOfirstname4,UbOlastname4,UbOfirstname5,UbOlastname5

📘

Note: A Virtual Account can only have customer details added once. Additionally, bulk adding of customer details (more than one set of Virtual Account Customer details) is limited to 1,000 Virtual Accounts per uploaded CSV file. The example file above shows the format required to update Virtual Accounts in bulk.

Example of how the flow of uploading via the UI can be

• Take the example for your .csv from the text file above and put it into your .csv file to use as a template for how each line per Virtual Account you want to add information should look. All fields of the header are mandatory even though you do not provide data for the optional fields.

• Find the Virtual Accounts missing the customer details information via the "Missing" filter on the page, giving you all the Virtual Accounts where the customer details and Ultimate Beneficiary Owner (UBO) information is missing:

• Take the Virtual Account and Company numbers you want to add customer details information to and add them to your .csv file via the example; put the information you have in and add for each Virtual Account you want to add the Customer Details and UBO information for. In case you use Excel for file editing you should be aware of possible auto-formatting of content.

• When done with adding the information to the .csv file, save the file, click the green "Add Customer Details" button on the page and follow the flow:

• When the file has been uploaded correctly, the file will be under pending and, when having been processed, will be found in the state of "Completed" if all is good:

Customer Details statuses

• Completed - The Virtual Account’s Customer Details have been set successfully.
• Pending - The Virtual Account’s Customer Details have been submitted and are being processed.
• Failed - The Virtual Account’s Customer Details could not be updated due to an error. Please get in touch with Client Service.
• Missing - The Virtual Account’s Customer Details have not been set.
• N/A - The Virtual Account type does not support setting Customer Detail.

Which characters are allowed in the .csv file?

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)