{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"Adobe Commerce Integration","description":"Integrate Finix with Adobe Commerce (Magento) to accept card transactions via our Cybersource Gateway integration.","siteUrl":"https://docs.finix.com/","llmstxt":{"hide":false,"sections":[{"title":"Getting Started","includeFiles":["guides/getting-started/**/*.md"],"excludeFiles":[]},{"title":"Online Payments","includeFiles":["guides/online-payments/**/*.md"],"excludeFiles":["guides/online-payments/payment-features/fsa-hsa-non-healthcare-mcc.md"]},{"title":"In-Person Payments","includeFiles":["guides/in-person-payments/**/*.md"],"excludeFiles":[]},{"title":"Subscriptions","includeFiles":["guides/subscriptions/**/*.md"],"excludeFiles":[]},{"title":"After the Payment","includeFiles":["guides/subscriptions/after-the-payment/**/*.md"],"excludeFiles":[]},{"title":"Managing Operations","includeFiles":["guides/managing-operations/**/*.md"],"excludeFiles":[]},{"title":"Platform Payments","includeFiles":["guides/platform-payments/**/*.md"],"excludeFiles":[]},{"title":"Payouts","includeFiles":["guides/payouts/**/*.md"],"excludeFiles":[]},{"title":"Developers","includeFiles":["additional-resources/developers/**/*.md"],"excludeFiles":[]},{"title":"Plugins","includeFiles":["additional-resources/plugins/**/*.md"],"excludeFiles":[]},{"title":"Industry Considerations","includeFiles":["guides/industry-considerations/**/*.md"],"excludeFiles":[]},{"title":"Regional Considerations","includeFiles":["guides/regional-considerations/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"adobe-commerce","__idx":0},"children":["Adobe Commerce"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accept payments with Finix on ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://business.adobe.com/products/magento/magento-commerce.html"},"children":["Adobe Commerce"]}," (formerly Magento)."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/cybersource-adobe-commerce-logo.7b777e86a363c41212f6d4bc677ae6a0e991b39832c2672b5fda4d8143d1970b.a7b6f700.png","alt":"Adobe Commerce","withLightbox":false,"style":"width: 700px"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"adobe-commerce-overview","__idx":1},"children":["Adobe Commerce Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adobe Commerce (formerly Magento) is an enterprise-grade eCommerce platform used by mid-market and Fortune 1000 retailers. It supports both cloud-hosted (Adobe Commerce Cloud) and self-hosted (Magento Open Source) deployments, with a flexible extension marketplace and headless storefront capabilities. Finix integrates with Adobe Commerce through the Cybersource payment gateway, enabling merchants to accept card payments directly within their storefront checkout."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"finix-requirements","__idx":2},"children":["Finix Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Finix Live Account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Active Adobe Commerce store (Adobe Commerce Cloud or Magento Open Source)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration","__idx":3},"children":["Integration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-sign-up-for-a-finix-account","__idx":4},"children":["Step 1: Sign up for a Finix Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a Finix account, you can follow our step-by-step ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/getting-started/finix-sign-up"},"children":["guide"]}," or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://finix.payments-dashboard.com"},"children":["sign up"]}," directly for a live or sandbox account."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":""},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend choosing Direct Merchant as your Customer Type."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-create-a-cybersource-gateway-integration","__idx":5},"children":["Step 2: Create a Cybersource Gateway Integration"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Cybersource Integration"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Finix supports Adobe Commerce via our Cybersource Gateway integration. Please note that there is an additional fee for using our Cybersource integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, please reach out to your Finix point of contact."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To create a Cybersource integration, navigate to the Integrations page on your Finix Dashboard."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/company-integrations-tab-direct-merchant.122c2c1c825f4eae56179fbbab7dccd64e2a27d406350be889d295ab1b71122a.08ff7529.png","alt":"Cybersource Merchant Integrations","withLightbox":false,"style":"width: 100%; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign up for Cybersource. You can view detailed instructions in our guide, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource#creating-a-cybersource-integration-using-the-dashboard"},"children":["here"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After accepting the Cybersource invitation email, retrieve the following credentials from the Cybersource Business Center under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Configuration → Key Management"]}," — you'll need these to configure Adobe Commerce:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant ID"]}," (also called Organization ID)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST API Keys"]}," (required for Microform checkout)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SOAP Keys"]}," (required for all other integrations)"]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/cybersource-key-management.8ca4ad79eaed0ff8320a9a6c38bac88625381127fb749b31f80a4ec6c4f5b99b.08ff7529.png","alt":"Cybersource Key Management","withLightbox":false,"style":"width: 100%; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-set-up-your-adobe-commerce-store","__idx":6},"children":["Step 3: Set Up Your Adobe Commerce Store"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before proceeding, ensure your Adobe Commerce environment is ready:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A working instance of Adobe Commerce or Magento. Learn more with Adobe's ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://experienceleague.adobe.com/en/docs/commerce-admin/start/guide-overview"},"children":["Getting Started Guide"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set up your Adobe Commerce Marketplace account and generate ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://experienceleague.adobe.com/en/docs/commerce-admin/start/resources/commerce-marketplace#create-an-access-key"},"children":["Access Keys"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-install-the-cybersource-extension","__idx":7},"children":["Step 4: Install the Cybersource Extension"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you proceed, ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Approved Finix Merchant Account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cybersource Gateway Integration linked to your Finix Merchant Account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adobe Commerce Account & Adobe Commerce Marketplace Access Keys"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To install the extension:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://commercemarketplace.adobe.com/cybersource-global-payment-management.html"},"children":["Cybersource Payment Management Platform"]}," on the Adobe Commerce Marketplace."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your Adobe Commerce edition and version (2.4), then complete checkout to add it to your account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your Magento root directory, rename ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auth.json.sample"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auth.json"]}," and populate it with your Marketplace Public and Private Keys:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"http-basic\": {\n    \"repo.magento.com\": {\n      \"username\": \"Your_Public_Key\",\n      \"password\": \"Your_Private_Key\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run the following Composer commands to install the extension and its dependencies:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"composer require cybersource/global-payment-management\ncomposer require cybersource/module-recaptcha\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable all Cybersource modules:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"php bin/magento module:enable CyberSource_AccountUpdater CyberSource_Core CyberSource_ApplePay CyberSource_Atp CyberSource_BankTransfer CyberSource_SecureAcceptance CyberSource_ECheck CyberSource_GooglePay CyberSource_KlarnaFinancial CyberSource_VisaCheckout CyberSource_Address CyberSource_Tax CyberSource_ThreeDSecure CyberSource_PayPal CyberSource_WeChatPay CyberSource_Recaptcha\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run the post-installation commands to compile, reindex, and clear caches:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"php bin/magento setup:upgrade\nphp bin/magento setup:di:compile\nphp bin/magento setup:static-content:deploy -f\nphp bin/magento indexer:reindex\nphp bin/magento cache:clean\nphp bin/magento cache:flush\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For full installation details, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.cybersource.com/technology-partners/adobe-commerce.html"},"children":["Cybersource Adobe Commerce developer documentation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-configure-adobe-commerce","__idx":8},"children":["Step 5: Configure Adobe Commerce"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your Adobe Commerce admin, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stores → Configuration → Sales → Payment Methods"]}," and locate the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cybersource"]}," section."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under Webservice Configurations, enter:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant ID — your Cybersource Organization ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set Test Mode to Yes for sandbox or No for production"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your REST API or SOAP credentials."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under Credit Card Settings:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set Enable to Yes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set Payment API to SOAP Toolkit"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set Checkout Flow to Flex Microform"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable the card brands and payment methods you want to offer."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After configuring your payment methods, you can now take payments through Finix via our Cybersource Gateway Integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn more about our Cybersource Gateway Integration, you can read our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource"},"children":["guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need additional assistance contact ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@finix.com"},"children":["support@finix.com"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"adobe-commerce-transactions","__idx":9},"children":["Adobe Commerce Transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you run a transaction on Adobe Commerce, you can locate it:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your Adobe Commerce admin under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sales"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Orders"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Cybersource Business Center."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your Finix Dashboard under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payments"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These transactions will be ingested by Finix and added to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Settlements"]},". To track transfers between Finix and Cybersource, please refer to our guide, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource#locating-cybersource-transactions"},"children":["here"]},"."]}]},"headings":[{"value":"Adobe Commerce","id":"adobe-commerce","depth":1},{"value":"Adobe Commerce Overview","id":"adobe-commerce-overview","depth":2},{"value":"Finix Requirements","id":"finix-requirements","depth":3},{"value":"Integration","id":"integration","depth":2},{"value":"Step 1: Sign up for a Finix Account","id":"step-1-sign-up-for-a-finix-account","depth":3},{"value":"Step 2: Create a Cybersource Gateway Integration","id":"step-2-create-a-cybersource-gateway-integration","depth":3},{"value":"Step 3: Set Up Your Adobe Commerce Store","id":"step-3-set-up-your-adobe-commerce-store","depth":3},{"value":"Step 4: Install the Cybersource Extension","id":"step-4-install-the-cybersource-extension","depth":3},{"value":"Step 5: Configure Adobe Commerce","id":"step-5-configure-adobe-commerce","depth":3},{"value":"Adobe Commerce Transactions","id":"adobe-commerce-transactions","depth":2}],"frontmatter":{"seo":{"title":"Adobe Commerce Integration","description":"Integrate Finix with Adobe Commerce (Magento) to accept card transactions via our Cybersource Gateway integration."},"keywords":{"includes":["adobe commerce","magento"]}},"lastModified":"2026-06-17T22:42:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/additional-resources/plugins/adobe-commerce-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}