Magento Adobe Commerce
Get in touch
Sign in
Magento Adobe Commerce
Secure card payments for Magento 2

Solidgate offers secure card payment processing for your Magento 2 store.

Follow the steps below to integrate the Solidgate Payment Module and start accepting payments smoothly. Before you begin, ensure that you have:

  • Solidgate account
    Access to your account at Solidgate HUB to get your Guide
    Learn to authenticate API requests and fix validation errors effectively.
    API keys.
  • Magento & PHP versions
    Ensure your Magento version and PHP version meet the requirements for the module.
    • Magento 2.4.x or higher
    • PHP 7.4+

Install module

To install the module


  1. Copy module files by placing the Solidgate directory into your Magento installation directory:
    cp -r Solidgate /path/to/magento/app/code/
  2. Enable and compile the module by running the following commands from the Magento root directory:
    php bin/magento cache:clean
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento cache:flush
  3. Verify installation with the following command:
    php bin/magento module:status Solidgate_Payment/
    You should see Solidgate_Payment: Module is enabled

Retrieve API keys

To retrieve API keys


  1. Log in to Solidgate HUB .
  2. Navigate to Developers > Channels.
  3. Find the needed channel to go to the Channel details page.
  4. Copy your Public key and Private key, then add them to the Magento configuration.
  5. Optionally, add a Guide
    Subscribe for events on your Solidgate account so your integration can automatically trigger actions
    Webhook
    URL in HUB for payment status updates. https://yourstore/solidgate/payment/notify

Configure payment gateway

To complete configuration in the Magento admin panel


  1. In Magento admin panel, go to Stores > Configuration.
  2. Navigate to Sales > Payment methods.
  3. Find Solidgate Payment and fill in the following details:
    • Enable: Yes
    • Title: Name shown to customers
    • Public key: Solidgate API public key
    • Private key: Solidgate API private key
    • Instructions: Information customers may need for payments (optional)
    • Sort order: Payment method position on Magento checkout (optional)
  4. Save your changes.

Checkout flow

Steps showing how payments are completed with Solidgate in Magento 2 are as follows:


  1. Customer selects Solidgate as the payment method.
  2. Store redirects the customer to the Solidgate’s secure Guide
    Create and customize a secure payment page for your customers.
    payment page.
  3. Customer enters their card details and confirms the payment.
  4. Solidgate processes the transaction and redirects them back to:
    • Success - Magento order success page
    • Failure - Checkout error message
For testing, you can use sandbox keys, which allow you to simulate payments without any real charges.

Once everything is set up, Solidgate is ready to process secure card payments for your Magento 2 store.

Handle errors

Here are a few tips that may help resolve common issues:

Module not visible in the admin panel

  • Check file permissions:
    chmod -R 755 app/code/Solidgate/
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile

API errors

  • Ensure correct Guide
    Learn to authenticate API requests and fix validation errors effectively.
    API keys.
  • Check var/log/system.log for error logs.

Should any issues persist, contact Solidgate support for further assistance.


Looking for help? Contact us
Stay informed with Changelog