{"title":"Install and set up the Salesforce OMS package","category":"default","creationDate":1618553400,"content":"<p>This page explains how to integrate with our OMS package to manage orders for your Salesforce Commerce Cloud store that uses the Adyen payments cartridge.<\/p>\n<div data-component-wrapper=\"in-page-filtering\">\n    <in-page-filtering\n        id=\"salesforce-order-management\"\n        :in-page-filtering=\"{&quot;guides&quot;:{&quot;sfra&quot;:{&quot;label&quot;:&quot;Salesforce OMS&quot;,&quot;integrations&quot;:{&quot;package&quot;:{&quot;label&quot;:&quot;package&quot;,&quot;description&quot;:&quot;Set up the Adyen Salesforce OMS package&quot;,&quot;displayVersionDropdown&quot;:true,&quot;visual_content&quot;:null,&quot;visual_images&quot;:null,&quot;external_content&quot;:null,&quot;external_icon&quot;:null,&quot;versions&quot;:{&quot;version-3.4.0&quot;:{&quot;sections&quot;:{&quot;before_you_begin&quot;:{&quot;$ref&quot;:&quot;33ff628eddc401060a8605fb907a336c&quot;},&quot;how_it_works&quot;:{&quot;$ref&quot;:&quot;3b733799f792d9a0ae5e7027723bfa40&quot;},&quot;install_the_app&quot;:{&quot;$ref&quot;:&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;},&quot;guided_configuration&quot;:{&quot;$ref&quot;:&quot;4b449421a5bd0cca78b59e3f94e512db&quot;},&quot;configure_sfcc&quot;:{&quot;$ref&quot;:&quot;a230d263af97d6ba6b787c71aa7f75ea&quot;},&quot;go_live&quot;:{&quot;$ref&quot;:&quot;e406122e0e9ddd9d658025b08ac9097a&quot;},&quot;next_steps&quot;:{&quot;$ref&quot;:&quot;6b466d437f4e97cf264243ad31b8c80a&quot;}},&quot;config&quot;:{&quot;published&quot;:null,&quot;visible&quot;:null,&quot;api_version&quot;:null},&quot;versions&quot;:{&quot;version&quot;:&quot;3.4.0&quot;}},&quot;version-3.3.0&quot;:{&quot;sections&quot;:{&quot;before_you_begin&quot;:{&quot;$ref&quot;:&quot;33ff628eddc401060a8605fb907a336c&quot;},&quot;how_it_works&quot;:{&quot;$ref&quot;:&quot;3b733799f792d9a0ae5e7027723bfa40&quot;},&quot;install_the_app&quot;:{&quot;$ref&quot;:&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;},&quot;guided_configuration&quot;:{&quot;$ref&quot;:&quot;4b449421a5bd0cca78b59e3f94e512db&quot;},&quot;configure_sfcc&quot;:{&quot;$ref&quot;:&quot;a230d263af97d6ba6b787c71aa7f75ea&quot;},&quot;go_live&quot;:{&quot;$ref&quot;:&quot;e406122e0e9ddd9d658025b08ac9097a&quot;},&quot;next_steps&quot;:{&quot;$ref&quot;:&quot;6b466d437f4e97cf264243ad31b8c80a&quot;}},&quot;versions&quot;:{&quot;version&quot;:&quot;3.3.0&quot;},&quot;config&quot;:{&quot;published&quot;:null,&quot;visible&quot;:null,&quot;api_version&quot;:null}},&quot;version-3.2.0&quot;:{&quot;sections&quot;:{&quot;before_you_begin&quot;:{&quot;$ref&quot;:&quot;33ff628eddc401060a8605fb907a336c&quot;},&quot;how_it_works&quot;:{&quot;$ref&quot;:&quot;145821d4f56bb005c81bf16877e0021a&quot;},&quot;install_the_app&quot;:{&quot;$ref&quot;:&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;},&quot;set_up_the_payment_gateway&quot;:{&quot;$ref&quot;:&quot;18287ae355baf0f61f532416644eb355&quot;},&quot;set_up_webhooks&quot;:{&quot;$ref&quot;:&quot;7a247bf370f24b055fe5e40046b694ae&quot;},&quot;configure_package_components&quot;:{&quot;$ref&quot;:&quot;bd74009d635f3b8386856411f52c7396&quot;},&quot;set_up_alternative_payment_methods&quot;:{&quot;$ref&quot;:&quot;b7bf96d8adc59770f7afed88e43fa81f&quot;},&quot;configure_sfcc&quot;:{&quot;$ref&quot;:&quot;a230d263af97d6ba6b787c71aa7f75ea&quot;},&quot;go_live&quot;:{&quot;$ref&quot;:&quot;e406122e0e9ddd9d658025b08ac9097a&quot;},&quot;next_steps&quot;:{&quot;$ref&quot;:&quot;6b466d437f4e97cf264243ad31b8c80a&quot;}},&quot;versions&quot;:{&quot;version&quot;:&quot;3.2.0&quot;},&quot;config&quot;:{&quot;published&quot;:null,&quot;visible&quot;:null,&quot;api_version&quot;:null}},&quot;version-3.1.0&quot;:{&quot;sections&quot;:{&quot;before_you_begin&quot;:{&quot;$ref&quot;:&quot;01dd973dc4c1b39d92e42a1f1b9792cb&quot;},&quot;how_it_works&quot;:{&quot;$ref&quot;:&quot;145821d4f56bb005c81bf16877e0021a&quot;},&quot;install_the_app&quot;:{&quot;$ref&quot;:&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;},&quot;set_up_the_payment_gateway&quot;:{&quot;$ref&quot;:&quot;18287ae355baf0f61f532416644eb355&quot;},&quot;set_up_webhooks&quot;:{&quot;$ref&quot;:&quot;77a7dfcb073a79c07de4b4c24d7f70f7&quot;},&quot;configure_package_components&quot;:{&quot;$ref&quot;:&quot;bd74009d635f3b8386856411f52c7396&quot;},&quot;set_up_alternative_payment_methods&quot;:{&quot;$ref&quot;:&quot;b7bf96d8adc59770f7afed88e43fa81f&quot;},&quot;configure_sfcc&quot;:{&quot;$ref&quot;:&quot;686d1d5acfa3c1d05c4d6373a8ecf901&quot;},&quot;go_live&quot;:{&quot;$ref&quot;:&quot;e406122e0e9ddd9d658025b08ac9097a&quot;},&quot;next_steps&quot;:{&quot;$ref&quot;:&quot;6b466d437f4e97cf264243ad31b8c80a&quot;}},&quot;config&quot;:{&quot;published&quot;:null,&quot;visible&quot;:null,&quot;api_version&quot;:null},&quot;versions&quot;:{&quot;version&quot;:&quot;3.1.0&quot;}},&quot;version-3.0.0&quot;:{&quot;sections&quot;:{&quot;before_you_begin&quot;:{&quot;$ref&quot;:&quot;01dd973dc4c1b39d92e42a1f1b9792cb&quot;},&quot;how_it_works&quot;:{&quot;$ref&quot;:&quot;145821d4f56bb005c81bf16877e0021a&quot;},&quot;install_the_app&quot;:{&quot;$ref&quot;:&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;},&quot;set_up_the_payment_gateway&quot;:{&quot;$ref&quot;:&quot;18287ae355baf0f61f532416644eb355&quot;},&quot;set_up_webhooks&quot;:{&quot;$ref&quot;:&quot;77a7dfcb073a79c07de4b4c24d7f70f7&quot;},&quot;configure_package_components&quot;:{&quot;$ref&quot;:&quot;bd74009d635f3b8386856411f52c7396&quot;},&quot;set_up_alternative_payment_methods&quot;:{&quot;$ref&quot;:&quot;b7bf96d8adc59770f7afed88e43fa81f&quot;},&quot;configure_sfcc&quot;:{&quot;$ref&quot;:&quot;686d1d5acfa3c1d05c4d6373a8ecf901&quot;},&quot;go_live&quot;:{&quot;$ref&quot;:&quot;e406122e0e9ddd9d658025b08ac9097a&quot;},&quot;next_steps&quot;:{&quot;$ref&quot;:&quot;6b466d437f4e97cf264243ad31b8c80a&quot;}},&quot;versions&quot;:{&quot;version&quot;:&quot;3.0.0&quot;},&quot;config&quot;:{&quot;published&quot;:null,&quot;visible&quot;:null,&quot;api_version&quot;:null}},&quot;version-2.1.2&quot;:{&quot;sections&quot;:{&quot;before_you_begin&quot;:{&quot;$ref&quot;:&quot;01dd973dc4c1b39d92e42a1f1b9792cb&quot;},&quot;how_it_works&quot;:{&quot;$ref&quot;:&quot;145821d4f56bb005c81bf16877e0021a&quot;},&quot;install_the_app&quot;:{&quot;$ref&quot;:&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;},&quot;configure_package_components&quot;:{&quot;$ref&quot;:&quot;b48ec765f3691470163c51b5db1fd40c&quot;},&quot;set_up_the_payment_gateway&quot;:{&quot;$ref&quot;:&quot;9ec8a55ecb491d4ed9e381330e1bff63&quot;},&quot;set_up_webhooks&quot;:{&quot;$ref&quot;:&quot;085bc32bb48508fc48351f8ded4a56fb&quot;},&quot;set_up_alternative_payment_methods&quot;:{&quot;$ref&quot;:&quot;71b6cbb50705a9c7b2e4f0e1c9c0ad1c&quot;},&quot;configure_sfcc&quot;:{&quot;$ref&quot;:&quot;686d1d5acfa3c1d05c4d6373a8ecf901&quot;},&quot;go_live&quot;:{&quot;$ref&quot;:&quot;7e2d6d71b7c078e1ec0c8668ffe0258c&quot;},&quot;next_steps&quot;:{&quot;$ref&quot;:&quot;e3d09aaf20c0e5a8ebe05acee91f70c5&quot;}},&quot;config&quot;:{&quot;published&quot;:true,&quot;visible&quot;:true,&quot;api_version&quot;:68},&quot;versions&quot;:{&quot;version&quot;:&quot;2.1.2&quot;}},&quot;version-2.1.0&quot;:{&quot;sections&quot;:{&quot;before_you_begin&quot;:{&quot;$ref&quot;:&quot;01dd973dc4c1b39d92e42a1f1b9792cb&quot;},&quot;how_it_works&quot;:{&quot;$ref&quot;:&quot;145821d4f56bb005c81bf16877e0021a&quot;},&quot;install_the_app&quot;:{&quot;$ref&quot;:&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;},&quot;configure_package_components&quot;:{&quot;$ref&quot;:&quot;b48ec765f3691470163c51b5db1fd40c&quot;},&quot;set_up_the_payment_gateway&quot;:{&quot;$ref&quot;:&quot;9ec8a55ecb491d4ed9e381330e1bff63&quot;},&quot;set_up_webhooks&quot;:{&quot;$ref&quot;:&quot;085bc32bb48508fc48351f8ded4a56fb&quot;},&quot;set_up_alternative_payment_methods&quot;:{&quot;$ref&quot;:&quot;71b6cbb50705a9c7b2e4f0e1c9c0ad1c&quot;},&quot;configure_sfcc&quot;:{&quot;$ref&quot;:&quot;686d1d5acfa3c1d05c4d6373a8ecf901&quot;},&quot;go_live&quot;:{&quot;$ref&quot;:&quot;7e2d6d71b7c078e1ec0c8668ffe0258c&quot;},&quot;next_steps&quot;:{&quot;$ref&quot;:&quot;e3d09aaf20c0e5a8ebe05acee91f70c5&quot;}},&quot;versions&quot;:{&quot;version&quot;:&quot;2.1.0&quot;},&quot;config&quot;:{&quot;published&quot;:true,&quot;visible&quot;:true,&quot;api_version&quot;:68}}},&quot;sections&quot;:[],&quot;components&quot;:{&quot;01dd973dc4c1b39d92e42a1f1b9792cb&quot;:&quot;&lt;h2 id=\\&quot;requirements\\&quot;&gt;Requirements&lt;\\\/h2&gt;\\n&lt;p&gt;Before you begin, take into account the following requirements, limitations, and preparations.&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Requirement&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Integration type&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Make sure that you have a Salesforce Commerce Cloud (SFCC) storefront that uses the &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\&quot;&gt;Adyen payments cartridge&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;&lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\&quot;&gt;Webhooks&lt;\\\/a&gt;&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Subscribe to the Standard webhooks.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Limitations&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;You must only initiate captures and refunds from Salesforce OMS. Initiating modifications from the Adyen Customer Area will lead to inconsistent order processing. For example, if a capture is initiated in the Customer Area, you can not process refunds for it in OMS.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Setup steps&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Before you begin: &lt;ul&gt;&lt;li&gt;Create a Salesforce OMS Org. &lt;\\\/li&gt;&lt;li&gt; Connect your SFCC storefront and OMS Org. Refer to &lt;a href=\\&quot;https:\\\/\\\/resources.docs.salesforce.com\\\/latest\\\/latest\\\/en-us\\\/sfdc\\\/pdf\\\/sfom_impl_b2ce.pdf\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;the documentation from Salesforce&lt;\\\/a&gt; to read more about connecting B2C Commerce and Order Management.&lt;\\\/li&gt;&lt;li&gt; &lt;a href=\\&quot;\\\/online-payments\\\/capture\\\/#enable-manual-capture\\&quot;&gt;Enable manual capture&lt;\\\/a&gt; in your Customer Area. &lt;div class=\\&quot;sc-notice note\\&quot;&gt;&lt;div&gt; The OMS flow relies on manual captures, &lt;a href=\\&quot;\\\/online-payments\\\/capture\\&quot;&gt;automatic&lt;\\\/a&gt;, or &lt;a href=\\&quot;\\\/online-payments\\\/capture\\\/#delayed-automatic-capture\\&quot;&gt;delayed automatic&lt;\\\/a&gt; captures disrupt the order management flow. &lt;\\\/div&gt;&lt;\\\/div&gt;&lt;\\\/li&gt;&lt;li&gt; Install the base dependent &lt;a href=\\&quot;https:\\\/\\\/appexchange.salesforce.com\\\/appxListingDetail?listingId=a0N3u00000PraxuEAB\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;&lt;code&gt;API Library Apex Adyen&lt;\\\/code&gt; package&lt;\\\/a&gt;  with the installation key &lt;strong&gt;Payments@Adyen&lt;\\\/strong&gt;.&lt;\\\/li&gt;&lt;\\\/ul&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;&quot;,&quot;145821d4f56bb005c81bf16877e0021a&quot;:&quot;&lt;h2 id=\\&quot;how-it-works\\&quot;&gt;How it works&lt;\\\/h2&gt;\\n&lt;p&gt;With our Salesforce OMS package, you handle captures and refunds for the payments of your &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\&quot;&gt;Salesforce Commerce Cloud storefront&lt;\\\/a&gt;. The package keeps the Adyen and Salesforce systems in sync, so that you can seamlessly manage your order and payment flows.&lt;\\\/p&gt;\\n&lt;p&gt;To set up the package:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#install-the-app\\&quot;&gt;Install the package&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#set-up-payment-gateway\\&quot;&gt;Configure package components&lt;\\\/a&gt; in your OMS Org.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-package-components\\&quot;&gt;Set up the payment gateway&lt;\\\/a&gt; in your OMS Org.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#set-up-webhooks\\&quot;&gt;Set up webhooks&lt;\\\/a&gt; in your OMS Org and the Adyen Customer Area.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#set-up-alternative-payment-methods\\&quot;&gt;Set up alternative payment methods&lt;\\\/a&gt; in your OMS Org.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-capture-settings\\&quot;&gt;Configure capture settings&lt;\\\/a&gt; in your SFCC Business Manager.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;cb7bf08d5d9e72cc749472286ed51fc6&quot;:&quot;&lt;h2 id=\\&quot;install-the-app\\&quot;&gt;Install the app&lt;\\\/h2&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce OMS Org, &lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.comm_currency_considerations.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;enable multiple currencies&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&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) app&lt;\\\/a&gt; with the installation key &lt;strong&gt;Payments@Adyen&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Follow the instructions on the &lt;a href=\\&quot;https:\\\/\\\/developer.salesforce.com\\\/docs\\\/atlas.en-us.appExchangeInstallGuide.meta\\\/appExchangeInstallGuide\\\/appexchange_install_installation.htm\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Salesforce Application Installation Guide&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;b48ec765f3691470163c51b5db1fd40c&quot;:&quot;&lt;h2&gt;Configure package components&lt;\\\/h2&gt;\\n&lt;p&gt;In your Salesforce OMS Org, configure package components:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#add-adyen-fields-to-layout\\&quot;&gt;Add new Adyen fields to the layout&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-named-credential\\&quot;&gt;Configure Named Credentials&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;Configure Adyen custom metadata type&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-sales-channel\\&quot;&gt;Configure sales channels&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;add-adyen-fields-to-layout\\&quot;&gt;Add new Adyen fields to the layout&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;From &lt;strong&gt;Setup&lt;\\\/strong&gt;, go to &lt;strong&gt;Object Manager&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Search for and click on the &lt;strong&gt;Sales Channel&lt;\\\/strong&gt; object.&lt;\\\/li&gt;\\n&lt;li&gt;Click on &lt;strong&gt;Page Layouts&lt;\\\/strong&gt; and select the page layout that you want the new &lt;strong&gt;Adyen Merchant Account&lt;\\\/strong&gt; field to appear in.&lt;\\\/li&gt;\\n&lt;li&gt;Drag and drop the field to your selected layout.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;Repeat these steps for the &lt;strong&gt;Payment&lt;\\\/strong&gt; and &lt;strong&gt;Payment Authorization&lt;\\\/strong&gt; objects by adding the &lt;strong&gt;Adyen Override Merchant Config&lt;\\\/strong&gt;, &lt;strong&gt;Adyen Payment Method&lt;\\\/strong&gt;, &lt;strong&gt;Adyen Payment Method Variant&lt;\\\/strong&gt; fields.&lt;\\\/p&gt;\\n&lt;h3 id=\\&quot;configure-named-credential\\&quot;&gt;Configure Named Credentials&lt;\\\/h3&gt;\\n&lt;p&gt;The Named Credentials have the authentication details used between the Salesforce OMS and Adyen.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;From &lt;strong&gt;Setup&lt;\\\/strong&gt;, enter &lt;strong&gt;Named Credentials&lt;\\\/strong&gt; in the search field.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Adyen Legacy Named Credential&lt;\\\/strong&gt; and click &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Fill these properties:&lt;\\\/li&gt;\\n&lt;\\\/ol&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;&lt;strong&gt;Username&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The name of your &lt;a href=\\&quot;\\\/development-resources\\\/api-credentials\\&quot;&gt;Adyen API Credential&lt;\\\/a&gt;, for example &lt;strong&gt;ws@Company.[YourAdyenCompanyAccount]&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Password&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The basic authentication password for your &lt;a href=\\&quot;\\\/development-resources\\\/api-credentials\\&quot;&gt;Adyen API Credential&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Callout options&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select the checkbox for:&lt;br&gt; - &lt;strong&gt;Generate Authorization Header&lt;\\\/strong&gt; &lt;br&gt; - &lt;strong&gt;Allow Merge Fields in HTTP Body&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;ol start=\\&quot;4\\&quot;&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;&lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.named_credentials_legacy_about.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Legacy Named Credentials&lt;\\\/a&gt; are deprecated by Salesforce and will be discontinued in future releases. We are working on the integration with new Named Credentials.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;h3 id=\\&quot;configure-adyen-custom-metadata\\&quot;&gt;Configure Adyen custom metadata type&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;From &lt;strong&gt;Setup&lt;\\\/strong&gt;, search for &lt;strong&gt;Custom Metadata Type&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Manage Records of Adyen Adapter metadata&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Edit&lt;\\\/strong&gt; for the &lt;strong&gt;Adyen Default&lt;\\\/strong&gt; metadata record.&lt;\\\/li&gt;\\n&lt;li&gt;Set the &lt;strong&gt;Merchant Account&lt;\\\/strong&gt; to the name of your &lt;a href=\\&quot;\\\/account\\\/account-structure#merchant-accounts\\&quot;&gt;Adyen merchant account&lt;\\\/a&gt;. This field is case-sensitive.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;configure-sales-channel\\&quot;&gt;Configure sales channels&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;From the &lt;strong&gt;App Launcher&lt;\\\/strong&gt;, search for &lt;strong&gt;Sales Channels&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Sales Channel&lt;\\\/strong&gt; that you want to use.&lt;\\\/li&gt;\\n&lt;li&gt;Set the &lt;strong&gt;Adyen Merchant Account&lt;\\\/strong&gt; field to &lt;strong&gt;AdyenDefault&lt;\\\/strong&gt;.\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;This must match the custom metadata record name from the &lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;previous step&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;9ec8a55ecb491d4ed9e381330e1bff63&quot;:&quot;&lt;h2 id=\\&quot;set-up-payment-gateway\\&quot;&gt;Set up the Payment Gateway&lt;\\\/h2&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#create-payment-gateway\\&quot;&gt;Create a Payment Gateway record&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#create-payment-gateway-provider\\&quot;&gt;Create a Payment Gateway Provider record&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#create-payment-gateway\\&quot;&gt;Create a Payment Gateway record&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Only if you process &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/sfra\\\/set-up-the-cartridge?plugin=Salesforce%20SFRA&amp;amp;integration=cartridge&amp;amp;version=latest#set-up-in-person-payments\\&quot;&gt;in-person payments with endless aisle&lt;\\\/a&gt;, &lt;a href=\\&quot;#create-pos-payment-gateway\\&quot;&gt;create a payment gateway record for in-person payments&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;create-payment-gateway-provider\\&quot;&gt;Create the Payment Gateway Provider record&lt;\\\/h3&gt;\\n&lt;p&gt;Get the Apex Adapter ID:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce OMS 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;Apex Classes&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Choose &lt;strong&gt;AdyenAsyncAdapter&lt;\\\/strong&gt; class.&lt;\\\/li&gt;\\n&lt;li&gt;Get the Apex Adapter ID from the last 15 digits of the URL in your browser&#039;s address bar, for example &lt;strong&gt;01pB0000004IvhM&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;Add the Payment Gateway Provider record:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In &lt;a href=\\&quot;https:\\\/\\\/workbench.developerforce.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Workbench&lt;\\\/a&gt;, choose the latest API version available.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Utilities&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;REST Explorer&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a &lt;strong&gt;POST&lt;\\\/strong&gt; &lt;code&gt;\\\/services\\\/data\\\/v58.0\\\/tooling\\\/sobjects\\\/PaymentGatewayProvider&lt;\\\/code&gt; request with the following body:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-json\\&quot;&gt;{\\n\\&quot;ApexAdapterId\\&quot;: \\&quot;YOUR_APEX_ADAPTER_ID\\&quot;,\\n\\&quot;DeveloperName\\&quot;: \\&quot;Adyen\\&quot;,\\n\\&quot;MasterLabel\\&quot;: \\&quot;SalesforceOrderManagement-Adyen\\&quot;,\\n\\&quot;IdempotencySupported\\&quot;: \\&quot;Yes\\&quot;\\n}&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;You get a confirmation in the API response if the Payment Gateway Provider record was created successfully.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;create-payment-gateway\\&quot;&gt;Create a Payment Gateway record&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the &lt;strong&gt;App Launcher&lt;\\\/strong&gt;, search for &lt;strong&gt;Payment Gateways&lt;\\\/strong&gt; and select it.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt; and enter the following values into the corresponding fields:&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 Name&lt;\\\/td&gt;\\n&lt;td&gt;Adyen&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Payment Gateway Provider&lt;\\\/td&gt;\\n&lt;td&gt;Choose the &lt;a href=\\&quot;#create-payment-gateway-provider\\&quot;&gt;Payment Gateway Provider you created&lt;\\\/a&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;The &lt;a href=\\&quot;#configure-named-credential\\&quot;&gt;Named Credential&lt;\\\/a&gt; you created.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Status&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Active&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;External Reference&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Adyen_Component&lt;\\\/strong&gt;. This value must match your SFCC B2C Payment Processor ID.&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 &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;create-pos-payment-gateway\\&quot;&gt;Create a Payment Gateway record for in-person payments&lt;\\\/h3&gt;\\n&lt;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;This step is only required if you process &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/sfra\\\/set-up-the-cartridge?plugin=Salesforce%20SFRA&amp;amp;integration=cartridge&amp;amp;version=latest#set-up-in-person-payments\\&quot;&gt;in-person payments with endless aisle&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;p&gt;Create a Payment Gateway record in Salesforce:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the &lt;strong&gt;App Launcher&lt;\\\/strong&gt;, search for &lt;strong&gt;Payment Gateways&lt;\\\/strong&gt; and select it.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt; and enter the following values into the corresponding fields:&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 Name&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;AdyenPos&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&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;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Status&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Active&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;External Reference&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Adyen_POS&lt;\\\/strong&gt;. This value must match your SFCC B2C Payment Processor ID.&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 &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;085bc32bb48508fc48351f8ded4a56fb&quot;:&quot;&lt;h2 id=\\&quot;set-up-webhooks\\&quot;&gt;Set up webhooks&lt;\\\/h2&gt;\\n&lt;p&gt;Adyen sends webhooks that contain JSON objects to your Salesforce payment gateway adapter. To receive these webhooks:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#expose-salesforce-site-endpoint\\&quot;&gt;Expose a Salesforce site endpoint&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-webhook\\&quot;&gt;Configure webhooks&lt;\\\/a&gt; in the Customer Area.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#test-webhook\\&quot;&gt;Test your webhook configuration&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;expose-salesforce-site-endpoint\\&quot;&gt;Expose a Salesforce site endpoint&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce OMS Org, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;User Interface&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Sites and Domains&lt;\\\/strong&gt; - &lt;strong&gt;Sites&lt;\\\/strong&gt;, and then select &lt;strong&gt;Site&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Enter a label, for example &lt;strong&gt;Adyen&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Enter a unique value for the default web address, for example &lt;code&gt;http:\\\/\\\/dev-myorganization--sandbox.cs17.force.com\\\/adyen&lt;\\\/code&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Active&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select an &lt;strong&gt;Active Site Home Page&lt;\\\/strong&gt;, for example, UnderConstruction.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Guest Access to the Payments API&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt; to save your changes and make sure the site is active.&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;Select &lt;strong&gt;Edit&lt;\\\/strong&gt; and enable the &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt; metadata type by moving it to 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;li&gt;\\n&lt;p&gt;Construct the webhook endpoint URL. For this you need:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The URL of your Salesforce site.&lt;\\\/li&gt;\\n&lt;li&gt;The Payment Gateway Provider ID you got when &lt;a href=\\&quot;#create-payment-gateway-provider\\&quot;&gt;creating the Payment Gateway Provider record&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;SALESFORCE_SITE_URL\\\\\\\/services\\\\\\\/data\\\\\\\/v58.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;http:\\\\\\\/\\\\\\\/ dev-clientname.cs17.force.com\\\\\\\/adyen\\\\\\\/services\\\\\\\/data\\\\\\\/v49.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;\\\/ol&gt;\\n&lt;h3 id=\\&quot;configure-webhook\\&quot;&gt;Configure webhooks in the Customer Area&lt;\\\/h3&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;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;We &lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/configure-and-manage\\&quot;&gt;recommend to configure webhooks for your company account&lt;\\\/a&gt;. This ensures that you do not have duplicate webhook configurations, and improves performance.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;i class=\\&quot;adl-icon-add\\&quot; role=\\&quot;img\\&quot; aria-label=\\&quot;add icon\\&quot;&gt;&lt;\\\/i&gt; &lt;strong&gt;Webhook&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;From the list of webhooks, next to &lt;strong&gt;Standard webhook&lt;\\\/strong&gt;, select &lt;strong&gt;Add&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;General&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Enabled&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select the toggle to enable or disable the webhook.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Version&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The webhook version.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Description&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Your description of the webhook.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Merchant accounts&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;You can apply the webhook to all merchant accounts for a company account, include only specific merchant accounts, or exclude specific merchant accounts for your company account.&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;Under &lt;strong&gt;Server configuration&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;URL&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;a href=\\&quot;#expose-salesforce-site-endpoint\\&quot;&gt;The webhook endpoint URL&lt;\\\/a&gt; you constructed.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Method&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;JSON&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Encryption protocol&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The latest &lt;strong&gt;TLS version&lt;\\\/strong&gt; in the list.&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;Under &lt;strong&gt;Security&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;HMAC Key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/secure-webhooks\\\/verify-hmac-signatures#enable-hmac-signatures\\&quot;&gt;Generate the HMAC Key&lt;\\\/a&gt;, copy it, and store it securely in your system. You will need your HMAC key &lt;a href=\\&quot;#configure-package-components\\&quot;&gt;when configuring package components&lt;\\\/a&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;Under &lt;strong&gt;Events&lt;\\\/strong&gt;, in addition to the default events that are selected, select &lt;strong&gt;CAPTURE&lt;\\\/strong&gt;, and &lt;strong&gt;REFUND&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 id=\\&quot;test-webhook\\&quot;&gt;Test your webhook configuration&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&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; &amp;gt; &lt;strong&gt;Webhooks&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Next to &lt;strong&gt;Standard webhook&lt;\\\/strong&gt;, select the edit webhook icon &lt;i class=\\&quot;adl-icon-edit\\&quot;&gt;&lt;\\\/i&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Test Configuration&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;If you are on a &lt;a href=\\&quot;\\\/account\\\/account-structure#company-account\\&quot;&gt;company account&lt;\\\/a&gt;, select a &lt;strong&gt;Merchant account&lt;\\\/strong&gt; from the dropdown list.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Event&lt;\\\/strong&gt; dropdown list, select the &lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/webhook-types#event-codes\\&quot;&gt;event code&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;If your webhook configuration is correct, it shows a &lt;a href=\\&quot;https:\\\/\\\/developer.mozilla.org\\\/en-US\\\/docs\\\/Web\\\/HTTP\\\/Status#successful_responses\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;successful HTTP response status code&lt;\\\/a&gt;, for example &lt;code&gt;ResponseCode&lt;\\\/code&gt;: &lt;strong&gt;200&lt;\\\/strong&gt;.&lt;\\\/p&gt;&quot;,&quot;71b6cbb50705a9c7b2e4f0e1c9c0ad1c&quot;:&quot;&lt;h2 id=\\&quot;set-up-alternative-payment-methods\\&quot;&gt;Set up alternative payment methods&lt;\\\/h2&gt;\\n&lt;p&gt;To set up alternative payment methods:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#add-new-gateway-pm-type\\&quot;&gt;Add a new gateway provider payment method type&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#add-permissions\\&quot;&gt;Add permissions&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;add-new-gateway-pm-type\\&quot;&gt;Add a new gateway provider payment method type&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&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; &amp;gt; &lt;strong&gt;Alternative Payment Method&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Record Type&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Verify that you have a record type named &lt;strong&gt;Alternative Payment Method&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Developer Console&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Query Editor&lt;\\\/strong&gt; tab.&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Run the following query:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-text\\&quot;&gt;SELECT Id from RecordType where Name = &#039;Alternative Payment Method&#039; Limit 1&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;From the response to the query, store the &lt;code&gt;Id&lt;\\\/code&gt; of the record type. If you get a parsing error, you need to remove and insert the single quotes (&lt;strong&gt;\\u2018&lt;\\\/strong&gt;) back in the query.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;a href=\\&quot;https:\\\/\\\/workbench.developerforce.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Workbench&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Choose the latest API version available.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Login with Salesforce&lt;\\\/strong&gt; and log in with your OMS sandbox credentials.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Utilities&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;REST Explorer&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a &lt;strong&gt;POST&lt;\\\/strong&gt; &lt;code&gt;\\\/services\\\/data\\\/v58.0\\\/sobjects\\\/GtwyProvPaymentMethodType&lt;\\\/code&gt; request with the following body:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-json\\&quot;&gt;{\\n\\&quot;DeveloperName\\&quot;: \\&quot;AlternativePaymentMethod\\&quot;,\\n\\&quot;MasterLabel\\&quot;: \\&quot;Alternative Payment Method\\&quot;,\\n\\&quot;GtwyProviderPaymentMethodType\\&quot; : \\&quot;AdyenComponent\\&quot;,\\n\\&quot;PaymentGatewayProviderId\\&quot; : \\&quot;YOUR_APEX_ADAPTER_ID\\&quot;, \\\/\\\/Id of the Payment Gateway Provider record from step 3\\n\\&quot;PaymentMethodType\\&quot; : \\&quot;AlternativePaymentMethod\\&quot;,\\n\\&quot;RecordTypeId\\&quot;: \\&quot;YOUR_RECORD_TYPE_ID\\&quot;  \\\/\\\/Id of your Alternative Payment Method record type\\n}&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;p&gt;You receive the following response:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-json\\&quot;&gt;{\\n  \\&quot;id\\&quot; : \\&quot;1gpxxxxxxxxxxxxxxx\\&quot;,\\n  \\&quot;success\\&quot; : true,\\n  \\&quot;errors\\&quot; : [ ]\\n}&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;add-permissions\\&quot;&gt;Add permissions&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce OMS Org, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Permission Sets&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Order Management B2C service&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Object Settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Alternative Payment Methods&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Record Type Assignments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Alternative Payment Method record type&lt;\\\/strong&gt;, select the &lt;strong&gt;Assigned Record Types&lt;\\\/strong&gt; checkbox.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go back to &lt;strong&gt;Object Settings&lt;\\\/strong&gt; and go to &lt;strong&gt;Payment Authorizations&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Field Permissions&lt;\\\/strong&gt;, add &lt;strong&gt;Edit access&lt;\\\/strong&gt; for the &lt;strong&gt;Adyen Payment Method&lt;\\\/strong&gt; and &lt;strong&gt;Adyen Payment Method Variant&lt;\\\/strong&gt; fields.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go back to &lt;strong&gt;Object Settings&lt;\\\/strong&gt; and go to &lt;strong&gt;Payments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Field Permissions&lt;\\\/strong&gt;, add &lt;strong&gt;Edit access&lt;\\\/strong&gt; for the &lt;strong&gt;Adyen Payment Method&lt;\\\/strong&gt; and &lt;strong&gt;Adyen Payment Method Variant&lt;\\\/strong&gt; fields.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;686d1d5acfa3c1d05c4d6373a8ecf901&quot;:&quot;&lt;h2&gt;Configure capture settings in SFCC&lt;\\\/h2&gt;\\n&lt;p&gt;With our OMS package, you can capture payments at any step in your order fulfillment flow. In Adyen, some payment methods are captured immediately after authorization. You need to specify these payment methods that you enabled in your Customer Area in your SFCC Business Manager to prevent OMS from initiating duplicate capture requests.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In your &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/sfra\\\/set-up-the-cartridge\\\/?plugin=Salesforce%20SFRA&amp;amp;integration=cartridge&amp;amp;version=latest#set-up-the-business-manager\\&quot;&gt;Salesforce Business Manager&lt;\\\/a&gt;, go to &lt;strong&gt;Merchant Tools&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Site Preferences&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Adyen settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Local payment method settings&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the &lt;strong&gt;Payment methods without separate capture&lt;\\\/strong&gt; field, specify the payment methods that you added in your Customer Area, using the &lt;a href=\\&quot;\\\/development-resources\\\/paymentmethodvariant\\\/\\&quot;&gt;\\n  &lt;code&gt;paymentMethodVariant&lt;\\\/code&gt;\\n&lt;\\\/a&gt; for each payment method. Separate each variant with a comma, for example:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-text\\&quot;&gt;ideal, paypal, applepay, visa_applepay, mc_applepay, amex_applepay, klarna_paynow, twint, sepadirectdebit, bcmc, wechatpay, multibanco, blik, mbway, pix, onlineBanking_PL&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save Changes&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;7e2d6d71b7c078e1ec0c8668ffe0258c&quot;:&quot;&lt;h2 id=\\&quot;go-live\\&quot;&gt;Go live&lt;\\\/h2&gt;\\n&lt;p&gt;When you are ready to go live, follow our &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/go-live-checklist\\&quot;&gt;SFCC go-live checklist&lt;\\\/a&gt;. You do not need to follow the steps to &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/go-live-checklist#business-manager\\&quot;&gt;configure the SFCC Business Manager&lt;\\\/a&gt; in the checklist. Instead, you need to:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-named-credential\\&quot;&gt;Configure a new Named Credential&lt;\\\/a&gt; with the username and password for your live Adyen credential.&lt;\\\/li&gt;\\n&lt;li&gt;For the new Named Credential you created, add the live &lt;strong&gt;URL&lt;\\\/strong&gt; using your &lt;a href=\\&quot;\\\/development-resources\\\/live-endpoints#live-url-prefix\\&quot;&gt;live URL prefix&lt;\\\/a&gt;, for example:&lt;br \\\/&gt;\\n&lt;code&gt;https:\\\/\\\/[YOUR_LIVE_PREFIX]-checkout-live.adyenpayments.com&lt;\\\/code&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Replace &lt;strong&gt;[YOUR_LIVE_PREFIX]&lt;\\\/strong&gt; with the live prefix in your &lt;a href=\\&quot;https:\\\/\\\/ca-live.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;live Customer Area&lt;\\\/a&gt; under &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;API URLs&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Prefix&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;a href=\\&quot;#create-payment-gateway\\&quot;&gt;Adyen Payment Gateway record you created&lt;\\\/a&gt;, change the &lt;strong&gt;Merchant Credential&lt;\\\/strong&gt; value to the new Named Credential.&lt;\\\/li&gt;\\n&lt;li&gt;Only if you are using a different merchant account in live, change the &lt;strong&gt;Merchant Account&lt;\\\/strong&gt; for the &lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;Adyen custom metadata record&lt;\\\/a&gt; to the name of your live account.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;e3d09aaf20c0e5a8ebe05acee91f70c5&quot;:&quot;&lt;h2&gt;Next steps&lt;\\\/h2&gt;\\n&lt;div class=\\&quot;next-steps\\&quot; id=\\&quot;next-steps35886\\&quot; &gt;\\n&lt;a href=\\&quot;\\\/plugins\\\/salesforce-order-management-system\\\/set-up-oobo\\&quot; class=\\&quot;next-steps__step\\&quot; style=\\&quot;width:45%;\\&quot; target=\\&quot;_self\\&quot;&gt;&lt;div class=\\&quot;next-steps__title\\&quot;&gt;Set up Order on Behalf Of&lt;\\\/div&gt;&lt;p class=\\&quot;next-steps__body\\&quot;&gt;&lt;p&gt;Enable your customer service employees to place orders on behalf of shoppers.&lt;\\\/p&gt;&lt;\\\/p&gt;&lt;\\\/a&gt;&lt;a href=\\&quot;\\\/plugins\\\/salesforce-order-management-system\\\/authorization-reversal\\&quot; class=\\&quot;next-steps__step\\&quot; style=\\&quot;width:45%;\\&quot; target=\\&quot;_self\\&quot;&gt;&lt;div class=\\&quot;next-steps__title\\&quot;&gt;Enable Auhtorization Reversals&lt;\\\/div&gt;&lt;p class=\\&quot;next-steps__body\\&quot;&gt;&lt;p&gt;Handle situations where you need to reverse an authorization.&lt;\\\/p&gt;&lt;\\\/p&gt;&lt;\\\/a&gt;&lt;\\\/div&gt;\\n&quot;,&quot;18287ae355baf0f61f532416644eb355&quot;:&quot;&lt;h2 id=\\&quot;set-up-payment-gateway\\&quot;&gt;Set up the Payment Gateway&lt;\\\/h2&gt;\\n&lt;p&gt;To set up the Payment Gateway:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#create-payment-gateway\\&quot;&gt;Create a Payment Gateway record&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Only if you process &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/sfra\\\/set-up-the-cartridge?plugin=Salesforce%20SFRA&amp;amp;integration=cartridge&amp;amp;version=latest#set-up-in-person-payments\\&quot;&gt;in-person payments with endless aisle&lt;\\\/a&gt;, &lt;a href=\\&quot;#create-pos-payment-gateway\\&quot;&gt;create a payment gateway record for in-person payments&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#get-provider-id\\&quot;&gt;Get the Payment Gateway Provider ID&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;create-payment-gateway\\&quot;&gt;Create a Payment Gateway record&lt;\\\/h3&gt;\\n&lt;p&gt;Create a Payment Gateway record in Salesforce:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the &lt;strong&gt;App Launcher&lt;\\\/strong&gt;, search for &lt;strong&gt;Payment Gateways&lt;\\\/strong&gt; and select it.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt; and enter the following values into the corresponding fields:&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 Name&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Adyen&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&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; Due to a &lt;a href=\\&quot;https:\\\/\\\/issues.salesforce.com\\\/issue\\\/a028c00000zLQG6AAO\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;known Salesforce issue&lt;\\\/a&gt;, you may not be able to select &lt;strong&gt;AdyenCheckout&lt;\\\/strong&gt;. If you experience this, 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;tr&gt;\\n&lt;td&gt;Status&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Active&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;External Reference&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Adyen_Component&lt;\\\/strong&gt;. This value must match your SFCC B2C Payment Processor ID.&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 &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;create-pos-payment-gateway\\&quot;&gt;Create a Payment Gateway record for in-person payments&lt;\\\/h3&gt;\\n&lt;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;This step is only required if you process &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/sfra\\\/set-up-the-cartridge?plugin=Salesforce%20SFRA&amp;amp;integration=cartridge&amp;amp;version=latest#set-up-in-person-payments\\&quot;&gt;in-person payments with endless aisle&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;p&gt;Create a Payment Gateway record in Salesforce:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the &lt;strong&gt;App Launcher&lt;\\\/strong&gt;, search for &lt;strong&gt;Payment Gateways&lt;\\\/strong&gt; and select it.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt; and enter the following values into the corresponding fields:&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 Name&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;AdyenPos&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&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;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;Status&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Active&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;External Reference&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;Adyen_POS&lt;\\\/strong&gt;. This value must match your SFCC B2C Payment Processor ID.&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 &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;get-payment-gateway-id\\&quot;&gt;Get the Payment Gateway Provider ID&lt;\\\/h3&gt;\\n&lt;p&gt;Get the Payment Gateway Provider ID for the record you created. You will need this ID when you &lt;a href=\\&quot;#set-up-webhooks\\&quot;&gt;set up webhooks&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In the &lt;a href=\\&quot;#create-payment-gateway\\&quot;&gt;Payment Gateway record you created&lt;\\\/a&gt;, select the &lt;strong&gt;Adyen OMS Provider&lt;\\\/strong&gt; hyperlink.&lt;br \\\/&gt;\\nThis opens the Payment Gateway Provider page.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Site URL&lt;\\\/strong&gt;, find the ID, starting with &lt;strong&gt;0cJ&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Save this ID for later use.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;77a7dfcb073a79c07de4b4c24d7f70f7&quot;:&quot;&lt;h2 id=\\&quot;set-up-webhooks\\&quot;&gt;Set up webhooks&lt;\\\/h2&gt;\\n&lt;p&gt;Adyen sends webhooks that contain JSON objects to your Salesforce payment gateway adapter. To receive these webhooks:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#expose-salesforce-site-endpoint\\&quot;&gt;Expose a Salesforce site endpoint&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-webhook\\&quot;&gt;Configure webhooks&lt;\\\/a&gt; in the Customer Area.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#test-webhook\\&quot;&gt;Test your webhook configuration&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;expose-salesforce-site-endpoint\\&quot;&gt;Expose a Salesforce site endpoint&lt;\\\/h3&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;User Interface&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Sites and Domains&lt;\\\/strong&gt; - &lt;strong&gt;Sites&lt;\\\/strong&gt;, and then select &lt;strong&gt;Site&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Enter a label, for example &lt;strong&gt;Adyen&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Enter a unique value for the default web address, for example &lt;code&gt;http:\\\/\\\/dev-myorganization--sandbox.cs17.force.com\\\/adyen&lt;\\\/code&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Active&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select an &lt;strong&gt;Active Site Home Page&lt;\\\/strong&gt;, for example, &lt;strong&gt;UnderConstruction&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Guest Access to the Payments API&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt; to save your changes and make sure the site is active.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&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;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Edit&lt;\\\/strong&gt; and enable the &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt; metadata type by moving it to the &lt;strong&gt;Enabled&lt;\\\/strong&gt; column.&lt;\\\/p&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;li&gt;\\n&lt;p&gt;Construct your webhook endpoint URL with:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The URL of your Salesforce site.&lt;\\\/li&gt;\\n&lt;li&gt;The &lt;a href=\\&quot;#get-payment-gateway-id\\&quot;&gt;Payment Gateway Provider ID&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;Save the endpoint URL in your system, you will need it when you &lt;a href=\\&quot;#configure-wehook\\&quot;&gt;configure webhooks in the Customer Area&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;configure-webhook\\&quot;&gt;Configure webhooks in the Customer Area&lt;\\\/h3&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;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;We &lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/configure-and-manage\\&quot;&gt;recommend to configure webhooks for your company account&lt;\\\/a&gt;. This ensures that you do not have duplicate webhook configurations, and improves performance.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;i class=\\&quot;adl-icon-add\\&quot; role=\\&quot;img\\&quot; aria-label=\\&quot;add icon\\&quot;&gt;&lt;\\\/i&gt; &lt;strong&gt;Webhook&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;From the list of webhooks, next to &lt;strong&gt;Standard webhook&lt;\\\/strong&gt;, select &lt;strong&gt;Add&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;General&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Enabled&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select the toggle to enable or disable the webhook.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Version&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The webhook version.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Description&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Your description of the webhook.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Merchant accounts&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;You can apply the webhook to all merchant accounts for a company account, include only specific merchant accounts, or exclude specific merchant accounts for your company account.&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;Under &lt;strong&gt;Server configuration&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;URL&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;a href=\\&quot;#expose-salesforce-site-endpoint\\&quot;&gt;The webhook endpoint URL&lt;\\\/a&gt; you constructed.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Method&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;JSON&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Encryption protocol&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The latest &lt;strong&gt;TLS version&lt;\\\/strong&gt; in the list.&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;Under &lt;strong&gt;Security&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;HMAC Key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/secure-webhooks\\\/verify-hmac-signatures#enable-hmac-signatures\\&quot;&gt;Generate the HMAC Key&lt;\\\/a&gt;, copy it, and store it securely in your system. You need to enter the HMAC key when you &lt;a href=\\&quot;#configure-package-components\\&quot;&gt;configure package components&lt;\\\/a&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;Under &lt;strong&gt;Events&lt;\\\/strong&gt;, in addition to the default events that are selected, select &lt;strong&gt;CAPTURE&lt;\\\/strong&gt;, &lt;strong&gt;CAPTURE_FAILED&lt;\\\/strong&gt;, &lt;strong&gt;REFUND&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;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;Rarely, a refund or capture can fail after you have received a &lt;strong&gt;REFUND&lt;\\\/strong&gt; or &lt;strong&gt;CAPTURE&lt;\\\/strong&gt; webhook with &lt;code&gt;success:&lt;\\\/code&gt; &lt;strong&gt;true&lt;\\\/strong&gt;. After a payment is processed in Salesforce, the status cannot be changed. Therefore, we recommend to monitor these cases in the &lt;code&gt;GatewayResultCode&lt;\\\/code&gt; field of the &lt;a href=\\&quot;https:\\\/\\\/developer.salesforce.com\\\/docs\\\/atlas.en-us.object_reference.meta\\\/object_reference\\\/sforce_api_objects_paymentgatewaylog.htm\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;PaymentGatewayLog&lt;\\\/a&gt; object in Salesforce. When a refund or capture fails, the &lt;code&gt;GatewayResultCode&lt;\\\/code&gt; is marked with &lt;strong&gt;CAPTURE_FAILED&lt;\\\/strong&gt;, or &lt;strong&gt;REFUND_FAILED&lt;\\\/strong&gt;. Learn more in our &lt;a href=\\&quot;\\\/online-payments\\\/capture#failed-capture\\&quot;&gt;Capture&lt;\\\/a&gt; and &lt;a href=\\&quot;\\\/online-payments\\\/refund#refund-failed\\&quot;&gt;Refund&lt;\\\/a&gt; documentation.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;h3 id=\\&quot;test-webhook\\&quot;&gt;Test your webhook configuration&lt;\\\/h3&gt;\\n&lt;p&gt;Before you can test your webhook configuration, you have to add your HMAC key in your &lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;Salesforce custom metadata configuration&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&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; &amp;gt; &lt;strong&gt;Webhooks&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Next to &lt;strong&gt;Standard webhook&lt;\\\/strong&gt;, select the edit webhook icon &lt;i class=\\&quot;adl-icon-edit\\&quot;&gt;&lt;\\\/i&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Test Configuration&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;If you are on a &lt;a href=\\&quot;\\\/account\\\/account-structure#company-account\\&quot;&gt;company account&lt;\\\/a&gt;, select a &lt;strong&gt;Merchant account&lt;\\\/strong&gt; from the dropdown list.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Event&lt;\\\/strong&gt; dropdown list, select the &lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/webhook-types#event-codes\\&quot;&gt;event code&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;If your webhook configuration is correct, it shows a &lt;a href=\\&quot;https:\\\/\\\/developer.mozilla.org\\\/en-US\\\/docs\\\/Web\\\/HTTP\\\/Status#successful_responses\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;successful HTTP response status code&lt;\\\/a&gt;, for example &lt;code&gt;ResponseCode&lt;\\\/code&gt;: &lt;strong&gt;200&lt;\\\/strong&gt;.&lt;\\\/p&gt;&quot;,&quot;bd74009d635f3b8386856411f52c7396&quot;:&quot;&lt;h2 id=\\&quot;configure-package-components\\&quot;&gt;Configure package components&lt;\\\/h2&gt;\\n&lt;p&gt;In your Salesforce OMS Org, configure package components:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#add-adyen-fields-to-layout\\&quot;&gt;Add new Adyen fields to the layout&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#set-up-the-principal-credential\\&quot;&gt;Set up the Principal Credential&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;Configure Adyen custom metadata type&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Optionally, &lt;a href=\\&quot;#configure-sales-channel\\&quot;&gt;configure a merchant account for a sales channel&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;add-adyen-fields-to-layout\\&quot;&gt;Add new Adyen fields to the layout&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;From &lt;strong&gt;Setup&lt;\\\/strong&gt;, go to &lt;strong&gt;Object Manager&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Search for and click on the &lt;strong&gt;Sales Channel&lt;\\\/strong&gt; object.&lt;\\\/li&gt;\\n&lt;li&gt;Click on &lt;strong&gt;Page Layouts&lt;\\\/strong&gt; and select the page layout that you want the new &lt;strong&gt;Adyen Merchant Account&lt;\\\/strong&gt; field to appear in.&lt;\\\/li&gt;\\n&lt;li&gt;Drag and drop the field to your selected layout.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;Repeat these steps for the &lt;strong&gt;Payment&lt;\\\/strong&gt; and &lt;strong&gt;Payment Authorization&lt;\\\/strong&gt; objects by adding the &lt;strong&gt;Adyen Payment Method&lt;\\\/strong&gt; and &lt;strong&gt;Adyen Payment Method Variant&lt;\\\/strong&gt; fields.&lt;\\\/p&gt;\\n&lt;h3 id=\\&quot;configure-named-credential\\&quot;&gt;Set up the Principal Credential&lt;\\\/h3&gt;\\n&lt;p&gt;The package uses Named Credentials to perform authentication between the Salesforce OMS and Adyen. When you &lt;a href=\\&quot;#install-the-app\\&quot;&gt;install the app&lt;\\\/a&gt;, the &lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.named_credentials_about.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Named Credential&lt;\\\/a&gt; is set up automatically.&lt;\\\/p&gt;\\n&lt;p&gt;You must also set up a &lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.nc_enable_ext_cred_principal.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt; Principal Credential&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;&lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.named_credentials_legacy_about.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt; Legacy Named Credentials &lt;\\\/a&gt; are deprecated by Salesforce and are not used in our package from this version onwards.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;p&gt;These steps below are based on the &lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.users_profiles_about_enhanced_ui.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Salesforce Enhanced Profile User Interface&lt;\\\/a&gt;. If you use the old view, the steps you have to take may differ.&lt;\\\/p&gt;\\n&lt;p&gt;In addition to the Named Credential, you need to set up a Principal Credential. To do this, in your OMS Org:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Security&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Named Credentials&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;External Credential&lt;\\\/strong&gt;, select &lt;strong&gt;Adyen API&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Principals&lt;\\\/strong&gt;, next to the &lt;strong&gt;AdyenParameterKey&lt;\\\/strong&gt;, select the &lt;strong&gt;Actions&lt;\\\/strong&gt; button, and then select &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;br \\\/&gt;\\nThis opens a modal window.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Add&lt;\\\/strong&gt;, and add an authentication parameter with the following properties:\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Name&lt;\\\/strong&gt;: &lt;strong&gt;ApiKey&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;Value&lt;\\\/strong&gt;: &lt;a href=\\&quot;\\\/development-resources\\\/api-credentials\\\/#generate-api-key\\&quot;&gt;Your API key&lt;\\\/a&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;After setting up the Principal, give access to this Principal with a permission set:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Users&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Permission Sets&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Label&lt;\\\/strong&gt; field, enter a name, and select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;External Credential Principal Access&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Edit&lt;\\\/strong&gt; and enable the Principal you have set up by moving it from the &lt;strong&gt;Available&lt;\\\/strong&gt; to the &lt;strong&gt;Enabled&lt;\\\/strong&gt; column.&lt;\\\/li&gt;\\n&lt;li&gt;Go back to the permission set, and select &lt;strong&gt;Object Settings&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;User External Credentials&lt;\\\/strong&gt;, and select &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Next to &lt;strong&gt;Read&lt;\\\/strong&gt;, select the checkbox to give read access.&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Assign the permission set you have created to the &lt;strong&gt;Automated Process&lt;\\\/strong&gt; user. This user is a hidden Salesforce user that runs scheduled flows and other automated processes, including the payment flows. If you have modified &lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.wf_approval_settings.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt; your process automation settings &lt;\\\/a&gt;, this user may differ.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Select &lt;strong&gt;Manage Assignments&lt;\\\/strong&gt;, and then select &lt;strong&gt;Add Assignment&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the user list, select the &lt;strong&gt;Automated Process&lt;\\\/strong&gt; user, and select &lt;strong&gt;Next&lt;\\\/strong&gt;.&lt;br \\\/&gt;\\nIf the user is not visible in the list, switch to the &lt;strong&gt;All Users&lt;\\\/strong&gt; list view and search for &lt;strong&gt;auto&lt;\\\/strong&gt;,&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Assign&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;Alternatively, you can assign also assign the permission set to the &lt;strong&gt;Automated Process&lt;\\\/strong&gt; user by:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;In your Developer Console, query the Profile Id for this user with the following:&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=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;txt&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;SELECT ProfileId FROM User WHERE Alias = &#039;autoproc&#039;&amp;quot;}]\\&quot; :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;Construct a URL to access the page where you can edit permissions.&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;txt\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;YOUR_SF_ORG_URL\\\\\\\/_ui\\\\\\\/system\\\\\\\/user\\\\\\\/ProfileExternalCredentialPrincipalPermissionEdit\\\\\\\/e?profile_id=PROFILE_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;ul&gt;\\n&lt;li&gt;&lt;code&gt;YOUR_SF_ORG_URL&lt;\\\/code&gt;: Your Salesforce Org Url.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;PROFILE_ID&lt;\\\/code&gt;: The profile Id you received as a result to the query.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Navigate to the URL that you constructed.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Edit&lt;\\\/strong&gt; and enable the Principal you have set up by moving it from the &lt;strong&gt;Available&lt;\\\/strong&gt; to the &lt;strong&gt;Enabled&lt;\\\/strong&gt; column.&lt;\\\/p&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;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;configure-adyen-custom-metadata\\&quot;&gt;Configure Adyen custom metadata type&lt;\\\/h3&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your OMS 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;Next to &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt;, select &lt;strong&gt;Manage Records&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;Fill the following fields:\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Merchant Account&lt;\\\/strong&gt;: your &lt;a href=\\&quot;\\\/account\\\/account-structure#merchant-accounts\\&quot;&gt;Adyen merchant account name&lt;\\\/a&gt;. This field is case-sensitive.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;HMAC Key&lt;\\\/strong&gt;: your &lt;a href=\\&quot;#set-up-webhooks\\&quot;&gt;HMAC key&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;After you have added your HMAC key in Salesforce, &lt;a href=\\&quot;#test-webhook\\&quot;&gt;test your webhook configuration&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;h3 id=\\&quot;configure-sales-channel\\&quot;&gt;(Optional) Configure sales channels&lt;\\\/h3&gt;\\n&lt;p&gt;Optionally, you can link your &lt;a href=\\&quot;https:\\\/\\\/help.salesforce.com\\\/s\\\/articleView?id=sf.om_sales_channel_fields.htm&amp;amp;type=5\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt; sales channels &lt;\\\/a&gt; to use specific Adyen merchant accounts. Sales channels that are not linked to a specific merchant account use the merchant account you &lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;configured in the &lt;strong&gt;Adyen Default&lt;\\\/strong&gt; custom metadata record&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;Before you can link an Adyen merchant account to a sales channel, make sure that:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The merchant account has &lt;a href=\\&quot;\\\/development-resources\\\/api-credentials\\\/#api-permissions\\&quot;&gt;API permissions&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;There is a &lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;custom metadata record&lt;\\\/a&gt; with the merchant account name in the &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt; custom metadata object.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To link an Adyen merchant account to a sales channel:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your OMS Org, go to the App Launcher, , search for &lt;strong&gt;Sales Channels&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Sales Channel&lt;\\\/strong&gt; that you want to configure a merchant account for.&lt;\\\/li&gt;\\n&lt;li&gt;Set the &lt;strong&gt;Adyen Merchant Account&lt;\\\/strong&gt; field to the name of the merchant account that you want to link to this sales channel.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;b7bf96d8adc59770f7afed88e43fa81f&quot;:&quot;&lt;h2 id=\\&quot;set-up-alternative-payment-methods\\&quot;&gt;Set up alternative payment methods&lt;\\\/h2&gt;\\n&lt;p&gt;To set up alternative payment methods, add permissions in Salesforce:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce OMS Org, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Permission Sets&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Order Management B2C service&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Object Settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Alternative Payment Methods&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Record Type Assignments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Alternative Payment Method record type&lt;\\\/strong&gt;, select the &lt;strong&gt;Assigned Record Types&lt;\\\/strong&gt; checkbox.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go back to &lt;strong&gt;Object Settings&lt;\\\/strong&gt; and go to &lt;strong&gt;Payment Authorizations&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Field Permissions&lt;\\\/strong&gt;, add &lt;strong&gt;Edit access&lt;\\\/strong&gt; for the &lt;strong&gt;Adyen Payment Method&lt;\\\/strong&gt; and &lt;strong&gt;Adyen Payment Method Variant&lt;\\\/strong&gt; fields.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Go back to &lt;strong&gt;Object Settings&lt;\\\/strong&gt; and go to &lt;strong&gt;Payments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Field Permissions&lt;\\\/strong&gt;, add &lt;strong&gt;Edit access&lt;\\\/strong&gt; for the &lt;strong&gt;Adyen Payment Method&lt;\\\/strong&gt; and &lt;strong&gt;Adyen Payment Method Variant&lt;\\\/strong&gt; fields.&lt;\\\/li&gt;\\n&lt;li&gt;Click &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;e406122e0e9ddd9d658025b08ac9097a&quot;:&quot;&lt;h2 id=\\&quot;go-live\\&quot;&gt;Go live&lt;\\\/h2&gt;\\n&lt;p&gt;When you are ready to go live, &lt;a href=\\&quot;\\\/get-started-with-adyen\\\/application-requirements\\&quot;&gt;apply for a live account&lt;\\\/a&gt;. Review the process to start accepting payments on &lt;a href=\\&quot;\\\/get-started-with-adyen\\&quot;&gt;Get started with Adyen&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;When you get your live account:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Follow our &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/go-live-checklist\\&quot;&gt;SFCC go-live checklist&lt;\\\/a&gt;. You do not need to follow the steps to &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/go-live-checklist#business-manager\\&quot;&gt;configure the SFCC Business Manager&lt;\\\/a&gt; in the checklist.&lt;\\\/li&gt;\\n&lt;li&gt;Update the Adyen credentials you used to set up your Salesforce OMS Org:\\n&lt;ul&gt;\\n&lt;li&gt;In the &lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;custom metadata record&lt;\\\/a&gt;:\\n&lt;ol&gt;\\n&lt;li&gt;Update your HMAC key.&lt;\\\/li&gt;\\n&lt;li&gt;If you are using a different merchant account in the live environment, update the merchant account name.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Switch the URL for the &lt;strong&gt;Adyen Checkout&lt;\\\/strong&gt; named credential to your live URL:\\n&lt;ol&gt;\\n&lt;li&gt;In your OMS Org, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Security&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Named Credentials&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Adyen Checkout&lt;\\\/strong&gt; named credential.&lt;\\\/li&gt;\\n&lt;li&gt;Replace the test URL with &lt;code&gt;https:\\\/\\\/[YOUR_LIVE_PREFIX]-checkout-live.adyenpayments.com\\\/checkout&lt;\\\/code&gt;. &lt;a href=\\&quot;\\\/development-resources\\\/live-endpoints\\\/#live-url-prefix\\&quot;&gt;Get your live prefix&lt;\\\/a&gt; from the live Customer Area.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Switch your test API key to your live API Key:\\n&lt;ol&gt;\\n&lt;li&gt;Select the &lt;strong&gt;External Credential&lt;\\\/strong&gt; linked to your &lt;strong&gt;Adyen Checkout&lt;\\\/strong&gt; named credential.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Principals&lt;\\\/strong&gt;, update your API key authentication parameter to your live API key.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;6b466d437f4e97cf264243ad31b8c80a&quot;:&quot;&lt;h2&gt;Next steps&lt;\\\/h2&gt;\\n&lt;div class=\\&quot;next-steps\\&quot; id=\\&quot;next-steps95748\\&quot; &gt;\\n&lt;a href=\\&quot;\\\/plugins\\\/salesforce-order-management-system\\\/set-up-oobo\\&quot; class=\\&quot;next-steps__step\\&quot; style=\\&quot;width:45%;\\&quot; target=\\&quot;_self\\&quot;&gt;&lt;div class=\\&quot;next-steps__title\\&quot;&gt;Set up Order on Behalf Of&lt;\\\/div&gt;&lt;p class=\\&quot;next-steps__body\\&quot;&gt;&lt;p&gt;Enable your customer service employees to place orders on behalf of shoppers.&lt;\\\/p&gt;&lt;\\\/p&gt;&lt;\\\/a&gt;&lt;a href=\\&quot;\\\/plugins\\\/salesforce-order-management-system\\\/authorization-reversal\\&quot; class=\\&quot;next-steps__step\\&quot; style=\\&quot;width:45%;\\&quot; target=\\&quot;_self\\&quot;&gt;&lt;div class=\\&quot;next-steps__title\\&quot;&gt;Enable Auhtorization Reversals&lt;\\\/div&gt;&lt;p class=\\&quot;next-steps__body\\&quot;&gt;&lt;p&gt;Handle situations where you need to reverse an authorization.&lt;\\\/p&gt;&lt;\\\/p&gt;&lt;\\\/a&gt;&lt;\\\/div&gt;\\n&quot;,&quot;33ff628eddc401060a8605fb907a336c&quot;:&quot;&lt;h2 id=\\&quot;requirements\\&quot;&gt;Requirements&lt;\\\/h2&gt;\\n&lt;p&gt;Before you begin, take into account the following requirements, limitations, and preparations.&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Requirement&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Integration type&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Make sure that you have a Salesforce Commerce Cloud (SFCC) storefront that uses the &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\&quot;&gt;Adyen payments cartridge&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;&lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\&quot;&gt;Webhooks&lt;\\\/a&gt;&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Subscribe to the Standard webhooks.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;strong&gt;Setup steps&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Before you begin: &lt;ul&gt;&lt;li&gt;Create a Salesforce OMS Org. &lt;\\\/li&gt;&lt;li&gt; Connect your SFCC storefront and OMS Org. Refer to &lt;a href=\\&quot;https:\\\/\\\/resources.docs.salesforce.com\\\/latest\\\/latest\\\/en-us\\\/sfdc\\\/pdf\\\/sfom_impl_b2ce.pdf\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;the documentation from Salesforce&lt;\\\/a&gt; to read more about connecting B2C Commerce and Order Management.&lt;\\\/li&gt;&lt;li&gt; &lt;a href=\\&quot;\\\/online-payments\\\/capture\\\/#enable-manual-capture\\&quot;&gt;Enable manual capture&lt;\\\/a&gt; in your Customer Area. &lt;\\\/li&gt;&lt;li&gt; Install the base dependent &lt;a href=\\&quot;https:\\\/\\\/appexchange.salesforce.com\\\/appxListingDetail?listingId=a0N3u00000PraxuEAB\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;&lt;code&gt;API Library Apex Adyen&lt;\\\/code&gt; package&lt;\\\/a&gt;  with the installation key &lt;strong&gt;Payments@Adyen&lt;\\\/strong&gt;.&lt;\\\/li&gt;&lt;\\\/ul&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;&quot;,&quot;7a247bf370f24b055fe5e40046b694ae&quot;:&quot;&lt;h2 id=\\&quot;set-up-webhooks\\&quot;&gt;Set up webhooks&lt;\\\/h2&gt;\\n&lt;p&gt;Adyen uses webhooks to send you updates on payment statuses. To enable receiving these webhooks:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#expose-salesforce-site-endpoint\\&quot;&gt;Expose a Salesforce site endpoint&lt;\\\/a&gt;. You need to expose different Salesforce site endpoints to receive default payment status updates, and updates related to payment modifications initiated from the Adyen Customer Area.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#configure-webhook\\&quot;&gt;Configure webhooks&lt;\\\/a&gt; in the Customer Area, for each of your Salesforce site endpoints.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#test-webhook\\&quot;&gt;Test your webhook configuration&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h3 id=\\&quot;expose-salesforce-site-endpoint\\&quot;&gt;Expose Salesforce site endpoints&lt;\\\/h3&gt;\\n&lt;h4&gt;Default webhooks&lt;\\\/h4&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;User Interface&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Sites and Domains&lt;\\\/strong&gt; - &lt;strong&gt;Sites&lt;\\\/strong&gt;, and then select &lt;strong&gt;Sites&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;New&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Enter a label, for example &lt;strong&gt;Adyen&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Enter a unique value for the default web address, for example &lt;code&gt;http:\\\/\\\/dev-myorganization--sandbox.cs17.force.com\\\/adyen&lt;\\\/code&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Active&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select an &lt;strong&gt;Active Site Home Page&lt;\\\/strong&gt;, for example, &lt;strong&gt;UnderConstruction&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Guest Access to the Payments API&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt; to save your changes and make sure the site is active.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&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;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Edit&lt;\\\/strong&gt; and enable the &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt; metadata type by moving it to the &lt;strong&gt;Enabled&lt;\\\/strong&gt; column.&lt;\\\/p&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;li&gt;\\n&lt;p&gt;Construct your webhook endpoint URL with:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The URL of your Salesforce site.&lt;\\\/li&gt;\\n&lt;li&gt;The &lt;a href=\\&quot;#get-payment-gateway-id\\&quot;&gt;Payment Gateway Provider ID&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;Save the endpoint URL in your system, you will need it when you &lt;a href=\\&quot;#configure-webhook\\&quot;&gt;configure webhooks in the Customer Area&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;h4 id=\\&quot;ca-modification-webhooks\\&quot;&gt;Webhooks for modifications initiated from the Customer Area&lt;\\\/h4&gt;\\n&lt;p&gt;Expose an additional Salesforce site endpoint to receive webhooks related to captures or refunds initiated from the Adyen Customer Area. Our OMS package creates a payment gateway log under the Salesforce Order Payment Summary. This lets you track the status of payments that are modified through the Customer Area.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your Salesforce OMS Org, go to &lt;strong&gt;Setup&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;User Interface&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Sites and Domains&lt;\\\/strong&gt; - &lt;strong&gt;Sites&lt;\\\/strong&gt;, and then select &lt;strong&gt;Sites&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;From the site list, select &lt;strong&gt;Adyen&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Public Access Settings&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Apps&lt;\\\/strong&gt;, select &lt;strong&gt;Apex Class Access&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Edit&lt;\\\/strong&gt;, and from the &lt;strong&gt;Available Apex Classes&lt;\\\/strong&gt; list, select &lt;strong&gt;adyen_payment.NonPaymentWebhookHandler&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Add&lt;\\\/strong&gt; to move it to the &lt;strong&gt;Enabled Apex Classes&lt;\\\/strong&gt; list.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;This exposes an additional site endpoint to receive webhooks:&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Webhook endpoint URL for captures and refunds&#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\\\\\\\/adyen\\\\\\\/services\\\\\\\/apexrest\\\\\\\/adyen_payment\\\\\\\/nonPaymentWebhook\\\\\\\/v1\\&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;h3 id=\\&quot;configure-webhook\\&quot;&gt;Configure webhooks in the Customer Area&lt;\\\/h3&gt;\\n&lt;p&gt;Configure webhooks for each of the Salesforce site endpoint URLs you exposed.&lt;\\\/p&gt;\\n&lt;p&gt;To configure a webhook:&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;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;We &lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/configure-and-manage\\&quot;&gt;recommend to configure webhooks for your company account&lt;\\\/a&gt;. This ensures that you do not have duplicate webhook configurations, and improves performance.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;i class=\\&quot;adl-icon-add\\&quot; role=\\&quot;img\\&quot; aria-label=\\&quot;add icon\\&quot;&gt;&lt;\\\/i&gt; &lt;strong&gt;Webhook&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;From the list of webhooks, next to &lt;strong&gt;Standard webhook&lt;\\\/strong&gt;, select &lt;strong&gt;Add&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;General&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Enabled&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Select the toggle to enable or disable the webhook.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Version&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The webhook version.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Description&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Your description of the webhook.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Merchant accounts&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;You can apply the webhook to all merchant accounts under a company account, or only to specific merchant accounts.&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;Under &lt;strong&gt;Server configuration&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;URL&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The webhook endpoint URL for either: &lt;br&gt; - &lt;a href=\\&quot;#default-webhooks\\&quot;&gt;Default webhooks&lt;\\\/a&gt; &lt;br&gt; - &lt;a href=\\&quot;#ca-modification-webhooks\\&quot;&gt;Webhooks for modifications initiated from the Customer Area&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Method&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;strong&gt;JSON&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Encryption protocol&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The latest &lt;strong&gt;TLS version&lt;\\\/strong&gt; in the list.&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;Under &lt;strong&gt;Security&lt;\\\/strong&gt;, configure the following:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Setting&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;HMAC Key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td&gt;&lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/secure-webhooks\\\/verify-hmac-signatures#enable-hmac-signatures\\&quot;&gt;Generate the HMAC Key&lt;\\\/a&gt;, copy it, and store it securely in your system. You need to enter the HMAC key when you &lt;a href=\\&quot;#configure-package-components\\&quot;&gt;configure package components&lt;\\\/a&gt;. &lt;br&gt; You only have to generate the HMAC key once, if you are setting up the second webhook, use the HMAC key that you already generated.&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;Under &lt;strong&gt;Events&lt;\\\/strong&gt;, in addition to the default events that are selected, select the following events:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;For &lt;a href=\\&quot;#default-webhooks\\&quot;&gt;default webhooks&lt;\\\/a&gt;, select &lt;strong&gt;CAPTURE&lt;\\\/strong&gt;, &lt;strong&gt;CAPTURE_FAILED&lt;\\\/strong&gt;, &lt;strong&gt;REFUND&lt;\\\/strong&gt;, and &lt;strong&gt;REFUND_FAILED&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;For &lt;a href=\\&quot;#ca-modification-webhooks\\&quot;&gt;webhooks for modifications initiated from the Customer Area&lt;\\\/a&gt;, select &lt;strong&gt;AUTHORISATION&lt;\\\/strong&gt;, &lt;strong&gt;CAPTURE&lt;\\\/strong&gt;, and &lt;strong&gt;REFUND&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&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;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;Rarely, a refund or capture can fail after you have received a &lt;strong&gt;REFUND&lt;\\\/strong&gt; or &lt;strong&gt;CAPTURE&lt;\\\/strong&gt; webhook with &lt;code&gt;success:&lt;\\\/code&gt; &lt;strong&gt;true&lt;\\\/strong&gt;. After a payment is processed in Salesforce, the status cannot be changed. Therefore, we recommend to monitor these cases in the &lt;code&gt;GatewayResultCode&lt;\\\/code&gt; field of the &lt;a href=\\&quot;https:\\\/\\\/developer.salesforce.com\\\/docs\\\/atlas.en-us.object_reference.meta\\\/object_reference\\\/sforce_api_objects_paymentgatewaylog.htm\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;PaymentGatewayLog&lt;\\\/a&gt; object in Salesforce. When a refund or capture fails, the &lt;code&gt;GatewayResultCode&lt;\\\/code&gt; is marked with &lt;strong&gt;CAPTURE_FAILED&lt;\\\/strong&gt;, or &lt;strong&gt;REFUND_FAILED&lt;\\\/strong&gt;. Learn more in our &lt;a href=\\&quot;\\\/online-payments\\\/capture#failed-capture\\&quot;&gt;Capture&lt;\\\/a&gt; and &lt;a href=\\&quot;\\\/online-payments\\\/refund#refund-failed\\&quot;&gt;Refund&lt;\\\/a&gt; documentation.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;h3 id=\\&quot;test-webhook\\&quot;&gt;Test your webhook configuration&lt;\\\/h3&gt;\\n&lt;p&gt;Before you can test your webhook configuration, you have to add your HMAC key in your &lt;a href=\\&quot;#configure-adyen-custom-metadata\\&quot;&gt;Salesforce custom metadata configuration&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&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; &amp;gt; &lt;strong&gt;Webhooks&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Next to &lt;strong&gt;Standard webhook&lt;\\\/strong&gt;, select the edit webhook icon &lt;i class=\\&quot;adl-icon-edit\\&quot;&gt;&lt;\\\/i&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Test Configuration&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;If you are on a &lt;a href=\\&quot;\\\/account\\\/account-structure#company-account\\&quot;&gt;company account&lt;\\\/a&gt;, select a &lt;strong&gt;Merchant account&lt;\\\/strong&gt; from the dropdown list.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Event&lt;\\\/strong&gt; dropdown list, select the &lt;a href=\\&quot;\\\/development-resources\\\/webhooks\\\/webhook-types#event-codes\\&quot;&gt;event code&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;If your webhook configuration is correct, it shows a &lt;a href=\\&quot;https:\\\/\\\/developer.mozilla.org\\\/en-US\\\/docs\\\/Web\\\/HTTP\\\/Status#successful_responses\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;successful HTTP response status code&lt;\\\/a&gt;, for example &lt;code&gt;ResponseCode&lt;\\\/code&gt;: &lt;strong&gt;200&lt;\\\/strong&gt;.&lt;\\\/p&gt;&quot;,&quot;a230d263af97d6ba6b787c71aa7f75ea&quot;:&quot;&lt;h2&gt;Configure capture settings&lt;\\\/h2&gt;\\n&lt;p&gt;With our OMS package, you can capture payments at any step in your order fulfillment flow. The steps you need to follow to configure captures in SFCC depends on your capture setting in the Adyen Customer Area:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;a href=\\&quot;\\\/online-payments\\\/capture\\\/#manual-capture\\&quot;&gt;\\n  &lt;strong&gt;Manual capture&lt;\\\/strong&gt;\\n&lt;\\\/a&gt;: you can capture payments from the OMS after they have been authorized.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;\\\/online-payments\\\/capture\\&quot;&gt;\\n  &lt;strong&gt;Automatic capture&lt;\\\/strong&gt;\\n&lt;\\\/a&gt;: payments are captured automatically after authorization. You do not have to manually capture payments from the OMS. Our OMS package handles the automatic captures without disrupting the payment flow. If you have set up automatic capture in your Customer Area, follow the steps to &lt;a href=\\&quot;#enable-automatic-captures\\&quot;&gt;enable automatic captures with OMS&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Regardless of your setting, payments for some payment methods are captured immediately after authorization. You must &lt;a href=\\&quot;#payment-methods-without-capture\\&quot;&gt;specify these payment methods&lt;\\\/a&gt; in your Salesforce Business Manager to prevent duplicate capture requests.&lt;\\\/p&gt;\\n&lt;h3 id=\\&quot;enable-automatic-captures\\&quot;&gt;Enable automatic captures&lt;\\\/h3&gt;\\n&lt;p&gt;To prevent OMS from making duplicate capture requests to Adyen when you have set up &lt;a href=\\&quot;\\\/online-payments\\\/capture\\&quot;&gt;automatic captures&lt;\\\/a&gt; in your Adyen Customer Area, follow the steps below.&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;Custom Code&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Custom Metadata Types&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Adyen Adapter&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Scroll down to &lt;strong&gt;Adyen Adapter Layout&lt;\\\/strong&gt;, and select &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Drag and drop the &lt;strong&gt;Auto Capture Enabled&lt;\\\/strong&gt; and &lt;strong&gt;Manual Capture Payment Methods&lt;\\\/strong&gt; fields to the &lt;strong&gt;Adyen Adapter Layout&lt;\\\/strong&gt;.&lt;\\\/p&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;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Manage Adyen Adapters&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Next to &lt;strong&gt;Adyen Default&lt;\\\/strong&gt;, select &lt;strong&gt;Edit&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select the checkbox next to &lt;strong&gt;Auto Capture Enabled&lt;\\\/strong&gt;.&lt;br \\\/&gt;\\nWhen you have set this up, OMS will process the payment record without an additional capture request, and the following payment gateway log will be created:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-text\\&quot;&gt;[capture-complete] Auto Capture enabled&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;For some payment methods, manual captures are required even when you have set up automatic captures in your Adyen Customer Area. In the &lt;strong&gt;Manual Capture Payment Methods&lt;\\\/strong&gt; field, specify the payment methods that require manual capture, using the &lt;a href=\\&quot;\\\/development-resources\\\/paymentmethodvariant\\\/\\&quot;&gt;\\n  &lt;code&gt;paymentMethodVariant&lt;\\\/code&gt;\\n&lt;\\\/a&gt; for each payment method. Separate each variant with a comma, for example:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-text\\&quot;&gt;klarna, klarna_account&lt;\\\/code&gt;&lt;\\\/pre&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;h3 id=\\&quot;payment-methods-without-capture\\&quot;&gt;Specify payments without separate captures in SFCC&lt;\\\/h3&gt;\\n&lt;p&gt;Payments for some payment methods are captured immediately after authorization regardless of your capture settings. You need to specify these payment methods that you enabled in the Adyen Customer Area in your Salesforce Business Manager. This prevents OMS from initiating duplicate capture requests.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\\/sfra\\\/set-up-the-cartridge\\\/?plugin=Salesforce%20SFRA&amp;amp;integration=cartridge&amp;amp;version=latest#set-up-the-business-manager\\&quot;&gt;Salesforce Business Manager&lt;\\\/a&gt;, go to &lt;strong&gt;Merchant Tools&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Site Preferences&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Adyen settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Local payment method settings&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;In the &lt;strong&gt;Payment methods without separate capture&lt;\\\/strong&gt; field, specify the payment methods that you added in your Customer Area. Separate each variant with a comma, for example:\\n&lt;pre&gt;&lt;code class=\\&quot;language-text\\&quot;&gt;ideal, paypal, applepay, visa_applepay, mc_applepay, amex_applepay, klarna_paynow, twint, sepadirectdebit, bcmc, wechatpay, multibanco, blik, mbway, pix, onlineBanking_PL&lt;\\\/code&gt;&lt;\\\/pre&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save Changes&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;3b733799f792d9a0ae5e7027723bfa40&quot;:&quot;&lt;h2 id=\\&quot;how-it-works\\&quot;&gt;How it works&lt;\\\/h2&gt;\\n&lt;p&gt;With our Salesforce OMS package, you handle captures and refunds for the payments of your &lt;a href=\\&quot;\\\/plugins\\\/salesforce-commerce-cloud\\&quot;&gt;Salesforce Commerce Cloud storefront&lt;\\\/a&gt;. The package keeps the Adyen and Salesforce systems in sync, so that you can seamlessly manage your order and payment flows.&lt;\\\/p&gt;\\n&lt;p&gt;To set up the package:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Follow the &lt;a href=\\&quot;#guided-configuration\\&quot;&gt;guided configuration&lt;\\\/a&gt; flow. Optionally, you can still &lt;a href=\\&quot;\\\/plugins\\\/salesforce-order-management-system\\\/install-and-set-up-the-package\\\/manual-setup\\&quot;&gt;set up the package manually&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;After you have set up the package, &lt;a href=\\&quot;#configure-capture-settings\\&quot;&gt;configure capture settings&lt;\\\/a&gt; to make sure your &lt;a href=\\&quot;\\\/plugins\\\/salesforce-order-management-system\\\/order-status-lifecycle\\&quot;&gt;order status lifecycle&lt;\\\/a&gt; runs as expected.&lt;\\\/li&gt;\\n&lt;li&gt;When you are ready to go-live, follow the &lt;a href=\\&quot;#go-live\\&quot;&gt;steps to go-live&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;,&quot;4b449421a5bd0cca78b59e3f94e512db&quot;:&quot;&lt;h2 id=\\&quot;guided-configuration\\&quot;&gt;Follow the guided configuration&lt;\\\/h2&gt;\\n&lt;p&gt;From v3.3.0 onwards, the Salesforce OMS package includes a guided configuration.&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Open your Salesforce OMS.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;App Launcher&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Adyen Config Page&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Follow the on-screen steps to complete the setup.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&quot;}}}}}}\"\n        query-param-tab=\"plugin\"\n        query-param-box=\"integration\"\n        query-param-dropdown=\"version\">\n    <\/in-page-filtering>\n<\/div>\n<div class=\"version_docs__image-placeholder u-display-none\">\n    <\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-order-management-system\/install-and-set-up-the-package","articleFields":{"description":"Learn how to install and set up your Adyen Salesforce OMS package. ","feedback_component":true,"filters_component":true,"filters_config_folder":"salesforce-order-management","dynamic_minitoc":true,"dynamic_minitoc_context":".in-page-filtering--content","page_id":"d1ee3df2-5f1f-4036-8000-0a436a8b5551","last_edit_on":"12-12-2023 16:56","decision_tree":"[]"},"algolia":[{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-order-management-system\/install-and-set-up-the-package","title":"Install and set up the Salesforce OMS package","content":"Requirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have a Salesforce Commerce Cloud (SFCC) storefront that uses the Adyen payments cartridge.\n\n\nWebhooks\nSubscribe to the Standard webhooks.\n\n\nSetup steps\nBefore you begin: Create a Salesforce OMS Org.  Connect your SFCC storefront and OMS Org. Refer to the documentation from Salesforce to read more about connecting B2C Commerce and Order Management. Enable manual capture in your Customer Area.  Install the base dependent API Library Apex Adyen package  with the installation key Payments@Adyen.\n\n\nHow it works\nWith our Salesforce OMS package, you handle captures and refunds for the payments of your Salesforce Commerce Cloud storefront. The package keeps the Adyen and Salesforce systems in sync, so that you can seamlessly manage your order and payment flows.\nTo set up the package:\n\nFollow the guided configuration flow. Optionally, you can still set up the package manually.\nAfter you have set up the package, configure capture settings to make sure your order status lifecycle runs as expected.\nWhen you are ready to go-live, follow the steps to go-live.\nInstall the app\n\nIn your Salesforce OMS Org, enable multiple currencies.\nInstall the Adyen Payments for Salesforce Order Management (SOM) app with the installation key Payments@Adyen.\nFollow the instructions on the Salesforce Application Installation Guide.\nFollow the guided configuration\nFrom v3.3.0 onwards, the Salesforce OMS package includes a guided configuration.\n\nOpen your Salesforce OMS.\nGo to App Launcher &gt; Adyen Config Page.\nFollow the on-screen steps to complete the setup.\nConfigure capture settings\nWith our OMS package, you can capture payments at any step in your order fulfillment flow. The steps you need to follow to configure captures in SFCC depends on your capture setting in the Adyen Customer Area:\n\n\n  Manual capture\n: you can capture payments from the OMS after they have been authorized.\n\n  Automatic capture\n: payments are captured automatically after authorization. You do not have to manually capture payments from the OMS. Our OMS package handles the automatic captures without disrupting the payment flow. If you have set up automatic capture in your Customer Area, follow the steps to enable automatic captures with OMS.\n\nRegardless of your setting, payments for some payment methods are captured immediately after authorization. You must specify these payment methods in your Salesforce Business Manager to prevent duplicate capture requests.\nEnable automatic captures\nTo prevent OMS from making duplicate capture requests to Adyen when you have set up automatic captures in your Adyen Customer Area, follow the steps below.\n\n\nIn your Salesforce OMS Org, go to Setup &gt; Custom Code &gt; Custom Metadata Types.\n\n\nSelect Adyen Adapter.\n\n\nScroll down to Adyen Adapter Layout, and select Edit.\n\n\nDrag and drop the Auto Capture Enabled and Manual Capture Payment Methods fields to the Adyen Adapter Layout.\n\n\nSelect Save.\n\n\nSelect Manage Adyen Adapters.\n\n\nNext to Adyen Default, select Edit.\n\n\nSelect the checkbox next to Auto Capture Enabled.\nWhen you have set this up, OMS will process the payment record without an additional capture request, and the following payment gateway log will be created:\n[capture-complete] Auto Capture enabled\n\n\nFor some payment methods, manual captures are required even when you have set up automatic captures in your Adyen Customer Area. In the Manual Capture Payment Methods field, specify the payment methods that require manual capture, using the \n  paymentMethodVariant\n for each payment method. Separate each variant with a comma, for example:\nklarna, klarna_account\n\n\nSelect Save.\n\n\nSpecify payments without separate captures in SFCC\nPayments for some payment methods are captured immediately after authorization regardless of your capture settings. You need to specify these payment methods that you enabled in the Adyen Customer Area in your Salesforce Business Manager. This prevents OMS from initiating duplicate capture requests.\n\nIn your Salesforce Business Manager, go to Merchant Tools &gt; Site Preferences &gt; Adyen settings &gt; Local payment method settings.\nIn the Payment methods without separate capture field, specify the payment methods that you added in your Customer Area. Separate each variant with a comma, for example:\nideal, paypal, applepay, visa_applepay, mc_applepay, amex_applepay, klarna_paynow, twint, sepadirectdebit, bcmc, wechatpay, multibanco, blik, mbway, pix, onlineBanking_PL\nSelect Save Changes.\nGo live\nWhen you are ready to go live, apply for a live account. Review the process to start accepting payments on Get started with Adyen.\nWhen you get your live account:\n\nFollow our SFCC go-live checklist. You do not need to follow the steps to configure the SFCC Business Manager in the checklist.\nUpdate the Adyen credentials you used to set up your Salesforce OMS Org:\n\nIn the custom metadata record:\n\nUpdate your HMAC key.\nIf you are using a different merchant account in the live environment, update the merchant account name.\n\n\nSwitch the URL for the Adyen Checkout named credential to your live URL:\n\nIn your OMS Org, go to Setup &gt; Security &gt; Named Credentials.\nSelect the Adyen Checkout named credential.\nReplace the test URL with https:\/\/[YOUR_LIVE_PREFIX]-checkout-live.adyenpayments.com\/checkout. Get your live prefix from the live Customer Area.\n\nSwitch your test API key to your live API Key:\n\nSelect the External Credential linked to your Adyen Checkout named credential.\nUnder Principals, update your API key authentication parameter to your live API key.\n\nNext steps\n\nSet up Order on Behalf OfEnable your customer service employees to place orders on behalf of shoppers.Enable Auhtorization ReversalsHandle situations where you need to reverse an authorization.\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Salesforce Order Management System","lvl3":"Install and set up the Salesforce OMS package"},"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\/install-and-set-up-the-package"},"levels":4,"category":"Plugins","category_color":"green","tags":["Install","Salesforce","package"]},{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/salesforce-order-management-system\/install-and-set-up-the-package?plugin=Salesforce OMS&integration=package","title":"Salesforce OMS package","content":"Requirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have a Salesforce Commerce Cloud (SFCC) storefront that uses the Adyen payments cartridge.\n\n\nWebhooks\nSubscribe to the Standard webhooks.\n\n\nSetup steps\nBefore you begin: Create a Salesforce OMS Org.  Connect your SFCC storefront and OMS Org. Refer to the documentation from Salesforce to read more about connecting B2C Commerce and Order Management. Enable manual capture in your Customer Area.  Install the base dependent API Library Apex Adyen package  with the installation key Payments@Adyen.\n\n\nHow it works\nWith our Salesforce OMS package, you handle captures and refunds for the payments of your Salesforce Commerce Cloud storefront. The package keeps the Adyen and Salesforce systems in sync, so that you can seamlessly manage your order and payment flows.\nTo set up the package:\n\nFollow the guided configuration flow. Optionally, you can still set up the package manually.\nAfter you have set up the package, configure capture settings to make sure your order status lifecycle runs as expected.\nWhen you are ready to go-live, follow the steps to go-live.\nInstall the app\n\nIn your Salesforce OMS Org, enable multiple currencies.\nInstall the Adyen Payments for Salesforce Order Management (SOM) app with the installation key Payments@Adyen.\nFollow the instructions on the Salesforce Application Installation Guide.\nFollow the guided configuration\nFrom v3.3.0 onwards, the Salesforce OMS package includes a guided configuration.\n\nOpen your Salesforce OMS.\nGo to App Launcher &gt; Adyen Config Page.\nFollow the on-screen steps to complete the setup.\nConfigure capture settings\nWith our OMS package, you can capture payments at any step in your order fulfillment flow. The steps you need to follow to configure captures in SFCC depends on your capture setting in the Adyen Customer Area:\n\n\n  Manual capture\n: you can capture payments from the OMS after they have been authorized.\n\n  Automatic capture\n: payments are captured automatically after authorization. You do not have to manually capture payments from the OMS. Our OMS package handles the automatic captures without disrupting the payment flow. If you have set up automatic capture in your Customer Area, follow the steps to enable automatic captures with OMS.\n\nRegardless of your setting, payments for some payment methods are captured immediately after authorization. You must specify these payment methods in your Salesforce Business Manager to prevent duplicate capture requests.\nEnable automatic captures\nTo prevent OMS from making duplicate capture requests to Adyen when you have set up automatic captures in your Adyen Customer Area, follow the steps below.\n\n\nIn your Salesforce OMS Org, go to Setup &gt; Custom Code &gt; Custom Metadata Types.\n\n\nSelect Adyen Adapter.\n\n\nScroll down to Adyen Adapter Layout, and select Edit.\n\n\nDrag and drop the Auto Capture Enabled and Manual Capture Payment Methods fields to the Adyen Adapter Layout.\n\n\nSelect Save.\n\n\nSelect Manage Adyen Adapters.\n\n\nNext to Adyen Default, select Edit.\n\n\nSelect the checkbox next to Auto Capture Enabled.\nWhen you have set this up, OMS will process the payment record without an additional capture request, and the following payment gateway log will be created:\n[capture-complete] Auto Capture enabled\n\n\nFor some payment methods, manual captures are required even when you have set up automatic captures in your Adyen Customer Area. In the Manual Capture Payment Methods field, specify the payment methods that require manual capture, using the \n  paymentMethodVariant\n for each payment method. Separate each variant with a comma, for example:\nklarna, klarna_account\n\n\nSelect Save.\n\n\nSpecify payments without separate captures in SFCC\nPayments for some payment methods are captured immediately after authorization regardless of your capture settings. You need to specify these payment methods that you enabled in the Adyen Customer Area in your Salesforce Business Manager. This prevents OMS from initiating duplicate capture requests.\n\nIn your Salesforce Business Manager, go to Merchant Tools &gt; Site Preferences &gt; Adyen settings &gt; Local payment method settings.\nIn the Payment methods without separate capture field, specify the payment methods that you added in your Customer Area. Separate each variant with a comma, for example:\nideal, paypal, applepay, visa_applepay, mc_applepay, amex_applepay, klarna_paynow, twint, sepadirectdebit, bcmc, wechatpay, multibanco, blik, mbway, pix, onlineBanking_PL\nSelect Save Changes.\nGo live\nWhen you are ready to go live, apply for a live account. Review the process to start accepting payments on Get started with Adyen.\nWhen you get your live account:\n\nFollow our SFCC go-live checklist. You do not need to follow the steps to configure the SFCC Business Manager in the checklist.\nUpdate the Adyen credentials you used to set up your Salesforce OMS Org:\n\nIn the custom metadata record:\n\nUpdate your HMAC key.\nIf you are using a different merchant account in the live environment, update the merchant account name.\n\n\nSwitch the URL for the Adyen Checkout named credential to your live URL:\n\nIn your OMS Org, go to Setup &gt; Security &gt; Named Credentials.\nSelect the Adyen Checkout named credential.\nReplace the test URL with https:\/\/[YOUR_LIVE_PREFIX]-checkout-live.adyenpayments.com\/checkout. Get your live prefix from the live Customer Area.\n\nSwitch your test API key to your live API Key:\n\nSelect the External Credential linked to your Adyen Checkout named credential.\nUnder Principals, update your API key authentication parameter to your live API key.\n\nNext steps\n\nSet up Order on Behalf OfEnable your customer service employees to place orders on behalf of shoppers.Enable Auhtorization ReversalsHandle situations where you need to reverse an authorization.\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Salesforce Order Management System","lvl3":"Install and set up the Salesforce OMS package"},"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\/install-and-set-up-the-package"},"levels":4,"category":"Plugins","category_color":"green","tags":["Salesforce OMS","package"]}]}