Solidgate offers secure card payment processing for your PrestaShop store. Follow the steps below to integrate the Solidgate Payment module and start accepting payments smoothly.
Before you begin, ensure that you have access to the Solidgate Hub account to get API keys.
Install module
To install the module
- Upload the files from the provided archive and add solidgate/module to the /modules/solidgate/ directory in your project root.
- In PrestaShop admin panel, go to Back Office > Modules.
- Find Solidgate Payment.
- Proceed with Install.
- Click on Enable.
Get API keys
To get API keys
- Log in to the Solidgate Hub account.
- Navigate to Developers > Channels.
- Click on the needed channel to go to the Channel details page.
- For the PrestaShop configuration page, find the following credentials:
- Public key - API public key from the Solidgate Hub
api_pk - Secret key - API secret key from the Solidgate Hub
api_sk
- Public key - API public key from the Solidgate Hub
- 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 PrestaShop admin panel
- In PrestaShop admin panel, go to Back Office > Modules.
- Find Solidgate Payment.
- Go to Configure and fill in the following details:
- Public API key: API public key from the Solidgate Hub
api_pk - Secret API key: API secret key from the Solidgate Hub
api_sk - Webhook public key: Webhook public key from the Solidgate Hub
wh_pk - Webhook secret key: Webhook secret key from the Solidgate Hub
wh_sk - Webhook URL: URL for webhook notifications
- Enable logging: Enable logging for payment events
- Success/Failure URL: URL to redirect after payment success or failure
- Public API key: API public key from the Solidgate Hub
- Click on Save to complete the configuration.
Handle errors
These are common issues encountered during the integration with PrestaShop and recommendations to resolve them.
InstallationThe hook with the actionOrderStatusUpdate name is registered by Solidgate, but the corresponding method hookActionOrderStatusUpdate is not defined.
RecommendationsRemove unused hook actionOrderStatusUpdate from the HOOKS constant.
ConfigurationFields in the admin panel are not saving.
RecommendationsAnalyze the liqpaypayments module, rework the saving mechanism using HelperForm .
IntegrationEnsure positive customer experience by handling redirects.
RecommendationsSet up redirection to the standard order confirmation page. Add paymentReturn hook to display information on the standard page. For failed payments, redirect customers to the order history page.
TemplateSmartyException: Unable to load template iframe.tpl
RecommendationsChange the template loading method from $this->context->smarty->fetch() to $this->display(FILE, …)
AuthenticationAuthentication failed.
RecommendationsTry fixing the HMAC-SHA512 signature generation by removing the unnecessary true parameter.