iono Documentation - WorldPay
About
WorldPay is a world leader in payment processing and accepts all major credit and debit cards. Visit the WorldPay website for more information.
Features
The following features are supported by the gateway and can be handled by iono. In the case of refunds and fee calculations, the details will be logged by iono with the transaction.
- One Time Payments: Yes
- Recurring Payments: Yes
- Transaction Logging: Yes
- Refund Logging: No
- Fee Logging: No
- Has Test Mode: Yes
Method
The customer clicks the pay button and is taken to the WorldPay website. There the customer is asked to select and enter their card billing details to complete payment. Once payment is made or if the customer cancels the transaction, iono receives a callback and will log the transaction. You can make major changes to the WorldPay interface including the pages that the customer seems on cancellation and successful payment. A guide to customising can be found on the WorldPay website.
Setup
- From the Gateways section of the Settings section of the admin control panel, click on Edit next to the WorldPay entry.
- You can leave all the values as default except the following:
- Status: Change to Active
- Seller ID: Enter your WorldPay installation ID
- Click Edit and the WorldPay gateway is now enabled
The other options can also be changed:
- Name: The name of the gateway as it appears to your customers.
- Description: The description of the gateway as it is displayed to your customers. HTML is allowed.
- File: The location of the gateway module file in your iono directory. This file is not encoded so you are free to view and edit it.
Testing
WorldPay supports testing of the gateway module without any additional changes to your WorldPay account. To enable the test mode on the gateway:
- From the Gateways section of the Settings section of the admin control panel, click on Edit next to the WorldPay entry.
- Tick the Test Mode option
- Click Edit and the WorldPay gateway is now in test mode
Callback
Callback is performed with WorldPay when the customer makes a successful payment or when they click the cancel link during the WorldPay transaction process. However, it is not enabled by default and you must configure your WorldPay account to do this.
- Login to your WorldPay account
- Scroll down the page to the table containing your installations. Next to the one you are going to use, click the Configuration options button
- Enter your full callback URL into the field labelled Callback URL. The callback URL is displayed beneath the gateway list table on the Gateways page of the Settings section of the admin control panel. Replace gatewayname at the end of the URL with worldpay.
- Tick the boxes marked Callback enabled?, FuturePay callback Enabled? and Use callback response?.
- In the field labelled MD5 secret for transactions at the bottom of the page enter your iono Remote Authentication String. This can be obtained from the General Settings section of your iono admin control panel.
- Click Save Changes and your WorldPay installation is ready.