Modify customer details (JSON)

The endpoint enables you to modify customer details assigned to your Virtual Accounts. You can send multiple Virtual Accounts with changes in the request body. Make sure you only include the properties you wish to change.

The endpoint will only work for Virtual Accounts with status Active that already have customer details assigned. To add customer details, please use this endpoint.

A modification request must include a reason. Please provide one of the available modification reasons for each Virtual Account/modification.

• E01 (Change of the trading name)
• E02 (Name change due to marriage status change or legal change)
• E03 (Change of the business address)
• E04 (Change of the ownership/contract person for regulatory reporting)

You can make two modifications per running year for each Virtual Account. However, within that restriction, you can only do one modification to Name, Address, and BeneficialOwners per running year. For example, a modification request that changes Name and Address fields counts as two modifications, which means no further customer details changes for that virtual account are allowed within the running year.

❗️

When you want to clear an existing value of an optional property, you have to provide the property with an empty value, example: "Department",""

If you want to make multiple changes to the same Virtual Account in a single modification request, you should make sure to separate the modifications into two objects in the Items array. Example:

{
    "items":
    [
        {
        "virtualAccountNumber":"0040087035",
        "reasonCode":"E01",
        "name":"NewName"
        },
        {
        "virtualAccountNumber":"0040087035",
        "reasonCode":"E03",
        "address": {
            "streetName": "NewStreet 2",
            "townName": "NewTown",
            "Country": "SE"
            }
        }        
    ]
}

❗️

There is a limit of 100 modifications per request and a processing limit allowing up to 2000 modifications per 10 minutes.

Some properties marked as required in the body params section below are only required if you update the object they are in. For example, Address.TownName and Address.Country are only required when you modify the Address object, not if you modify Name or BeneficialOwners. Only VirtualAccountNumber and ReasonCode are always required.

The customer detail properties for Name and BeneficialOwners accept up to 35 characters. The Address properties have varying limits, which are shown in the table below. 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)

After a successful modification request, you can check the status of the modification process with the status endpoint.