The below guidance refers to an API connection to a Magento v1 store.
When setting up a new Magento channel in Tradebox One or using an existing channel, you may receive a connection error from Magento. Tradebox will always surface these errors exactly as they are returned from Magento's API. These errors are generic to any application that accesses Magento via API and not specific to Tradebox; as such they almost always require action by your Magento developer to resolve them.
- How can I test my connection to Magento?
For an existing Magento connection, in Channels, select the relevant channel, click Edit, and then from within the Actions drop down menu choose Magento - Test Connection.
For a new Magento sales channel, the connection test is a mandatory part of the setup once the API credentials have been provided.
- What does Tradebox use to connect to Magento?
Tradebox uses the API URL, along with the username and password that you should have created within your Magento admin panel. See our guide to creating API credentials for details.
- Should I include the suffixes (/api/xmlrpc or /api/v2_soap) within my URL?
No, Tradebox will automatically append your URL with these. Your API URL is normally the same as the URL that your customer would enter to shop on your site, though you may need to append it with /index.php
- Why am I getting a connection error through Tradebox One? Finance Manager connected to my Magento store with no issues
With Tradebox One we have made two changes to the Magento connection. The first is that we've moved from an XML-RPC connector to Magento's SOAP v2 API. The second is that we now expect the security standard of TSL 1.2 where the connection is https. Both changes were made to keep Tradebox current with modern industry standards for security in e-commerce; as an online seller these standards impact on your PCI compliance.
- My web developers have made a change, how can I check if that's solved the problem?
Use the test connection button as described above. If the error was due to the code or setup of your website then testing the same credentials that failed previously should now report a successful connection test if the problem is resolved.
Below are some of the most common API connection issues users have come across with Magento, and their resolutions. Mostly these will require input from your Magento developer to resolve.
The SOAP connection to the Magento website failed with the following error returned by the API: Could not establish secure channel for SSL/TLS with authority '[website url]'.
Users have received this where their Magento site does not support TLS 1.2 over https. Ask your web developer to ensure TLS 1.2 is enabled.
The SOAP connection to the Magento website failed with the following error returned by the API: Unrecognized message version.
In the first instance, make sure your website as a whole isn't down, by browsing to the top level of the domain in a web browser; if your site is example.com then make sure you can access it through a browser like Internet Explorer or Google Chrome. If the website is fine, you should check the API URL itself. Copy and paste it into your web browser - it should look something like http://www.example.com/api/v2_soap. If the connection test has returned 'unrecognized message version', it's likely there will be an error displaying within the XML on the API URL page itself which indicates what the underlying problem is.
The SOAP connection to the Magento website failed with the following error returned by the API: SOAP-ERROR: Parsing WSDL: Couldn't load from '[website url]'
A number of users have reported this error on testing and had it resolved by their web developer. Although we haven't had feedback on all cases we have had one report that this was the result of the SSL Root CA certificate expiring.
In all cases this issue was entirely external and has required no changes to the credentials used, or to Tradebox's code. In the first instance, check your API URL; Copy and paste it into your web browser - it should look something like http://www.example.com/api/v2_soap. Note that a redirect which appends the URL (e.g. http://www.example.com/api/soap?wsdl=1) is not valid for Tradebox to connect to your Magento site; in all instances the API URL should end /api/v2_soap.
The SOAP connection to the Magento website failed with the following error returned from the Magento API: Procedure 'login' not present
Some users have also reported the above error message when attempting to connect via Tradebox. This can be resolved by changing the following setting on your Magento admin panel:
System > Configuration > Magento Core API > change WSI Compliance setting to OFF.
You should discuss this change with your developer prior to making it as it may have an impact on other aspects of your Magento store.