Search

Are you looking for test card numbers?

Would you like to contact support?

Default icon

Update a contact detail

Update a financial or shareholder contact detail for a merchant account.

This call does not support partial updates.

If an error occurs during an update:

  • No changes are applied.
  • Current data is kept.
  • The entire update fails.

Request parameters

To update contact details for the specified contact type associated with a merchant account, make a POST /updateContactDetail specifying:

Name Type
Required
Description

contactType

enum
-white_check_mark-
The type of contact whose details you want to retrieve.
Allowed values:
  • financialContact
  • shareHolder1
  • shareHolder2
  • shareHolder3
  • shareHolder4

merchantCode

String
-white_check_mark-
A merchant code string holds a value to identify a merchant. Format:
  • Either: MerchantAccount.Merchant_Code
  • Or: Merchant_Code
contact
class
-white_check_mark-
A container object for contact type data This field holds the following child element(s):
  • address
  • name
  • personalData
  • PhoneNumber
  • fullPhoneNumber
  • email
  • webAddress
|-fullPhoneNumber String
-x-
Complete telephone number, i.e. country code + area code + phone number, represented as one string.
For example: 0031 6 11 22 33 44; +316/1122-3344; (0031) 611223344. It is handled as a Landline phone type.
Max. length: 14 chars.
|-email String
-x-
The email address associated with the user account.

|-webAddress

String
-x-
Web address of the contact.
|-address
class
-white_check_mark-
A container object for address details. This field holds the following child element(s):
  • city
  • country
  • houseNumberOrName
  • postalCode
  • stateOrProvince
  • street

|-city

String
-white_check_mark-
The city the contact operates from.

|-country

String
-white_check_mark-

The country the contact operates from.

The country value format needs to adhere to the ISO 3166-1 alpha-2 standard. An invalid country code results in a transaction/request rejection. You can look up country codes on the ISO website.

|-houseNumberOrName

String
-white_check_mark-
House number or name of the building the contact operates from.

|-postalCode

String
-white_check_mark-
ZIP code. Character limitations:
  • US ZIP code: max. 5 chars.
  • Any other country: max. 10 chars.
|-stateOrProvince String
-white_check_mark-
State, region or province the contact operates from.
|-street String
-white_check_mark-
Street address.
|-name
class
-white_check_mark-
A container object for personal data
  • firstName
  • gender
  • infix
  • lastName

|-firstName

String
-white_check_mark-
The first name/given name of the user.
  • Max. length: 80 characters

|-lastName

String
-white_check_mark-
The last name/family name of the user.
  • Max. length: 80 characters

|-infix

String
-white_check_mark-
Infix in the user account's name.
  • Max. length: 20 characters

|-gender

enum
-white_check_mark-
Defines the gender of the user.
Allowed values:
  • MALE
  • FEMALE
  • UNKNOWN
|-personalData
class
-white_check_mark-
A container object for personal information details.
  • dateOfBirth
  • idNumber
  • nationality

|-dateOfBirth

class
-white_check_mark-
The shopper's date of birth. Format: ISO-8601; example: YYYY-MM-DD

|-idNumber

String
-white_check_mark-
A unique identifier for the contact type.

|-nationality

String
-x-

Nationality of the contact.

The country value format needs to adhere to the ISO 3166-1 alpha-2 standard. An invalid country code results in a transaction/request rejection. You can look up country codes on the ISO website. 

|-PhoneNumber
class
-white_check_mark-
A container object for telephone details. This field holds the following child element(s):
  • phoneCountryCode
  • phoneNumber
  • phoneType

|-phoneCountryCode

String
:-white_check_mark-

The country the phone line operates from.

The country value format needs to adhere to the ISO 3166-1 alpha-2 standard. An invalid country code results in a transaction/request rejection. You can look up country codes on the ISO website.

|-phoneNumber

String
-white_check_mark-

Telephone number, without the country code.

|-phoneType

enum
:-white_check_mark-
Telephone line type.
Allowed values:
  • Landline
  • Mobile
  • SIP
  • Fax

Response parameters

If there are no errors in the request, the call returns a pspReference.If any issues occur during the process, the call returns one or more warning or error messages.

Name Type Returned by default Description
pspReference String
-white_check_mark-
A reference to uniquely identify the request.
warnings String

-x-
List containing one or more warning messages.
Returned when the request is not correctly processed.
errors String
-x-
List containing one or more error messages.
Returned when the request fails.

Examples

Request

 {  
   "contact":{  
      "address":{  
         "city":"Amsterdam",
         "country":"NL",
         "houseNumberOrName":"2",
         "postalCode":"1111",
         "stateOrProvince":"AA",
         "street":"Erstestraat"
      },
      "email":"johanna.van.doe@testshop.nl",
      "name":{  
         "firstName":"Johanna",
         "gender":"FEMALE",
         "infix":"van",
         "lastName":"Doe"
      },
      "personalData":{  
         "dateOfBirth":"1948-08-14",
         "idNumber":"NL2227779",
         "nationality":"PL"
      },
      "phoneNumber":{  
         "phoneCountryCode":"NL",
         "phoneNumber":"11 22 33 44",
         "phoneType":"Landline"
      },
      "webAddress":"http:\/\/testshop.nl"
   },
   "contactType":"financialContact",
   "merchantCode":"TestMerchant"
}
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <updateContactDetail xmlns="http://caaccount.services.adyen.com">
      <request>
        <contact>
          <email xmlns="http://common.services.adyen.com">johanna.van.doe@testshop.nl</email>
          <name xmlns="http://common.services.adyen.com">
            <firstName>Johanna</firstName>
            <gender>FEMALE</gender>
            <infix>van</infix>
            <lastName>Doe</lastName>
          </name>
          <address xmlns="http://common.services.adyen.com">
            <city>Amsterdam</city>
            <country>NL</country>
            <houseNumberOrName>2</houseNumberOrName>
            <postalCode>1111</postalCode>
            <stateOrProvince>AA</stateOrProvince>
            <street>Erstestraat</street>
          </address>
          <personalData xmlns="http://common.services.adyen.com">
            <dateOfBirth>1948-08-14</dateOfBirth>
            <idNumber>NL2227779</idNumber>
            <nationality>PL</nationality>
          </personalData>
          <phoneNumber xmlns="http://common.services.adyen.com">
            <phoneCountryCode>NL</phoneCountryCode>
            <phoneNumber>11 22 33 44</phoneNumber>
            <phoneType>Landline</phoneType>
          </phoneNumber>
          <webAddress xmlns="http://common.services.adyen.com">http://testshop.nl</webAddress>
        </contact>
        <contactType>financialContact</contactType>
        <merchantCode>TestMerchant</merchantCode>
      </request>
    </updateContactDetail>
  </soap:Body>
</soap:Envelope>

Response in case of an error

{  
  "errors":[  
    "8_088 contactType 'financialContact' is not yet configured, can't update"
  ],
  "pspReference":"9914140685310352"
}
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns0="http://caaccount.services.adyen.com" xmlns:ns1="http://common.services.adyen.com" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <ns0:updateContactDetailResponse>
      <ns0:response>
        <ns0:contact>
          <ns0:pspReference>9914140685310352</ns0:pspReference>
          <ns0:errors>
            <ns0:string>8_088 contactType 'financialContact' is not yet configured, can't update</ns0:string>
          </ns0:errors>
        </ns0:contact>
      </ns0:response>
    </ns0:updateContactDetailResponse>
  </soap:Body>
</soap:Envelope>