{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"VTEX Integration","description":"Integrate Finix with VTEX 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":"vtex","__idx":0},"children":["VTEX"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accept payments with Finix on ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://vtex.com"},"children":["VTEX"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/vtex-logo.bdd965f1da4b95c5fffa7f17851869d5611c1692b5ac1f8db0b3fdbb3c15ff5d.a7b6f700.png","alt":"VTEX","withLightbox":false,"style":"width: 800px; height: auto"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"vtex-overview","__idx":1},"children":["VTEX Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VTEX is a global composable commerce platform built for enterprise retail. It provides a unified suite of tools spanning storefront, order management, marketplace, and fulfillment — enabling brands to deliver consistent commerce experiences across digital and physical channels. Serving over 3,200 enterprise customers, with especially strong adoption in Latin America, VTEX is trusted by some of the world's leading brands for complex B2C and B2B operations. Finix integrates with VTEX through the Cybersource payment gateway, enabling merchants to process payments and reconcile transaction data within their VTEX environment."]},{"$$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 VTEX account"]}]},{"$$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 VTEX 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/direct_merchant_integration_tab.e40b62fd3a5e39d86b2f89d2bf8f7474bcdd6785f5e5807355d8ee1230ac9de8.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 VTEX:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant ID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST API Key"]}]}]}]}]},{"$$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-install-the-cybersource-apps-in-vtex","__idx":6},"children":["Step 3: Install the Cybersource Apps in VTEX"]},{"$$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":["Cybersource credentials from Step 2"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Administrator access to your VTEX account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["VTEX IO CLI installed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For full installation details, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.vtex.com/docs/tutorials/setting-up-cybersource-gateway"},"children":["VTEX Cybersource Gateway setup guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using the VTEX IO CLI, install the following required Cybersource apps:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vtex.cybersource-ui"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vtex.cybersource"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vtex.cybersource-payer-auth"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-configure-the-cybersource-app","__idx":7},"children":["Step 4: Configure the Cybersource App"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your VTEX Admin, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apps → Installed Apps → Cybersource"]}," and enter the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant ID"]}," — your Cybersource Merchant ID from Step 2"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Key"]}," — your REST Shared Secret Key ID from Step 2"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shared Secret Key"]}," — your REST Shared Secret from Step 2"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processor"]}," — select your processor"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Region"]}," — select your region"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/vtex-cybersource-app-config.705cdeb83c1a4111184a8b8f520b1f231b79fff95fee1bc9f6f0b193d1519bbf.08ff7529.png","alt":"VTEX Cybersource App Configuration","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-5-configure-the-gateway-provider-and-payment-conditions","__idx":8},"children":["Step 5: Configure the Gateway Provider and Payment Conditions"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your VTEX Admin, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Store Settings → Payment → Providers"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New Provider"]},", search for, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cybersource IO"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":""},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Leave the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App key"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App token"]}," fields blank on this screen. Also leave ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant ID"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Key"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shared Secret Key"]}," blank here — these are configured in the app settings in Step 4, not the provider screen."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capture Setting"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer Authentication"]}," options as needed, then save."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Store Settings → Payment → Settings"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Conditions"]},", select your credit card type, and enter a condition name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Process with provider"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cybersource - IO"]}," and activate the condition."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the configuration."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After completing configuration, 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":"vtex-transactions","__idx":9},"children":["VTEX Transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you run a transaction on VTEX, you'll see it:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your VTEX Admin under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Orders → All 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":"VTEX","id":"vtex","depth":1},{"value":"VTEX Overview","id":"vtex-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: Install the Cybersource Apps in VTEX","id":"step-3-install-the-cybersource-apps-in-vtex","depth":3},{"value":"Step 4: Configure the Cybersource App","id":"step-4-configure-the-cybersource-app","depth":3},{"value":"Step 5: Configure the Gateway Provider and Payment Conditions","id":"step-5-configure-the-gateway-provider-and-payment-conditions","depth":3},{"value":"VTEX Transactions","id":"vtex-transactions","depth":2}],"frontmatter":{"seo":{"title":"VTEX Integration","description":"Integrate Finix with VTEX to accept card transactions via our Cybersource Gateway integration."},"keywords":{"includes":["vtex"]}},"lastModified":"2026-05-14T20:16:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/additional-resources/plugins/vtex-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}