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 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

Get API keys

To get API keys


  1. Log in to the Solidgate Hub account.
  2. Navigate to Developers > Channels.
  3. Click on the needed channel to go to the Channel details page.
  4. On the PrestaShop configuration page, add the required credentials:
    • Public key - API public key from the Solidgate Hub api_pk
    • Secret key - API secret key from the Solidgate Hub api_sk
  5. Optionally, on the Channel details page, add a Webhook URL 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 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 API keys.
  • Check var/log/system.log for error logs.

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