Checkout: SagePay (Form)

WordPress Shopping Cart plugin: SagePay (Form)

Requirements

The SagePay Form Protocol Gateway extension plugin has the following requirements:

  • WordPress Shopping Cart plugin.
  • A SagePay account

Installation

1. Make sure that you have the WordPress Shopping Cart plugin installed and have purchased the SagePay extension.

2. Download the SagePay extension from the downloads management section in a ZIP archive (you may need to login to your Tribulant Software account in order to access your download).

3. Extract the ZIP archive named checkout-sagepay.zip in order to be presented with a single folder named checkout-sagepay.

4. Upload the checkout-sagepay folder to the wp-content/plugins/ directory of your WordPress installation, like seen in the example image below.

Activation

Once you have installed the SagePay extension via FTP you need to activate it.

To activate it you need to go to the normal Plugins > Installed Plugins section via your admin sidebar. There you will see the extension as a plugin listed amongst other plugins, look at the screenshot below.

Once activated, you will notice that it is listed in the Checkout > Extensions section via the admin sidebar. As seen in this image below. When you hover over this, it will have an “Activate” option available which needs to be clicked and the red message will change to a green “Installed and Active”

Configuration

After you installed and activated the SagePay Form Protocol Gateway extension, you can go to Checkout > Configuration > Payment Methods in the plugin where you’ll notice the “SagePay (Form Protocol)” checkbox on the right-hand side, this checkbox needs to be selected and then save the configuration. The SagePay option is now available for your customers to select, but you need to still configure it as seen in the the below screenshot:

 

1. Title/Caption

Specify a title/caption here which will be used to display this payment method to your customers on the front-end of your shop such as on the billing page, orders history and other sections.

2. Vendor Name

Fill in your SagePay Vendor Name. This is supplied to you by SagePay upon registration. If not, or if you forgot, you can obtain this value from the Form Protocol.

3. Encryption Password

Fill in your SagePay Encryption Password. This is supplied to you by SagePay upon registration. If not, or if you forgot, you can obtain this value from the Form Protocol.

4. Partner ID

This setting is optional and is used if you have the same SagePay account collecting payments from multiple online shops. It’s a way to almost ‘prefix’ the order so it’s easy to identify which payments came from which site. Most the time, this setting will be irrelevant.

5. Connect Mode

There are 3 available connection modes:

  • Live: This is exactly what it says, live payments, everything is done for real, this is when your site is fully functional and you are taking payments online.
  • Test: Almost like the “Live” mode, but it doesn’t actually process payments, it allows you to go through the process to ‘test’ that all is working well.
  • Simulator: This is like the “Test” mode due to the fact that the payments are not charged, but this mode outputs strings as you go through the procedure. It is essentially a debugging mode which shows all possible information from a developer’s point of view.

Table of Contents