Update Account Information

Last changes: 07-03-2023

Call the API method 1.4 Update Account Information to replace/amend account information by the provided data.

If you do not submit a previously set optional parameter with the same data, it will be overwritten with null, e.g. if a value is set for "addr2" and you do not resubmit the same value during the update, the value for "addr2" will be set to null

Therefore, we recommend to get the contemporary account information (see Get Account Information) and reuse this data apart from the changed fields.

For more information on handling null values and empty strings in requests, please check our FAQ section on "Sending parameter with null value".

In line with Strong Customer Authentication (SCA), any customer information, such as names and addresses, must be accurately provided and reflect real customer data, especially in the following:

firstName
lastName
addr1
houseNumber (if not included in "addr1")
city
postcode
countryCode
emailAddress

Please discuss with you business contacts when providing accurate data may not be possible in production, as it may result in transactions being rejected and future incompatibility.

If the value of "countryCode" is "US" (United States of America) or "CA" (Canada) the "state" parameter is required. The value of "state" must be a valid State Code. (ex. "countryCode": "US", "state": "NY",)

In the example below we add a phone number to the account associated with the External Account Reference KDNR0001.

Update Account Request

Path:: POST {baseURL}/account/KDNR0001/updateInfo
Header:: Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=

{
    "partnerReference": "DEV-SVR001-DE_CUSTID-4V88Y8J27W_CARTID-BJ4PB47WWW_924FH2HJCW",
    "programCode": "COMPANYDE",
    "accnoType": "00",
    "lastName": "Smith",
    "firstName": "Jacob",
    "addr1":"Anystreet 321",
    "city":"Anycity",
    "countryCode":"DE",
    "postCode":"12345",
    "dob": "1990-01-01",
    "emailAddress": "user@example.com",
    "phone": "+4900000000",
    "useDifferentCorrespondenceAddress": false,
    "nationality": "DE",
    "localDate": "2018-10-20",
    "localTime": "113114"
}

Update Account Response

Status Code:: 200 (OK)
Header:: Content-Type: application/json
Accept-Language: en-US

{
    "accno": "KDNR0001",
    "providerResponse": {
        "complianceData": []
    },
    "programCode": "COMPANYDE",
    "partnerReference": "DEV-SVR001-DE_CUSTID-YHHG97XPCD_CARTID-BJ4PB47WWW_C3Y8J86343",
    "localDate": "2018-10-20",
    "localTime": "114920",
    "sysDate": "2018-10-20",
    "sysTime": "104921",
    "responseCode": "0000",
    "responseDescription": "Successful execution",
    "additionalInformation": {
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}

The "responseCode" 0000 and the “responseDescription” signify a successful update of the account information.

Previous

Next