Update Account Information

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

note

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".

note

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.

note

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: text/plain
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.