Kartris User Guide

17.19. Secure Trading

IMPORTANT: Secure Trading is no longer accepting customers on this particular implementation. We are maintaining it for legacy reasons. New customers therefore should not choose to setup an account with Secure Trading as Kartris is not compatible with the version they will require you to run. 

Secure Trading delivers a fully PCI DSS compliant online payment processing solution to businesses worldwide.

17.19.1. Setup within Kartris

  1. Go to Configuration > Payment and Shipping Gateways and click to edit Secure Trading.
  2. For 'friendly name', you can enter 'Secure Trading', or just simply 'Credit Card'. This is just the name of the payment method that customers will get to choose on the web site during checkout if you have multiple payment methods.
  3. Change the status from 'OFF' to 'ON' (for live orders) or 'TEST' or 'FAKE' for testing. 'TEST' invokes a demo order, allowing you to test the full integration and pass multiple orders at zero cost without needing to do refunds. 'FAKE' means that Kartris will skip the Secure Trading site and instead format a post back itself to the callback page of Kartris. This is useful for testing that the callback process works, triggers the appropriate emails and so on without keep having to keep going through the Secure Trading payment process.
  4. 'Required Fields' should be set to 'name,email'.
  5. 'CallbackID' should be set to 1 if you only have a single web site. If you use your Secure Trading account with multiple web sites, you can number each of them.
  6. 'SiteReferenceID' should be set to the values provided by Secure Trading.
  7. 'Password' is an arbitrary password you use to protect the callback process; it should match the one set up in the callback.txt file (see @17.19.2. Setup within Secure Trading).

17.19.2. Setup within Secure Trading

The majority of configuration for Secure Trading is contained in a number of text files that are uploaded through your Secure Trading admin area. We provide versions of these files configured for Kartris within a zip in the /Plugins/Secure Trading/ folder of Kartris. You must use these text configuration files rather than the default ones available from Secure Trading. You can remove the zip itself from your site, as it does not need to be present there.

callback.txt contains the following text:
method1 POST
url1 http://www.mydomainnamegoeshere.com/callback.aspx?g=securetrading&p=stpassword
fields1 orderref, streference, email, amount, stresult
You should edit the URL to match your site. The parameter 'g' should remain as 'securetrading' but 'p' should be set to the same 'Password' configured for Secure Trading within your Kartris back end.

If you have multiple online stores using the same Secure Trading account, you can copy these three lines of text and paste them below. The 'CallbackID' in @17.19.1. Setup within Kartris will be '1' for the site covered by the first three lines of the file, '2' for the next three lines and so on.

Remember, our callback.txt file is different to the standard one available from Secure Trading. You must use our version or your callbacks will fail.

failure.html and success.html

These files are templates for the pages displayed to a customer when making an order. These must be static HTML files, do not change them to .asp or .aspx or other active pages because the Secure Trading server will not run these.
form.html

This is the HTML template used for the credit card form that Secure Trading displays to your customers. Be very careful when editing this that you do not change any field names, remove required fields or otherwise break the form.

If you experience problems with Secure Trading, please ensure that you revert files to the ones we provide with Kartris. The most common issues we see are bugs introduced by edits to the various template files, or use of default files provided by Secure Trading.

 
powered by tomehost