Magento 2 module

    Learn about the Magento 2 module, which allows merchants to accept payments on the Magento platform.

    Download and install the module

    Follow our installation guide to install the Stripe Magento 2 module and then configure the module to set the payment methods and checkout options for your Magento site.

    Magento demo

    You can see our demo of an example Magento storefront using the Stripe module, along with the Magento Admin Panel, which demonstrates the module’s configuration for payment methods and card payments. This demo includes examples of Apple Pay, Google Pay, orders, invoices, refunds, and MOTO payments.

    Enabling fraud prevention with Stripe Radar

    The module supports three fraud prevention features: a standard CVC check, Stripe Radar, and 3D Secure.

    Radar detects and prevents fraud in real-time, based on thousands of signals about each incoming payment. If Radar detects a high-risk payment, it may be placed under review with an Elevated risk status. If you want to automatically decline charges, you can create a custom rule for Radar directly in the Stripe Dashboard.

    When Radar is enabled, any orders that are placed under manual review will be automatically placed on hold in Magento. You can inspect these orders before fulfilling any of them. For example, you can check the address verification results in the Magento Admin Panel:

    Stripe Radar can detect and prevent fraud for orders placed on your site

    If you think that an order is not fraudulent, you can simply click Unhold on the order page. This changes the order status to Processing or Complete and you can fulfill the order normally.

    To test a fraudulent payment, switch the module to Test mode from the configuration section, and then place an order using the card number 4000 0000 0000 9235.

    3D Secure

    3D Secure provides a layer of protection against fraudulent payments and is supported by most card issuers. The Strong Customer Authentication (SCA) regulation in Europe requires 3D Secure authentication for card payments. Unlike regular card payments, 3D Secure requires cardholders to complete an additional verification step with the issuer. Typically, this involves showing the customer an authentication page on their bank’s website, where they’re prompted to enter a password associated with the card or a verification code sent to their phone. This process is familiar to customers through the card networks’ brand names, such as Visa Secure and Mastercard Identity Check.

    Stripe provides a 3D Secure test payment page in test mode

    As of version 2.3.0 of the module, 3D Secure 2 replaces the 3D Secure 1 system and supports SCA regulation. The regulation is in effect as of September 14, 2019. With SCA, banks decline payments that don’t use 3D Secure 2. If you use v2.3.0 or newer, 3D Secure 2 is always enabled by default and the configuration option to disable it has been removed.

    For complete details, you can read our guide to 3D Secure 2. To test 3D Secure 2, switch the module to be in Test Mode and use any of the testing card numbers. You can test the authentication process by creating a custom Radar rule on your Stripe account, or try the flow on our demo Magento server.

    Translations for multi-language websites

    The module contains a translation file that you can use to configure a multi-language Magento site:

    /app/code/community/StripeIntegration/Payments/i18n/en_US.csv
    

    To create a translation file for a different language, copy this file to:

    /app/code/community/StripeIntegration/Payments/i18n/languagecode_COUNTRYCODE.csv
    

    Make sure to replace languagecode_COUNTRYCODE with the locale code for your target language. This is the same language you have selected under System > Configuration > General > Locale Options > Locale.

    Once you have copied the file, you can replace the second string on each row of the file with a translation of the first string. There is nothing else you need to do for translations.

    Translations for 32 more countries are included in the module’s i18n directory for your convenience. These are the same language codes that you selected under Currency Setup for each of your available Magento stores.

    Was this page helpful?

    Thank you for helping improve Stripe's documentation. If you need help or have any questions, please consider contacting support.

    Questions?

    We're always happy to help with code or other questions you might have. Search our documentation, contact support, or connect with our sales team. You can also chat live with other developers in #stripe on freenode.

    On this page