Search

Are you looking for test card numbers?

Would you like to contact support?

Default icon

Invite web user

Create a new web user and send a registration email.

Use the /inviteWebUser endpoint to create a user and send an email to invite them to register.

After you submit the request, the user will receive an email from Adyen, containing a one-time use link to a page where they create their own password to complete the registration process. The link is valid within 24 hours. If the link has already expired and the user has not yet completed the registration, inform them to contact their Admin and ask to send a new invitation email.

The endpoint requires at least one merchantCode and one role. After the user completes the registration, their account will be associated with the merchant codes provided in the request.

Request parameters

To invite a new web user, make a POST /inviteWebUser request specifying the following parameters:

Name Type
Required
Description
email String
-white_check_mark-
The email address associated with the user account.
merchantCodes Array
-white_check_mark-
An array of merchant code strings.
A merchant code string holds a value to identify a merchant. Format:
  • Either: MerchantAccount.Merchant_Code
  • Or: Merchant_Code
timeZoneCode String
-white_check_mark-
The time zone associated to the user account profile. If you do not specify any value, the active user's time zone settings are used instead.
userName String
-white_check_mark-
A user name string holds the user account display name.
It can include:
  • Digits: 0-9
  • Letters a-z, A-Z
  • Special characters: "." (dot), "-" (hyphen), "_" (underscore)
name Object
-white_check_mark-
A container object for personal data. This object contains:
  • firstName
  • infix
  • lastName
|-firstName String
-white_check_mark-
The first name/given name of the user.
  • Max. length: 80 characters
  |-infix String
-x-
Infix in the user account's name.
  • Max. length: 20 characters
  |-lastName String
-white_check_mark-
The last name/family name of the user.
  • Max. length: 80 characters
roles Array
-white_check_mark-

A container object for types of role for the account user.

  • RoleType
RoleType Enum
-x-
It defines the type of role assigned to the user account.
Some examples of roles are:
  • Merchant_standard_role
  • Merchant_manage_payments
  • Merchant_Report_role
  • Merchant_dispute_management
  • Merchant_technical_integrator
  • Merchant_View_Risk_Results_role
  • Merchant_view_risk_settings
  • Merchant_change_risk_settings 
  • Merchant_allowed_own_password_reset

Response parameters

The response contains the user name and a pspReference.

If any issues occur during the process, the call returns one or more warning or error messages. The user is not created and no username is returned in the response.

Name Type Returned by default Description
userName String -x- The user name assigned to the newly created account.
pspReference String -white_check_mark- Unique identifier for the request.
warnings Array -x- String array containing one or more warning messages.
Returned when the request is not correctly processed.
errors Array -x- String array containing one or more warning messages.
Returned when the request is not correctly processed.

Examples

Request

{
   "email":"test@test.nl",
   "merchantCodes":[
      "MerchantAccount.TestMerchant"
   ],
   "name":{
      "firstName":"Jane",
      "lastName":"Hopper"
   },
    "roles": [
        "Merchant_standard_role",
        "Merchant_allowed_own_password_reset"
    ],
    "timeZoneCode":"UTC",
    "userName":"testUser"
}
<?xml version="1.0" encoding="UTF-8"?>
<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>
        <addWebUser xmlns="http://caaccount.services.adyen.com">
            <request>
                <email>test@test.nl</email>
                <merchantCodes>
                    <string>MerchantAccount.TestMerchant</string>
                </merchantCodes>
                <roles>
                  <RoleType>Merchant_standard_role</RoleType>
                  <RoleType>Merchant_allowed_own_password_reset</RoleType>
                </roles>
                </merchantCodes>
                <name>
                    <firstName xmlns="http://common.services.adyen.com">Jane</firstName>
                    <lastName xmlns="http://common.services.adyen.com">Hopper</lastName>
                </name>
                <timeZoneCode>UTC</timeZoneCode>
                <userName>testUser</userName>
            </request>
        </addWebUser>
    </soap:Body>
</soap:Envelope>

Response

{
   "pspReference":"9914526950450289",
   "userName": "testUser"
}
<?xml version="1.0" encoding="UTF-8"?>
<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" xmlns:ns0="http://caaccount.services.adyen.com">
    <soap:Body>
        <ns0:addWebUserResponse>
            <ns0:response>
                <ns0:pspReference>9914526950450289</ns0:pspReference>
                <ns0:userName>testUser</ns0:userName>
            </ns0:response>
        </ns0:addWebUserResponse>
    </soap:Body>
</soap:Envelope>

Response in case of an error

{
  "pspReference":"9914368689030052",
  "errors":[
    "8_008 lacks permission to merchant 'TestMerchant'"
  ]
}
<?xml version="1.0" encoding="UTF-8"?>
<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" xmlns:ns0="http://caaccount.services.adyen.com">
    <soap:Body>
        <ns0:addWebUserResponse>
            <ns0:response>
                <ns0:errors>
                    <ns0:string>8_008 lacks permission to merchant 'TestMerchant'</ns0:string>
                </ns0:errors>
                <ns0:pspReference>9914368689030052</ns0:pspReference>
            </ns0:response>
        </ns0:addWebUserResponse>
    </soap:Body>
</soap:Envelope>