{"title":"Get a web user","category":"default","creationDate":1776961629,"content":"<h2 id=\"getwebuser-request-fields\">Request parameters<\/h2>\n<p>To get detailed web user account information, make a POST <code>\/getWebUser<\/code> request specifying<\/p>\n<table><colgroup><\/colgroup><thead><tr class=\"header\"><th>Name<\/th><th>Type<\/th><th>Required<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td><p><code>userName<\/code><br>\n<\/p><\/td><td>\n<p>String<\/p>\n<\/td><td>\n<center><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/center>\n<\/td><td>\n<p>A user name string holds the user account display name.<br \/>\nIt can include:<\/p>\n<ul>\n<li>Digits: <em>0-9<\/em><\/li>\n<li>Letters <em>a-z<\/em>, <em>A-Z<\/em><\/li>\n<li>Special characters: \"<em>.<\/em>\" (dot), \"<em>-<\/em>\" (hyphen), \"<em>_<\/em>\" (underscore)<em><br \/>\n<\/em><\/li>\n<\/ul>\n<\/td><\/tr><\/tbody><\/table>\n<h2 id=\"getwebuser-response-fields\">Response parameters<\/h2>\n<p>If there are no errors in the request, the call returns\u00a0detailed information about the specified user account.<\/p>\n<p>If any issues occur during the process, the call returns an error message.<\/p>\n<table>\n<col style=\"width: 10%\"><col style=\"width: 15%\"><col style=\"width: 10%\"><col style=\"width: 15%\"><col style=\"width: 50%\">\n  <tbody>\n    <tr>\n      <th colspan=\"2\">Name<\/th>\n      <th>Type<\/th>\n      <th>Returned\u00a0by\u00a0default<\/th>\n      <th>Description<\/th>\n    <\/tr>\n   <tr><td colspan=\"2\"><code>pspReference<\/code><\/td><td>\n<p>String<\/p>\n<\/td><td>\n<center><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/center>\n<\/td><td>\n<p>A reference to uniquely identify the request.<\/p>\n<\/td><\/tr><tr><td colspan=\"2\"><p><code>active<\/code><br>\n<\/p><\/td><td>\n<p>Boolean<\/p>\n<\/td><td>\n<center><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/center>\n<\/td><td>\n<ul><li>\n<p><code>true<\/code>: the account is active.<\/p>\n<\/li><li>\n<p><code>false<\/code>: the account is inactive.<\/p>\n<\/li><\/ul>\n<\/td><\/tr><tr><td colspan=\"2\"><p><code>email<\/code><br>\n<\/p><\/td><td>\n<p>String<\/p>\n<\/td><td>\n<center><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/center>\n<\/td><td>\n<p>The email address associated with the user account.<\/p>\n<\/td><\/tr><tr><td colspan=\"2\"><code>merchantCodes<\/code><br>\n<\/td><td>\n<p>List<\/p>\n<\/td><td>\n<center><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/center>\n<\/td><td>\n<p>A list holding merchant code strings.A merchant code string holds a value to identify a merchant.<\/p>\n<p>Format:<\/p>\n<ul>\n<li>Either: <code>MerchantAccount.Merchant_Code<\/code><\/li>\n<li>Or: <code>Merchant_Code<\/code><\/li>\n<\/ul>\n<\/td><\/tr>\n<tr>\n  <td colspan=\"2\"><code>accountGroupCodes<\/code><\/td>\n  <td>\n<p>Array<\/p>\n<\/td>\n  <td>\n<center><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/center>\n<\/td>\n  <td>\n<p>An array of <a href=\"\/pt\/account\/account-structure#account-groups\">account group names<\/a>.<br \/>\nFor example: <code>[\"groupEU\", \"groupUS\"]<\/code>.<\/p>\n<\/td>\n<\/tr>\n<tr><td colspan=\"2\"><code>roles<\/code><br>\n<\/td><td>\n<p>List<\/p>\n<\/td><td>\n<center><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/center>\n<\/td><td>\n<p>A container object for\u00a0types of role for the account user.<\/p>\n<ul>\n<li><code>RoleType<\/code><\/li>\n<\/ul>\n<\/td><\/tr><tr><td colspan=\"1\"><\/td><td colspan=\"1\"><code>RoleType<\/code><\/td><td>\n<p>enum<\/p>\n<\/td><td>\n<center><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/center>\n<\/td><td>\n<p>It defines the type of role assigned to the user account.<br \/>\nSome examples of roles are:<\/p>\n<ul>\n<li><code>Merchant_standard_role<\/code><\/li>\n<li><code>Merchant_manage_payments<\/code><\/li>\n<li><code>Merchant_Report_role<\/code><\/li>\n<li><code>Merchant_dispute_management<\/code><\/li>\n<li><code>Merchant_technical_integrator<\/code><\/li>\n<li><code>Merchant_View_Risk_Results_role<\/code><\/li>\n<li><code>Merchant_view_risk_settings<\/code><\/li>\n<li><code>Merchant_change_risk_settings<\/code>\u00a0<\/li>\n<li><code>Merchant_allowed_own_password_reset<\/code><\/li>\n<\/ul>\n<\/td><\/tr><tr><td colspan=\"2\"><p><code>timeZoneCode<\/code><br>\n<\/p><\/td><td>\n<p>String<\/p>\n<\/td><td>\n<center><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/center>\n<\/td><td>\n<p>The time zone associated to the user account profile.<\/p>\n<p>If you do not specify any value, the active user's time zone settings are used instead.<\/p>\n<\/td><\/tr><tr><td colspan=\"2\"><p><code>userName<\/code><br>\n<\/p><\/td><td>\n<p>String<\/p>\n<\/td><td>\n<center><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/center>\n<\/td><td>\n<p>A user name string holds the user account display name.<br \/>\nIt can include:<\/p>\n<ul>\n<li>Digits: <em>0-9<\/em><\/li>\n<li>Letters <em>a-z<\/em>, <em>A-Z<\/em><\/li>\n<li>Special characters: \"<em>.<\/em>\" (dot), \"<em>-<\/em>\" (hyphen), \"<em>_<\/em>\" (underscore)<em><br \/>\n<\/em><\/li>\n<\/ul>\n<\/td><\/tr>\n   <tr>\n     <td colspan=\"2\"><code>name<\/code><\/td>\n     <td>\n<p>Object<\/p>\n<\/td>\n     <td>\n<center><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/center>\n<\/td>\n     <td>\n<p>A container object for personal data. This object contains: <ul><li markdown=\"1\"><code>firstName<\/code><\/li><li markdown=\"1\"><code>lastName<\/code><\/li><\/ul><\/p>\n<\/td>\n   <\/tr>\n   <tr>\n     <td colspan=\"1\"> <\/td>\n     <td colspan=\"1\">|-<code>firstName<\/code><\/td>\n     <td>\n<p>String<\/p>\n<\/td>\n     <td>\n<center><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/center>\n<\/td>\n     <td>\n<p>The first name\/given name of the user.<\/p>\n<ul>\n<li>Max. length: 80 characters<\/li>\n<\/ul>\n<\/td>\n   <\/tr>\n   <tr>\n     <td colspan=\"1\">\u00a0<\/td>\n     <td colspan=\"1\">|-<code>lastName<\/code><\/td>\n     <td>\n<p>String<\/p>\n<\/td>\n     <td>\n<center><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\" \/><\/center>\n<\/td>\n     <td>\n<p>The last name\/family name of the user.<\/p>\n<ul>\n<li>Max. length: 80 characters<\/li>\n<\/ul>\n<\/td>\n   <\/tr>\n<\/tbody><\/table>\n<h2>Examples<\/h2>\n<h3 id=\"request\">Request<\/h3>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"''\" :id=\"'1837377655'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{  \\n   \\\"userName\\\":\\\"merchant1\\\"\\n}\"},{\"language\":\"xml\",\"tabTitle\":\"Soap\",\"content\":\"&lt;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\\\"&gt;\\n  &lt;soap:Body&gt;\\n    &lt;getWebUser xmlns=\\\"http:\\\/\\\/caaccount.services.adyen.com\\\"&gt;\\n      &lt;request&gt;\\n        &lt;userName&gt;merchant1&lt;\\\/userName&gt;\\n      &lt;\\\/request&gt;\\n    &lt;\\\/getWebUser&gt;\\n  &lt;\\\/soap:Body&gt;\\n&lt;\\\/soap:Envelope&gt;\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h3 id=\"response\">Response<\/h3>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"''\" :id=\"'41260873'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n   \\\"pspReference\\\":\\\"9914526953450369\\\",\\n   \\\"active\\\":\\\"true\\\",\\n   \\\"email\\\":\\\"janedoe@adyen.com\\\",\\n   \\\"merchantCodes\\\":[\\n      \\\"TestMerchant\\\"\\n   ],\\n   \\\"name\\\":{\\n      \\\"firstName\\\":\\\"Jane\\\",\\n      \\\"lastName\\\":\\\"Doe\\\"\\n   },\\n   \\\"timeZoneCode\\\":\\\"Europe\\\/Amsterdam\\\",\\n   \\\"userName\\\":\\\"merchant1\\\"\\n}\"},{\"language\":\"xml\",\"tabTitle\":\"Soap\",\"content\":\"\\u00a0&lt;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\\\"&gt;\\n  &lt;soap:Body&gt;\\n    &lt;ns0:getWebUserResponse&gt;\\n      &lt;ns0:response&gt;\\n        &lt;ns0:pspReference&gt;9914526953450369&lt;\\\/ns0:pspReference&gt;\\n        &lt;ns0:active&gt;true&lt;\\\/ns0:active&gt;\\n        &lt;ns0:email&gt;janedoe@adyen.com&lt;\\\/ns0:email&gt;\\n        &lt;ns0:merchantCodes&gt;\\n          &lt;ns0:string&gt;TestMerchant&lt;\\\/ns0:string&gt;\\n        &lt;\\\/ns0:merchantCodes&gt;\\n        &lt;ns0:name&gt;\\n          &lt;ns1:firstName&gt;Jane&lt;\\\/ns1:firstName&gt;\\n          &lt;ns1:lastName&gt;Doe&lt;\\\/ns1:lastName&gt;\\n        &lt;\\\/ns0:name&gt;\\n        &lt;ns0:timeZoneCode&gt;Europe\\\/Amsterdam&lt;\\\/ns0:timeZoneCode&gt;\\n        &lt;ns0:userName&gt;merchant1&lt;\\\/ns0:userName&gt;\\n      &lt;\\\/ns0:response&gt;\\n    &lt;\\\/ns0:getWebUserResponse&gt;\\n  &lt;\\\/soap:Body&gt;\\n&lt;\\\/soap:Envelope&gt;\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>","url":"https:\/\/docs.adyen.com\/pt\/account-management-api\/manage-user-accounts\/getwebuser","articleFields":{"id":"25135011","type":"page","description":"Get user account information.","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/account-management-api\/manage-user-accounts\/getwebuser","title":"Get a web user","content":"Request parameters\nTo get detailed web user account information, make a POST \/getWebUser request specifying\nNameTypeRequiredDescriptionuserName\n\nString\n\n\n\nA user name string holds the user account display name.\nIt can include:\n\nDigits: 0-9\nLetters a-z, A-Z\nSpecial characters: \".\" (dot), \"-\" (hyphen), \"_\" (underscore)\n\n\n\nResponse parameters\nIf there are no errors in the request, the call returns\u00a0detailed information about the specified user account.\nIf any issues occur during the process, the call returns an error message.\n\n\n  \n    \n      Name\n      Type\n      Returned\u00a0by\u00a0default\n      Description\n    \n   pspReference\nString\n\n\n\nA reference to uniquely identify the request.\nactive\n\nBoolean\n\n\n\n\ntrue: the account is active.\n\nfalse: the account is inactive.\n\nemail\n\nString\n\n\n\nThe email address associated with the user account.\nmerchantCodes\n\nList\n\n\n\nA list holding merchant code strings.A merchant code string holds a value to identify a merchant.\nFormat:\n\nEither: MerchantAccount.Merchant_Code\nOr: Merchant_Code\n\n\n\n  accountGroupCodes\n  \nArray\n\n  \n\n\n  \nAn array of account group names.\nFor example: [\"groupEU\", \"groupUS\"].\n\n\nroles\n\nList\n\n\n\nA container object for\u00a0types of role for the account user.\n\nRoleType\n\nRoleType\nenum\n\n\n\nIt defines the type of role assigned to the user account.\nSome examples of roles are:\n\nMerchant_standard_role\nMerchant_manage_payments\nMerchant_Report_role\nMerchant_dispute_management\nMerchant_technical_integrator\nMerchant_View_Risk_Results_role\nMerchant_view_risk_settings\nMerchant_change_risk_settings\u00a0\nMerchant_allowed_own_password_reset\n\ntimeZoneCode\n\nString\n\n\n\nThe time zone associated to the user account profile.\nIf you do not specify any value, the active user's time zone settings are used instead.\nuserName\n\nString\n\n\n\nA user name string holds the user account display name.\nIt can include:\n\nDigits: 0-9\nLetters a-z, A-Z\nSpecial characters: \".\" (dot), \"-\" (hyphen), \"_\" (underscore)\n\n\n\n   \n     name\n     \nObject\n\n     \n\n\n     \nA container object for personal data. This object contains: firstNamelastName\n\n   \n   \n      \n     |-firstName\n     \nString\n\n     \n\n\n     \nThe first name\/given name of the user.\n\nMax. length: 80 characters\n\n\n   \n   \n     \u00a0\n     |-lastName\n     \nString\n\n     \n\n\n     \nThe last name\/family name of the user.\n\nMax. length: 80 characters\n\n\n   \n\nExamples\nRequest\n\n    \n\nResponse\n\n    \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Account management API","lvl2":"Manage user accounts","lvl3":"Get a web user"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/account-management-api","lvl2":"https:\/\/docs.adyen.com\/pt\/account-management-api\/manage-user-accounts","lvl3":"\/pt\/account-management-api\/manage-user-accounts\/getwebuser"},"levels":4,"category":"","category_color":"","tags":[]},"articleFiles":{"41260873.json":"<p alt=\"\">41260873.json<\/p>","1837377655.json":"<p alt=\"\">1837377655.json<\/p>"}}
