This is a Payment Plugin for Shopware 6, that gives you the ability to process payments through emerchantpay's Payment Gateway - Genesis.

• Shopware 6.6.x (Tested up to 6.6.10.5)
• GenesisPHP v2.2.0
• Composer v2.6.0

• PHP version 5.5.9 or newer
• PHP Extensions:
  • BCMath
  • CURL (required, only if you use the curl network interface)
  • Filter
  • Hash
  • XMLReader
  • XMLWriter
  • JSON
  • OpenSSL

• Download the archive with the desired release

• Extract the containing files into <Shopware 6 Root>\custom\plugins\EmerchantpayGenesis

• Navigate via the console to the Shopware 6 Root

• Check if Shopware 6 recognize the plugin

  $ php bin/console plugin:refresh

  The output should contain the following row:

  Plugin	Label	Version	Upgrade version	Author	Installed	Active	Upgradeable
  EmerchantpayGenesis	emerchantpay Genesis Plugin	x.x.x		emerchantpay Ltd	No	No	No

• Install and activate the plugin

$ php bin/console plugin:install --activate EmerchantpayGenesis

• Clear the cache

$ php bin/console cache:clear

• Log-in into the Admin
• Go to
  • Extenstions->My Extensions via Shopware 6.4.x, 6.5.x
• Activate, Install, Uninstall, etc.
• Choose Config and fill up the Credentials, choose Transaction Types, etc

• Log-in into the Admin
• Go to
  • Extenstions->My Extensions via Shopware 6.4.x, 6.5.x
• Choose Edit
• Set Active, Availability Rule, etc

• Log-in into the Admin
• Go to
• Navigate to section Payment and shipping
• Add Payment Methods emerchantpay Checkout

Note: In order to use processing in an iframe, you have to modify the SameSite cookie settings. This ensures that cookies are properly handled during cross-site requests, which is crucial for iframe-based payment solutions.

Ensure you have access to your Shopware 6 installation directory. This can be on your local machine or a server where your Shopware instance is hosted.

Navigate to the config/packages directory within your Shopware installation. This directory contains configuration files for various packages used by Shopware.

nano /path/to/your/shopware/installation/config/packages/framework.yml

Note instead of nano you can use your favorite editor.

Add/update the Cookie SameSite setting:

framework.yml:

framework:
  session:
    cookie_samesite: none

Save your changes and clear the cache:

cd /path/to/your/shopware/installation
./bin/console cache:clear

When uninstalling, a message will appear asking if the plug-in data needs to be removed:

• Yes - Removes all saved Plugin data *THIS CAN NOT BE UNDONE*
• No - The Plugin data remain untouched

• emerchantpay Checkout Payment Method
  • Alternative Payment Methods
    • SOFORT
  • Cash Payments
    • Pix
  • Credit Cards
    • Authorize
    • Authorize (3D-Secure)
    • Sale
    • Sale (3D-Secure)
    • EPS
  • Sepa Direct Debit
    • SDD Sale
  • Online Banking Payments
    • Bancontact (BCT)
    • iDEAL
    • iDebit Payin
    • Interac Combined Pay-in (CPI)
    • BLIK (BLK)
    • P24
    • SPEI (SE)
    • PayID (PID)
  • Mobile
    • Apple Pay
    • Google Pay
  • Vouchers
    • Paysafecard
  • Wallets
    • PayPal

Note: If you have trouble with your credentials or terminal configuration, get in touch with our support team

You're now ready to process payments through our gateway.

• Install with development packages

composer install

• Install without development packages

composer build

• Run PHP Code Sniffer

composer php-cs

• Run PHP Mess Detector

composer php-md

• Pack installation archive (Linux or macOS only)

composer pack