Adobe Commerce (previously Magento 2)

Install and set up the Adobe Commerce plugin with emerchantpay.

Accept payments and build a customised storefront with the emerchantpay’s Adobe Commerce shopping cart plugin.

Adobe Commerce storefront demo

Follow these instructions to install the Adobe Commerce emerchantpay Gateway Module on your server. Then you’ll be able to process payments through the emerchantpay Genesis payment gateway.

Supported payment methods:

  • Cards
  • Alternative Payment Methods (APMs)
  • Online Banking (oBeP)
  • Wallets
  • Vouchers
  • Cash Payments

Supported versions:

  • Magento 2 Community Edition (CE), Enterprise Edition (EE), and Enterprise Cloud Edition (ECE)


  • GenesisPHP is required to connect to the Genesis payment gateway, and it will be automatically installed as part of the recommended installation

  • Installation

    1. Download and install Composer.
    2. Add the free emerchantpay Gateway Module to your account in the Commerce Marketplace.
    3. After you have added Adobe Commerce to your account, follow the instructions on the confirmation screen to generate and add your access keys to the .json file on your server. Click here for help with this step.
    4. Install the Payment Module:
      $ composer require emerchantpay/magento2-emp-plugin
    5. Enable the Payment Module:
      $ php bin/magento module:enable EMerchantPay_Genesis –clear-static-content
      $ php bin/magento setup:upgrade
    6. Deploy Magento static content (execute if needed):
      $ php bin/magento setup:static-content:deploy

    Alternatively, you can install the Adobe Commerce Payment Module manually through this Packagist repository.


    1. Log in to the Adobe Commerce Admin Panel.
    2. In the navigation menu, go to Stores > Configuration > Sales > Payment Methods.
    3. Go to Payment Methods and select Configure under emerchantpay Checkout to expand the available settings.
    4. Set Enabled to Yes to use the selected payment method.
    5. Add your credentials.
    6. Select your preferred transaction types and configure additional settings.
    7. Select Save Config.
    8. Set Enable email notification to Yes to receive an email after a successful payment.

    Configure Adobe Commerce over a secured connection (HTTPS)

    1. Log in to the Adobe Commerce Admin Panel.
    2. Navigate to Stores > Configuration > General > Web.
    3. Expand the Base URLs (Secure) tab.
    4. Set Use Secure URLs on Storefront to Yes.
    5. Set Use Secure URLs in Admin to Yes.
    6. Enter your Secure Base URL and select Save Config.

    You are now ready to test your Adobe Commerce integration in the emerchantpay staging environment.

    Test your integration

    Before you can start accepting live payments from customers, you must test your integration in the emerchantpay staging environment.

    1. In your storefront, add an item to your cart.
    2. In your cart, select Go to Checkout.
    3. Fill in test values for the required billing fields.
    4. Select the emerchantpay Checkout payment method.
    5. Enter in the following card payment credentials:

      Enter the following test card numbers in the checkout screen to test your integration. For the other fields enter:

      • Any cardholder name
      • Any future expiration date
      • A random 3-digit CVV number

      Test card number Card Brand
      4200000000000000 Visa
      5555555555554444 Mastercard
    6. Select Place Order, and you will be redirected to the order confirmation page.
    7. Log in to the Adobe Commerce Admin Panel.
    8. Go to Sales > Orders. You should see your test order in the list of transactions.

    You are now ready to move to the production environment where you can accept live payments from your customers.

    Accept live payments

    Once you have successfully configured and tested the Adobe Commerce plugin in the staging environment, you’re ready to configure your merchant account in the production environment and accept live transactions.

    To move to the production environment:

    1. Contact emerchantpay support to activate your merchant account in the emerchantpay production environment.
    2. emerchantpay support will provide you with production credentials.
    3. In the Adobe Commerce Admin Panel, go to Stores > Configuration > Sales > Payment Methods. In the emerchantpay Checkout configuration options, enter your production credentials.
    4. Set Test Mode to No.
    5. Select Save Config.

    You are now ready to accept live payments from your customers.