Shifting your website to HTTPS
For security or SEO reasons, you have decided to secure the navigation on your e-commerce website. This modification can have consequences on the interaction between your website and the payment gateway. To avoid any issues:
Changing the default URLs in your Merchant Back Office
- Go to the Setup > Shop > Configuration menu.
- In the Details section, change the protocol to use in the URL field.
- In the Return URL section, change the protocol to use in the Return URL of the Shop in TEST mode field and Return URL of the Shop in PRODUCTION mode.
- Save the changes.
Changing the notification URLs in your Merchant Back Office
- Go to the Setup > Notification Rules menu, and click the Instant Payment Notification tab.
- For each enabled rule, double-click the rule name to access the rule settings.
- In the section Instant Payment Notification URL of the API form V1, V2, change the protocol to use in TEST and PRODUCTION mode.
- Save the changes.
- Proceed in the same way for each activated rule.
Checking the URLs submitted by your website
- Are you using a proprietary solution?
Ask your webmaster (or your developer) to check if the different URLs are transmitted in the payment form and modify them accordingly.
List of fields to be checked:
Field label Description vads_shop_url Shop URL vads_url_return Default return URL to the shop vads_url_success Return URL to the shop in case of accepted payment vads_url_refused Return URL to the shop in case of declined payment vads_url_cancel Return URL to the shop in case of cancellation vads_url_error Return URL to the shop in case of technical error vads_url_check Instant Payment Notification URL at the end of the payment - Do you use a payment module provided by Sogecommerce?
In this case, no action is necessary. The module dynamically retrieves the URL configured on your website.
Change the protocol in the IPN configuration as described above:
Making a payment to check if the IPN works correctly
The most common problem encountered when switching to HTTPS is related to the configuration of the SSL certificate on the website.
Bad configuration will block communication between your website and the payment gateway.
To test the communication, follow these steps:
- Make a payment (in TEST mode or in PRODUCTION mode).
- Once payment is complete, identify the transaction in your Merchant Back Office (Management> Transactions or TEST Transactions menu if you made the payment in TEST mode.
- Double-click the transaction to view the transaction details.
- Click the Event log tab.
- Search for the Instant Payment Notification line.
- Check if SENT appears in the Info column.
If it is not there, communication with the payment gateway has failed.
If you see FAILED_SSL_HANDSHAKE_EXCEPTION, see the article: What to do in case of an SSL problem?
Otherwise, see the following article: https://sogecommerce.societegenerale.eu/doc/fr-FR/error-code/server-url-error.html
What to do in case of an SSL problem?
You have recently made a change to your website and since then there have been communication issues with the payment gateway.
For each payment, you receive a warning e-mail telling you that the communication error encountered is FAILED_SSL_HANDSHAKE_EXCEPTION.
To help you solve this problem, follow these steps:
- Perform a diagnosis on Qualys website: https://www.ssllabs.com/ssltest/
- Fill in the URL of your website and click on submit.
- Wait for the diagnosis (the test may take several minutes).
- When the test is complete, review the report and identify the anomalies reported in red.The java8u31 line corresponds to the test closest to the dialog with the payment gateway.
- Correct any errors and make a new payment.
- If the communication still fails, contact technical support: support@sogecommerce.societegenerale.eu