Add customer details

This endpoint is only available for Virtual Accounts of types POBO and COBO.

You can update one or more existing Virtual Accounts and uniquely assign them to your underlying customer. Use the endpoint to provide the required customer and Ultimate Beneficial Owner (UBO) details.

The customerDetailsList property accepts an array of 1 to 1,000 Virtual Account numbers and customer details.

The endpoint only accepts update requests for Virtual Account numbers without customer details assigned. It is not possible to use the endpoint to update existing customer details.

All the customer detail parameters, except customerType, accept a string of up to 35 characters. The allowed characters are:

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)

📘

Address field 3 - Country code, ISO-2/Alpha-2 standard.

In this field, we require the country code to be present using the ISO-2 Alpha-2 standard. This standard uses two-letter country codes. For example,
'US' for the United States and 'GB' for the United Kingdom. Please use the correct
country code per the ISO-2 Alpha-2 standard. Please find all country codes here

🚧

Limit of number of Virtual Accounts per update

There is a limit of 1,000 Virtual Accounts in an update request.

Error codes and descriptions