{"title":"Upgrade to Adyen Payments for Salesforce OMS v3","category":"default","creationDate":1674038040,"content":"<p>This page explains the steps to upgrade your <a href=\"\/pt\/plugins\/salesforce-order-management-system\">Adyen Salesforce Order Management System (OMS) package<\/a> from earlier versions to v3 of the package. See our <a href=\"\/pt\/plugins\/release-notes\">release notes<\/a> to learn what has changed in later versions.<\/p>\n\n<div id=\"tabcSNqp\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Migrate from v2&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To migrate from v2 of the package to v3, follow the steps below.&lt;\\\/p&gt;\\n&lt;h2 id=\\&quot;update-your-payment-gateway-configuration\\&quot;&gt;1. Update your Payment Gateway configuration&lt;\\\/h2&gt;\\n&lt;p&gt;The package now includes a Payment Gateway Provider Record, and you no longer need to &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package\\\/?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=2.1.2#create-payment-gateway-provider\\&quot;&gt;create your own&lt;\\\/a&gt;. To use the new record with your integration:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In your Salesforce OMS Org, go to &lt;strong&gt;App Launcher&lt;\\\/strong&gt;, enter &lt;strong&gt;Payment Gateways&lt;\\\/strong&gt; in the search field, and select it.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;On the &lt;strong&gt;Payment Gateways&lt;\\\/strong&gt; page, select &lt;strong&gt;Adyen&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Update the following fields in the Payment Gateway record:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Field&lt;\\\/th&gt;\\n&lt;th&gt;Value&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Payment Gateway Provider&lt;\\\/td&gt;\\n&lt;td&gt;Select &lt;strong&gt;Adyen OMS Provider&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Merchant Credential&lt;\\\/td&gt;\\n&lt;td&gt;Select &lt;strong&gt;AdyenCheckout&lt;\\\/strong&gt;.     &lt;div class=\\&quot;sc-notice note\\&quot;&gt;&lt;div&gt; If you cannot select &lt;strong&gt;AdyenCheckout&lt;\\\/strong&gt;, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Named Credentials&lt;\\\/strong&gt;, and select &lt;strong&gt;Adyen Checkout&lt;\\\/strong&gt;. Then, go back to the &lt;strong&gt;Adyen&lt;\\\/strong&gt; Payment Gateway record, select &lt;strong&gt;Refresh&lt;\\\/strong&gt;, and try again. &lt;\\\/div&gt;&lt;\\\/div&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select the &lt;strong&gt;Adyen OMS Provider&lt;\\\/strong&gt; hyperlink.&lt;br \\\/&gt;\\nThis opens the Payment Gateway Provider page.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the &lt;strong&gt;Site URL&lt;\\\/strong&gt;, find the ID, starting with &lt;strong&gt;0cJ&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Save this ID in your system, you will need it when you &lt;a href=\\&quot;#update-your-webhook-configuration\\&quot;&gt;update your webhook configuration&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h2 id=\\&quot;update-your-webhook-configuration\\&quot;&gt;2. Update your webhook configuration&lt;\\\/h2&gt;\\n&lt;p&gt;In v3:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;It is mandatory to &lt;a href=\\&quot;\\\/pt\\\/development-resources\\\/webhooks\\\/secure-webhooks\\\/verify-hmac-signatures\\\/\\&quot;&gt;verify HMAC signatures&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;The following webhooks are enabled:\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;REFUND_FAILED&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;CAPTURE_FAILED&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To make sure your integration can handle the changes introduced in this version:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#update-your-webhook-configuration-in-the-adyen-customer-area\\&quot;&gt;Update your webhook configuration in the Adyen Customer Area&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#add-your-hmac-key-in-salesforce\\&quot;&gt;Add your HMAC key in Salesforce&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;After you have completed the steps, &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package\\\/?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=3.0.0#test-webhook\\&quot;&gt;test your new webhook configuration&lt;\\\/a&gt; to make sure it works correctly.&lt;\\\/p&gt;\\n&lt;h3&gt;Update your webhook configuration in the Adyen Customer Area&lt;\\\/h3&gt;\\n&lt;p&gt;Update your &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package\\\/?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=2.1.2#configure-webhook\\&quot;&gt;existing webhook configuration&lt;\\\/a&gt; to add your new webhook endpoint URL and enable new events:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;, go to &lt;strong&gt;Developers&lt;\\\/strong&gt;\\u00a0&amp;gt;\\u00a0 &lt;strong&gt;Webhooks&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select the webhook that you have configured for the package.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select the pencil icon &lt;i class=\\&quot;adl-icon-edit\\&quot;&gt;&lt;\\\/i&gt; to edit this webhook.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Server Configuration&lt;\\\/strong&gt;, update the &lt;strong&gt;URL&lt;\\\/strong&gt; with your &lt;a href=\\&quot;#update-your-payment-gateway-configuration\\&quot;&gt;Payment Gateway ID that you saved when you updated your Payment Gateway configuration&lt;\\\/a&gt;. Use the following format:&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Webhook endpoint URL format&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;text\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;YOUR_SALESFORCE_SITE_URL\\\\\\\/services\\\\\\\/data\\\\\\\/v60.0\\\\\\\/commerce\\\\\\\/payments\\\\\\\/notify?provider=YOUR_PAYMENT_GATEWAY_PROVIDER_ID\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;p&gt;For example:&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Example Webhook endpoint URL&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;text\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;https:\\\\\\\/\\\\\\\/dev-clientname.cs17.force.com\\\\\\\/adyen\\\\\\\/services\\\\\\\/data\\\\\\\/v60.0\\\\\\\/commerce\\\\\\\/payments\\\\\\\/notify?provider=0cJ4W000000XWnuUAG\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Security&lt;\\\/strong&gt;, &lt;a href=\\&quot;\\\/pt\\\/development-resources\\\/webhooks\\\/secure-webhooks\\\/verify-hmac-signatures#enable-hmac-signatures\\&quot;&gt;generate a HMAC Key&lt;\\\/a&gt;, copy it, and store it securely in your system.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Events&lt;\\\/strong&gt;, select &lt;strong&gt;CAPTURE_FAILED&lt;\\\/strong&gt;, and &lt;strong&gt;REFUND_FAILED&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save configuration&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3&gt;Add your HMAC key in Salesforce&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce B2B Org, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Custom Code&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Custom Metadata Types&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Add your HMAC key to the Adyen Adapter Layout:\\n&lt;ol&gt;\\n&lt;li&gt;Scroll down to &lt;strong&gt;Adyen Adapter Layout&lt;\\\/strong&gt;, and select &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Drag the &lt;strong&gt;HMAC Key&lt;\\\/strong&gt; field, and drop it into the layout.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Manage Adyen Adapter&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Next to &lt;strong&gt;Adyen Default&lt;\\\/strong&gt;, select &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Set the &lt;strong&gt;HMAC Key&lt;\\\/strong&gt; field to the HMAC key you generated in the Adyen Customer Area.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h2&gt;3. Verify your sales channel setup&lt;\\\/h2&gt;\\n&lt;p&gt;In v3, we changed how the Adyen merchant account field is populated for Salesforce sales channels. Choose one of the following options:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Use the merchant account that you &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=3.0.0#configure-adyen-custom-metadata\\&quot;&gt;configured in the &lt;strong&gt;Adyen Default&lt;\\\/strong&gt; custom metadata record&lt;\\\/a&gt;.&lt;br \\\/&gt;\\nFor this option, leave the merchant account field empty in the sales channel object:\\n&lt;ol&gt;\\n&lt;li&gt;In your OMS Org, go to the App Launcher, and search for &lt;strong&gt;Sales Channels&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select a sales channel.&lt;\\\/li&gt;\\n&lt;li&gt;Leave the &lt;strong&gt;Adyen Merchant Account&lt;\\\/strong&gt; field empty.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Link a specific merchant account to one of your sales channels.&lt;br \\\/&gt;\\nFor this option, follow the steps to  &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=3.0.0#configure-sales-channel\\&quot;&gt;configure sales channels&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;We recommend to update the help text that appears for the merchant account field in the Sales Channel object:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In your Salesforce OMS Org, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Object Manager&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Sales Channel&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Fields &amp;amp; Relationships&lt;\\\/strong&gt;, and then select &lt;strong&gt;Adyen Merchant Account&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Edit&lt;\\\/strong&gt; to replace the help text that appears for this field. For example:&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;text\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;The Adyen merchant account name used for this Sales Channel. When you leave this field empty, the merchant account configured for the Adyen Default custom metadata record will be used.\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h2&gt;4. Update your Named Credential setup&lt;\\\/h2&gt;\\n&lt;p&gt;The package includes the Named Credential by default, and uses API keys for authentication instead of &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=2.1.2#configure-named-credential\\&quot;&gt;basic authentication&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;To enable the new Named Credential in your integration, follow the steps to &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=3.0.0#configure-named-credential\\&quot;&gt;set up a Principal Credential&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;migrate_from_v2_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Migrate from v1&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;If you are migrating from v1 to a later version of the package, we strongly recommend to migrate directly to &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/release-notes\\\/?title%5B0%5D=Salesforce%20Order%20Management%20System\\&quot;&gt;v3.2.0&lt;\\\/a&gt;. This version introduces changes and features that enable a better shopper and integration experience, such as better refund tracking, and Pay by Link payments.&lt;\\\/p&gt;\\n&lt;p&gt;To migrate form v1 to v3.2.0, follow the steps below.&lt;\\\/p&gt;\\n&lt;h2&gt;1. Install the new version of the app&lt;\\\/h2&gt;\\n&lt;p&gt;V3.2.0 of the package has a &lt;a href=\\&quot;https:\\\/\\\/developer.salesforce.com\\\/docs\\\/atlas.en-us.sfdx_dev.meta\\\/sfdx_dev\\\/sfdx_dev_unlocked_pkg_plan_namespaces.htm\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt; separate namespace&lt;\\\/a&gt;. Therefore, you can install it with your existing integration.&lt;\\\/p&gt;\\n&lt;p&gt;Install the &lt;a href=\\&quot;https:\\\/\\\/appexchange.salesforce.com\\\/appxListingDetail?listingId=a0N3u00000ON7RtEAL&amp;amp;tab=d\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Adyen Payments for Salesforce Order Management (SOM)&lt;\\\/a&gt; with the installation key &lt;strong&gt;Payments@Adyen&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;h2&gt;2. Set up the new version of the package&lt;\\\/h2&gt;\\n&lt;p&gt;Follow the steps to &lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=3.2.0#how-it-works\\&quot;&gt;set up the package&lt;\\\/a&gt; for v3.2.0. You do &lt;strong&gt;not&lt;\\\/strong&gt; have to:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;\\n&lt;p&gt;&lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=3.2.0#set-up-payment-gateway\\&quot;&gt;Create a new Payment Gateway record&lt;\\\/a&gt;. Instead, you can use your existing record and update it. To make your existing record compatible with the latest version:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce Org, navigate to the existing Payment Gateway record you created for Adyen.&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Switch the following fields to the new values:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Field&lt;\\\/th&gt;\\n&lt;th&gt;Value&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Payment Gateway Provider&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Adyen OMS Provider&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Merchant Credential&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;AdyenCheckout&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;&lt;a href=\\&quot;\\\/pt\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;amp;integration=package&amp;amp;version=3.2.0#expose-salesforce-site-endpoint\\&quot;&gt;Create a new Salesforce site endpoint&lt;\\\/a&gt;. Instead, you can use your existing site endpoint and update the access settings. To make your existing site endpoint compatible the latest version:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce OMS Org, navigate to the existing site you created for Adyen.&lt;\\\/li&gt;\\n&lt;li&gt;Make sure that the site has &lt;strong&gt;Guest Access to the Payments API&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Public Access Settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Custom Metadata Type Access&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Make sure that the &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt; metadata type is in the &lt;strong&gt;Enabled&lt;\\\/strong&gt; column.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;h2&gt;3. Run the migration script&lt;\\\/h2&gt;\\n&lt;p&gt;To copy payment method data to the new custom fields included in the new version, run the &lt;a href=\\&quot;https:\\\/\\\/github.com\\\/Adyen\\\/adyen-salesforce-oms\\\/blob\\\/develop\\\/scripts\\\/BatchAdyenOMSMigration.cls\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;\\n  &lt;code&gt;BatchAdyenOMSMigration.cls&lt;\\\/code&gt;\\n&lt;\\\/a&gt; migration script. This script copies your package&#039;s custom attribute values from your existing OMS version to the new version.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Add the script to your Salesforce Org by either:\\n&lt;ul&gt;\\n&lt;li&gt;Creating a new Apex class in your Salesforce Developer Console, and paste the script.&lt;\\\/li&gt;\\n&lt;li&gt;Deploying the Apex class in your Salesforce Org using the Salesforce CLI.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;In your &lt;strong&gt;Developer Console&lt;\\\/strong&gt;, go to &lt;strong&gt;Debug&lt;\\\/strong&gt;&amp;gt; &lt;strong&gt;Open Execute Anonymous Window&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Enter the following code in the &lt;strong&gt;Enter Apex Code&lt;\\\/strong&gt; window and execute:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-java\\&quot;&gt;Id batchprocessid = Database.executeBatch(new BatchAdyenOMSMigration());&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;You receive an email when the batch process is completed.&lt;\\\/p&gt;\\n&lt;h2&gt;4. Uninstall the older version&lt;\\\/h2&gt;\\n&lt;p&gt;After you have completed the steps to upgrade, test your integration to make sure everything works as expected. Then, &lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=000392277&amp;amp;language=en_US&amp;amp;type=1\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;uninstall the package for the older version from your Salesforce Org.&lt;\\\/a&gt;&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;If you experience issues while uninstalling the package, remove the migration script from your  Salesforce Org, and try again.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;migrate_from_v1_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>Go live<\/h2>\n<p>After you have completed your upgrade, follow the <a href=\"\/pt\/plugins\/salesforce-order-management-system\/install-and-set-up-the-package?plugin=Salesforce%20OMS&amp;integration=package&amp;version=latest#go-live\">steps to go live<\/a> with the version you migrated to.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-order-management-system\/upgrade","articleFields":{"description":"Learn how to upgrade your Adyen Salesforce OMS package from v2 to v3.","feedback_component":true,"last_edit_on":"20-08-2024 13:11","filters_component":false,"page_id":"5bb3e62b-731d-4525-a3ad-3504ccc486e7","decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-order-management-system\/upgrade","title":"Upgrade to Adyen Payments for Salesforce OMS v3","content":"This page explains the steps to upgrade your Adyen Salesforce Order Management System (OMS) package from earlier versions to v3 of the package. See our release notes to learn what has changed in later versions.\n\n\n    \n        \n        \n    \n\n\nGo live\nAfter you have completed your upgrade, follow the steps to go live with the version you migrated to.","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Salesforce Order Management System","lvl3":"Upgrade to Adyen Payments for Salesforce OMS v3"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-order-management-system","lvl3":"\/pt\/plugins\/salesforce-order-management-system\/upgrade"},"levels":4,"category":"Plugins","category_color":"green","tags":["Upgrade","Adyen","Payments","Salesforce"]}}