API Reference
Client PortalAPI StatusWebsite
Start typing to search…

Modify customer details by file

patch
https://www.bankingcircleconnect.com/api/v1/virtual-accounts/customer-details/file

This endpoint allows you to modify the customer details of one or more active Virtual Accounts.

Requirements

  • You can send multiple Virtual Accounts with changes in the CSV file. Each Virtual Account and the associated changes go on a separate row.
  • All the headers are mandatory, but you should only include values for the headers you wish to modify.
  • Headers without changes should have null
  • The Virtual Accounts being modified must have status active and
  • The Virtual Accounts must already have customer details assigned. To assign customer details for the first time, use this endpoint.
  • You can perform up to two modifications per year for each Virtual Account, where each modification counts as a change to (Name, Address, or UltimateBeneficialOwners).
    • For example, if you modify both the name and address in one request, that counts as two modifications and no further customer details changes will be allowed for that Virtual Account within the same year.

Modification Reason Codes

A modification request must include one of the following reason codes:

CodeDescription
E01Change of the trading name
E02Name change due to marriage status change or legal change
E03Change of the business address
E04Change of the ownership/contract person for regulatory reporting

Modifying multiple values at once

If you want to modify multiple values of the same Virtual Account, include separate columns for each modification:

VirtualAccountNumber,ReasonCode,Name,Address_Department,Address_SubDepartment,Address_StreetName,Address_BuildingNumber,Address_BuildingName,Address_Floor,Address_PostBox,Address_Room,Address_PostCode,Address_TownName,Address_TownLocationName,Address_DistrictName,Address_CountrySubDivision,Address_Country,UltimateBeneficialOwner1_FirstName,UltimateBeneficialOwner1_LastName,UltimateBeneficialOwner2_FirstName,UltimateBeneficialOwner2_LastName,UltimateBeneficialOwner3_FirstName,UltimateBeneficialOwner3_LastName,UltimateBeneficialOwner4_FirstName,UltimateBeneficialOwner4_LastName,UltimateBeneficialOwner5_FirstName,UltimateBeneficialOwner5_LastName
0099876543,E01,Changed name,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null
0099876543,E03,null,null,null,NewStreetName,123,null,null,null,null,1000,Copenhagen,null,null,null,DK,null,null,null,null,null,null,null,null,null,null

Clearing optional columns

To clear an existing optional value, pass empty double quotes ("") to the column, for example:

VirtualAccountNumber,ReasonCode,Name,Address_Department,Address_SubDepartment,Address_StreetName,Address_BuildingNumber,Address_BuildingName,Address_Floor,Address_PostBox,Address_Room,Address_PostCode,Address_TownName,Address_TownLocationName,Address_DistrictName,Address_CountrySubDivision,Address_Country,UltimateBeneficialOwner1_FirstName,UltimateBeneficialOwner1_LastName,UltimateBeneficialOwner2_FirstName,UltimateBeneficialOwner2_LastName,UltimateBeneficialOwner3_FirstName,UltimateBeneficialOwner3_LastName,UltimateBeneficialOwner4_FirstName,UltimateBeneficialOwner4_LastName,UltimateBeneficialOwner5_FirstName,UltimateBeneficialOwner5_LastName
0099876543,E03,null,null,null,null,null,null,"",null,null,null,Copenhagen,null,null,null,DK,null,null,null,null,null,null,null,null,null,null

Rate and volume limits

  • Request limit of maximum 100 modifications per file
  • Processing limit of up to 2000 modifications per 10min

Required columns and column constraints

VirtualAccountNumber and ReasonCode are always required. Other columns marked as required in the table below are only required if you modify 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 UltimateBeneficialOwners.

The customer detail columns for Name and UltimateBeneficialOwners accept up to 35 characters. The Address columns have varying limits, which are shown in the table below.

Header (* required)Description
VirtualAccountNumber*The Virtual Account number customer details are assigned. Example: 0099876543
ReasonCode*The reason for the modification. Example: E01
NameMaximum 35 characters
Address.DepartmentMaximum 70 characters
Address.SubDepartmentMaximum 70 characters
Address.StreetNameMaximum 70 characters
Address.BuildingNumberMaximum 16 characters
Address.BuildingNameMaximum 35 characters
Address.FloorMaximum 70 characters
Address.PostBoxMaximum 16 characters
Address.RoomMaximum 70 characters
Address.PostCodeMaximum 16 characters
Address.TownName*Maximum 35 characters Required if you are changing the Address fields
Address.TownLocationNameMaximum 35 characters
Address.DistrictNameMaximum 35 characters
Address.CountrySubDivisionMaximum 35 characters
Address.Country*Must be a valid country code following the ISO-2 Alpha-2 standard. Required if you are changing the Address fields
UltimateBeneficialOwner1-5.FirstNameMaximum 35 characters The first set of FirstName/LastName is required if you are changing BeneficialOwner fields
UltimateBeneficialOwner1-5.LastNameMaximum 35 characters The first set of FirstName/LastName is required if you are changing BeneficialOwner fields

Allowed 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)
❗️

Leading spaces are not allowed

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

Language
Credentials
Bearer