{"title":"Salesforce Commerce Cloud troubleshooting","category":"default","creationDate":1776961628,"content":"<p>If you are experiencing a problem with your Salesforce Commerce Cloud integration, there are several ways how you can troubleshoot the issue yourself. Before you contact our Support Team:<\/p>\n<ul>\n<li>Make sure that you <a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/set-up-the-cartridge\">set up the cartridge correctly<\/a>.<\/li>\n<li>Check our <a href=\"https:\/\/help.adyen.com\/knowledge\/plugins\/salesforce\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">FAQ<\/a>.<\/li>\n<li>Follow the steps below.<\/li>\n<\/ul>\n<h2 class=\"no-border\">Step 1:  Clear the cache<\/h2>\n<p>The Adyen Payment cartridge does not make use of the Salesforce Commerce Cloud cache system.<\/p>\n<p>When troubleshooting, we still recommend that you clear the caches in Salesforce Commerce Cloud, for example in case a third-party cartridge is using the cache system.<\/p>\n<p>To clear the caches:<\/p>\n<ol>\n<li>In the Salesforce Business Manager, go to\u00a0<strong>Administration<\/strong> &gt; <strong>Sites<\/strong> &gt; <strong>Manage Sites<\/strong>.<\/li>\n<li>Select the name of your site.<br \/>\nThis opens a new window with the settings for this site.<\/li>\n<li>Go to the <strong>Cache<\/strong> tab.<\/li>\n<li>In the <strong>Cache Invalidation<\/strong> section, select <strong>Invalidate<\/strong> next to all the listed caches.<\/li>\n<\/ol>\n<h2>Step 2: Disable third-party cartridges<\/h2>\n<p>The Adyen Payment cartridge is often used in combination with other cartridges that can impact your checkout flow or the backend processes.<\/p>\n<p>When using third-party cartridges, make sure that Adyen's cartridges are the first in the <a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/set-up-the-cartridge?plugin=Salesforce%20SFRA&amp;integration=cartridge#step-1-set-up-the-cartridge-path\"><strong>Cartridges<\/strong> box<\/a>.<\/p>\n<p>When troubleshooting our cartridge, make sure to temporarily disable any third-party cartridge.<\/p>\n<h2>Step 3: Check for customizations<\/h2>\n<p>If you applied any customizations to the cartridge, the error might be related to the customization. You can check whether the issue is related to your custom code based on the way you implemented the customizations:<\/p>\n<ul>\n<li>\n<p>If you implemented the customizations in a separate cartridge as recommended in our <a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/customization-guide\">customization guide<\/a>, you can temporarily remove this cartridge from your cartridge path to see if the error persists.<\/p>\n<\/li>\n<li>\n<p>If you have added custom code in one of the Adyen cartridges, check if it persists on a <a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/install-the-cartridge-and-import-the-metadata\">cleanly installed<\/a> cartridge. If you cannot reproduce the issue with a clean version, it is most likely a customization issue.<\/p>\n<\/li>\n<\/ul>\n<h2 id=\"logs\">Step 4: Check Salesforce Commerce Cloud logs<\/h2>\n<p>Errors are logged by Salesforce Commerce Cloud in your Salesforce Business Manager. To find the logs:<\/p>\n<ol>\n<li>Go to\u00a0<strong>Administration<\/strong> &gt; <strong>Site Development<\/strong> &gt; <strong>Development Setup<\/strong>.<\/li>\n<li>In the <strong>WebDAV Access<\/strong> section, select the folder icon next to <strong>Log Files<\/strong>.<br \/>\nThis opens a page with all the logs.<\/li>\n<\/ol>\n<p>If no errors are shown in the above logs, you can also check your console logs by inspecting the browser.<\/p>\n<h2>Step 5: Check common errors<\/h2>\n<p>Learn how to troubleshoot the following common errors:<\/p>\n<ul>\n<li><a href=\"#payment-methods\">Payment methods not showing up<\/a><\/li>\n<li><a href=\"#configuration\">Configuration errors<\/a><\/li>\n<li><a href=\"#placing-orders\">Errors when placing orders<\/a><\/li>\n<\/ul>\n<h3 id=\"payment-methods\">Payment methods not showing up<\/h3>\n<p>If a payment method is not showing up in your checkout, check the following:<\/p>\n<ul>\n<li>Does this payment method require any <a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/set-up-payment-methods\">additional set up<\/a>?<\/li>\n<li>Does the <code>\/paymentMethods<\/code> API request include the correct country\/region and currency combination for the payment method? Use the <code>service-adyen<\/code> <a href=\"#logs\">log files<\/a> to look this up.<\/li>\n<li>Is the payment method included in the <code>\/paymentMethods<\/code> API response? Use the <code>service-adyen<\/code> <a href=\"#logs\">log files<\/a> to look this up.<\/li>\n<\/ul>\n<h3 id=\"configuration\">Configuration errors<\/h3>\n<p>Configuration errors include issues with the services, for example:<\/p>\n<ul>\n<li>Origin key not retrieved<\/li>\n<li>Payments call not functioning<\/li>\n<\/ul>\n<p>If you experience such issues, it is likely that the metadata was not loaded correctly.<\/p>\n<p>We recommend that you:<\/p>\n<ol>\n<li><a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/install-the-cartridge-and-import-the-metadata#step-4-import-the-metadata\">Import the metadata again<\/a>.<\/li>\n<li>If using cartridge v20.1.2 or earlier, make sure that you <a href=\"\/pt\/development-resources\/live-endpoints\">set up live endpoints<\/a> in your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">live Customer Area<\/a>.<\/li>\n<\/ol>\n<h3 id=\"placing-orders\">Errors when placing orders<\/h3>\n<h4><em>No user found for OriginKey on validation<\/em><\/h4>\n<p>This error indicates that there is an issue with the cartridge configuration.<\/p>\n<ol>\n<li>Make sure that you have provided a correct <a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/set-up-the-cartridge\">merchant account name<\/a> in your Salesforce Business Manager.<\/li>\n<li>Reset your API key: <a href=\"\/pt\/development-resources\/api-credentials#generate-api-key\">generate a new API key<\/a> in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, and <a href=\"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/set-up-the-cartridge?plugin=Salesforce%20SFRA&amp;integration=cartridge#generate-keys\">copy it over to your Salesforce Business Manager<\/a>. Check that the API key has <a href=\"\/pt\/development-resources\/api-credentials#api-permissions\">access to the merchant account<\/a> used for your integration.<\/li>\n<\/ol>\n<h4><em>Expected intent from order api call to be authorize, got capture<\/em><\/h4>\n<p>This error is specific to PayPal, and indicates that the capture setting in your code does not match the capture setting on Adyen's side.<\/p>\n<p>To resolve the issue, change the capture setting in your code to <strong>SALE<\/strong>.<\/p>\n<h2>Step 6: Check our release notes<\/h2>\n<p>Check if your current error is a known issue in the cartridge, and resolved in a later version. You can find the known issues and fixes either in our <a href=\"https:\/\/github.com\/Adyen\/adyen-salesforce-commerce-cloud\/releases\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">technical release notes on GitHub<\/a>, or in our <a href=\"\/pt\/plugins\/release-notes\/?title%5B0%5D=Salesforce%2BCommerce%2BCloud%2B-%2BB2C%2BCommerce\">commercial release notes<\/a>.<\/p>\n<p>To find out which version of the cartridge you are using:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>Transactions<\/strong> &gt; <strong>Payments<\/strong>, and select the PSP reference of any payment.<br \/>\nThis opens the <strong>Payment Details<\/strong> page.<\/li>\n<li>Go to the <strong>Application Info<\/strong> section.<br \/>\nThe cartridge version is shown under <strong>Payment Device Version<\/strong>.<\/li>\n<\/ol>\n<h2>Step 7: Check open issues in GitHub<\/h2>\n<p>Go to the <a href=\"https:\/\/github.com\/Adyen\/adyen-salesforce-commerce-cloud\/issues\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">open issues in our GitHub<\/a>, and see if there is an open issue related to your error. If that is the case, you can leave a comment there to have direct contact with our dev teams.<\/p>\n<h2>Step 8: Contact us<\/h2>\n<p>If the problem still persists after you have followed the above steps, you can either:<\/p>\n<ul>\n<li><a href=\"https:\/\/github.com\/Adyen\/adyen-salesforce-commerce-cloud\/issues\/new\/choose\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Create a GitHub issue<\/a> if you found a bug.<\/li>\n<li>Contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>, providing your cartridge version and other relevant information, for example screenshots or logs.<\/li>\n<\/ul>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"https:\/\/help.adyen.com\/knowledge\/plugins\/salesforce\"\n                        target=\"_blank\"\n                         class=\"external\">\n                    Adyen Salesforce Commerce Cloud cartridge FAQ\n                <\/a><\/li><li><a href=\"https:\/\/github.com\/Adyen\/adyen-salesforce-commerce-cloud\"\n                        target=\"_blank\"\n                         class=\"external\">\n                    Adyen Salesforce Commerce Cloud cartridge on GitHub\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/troubleshooting","articleFields":{"description":"Troubleshoot your Salesforce Commerce Cloud integration.","parameters":{"plugin_name":"Salesforce Commerce Cloud","plugin_bo":"Salesforce Business Manager","plugin_type":"cartridge","plugin_job":"scheduled job","plugin_url":"salesforce-commerce-cloud"},"last_edit_on":"28-10-2020 14:30","feedback_component":true},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/troubleshooting","title":"Salesforce Commerce Cloud troubleshooting","content":"If you are experiencing a problem with your Salesforce Commerce Cloud integration, there are several ways how you can troubleshoot the issue yourself. Before you contact our Support Team:\n\nMake sure that you set up the cartridge correctly.\nCheck our FAQ.\nFollow the steps below.\n\nStep 1:  Clear the cache\nThe Adyen Payment cartridge does not make use of the Salesforce Commerce Cloud cache system.\nWhen troubleshooting, we still recommend that you clear the caches in Salesforce Commerce Cloud, for example in case a third-party cartridge is using the cache system.\nTo clear the caches:\n\nIn the Salesforce Business Manager, go to\u00a0Administration &gt; Sites &gt; Manage Sites.\nSelect the name of your site.\nThis opens a new window with the settings for this site.\nGo to the Cache tab.\nIn the Cache Invalidation section, select Invalidate next to all the listed caches.\n\nStep 2: Disable third-party cartridges\nThe Adyen Payment cartridge is often used in combination with other cartridges that can impact your checkout flow or the backend processes.\nWhen using third-party cartridges, make sure that Adyen's cartridges are the first in the Cartridges box.\nWhen troubleshooting our cartridge, make sure to temporarily disable any third-party cartridge.\nStep 3: Check for customizations\nIf you applied any customizations to the cartridge, the error might be related to the customization. You can check whether the issue is related to your custom code based on the way you implemented the customizations:\n\n\nIf you implemented the customizations in a separate cartridge as recommended in our customization guide, you can temporarily remove this cartridge from your cartridge path to see if the error persists.\n\n\nIf you have added custom code in one of the Adyen cartridges, check if it persists on a cleanly installed cartridge. If you cannot reproduce the issue with a clean version, it is most likely a customization issue.\n\n\nStep 4: Check Salesforce Commerce Cloud logs\nErrors are logged by Salesforce Commerce Cloud in your Salesforce Business Manager. To find the logs:\n\nGo to\u00a0Administration &gt; Site Development &gt; Development Setup.\nIn the WebDAV Access section, select the folder icon next to Log Files.\nThis opens a page with all the logs.\n\nIf no errors are shown in the above logs, you can also check your console logs by inspecting the browser.\nStep 5: Check common errors\nLearn how to troubleshoot the following common errors:\n\nPayment methods not showing up\nConfiguration errors\nErrors when placing orders\n\nPayment methods not showing up\nIf a payment method is not showing up in your checkout, check the following:\n\nDoes this payment method require any additional set up?\nDoes the \/paymentMethods API request include the correct country\/region and currency combination for the payment method? Use the service-adyen log files to look this up.\nIs the payment method included in the \/paymentMethods API response? Use the service-adyen log files to look this up.\n\nConfiguration errors\nConfiguration errors include issues with the services, for example:\n\nOrigin key not retrieved\nPayments call not functioning\n\nIf you experience such issues, it is likely that the metadata was not loaded correctly.\nWe recommend that you:\n\nImport the metadata again.\nIf using cartridge v20.1.2 or earlier, make sure that you set up live endpoints in your live Customer Area.\n\nErrors when placing orders\nNo user found for OriginKey on validation\nThis error indicates that there is an issue with the cartridge configuration.\n\nMake sure that you have provided a correct merchant account name in your Salesforce Business Manager.\nReset your API key: generate a new API key in your Customer Area, and copy it over to your Salesforce Business Manager. Check that the API key has access to the merchant account used for your integration.\n\nExpected intent from order api call to be authorize, got capture\nThis error is specific to PayPal, and indicates that the capture setting in your code does not match the capture setting on Adyen's side.\nTo resolve the issue, change the capture setting in your code to SALE.\nStep 6: Check our release notes\nCheck if your current error is a known issue in the cartridge, and resolved in a later version. You can find the known issues and fixes either in our technical release notes on GitHub, or in our commercial release notes.\nTo find out which version of the cartridge you are using:\n\nLog in to your Customer Area.\nGo to Transactions &gt; Payments, and select the PSP reference of any payment.\nThis opens the Payment Details page.\nGo to the Application Info section.\nThe cartridge version is shown under Payment Device Version.\n\nStep 7: Check open issues in GitHub\nGo to the open issues in our GitHub, and see if there is an open issue related to your error. If that is the case, you can leave a comment there to have direct contact with our dev teams.\nStep 8: Contact us\nIf the problem still persists after you have followed the above steps, you can either:\n\nCreate a GitHub issue if you found a bug.\nContact our Support Team, providing your cartridge version and other relevant information, for example screenshots or logs.\n\nSee also\n\n\n                    Adyen Salesforce Commerce Cloud cartridge FAQ\n                \n                    Adyen Salesforce Commerce Cloud cartridge on GitHub\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Salesforce Commerce Cloud - B2C Commerce","lvl3":"Storefront Reference Architecture (SFRA)","lvl4":"Salesforce Commerce Cloud troubleshooting"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-commerce-cloud","lvl3":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-commerce-cloud\/sfra","lvl4":"\/pt\/plugins\/salesforce-commerce-cloud\/sfra\/troubleshooting"},"levels":5,"category":"Plugins","category_color":"green","tags":["Salesforce","Commerce","Cloud","troubleshooting"]}}
