Magento (Adobe Commerce) Payment Integration: Stripe, PayPal and Gateways

Published: Nov 6, 2026 Author: Itexus Team Read 13 min
Have a project in mind? Let’s turn it into a working product
Discuss Your Project

Every Magento store needs a way to take money, and the choice of payment integration decides more than which card logos appear at checkout. It decides how orders move from Pending Payment to Processing, where invoices and credit memos come from, how refunds reach the customer, and how much work finance does at month end to match payouts against orders. Merchants on Magento Open Source and Adobe Commerce usually face the same question: use what ships with the platform, install a provider's module such as Stripe's, or build something of their own.

This guide covers what a Magento payment integration actually syncs, the real options (Adobe's own Payment Services, the bundled PayPal and Braintree methods, provider modules such as Stripe, and custom gateway work through the APIs), how to set up the most common path, the problems that show up in production, what it costs, and when a custom build is worth it. Platform facts come from Adobe's and Stripe's own documentation as it reads in November 2026.

What a Magento Payment Integration Syncs

A payment integration in Magento is not only a checkout form. It ties a set of Magento sales documents to records in the payment provider, and keeps them in step in both directions.

Magento object Provider record Direction
Order (status, payment information) Payment or payment intent, authorization Magento creates, provider confirms back
Invoice Capture of the authorized amount Magento to provider, or provider to Magento on full capture
Credit memo Refund Either side, with limits on partial refunds
Customer and saved payment method Vaulted card or wallet token Provider holds the card data, Magento stores a reference
Fraud review status Risk score or fraud decision Provider to Magento (order placed On Hold)
Subscription orders Recurring billing records Provider to Magento through webhooks
Payouts, fees, balances Settlement and payout reports Stay in the provider unless you add reporting or an accounting sync

Some concrete examples from the vendors' docs:

  • Captures and invoices. In Stripe's module, Authorize Only mode places a hold on the card, and you capture the amount later by issuing an invoice in the Magento admin. Braintree for Adobe Commerce offers the same split between Authorize Only and Intent Sale (authorize and withdraw at once).
  • Webhooks. Stripe's documentation says webhooks update Magento orders when a customer's bank confirms or declines a payment or when subscription payments are collected, so the module can mark orders ready for fulfilment, record refunds against them, or add comments about payment failure reasons.
  • Refunds. Since version 4.1 of Stripe's module, only full captures and full refunds made in the Stripe Dashboard create invoices or credit memos in Magento automatically. Partial captures and refunds should be done from the Magento admin so the tax breakdown on the documents stays correct.
  • Reporting. Adobe's Payment Services syncs payment details with orders and gives visibility into processed volume, payment balance, payouts and transaction-level reporting for financial reconciliation.

What a standard module does not do is post fees, payouts and refunds to your general ledger. That is a separate accounting integration, covered in our guide to Stripe and QuickBooks integration.

Integration Options

Adobe Payment Services and the bundled methods

Adobe's documentation lists Payment Services first among its recommended online methods for Adobe Commerce and Magento Open Source, alongside PayPal Express Checkout and Braintree. Adobe describes it as a "turnkey self-service solution, including sandbox testing and a simple setup", available out of the box since version 2.4.7. It covers card fields, digital wallets and PayPal products, and it is the default payments solution in Adobe Commerce as a Cloud Service.

Beside it, Adobe's payment methods page lists PayPal Express Checkout, the PayPal all-in-one solutions (Payments Advanced, Payments Pro, Payments Standard), the PayPal Payflow Pro and Payflow Link gateways, and Braintree, which Adobe calls a "bundled vendor-developed extension" (the Braintree page names GENE Commerce as the developer). There are also offline methods: Check or Money Order, Bank Transfer, Cash On Delivery, Purchase Order, Zero Subtotal Checkout, and Payment on Account for Adobe Commerce B2B.

Adobe notes that some former bundled methods moved out of the core: Amazon Pay and Klarna were bundled in 2.4.0 to 2.4.3 and became Commerce Marketplace extensions in 2.4.4, and Signifyd fraud protection was removed in 2.4.0 in favor of its own extension.

Provider modules (Stripe and others)

Stripe publishes two plugins for Adobe Commerce and Magento Open Source: the Stripe Payments, Billing, and Tax plugin, and a Stripe Tax plugin for stores that calculate tax with Stripe but take payments elsewhere. The payments module supports Adobe Commerce 2.3.7 to 2.4.x, according to Stripe's lifecycle table.

It offers two checkout flows: the Payment Element embedded in the Magento checkout (Stripe's recommendation) or a redirect to the Stripe-hosted Checkout page. Stripe says both are SAQ-A eligible, which reduces PCI scope. Payment methods are switched on in the Stripe Dashboard rather than in code, and the list covers cards, Apple Pay, Google Pay, Link, ACH and SEPA debits, iDEAL, Bancontact, buy now pay later methods such as Klarna, Affirm and Afterpay/Clearpay, vouchers and bank transfers. The module also includes a subscription engine with trials and initial fees, and it is SCA-ready with 3D Secure 2.

Other gateways and processors publish their own Magento extensions on the Commerce Marketplace. Check each one against the versions you run and whether the vendor or a third party maintains it.

Custom integration through the APIs

When no module fits, a developer writes a payment method module against Magento's payment framework and the provider's API. That is the route for a regional acquirer with no Magento extension, a bank's own gateway, a headless storefront with unusual flows, or a store that has to route payments across several processors. Stripe's module already includes a GraphQL option for custom storefronts, so headless alone does not force a custom build.

Option Best for Limits Cost basis
Adobe Payment Services Stores on 2.4.7+ that want cards, wallets and PayPal in one place with payout reporting Feature availability varies by market (Adobe points to its compatibility page) Not published on Adobe's introduction page
Bundled PayPal and Braintree Merchants already using PayPal or Braintree accounts Settings and labels differ by method; some local methods unsupported (Braintree page: SEPA/ELV not yet supported) Provider's transaction fees
Stripe module Wide payment method coverage, subscriptions, Stripe Tax, Radar fraud rules Partial captures and refunds belong in Magento admin; IC+ features need Stripe's IC+ pricing Stripe's published processing fees
Custom module or middleware Unsupported gateways, multi-processor routing, special reconciliation Build and maintenance effort, PCI scope depends on design Development time

How to Set Up Stripe on Magento

The query people search most is Magento Stripe integration, so here are the steps from Stripe's own install and configuration docs. Stripe recommends testing the module before installing it in production.

Install the module

  1. Order the Stripe module through the Adobe Commerce Marketplace (Stripe's recommended route). A raw package from Stripe is the alternative.
  2. In your Magento directory, run composer require stripe/stripe-payments and provide your Adobe Commerce authentication keys when Composer asks.
  3. Run setup:upgrade and flush the cache. In production mode, also run setup:di:compile and setup:static-content:deploy.

Get your keys

  1. Install the Adobe Commerce app from the Stripe App Marketplace, in a sandbox or in live mode. It generates a publishable key and a restricted secret key for this integration, so you do not have to use your main secret key.
  2. Store the keys somewhere safe.

Configure the payment method

  1. In the Magento admin, go to Stores, Configuration, Sales, Payment Methods. Stripe appears at checkout only after the API keys are set.
  2. Set Mode to sandbox first, then enter the test and live keys.
  3. Choose the payment flow (embedded Payment Element or redirect to Stripe Checkout) and the form layout.
  4. Pick a Payment Action: Authorize and Capture charges right away; Authorize Only holds the amount until you invoice; Order saves the payment method and collects later by invoice.
  5. Decide on Hold Elevated Risk Orders (orders that Radar flags as elevated risk go On Hold), saving payment methods, receipt emails and the statement descriptor.
  6. Select a payment method configuration per store view if different stores need different methods.
  7. Turn on Express Checkout (Link, Apple Pay, Google Pay) and choose the pages where the wallet buttons appear.

Webhooks and testing

  1. Since version 3.0.0, the module configures webhooks itself on setup:upgrade, whenever API keys or store URLs change, and in an hourly check. It creates one webhook endpoint per Stripe account and verifies webhook signatures.
  2. Place test orders with Stripe's test cards, including 3D Secure cards, and check that orders move from Pending Payment to Processing, invoices appear, and refunds create credit memos.
  3. Switch to live mode.

If you choose Braintree instead

Adobe's Braintree page follows a similar pattern: get credentials from Braintree, go to Stores, Configuration, Sales, Payment Methods, confirm the Merchant Country, set the Environment to Sandbox or Production, enter the Merchant ID, Public Key and Private Key, click Validate Credentials, then enable the methods you need (cards, PayPal, Venmo, Apple Pay with domain verification, Google Pay with a Google Merchant ID, ACH, local methods). Enable webhooks and add the Fraud Protection URL in Braintree as the webhook destination; it must be secure and publicly reachable.

Common Problems and Limits

Expired authorizations. Stripe's docs say card payments that are not captured immediately must be captured within 7 days, after which a capture returns an error. The module has an Expired authorizations option that tries to recreate the payment with the saved card. Extended authorizations (up to 30 days depending on the card network) are an IC+ feature.

Partial captures and refunds. Stripe's module creates invoices and credit memos automatically only for full captures and full refunds made in the Stripe Dashboard. Partial ones made in the Dashboard leave Magento out of step, so the team has to do them in the Magento admin.

Reserved stock on abandoned 3D Secure. With Place order first disabled, the order sits in Pending Payment while the customer completes 3D Secure. If the customer fails or abandons it, a cron job cancels the order after two to three hours, and inventory stays reserved in the meantime. Adobe's pending payment order lifetime setting shortens that window.

Orders missing for a payment. If a charge succeeds but the module cannot find the order, Stripe's module can email the store's General Email address. Those cases need a manual check, otherwise you have a charge with no order.

Overcapture breaks reconciliation. Stripe warns that a custom capture amount is not reflected in order and invoice documents or in Stripe Tax calculations, so reconciliation can become inaccurate. Stripe suggests Payment Action set to Order instead.

Currency and method availability. Stripe's bank transfer method appears only for your Stripe account's settlement currencies, and buy now pay later messaging appears only for supported country and currency pairs. Braintree's PayPal Credit is US and UK only, and only one of PayPal Credit or PayLater can be on at a time.

Upgrades. Stripe advises backing up files and the database, upgrading in a sandbox first, and porting any changes to the module's own code, since minor and major releases may change code in incompatible ways. Customizing a vendor module directly is a common source of upgrade pain.

Multiple stores and accounts. Each Stripe account gets its own webhook endpoint, and when store views use different domains the module picks one store view domain rather than the base URL. Multi-brand setups need a clear map of which store view uses which account.

Payouts and fees stay outside Magento. None of these modules post processor fees and net payouts to accounting. Without a separate sync, finance matches payouts to orders by hand. The same gap exists on other platforms; see our Shopify payment integration guide.

Costs

  • Payment Services. Adobe's introduction page does not publish pricing.
  • Stripe. Stripe publishes its processing fees by country on its pricing page; rates differ by country, card type, international cards and currency conversion. Interchange plus (IC+) pricing, which the module needs for overcapture, multicapture and extended authorizations in the module, is a separate plan.
  • PayPal and Braintree. Transaction fees come from PayPal and Braintree and vary by country and method; check their pricing pages for your market.
  • Extensions. Marketplace extensions set their own prices.
  • Custom work. Depends on scope. For fintech projects in general, Itexus's fintech development page says discovery and prototyping "start from around $30,000", and enterprise fintech projects "often range from $150,000 to $1,000,000+". The cost of a Magento payment build depends on how much routing and reconciliation logic it needs.

When a Custom Integration Makes Sense

Your gateway has no maintained Magento module. A regional acquirer, a bank gateway or an in-house payment service often has an API but no extension. A custom payment method module, built on Magento's payment framework, is then the only clean route.

You route payments across several processors. Splitting traffic by country, currency or card type, or failing over when one processor declines, is beyond what a single provider's module does.

Finance needs automatic reconciliation. If payouts, fees, refunds and chargebacks must land in the ledger matched to Magento orders, you need middleware between the processor, Magento and the accounting system.

You run multiple entities or stores. Several legal entities, Stripe accounts or currencies mean rules about which order goes where, and reports that roll them up.

Compliance shapes the flow. Marketplaces paying out to sellers, regulated goods, or B2B terms with credit limits need logic that a standard checkout module was not built for.

How Itexus Can Help

Itexus has delivered 120+ integrations for neobanks, payment providers, robo-advisors and trading systems, and integrates products with Plaid, Yodlee, Stripe, Adyen, Bloomberg and 50+ fintech APIs. For Magento merchants, that means:

  • Custom payment modules for gateways without a Magento extension, including middleware for systems with no usable API.
  • Payment routing across several processors by country, currency or method.
  • Reconciliation of payouts, fees and refunds into accounting, as in our work for a 450k-subscriber investment advisory firm, where Stripe payouts are reconciled into QuickBooks.
  • PCI-conscious design that keeps card data with the processor.

We have not published a Magento case. To discuss your store, contact us.

Itexus is a trusted partner

40+ reviews on
4.9
Become a client

Frequently Asked Questions

How do I integrate Stripe with Magento 2?

Order the Stripe module on the Adobe Commerce Marketplace, install it with Composer, run setup:upgrade, get keys from the Adobe Commerce app in the Stripe App Marketplace, and configure it under Stores, Configuration, Sales, Payment Methods. Test in a sandbox before going live.

Does Magento have a built-in Stripe integration?

No. Adobe's bundled online methods are Payment Services, PayPal and Braintree. Stripe publishes and maintains its own module for Adobe Commerce and Magento Open Source.

What payment gateways does Magento support out of the box?

Adobe lists Payment Services, PayPal Express Checkout, PayPal Payments Advanced, Pro and Standard, Payflow Pro, Payflow Link and Braintree, plus offline methods such as Check or Money Order, Bank Transfer, Cash On Delivery and Purchase Order.

Is the Stripe module PCI compliant?

Stripe says both of its checkout flows for Adobe Commerce, the embedded Payment Element and the redirect to Stripe Checkout, are SAQ-A eligible, which simplifies PCI compliance. PCI remains a shared responsibility between Stripe and the merchant.

Can I do a Magento payment gateway integration for a gateway with no extension?

Yes, through a custom payment method module that calls the gateway's API and maps captures, refunds and webhooks to Magento invoices, credit memos and order statuses. Plan for sandbox testing, upgrade compatibility and PCI scope.

Why do refunds in Stripe not show up as credit memos in Magento?

Since version 4.1 of Stripe's module, only full refunds and full captures made in the Stripe Dashboard create credit memos or invoices in Magento automatically. Make partial refunds from the Magento admin.


Free expert consultation
Get a free architect consultation or system audit.
Consult with Our FinTech Experts
Sergey Privalov
Co-founder and CTO Itexus

Selected projects

Digital Wallet and App Ecosystem for Coinstar – a $2.2B Global Fintech Firm

A digital wallet app ecosystem for Coinstar, a $2.2B global fintech company — including mobile digital wallet apps, ePOS kiosk software, web applications, and a cloud API server enabling cryptocurrency and digital asset trading, bank account linking, crypto-fiat-cash conversions, and online payments.

  • iOS
  • React.js
  • Kotlin
  • .Net Core
  • DevOps
Read More

Retail Brokerage Platform with Mobile Trading, KYC, and Operations Console

A retail brokerage platform with a mobile trading app and a web console for compliance and operations teams, supporting automated KYC, investor onboarding, account funding and withdrawals, AI-powered market analysis, stock and ETF trading, fractional shares, Auto-Invest through regulated brokerage infrastructure.

  • React.js
  • Kotlin
  • JavaScript
  • Swift
  • Google Cloud
  • DevOps
Read More

Legacy WealthTech Platform Modernization for an SEC-Registered Investment Adviser Serving 450K+ Investors

Modernization of an inherited digital advisory platform combining model portfolio subscriptions, research, alerts, education, and SEC/RIA recordkeeping across mobile, web, and messaging channels.

  • React.js
  • Node.js
  • Flutter
  • NestJS / TypeScript
Read More