{"title":"Update merchant data","category":"default","creationDate":1776961629,"content":"<p>You can update the following details:<\/p>\n<ul>\n<li>Your merchant name.<\/li>\n<li>Your web shop URL.<\/li>\n<li>The city you operate from.<\/li>\n<li>The primary currency you use for payment settlements.<\/li>\n<li>The duration between authorising a payment and capturing\u00a0it.<\/li>\n<\/ul>\n<p>This call supports full and partial updates:<\/p>\n<ul>\n<li>All the populated fields in the update request are updated;<\/li>\n<li>Any non-mandatory fields excluded from the operation are skipped.<\/li>\n<\/ul>\n<p>For a field to be updated correctly, it needs to be completely populated.\u00a0For example, to update an element that contains child elements, all the mandatory child elements must be populated with valid data.<\/p>\n<p>If one or more mandatory sub-elements are missing from the update request, the whole parent element fails to update, and its value does not change.  <\/p>\n<h2 id=\"updatemerchantdata-request-fields\">Request parameters<\/h2>\n<p>To update merchant data information, submit a POST <code>\/updateMerchantData<\/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>merchantCode<\/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 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><tr><td>\n<p><code>name<\/code><br><\/p>\n<\/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>Provide a new name for the merchant.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>shopWebAddress<\/code><br><\/p>\n<\/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>Provide a new URL pointing to your online shop.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>merchantCity<\/code><br><\/p>\n<\/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>Provide a new city you operate from.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>primarySettlementCurrency<\/code><br><\/p>\n<\/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><p>Provide a different primary currency to settle payments.<br>\nRequirements and restrictions:<\/p><ul><li>\n<p>Currency format \u2013 The three-character <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_4217\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO currency code<\/a>.<br><\/p>\n<\/li><li>\n<p>You need to have an approved bank account that can handle transactions in the specified currency.<br><\/p>\n<\/li><\/ul><\/td><\/tr><tr><td>\n<p><code>captureDelay<\/code><br><\/p>\n<\/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><p>Define a new time interval between authorising and capturing a payment.<br>\nAllowed values:<\/p><ul><li><code>1<\/code> to <code>7<\/code>: capture occurs a specified number of days after authorisation.<br>\n<ul><li>\n<p>Min.: capture occurs 1 day after authorisation.<\/p>\n<\/li><li>\n<p>Max: capture occurs 7 days after authorisation.<\/p>\n<\/li><\/ul><\/li><\/ul><ul><li>\n<p><code>immediate<\/code>: capture occurs as soon as the payment is authorised, without any delay.<\/p>\n<\/li><li>\n<p><code>manual<\/code>: capture does not occur automatically; you need to manually trigger it.<\/p>\n<\/li><\/ul><\/td><\/tr><\/tbody><\/table>\n<h2 id=\"updatemerchantdata-response-fields\">Response fields<\/h2>\n<p>If there are no errors in the request, the call returns\u00a0a\u00a0<code>pspReference.<\/code>If any issues occur during the process, the call returns one or more warning or error messages.<\/p>\n<table><thead><tr class=\"header\"><th>Name<\/th><th>Type<\/th><th>Returned\u00a0by\u00a0default<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>\n<p><code>pspReference<\/code><\/p>\n<\/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>\n<p><code>warnings<\/code><\/p>\n<\/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>List containing one or more warning messages.<br \/>\nReturned when the request is not correctly processed.<\/p>\n<\/td><\/tr><tr><td>\n<p><code>errors<\/code><\/p>\n<\/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>List containing one or more error messages.<br \/>\nReturned when the request fails.<\/p>\n<\/td><\/tr><\/tbody><\/table>\n<h2>Examples<\/h2>\n<h3 id=\"request\">Request<\/h3>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"''\" :id=\"'1650415378'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{  \\n   \\\"merchantCode\\\":\\\"TestMerchant\\\",\\n   \\\"merchantCity\\\":\\\"Utrecht\\\"\\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;updateMerchantData xmlns=\\\"http:\\\/\\\/caaccount.services.adyen.com\\\"&gt;\\n      &lt;request&gt;\\n        &lt;merchantCode&gt;TestMerchant&lt;\\\/merchantCode&gt;\\n        &lt;merchantCity&gt;Utrecht&lt;\\\/merchantCity&gt;\\n      &lt;\\\/request&gt;\\n    &lt;\\\/updateMerchantData&gt;\\n  &lt;\\\/soap:Body&gt;\\n&lt;\\\/soap:Envelope&gt;\\u00a0\"}]' :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=\"'2111302742'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{  \\n   \\\"pspReference\\\":\\\"9914526953720373\\\"\\n}\"},{\"language\":\"xml\",\"tabTitle\":\"Soap\",\"content\":\"&lt;soap:Envelope xmlns:soap=\\\"http:\\\/\\\/schemas.xmlsoap.org\\\/soap\\\/envelope\\\/\\\" xmlns:ns0=\\\"http:\\\/\\\/caaccount.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:updateMerchantDataResponse&gt;\\n      &lt;ns0:response&gt;\\n        &lt;ns0:pspReference&gt;9914526953720373&lt;\\\/ns0:pspReference&gt;\\n      &lt;\\\/ns0:response&gt;\\n    &lt;\\\/ns0:updateMerchantDataResponse&gt;\\n  &lt;\\\/soap:Body&gt;\\n&lt;\\\/soap:Envelope&gt;\\u00a0\"}]' :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\/updatemerchantdata","articleFields":{"id":"25135015","type":"page","description":"Update an existing merchant account's details.","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/account-management-api\/manage-user-accounts\/updatemerchantdata","title":"Update merchant data","content":"You can update the following details:\n\nYour merchant name.\nYour web shop URL.\nThe city you operate from.\nThe primary currency you use for payment settlements.\nThe duration between authorising a payment and capturing\u00a0it.\n\nThis call supports full and partial updates:\n\nAll the populated fields in the update request are updated;\nAny non-mandatory fields excluded from the operation are skipped.\n\nFor a field to be updated correctly, it needs to be completely populated.\u00a0For example, to update an element that contains child elements, all the mandatory child elements must be populated with valid data.\nIf one or more mandatory sub-elements are missing from the update request, the whole parent element fails to update, and its value does not change.  \nRequest parameters\nTo update merchant data information, submit a POST \/updateMerchantData request specifying:\nNameTypeRequiredDescriptionmerchantCode\n\nString\n\n\n\nA merchant code string holds a value to identify a merchant.\nFormat:\n\nEither: MerchantAccount.Merchant_Code\nOr: Merchant_Code\n\n\nname\n\nString\n\n\n\nProvide a new name for the merchant.\n\nshopWebAddress\n\nString\n\n\n\nProvide a new URL pointing to your online shop.\n\nmerchantCity\n\nString\n\n\n\nProvide a new city you operate from.\n\nprimarySettlementCurrency\n\nString\n\n\nProvide a different primary currency to settle payments.\nRequirements and restrictions:\nCurrency format \u2013 The three-character ISO currency code.\n\nYou need to have an approved bank account that can handle transactions in the specified currency.\n\ncaptureDelay\n\nenum\n\n\nDefine a new time interval between authorising and capturing a payment.\nAllowed values:1 to 7: capture occurs a specified number of days after authorisation.\n\nMin.: capture occurs 1 day after authorisation.\n\nMax: capture occurs 7 days after authorisation.\n\nimmediate: capture occurs as soon as the payment is authorised, without any delay.\n\nmanual: capture does not occur automatically; you need to manually trigger it.\n\nResponse fields\nIf there are no errors in the request, the call returns\u00a0a\u00a0pspReference.If any issues occur during the process, the call returns one or more warning or error messages.\nNameTypeReturned\u00a0by\u00a0defaultDescription\npspReference\n\nString\n\n\n\nA reference to uniquely identify the request.\n\nwarnings\n\nString\n\n\n\nList containing one or more warning messages.\nReturned when the request is not correctly processed.\n\nerrors\n\nString\n\n\n\nList containing one or more error messages.\nReturned when the request fails.\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":"Update merchant data"},"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\/updatemerchantdata"},"levels":4,"category":"","category_color":"","tags":["Update","merchant"]},"articleFiles":{"1650415378.json":"<p alt=\"\">1650415378.json<\/p>","2111302742.json":"<p alt=\"\">2111302742.json<\/p>"}}