{"title":"Disable stored details","category":"default","creationDate":1776961627,"content":"<div class=\"sc-notice warning\"><div>\n<p><strong>Adyen is no longer developing the Classic API integration<\/strong><\/p>\n<p>This page is for the Classic API (<code>\/authorise<\/code>) integration, which we no longer accept new integrations with. <\/p>\n<p>We strongly recommend migrating to the newer <a href=\"\/online-payments\/tokenization\/managing-tokens#delete-stored-details\">Manage tokens<\/a> integration. To use this newer integration, you must also <a href=\"\/pt\/online-payments\/upgrade-your-integration\/migrate-to-checkout-api\">migrate to the Checkout API<\/a>.<\/p>\n<\/div><\/div>\n<p>When you terminate your shopper's subscription, you need to disable the recurring contract to prevent charging this shopper with the previously\u00a0<a href=\"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/tokenization\/store-payment-details\">stored payment details<\/a>.<\/p>\n<h2 id=\"request\">Request<\/h2>\n<p>To disable stored details, send a request to the\u00a0<code>\/disable<\/code>\u00a0endpoint. In this request specify the merchant account, shopper reference, and the contract type (either ONECLICK or RECURRING). You can also specify the reference of a particular recurring detail to disable, or skip this parameter to disable all recurring details for the specified shopper.<\/p>\n<p>For information on all available fields, refer to the\u00a0<a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Recurring\/disable\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/disable<\/a>\u00a0page.<\/p>\n<p>The example below illustrates how to disable a one-click recurring detail.\u00a0Submit this request to the\u00a0<a href=\"https:\/\/pal-test.adyen.com\/pal\/servlet\/Recurring\/v25\/disable\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/pal-test.adyen.com\/pal\/servlet\/Recurring\/v25\/disable<\/a>\u00a0endpoint.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"''\" :id=\"'1147805316'\" :code-data=\"[{&quot;language&quot;:&quot;json&quot;,&quot;tabTitle&quot;:&quot;JSON&quot;,&quot;content&quot;:&quot;{\\n   \\&quot;merchantAccount\\&quot;:\\&quot;TestMerchant\\&quot;,\\n   \\&quot;shopperReference\\&quot;:\\&quot;YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j\\&quot;,\\n   \\&quot;recurringDetailReference\\&quot;:\\&quot;8313147988756818\\&quot;,\\n   \\&quot;contract\\&quot;:\\&quot;ONECLICK\\&quot;\\n}&quot;},{&quot;language&quot;:&quot;xml&quot;,&quot;tabTitle&quot;:&quot;Soap&quot;,&quot;content&quot;:&quot;&lt;soap:Envelope xmlns:soap=\\&quot;http:\\\/\\\/schemas.xmlsoap.org\\\/soap\\\/envelope\\\/\\&quot; \\nxmlns:xsd=\\&quot;http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema\\&quot; xmlns:xsi=\\&quot;http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema-instance\\&quot;&gt;\\n  &lt;soap:Body&gt;\\n    &lt;ns1:disable xmlns:ns1=\\&quot;http:\\\/\\\/recurring.services.adyen.com\\&quot;&gt;\\n      &lt;ns1:request&gt;\\n        &lt;ns1:merchantAccount&gt;TestMerchant&lt;\\\/ns1:merchantAccount&gt;\\n        &lt;ns1:shopperReference&gt;YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j&lt;\\\/ns1:shopperReference&gt;\\n        &lt;ns1:recurringDetailReference&gt;8313147988756818&lt;\\\/ns1:recurringDetailReference&gt;\\n        &lt;ns1:contract&gt;ONECLICK&lt;\\\/ns1:contract&gt;\\n      &lt;\\\/ns1:request&gt;\\n    &lt;\\\/ns1:disable&gt;\\n  &lt;\\\/soap:Body&gt; \\n&lt;\\\/soap:Envelope&gt;&quot;},{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/pal-test.adyen.com\\\/pal\\\/servlet\\\/Recurring\\\/v25\\\/disable \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n \\&quot;merchantAccount\\&quot;: \\&quot;TestMerchant\\&quot;,\\n \\&quot;shopperReference\\&quot;: \\&quot;YOUR_UNIQUE_SHOPPER_ID\\&quot;,\\n \\&quot;recurringDetailReference\\&quot;: \\&quot;8314897374042210\\&quot;,\\n \\&quot;contract\\&quot;: \\&quot;ONECLICK\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>The following example shows how to disable all the details of a recurring contract.\u00a0Submit this request to the\u00a0<a href=\"https:\/\/pal-test.adyen.com\/pal\/servlet\/Recurring\/v25\/disable\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/pal-test.adyen.com\/pal\/servlet\/Recurring\/v25\/disable<\/a>\u00a0endpoint.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"''\" :id=\"'1204481453'\" :code-data=\"[{&quot;language&quot;:&quot;json&quot;,&quot;tabTitle&quot;:&quot;JSON&quot;,&quot;content&quot;:&quot;{\\n   \\&quot;merchantAccount\\&quot;:\\&quot;TestMerchant\\&quot;,\\n   \\&quot;shopperReference\\&quot;:\\&quot;YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j\\&quot;,\\n   \\&quot;recurringDetailReference\\&quot;:\\&quot;8313147988756818\\&quot;\\n}&quot;},{&quot;language&quot;:&quot;xml&quot;,&quot;tabTitle&quot;:&quot;Soap&quot;,&quot;content&quot;:&quot;&lt;soap:Envelope xmlns:soap=\\&quot;http:\\\/\\\/schemas.xmlsoap.org\\\/soap\\\/envelope\\\/\\&quot; \\nxmlns:xsd=\\&quot;http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema\\&quot; xmlns:xsi=\\&quot;http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema-instance\\&quot;&gt;\\n  &lt;soap:Body&gt;\\n    &lt;ns1:disable xmlns:ns1=\\&quot;http:\\\/\\\/recurring.services.adyen.com\\&quot;&gt;\\n      &lt;ns1:request&gt;\\n        &lt;ns1:merchantAccount&gt;TestMerchant&lt;\\\/ns1:merchantAccount&gt;\\n        &lt;ns1:shopperReference&gt;YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j&lt;\\\/ns1:shopperReference&gt;\\n        &lt;ns1:recurringDetailReference&gt;8313147988756818&lt;\\\/ns1:recurringDetailReference&gt;\\n      &lt;\\\/ns1:request&gt;\\n    &lt;\\\/ns1:disable&gt;\\n  &lt;\\\/soap:Body&gt; \\n&lt;\\\/soap:Envelope&gt;&quot;},{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/pal-test.adyen.com\\\/pal\\\/servlet\\\/Recurring\\\/v25\\\/disable \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-d '{\\n \\&quot;merchantAccount\\&quot;: \\&quot;TestMerchant\\&quot;,\\n \\&quot;shopperReference\\&quot;: \\&quot;YOUR_UNIQUE_SHOPPER_ID\\&quot;,\\n \\&quot;recurringDetailReference\\&quot;: \\&quot;8314897374042210\\&quot;\\n}'&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"response\">Response<\/h2>\n<p>The response to the\u00a0<code>\/disable<\/code>\u00a0endpoint contains only a <code>response<\/code> field of a string type.<\/p>\n<p>Possible values:<\/p>\n<ul>\n<li><code>[detail-successfully-disabled]<\/code>\u00a0-\u00a0when a single detail is disabled.<\/li>\n<li><code>[all-details-successfully-disabled]<\/code>\u00a0-\u00a0when all the details are disabled.<\/li>\n<\/ul>\n<p>For information on all available fields, refer to the\u00a0<a href=\"https:\/\/docs.adyen.com\/api-explorer\/#\/Recurring\/disable\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/disable<\/a>\u00a0page.<\/p>\n<p>The following examples shows the response in case all recurring details are successfully disabled:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"''\" :id=\"'684566052'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n   \\\"response\\\":\\\"[all-details-successfully-disabled]\\\"\\n}\"},{\"language\":\"xml\",\"tabTitle\":\"Soap\",\"content\":\"&lt;soap:Envelope xmlns:soap=\\\"http:\\\/\\\/schemas.xmlsoap.org\\\/soap\\\/envelope\\\/\\\" \\nxmlns:xsd=\\\"http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema\\\" xmlns:xsi=\\\"http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema-instance\\\"&gt;\\n  &lt;soap:Body&gt;\\n    &lt;ns1:disableResponse xmlns:ns1=\\\"http:\\\/\\\/recurring.services.adyen.com\\\"&gt;\\n      &lt;ns1:result&gt;\\n        &lt;ns1:response&gt;[all-details-successfully-disabled]&lt;\\\/ns1:response&gt;\\n      &lt;\\\/ns1:result&gt;\\n    &lt;\\\/ns1:disableResponse&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\/online-payments\/classic-integrations\/classic-api-integration\/tokenization\/disable-stored-details","articleFields":{"parameters":{"anchor_new":"<a href=\"\/online-payments\/tokenization\/managing-tokens#delete-stored-details\">Manage tokens<\/a>","parent_page":"Classic API (<code>\/authorise<\/code>)","new_desc":"integrating using our Checkout APIs"},"sitemap":{"priority":0.3},"id":"24216556","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"14-07-2020 12:41"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/tokenization\/disable-stored-details","title":"Disable stored details","content":"\nAdyen is no longer developing the Classic API integration\nThis page is for the Classic API (\/authorise) integration, which we no longer accept new integrations with. \nWe strongly recommend migrating to the newer Manage tokens integration. To use this newer integration, you must also migrate to the Checkout API.\n\nWhen you terminate your shopper's subscription, you need to disable the recurring contract to prevent charging this shopper with the previously\u00a0stored payment details.\nRequest\nTo disable stored details, send a request to the\u00a0\/disable\u00a0endpoint. In this request specify the merchant account, shopper reference, and the contract type (either ONECLICK or RECURRING). You can also specify the reference of a particular recurring detail to disable, or skip this parameter to disable all recurring details for the specified shopper.\nFor information on all available fields, refer to the\u00a0\/disable\u00a0page.\nThe example below illustrates how to disable a one-click recurring detail.\u00a0Submit this request to the\u00a0https:\/\/pal-test.adyen.com\/pal\/servlet\/Recurring\/v25\/disable\u00a0endpoint.\n\n    \n\nThe following example shows how to disable all the details of a recurring contract.\u00a0Submit this request to the\u00a0https:\/\/pal-test.adyen.com\/pal\/servlet\/Recurring\/v25\/disable\u00a0endpoint.\n\n    \n\nResponse\nThe response to the\u00a0\/disable\u00a0endpoint contains only a response field of a string type.\nPossible values:\n\n[detail-successfully-disabled]\u00a0-\u00a0when a single detail is disabled.\n[all-details-successfully-disabled]\u00a0-\u00a0when all the details are disabled.\n\nFor information on all available fields, refer to the\u00a0\/disable\u00a0page.\nThe following examples shows the response in case all recurring details are successfully disabled:\n\n    \n","type":"page","locale":"pt","boost":15,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Classic integrations for Ecommerce","lvl3":"Classic API integration","lvl4":"Tokenization","lvl5":"Disable stored details"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/online-payments","lvl2":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations","lvl3":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration","lvl4":"https:\/\/docs.adyen.com\/pt\/online-payments\/classic-integrations\/classic-api-integration\/tokenization","lvl5":"\/pt\/online-payments\/classic-integrations\/classic-api-integration\/tokenization\/disable-stored-details"},"levels":6,"category":"Online Payments","category_color":"green","tags":["Disable","stored","details"]},"articleFiles":{"684566052.json":"<p alt=\"\">684566052.json<\/p>","1147805316.json":"<p alt=\"\">1147805316.json<\/p>","1204481453.json":"<p alt=\"\">1204481453.json<\/p>"}}
