Documentation You are here: start » gateways » worldpay

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
gateways:worldpay [2011/06/02 05:55] – [Setting Up worldpay for FoxyCart] foxybrettgateways:worldpay [2022/02/17 17:13] (current) – adam
Line 1: Line 1:
 ---- dataentry gateway ---- ---- dataentry gateway ----
-type            : gateway         # do not change this line +type            : gateway #do not change this line 
- +name            : WorldPay (Global) 
-# Add the full name of the gateway after the colon below. +countries       : GB, US, DE, IE, AU, NZ, SG, HK, AD, AU, AT, BE, CY, CZ, DK, FI, FR, DE, GI, GR, VA, HK, HU, IE, IL, IT, LI, LU, MT, MC, NL, NZ, NO, PL, PT, SM, SG, SI, ES, SE, CH, TR, UM
-name            : RBS WorldPay (Global) +
- +
-# Supported Countries. Please use 2-character ISO Country Codes available at +
-# http://www.iso.org/iso/english_country_names_and_code_elements +
-# Separate multiple country codes by commas. +
-countries       :  +
- +
-# Enter the FoxyCart versions where support was added or removed (if applicable). +
-# Version numbers should include applicable decimals, such as "0.7.0" and not "070"+
 support-added   : 0.7.1 support-added   : 0.7.1
 support-removed :  support-removed : 
- +supports-3dsecure: yes 
-# Gateway URL+supports-multicurrency  : yes # enter "yes" or "no" (without quotes)
 gateway_url     : http://www.worldpay.com/ gateway_url     : http://www.worldpay.com/
 ---- ----
  
  
-====== RBS WorldPay (Global) ====== +====== WorldPay (Global) ====== 
-===== Setting Up worldpay for FoxyCart ===== +===== Setting Up WorldPay Global Gateway for FoxyCart =====
-Details are coming soon. Please feel free to edit this page if you have anything to add. (Because we're most familiar with the test account, we don't always know the exact details to set up a real account.)+
  
 +If you have questions about setting up your WorldPay Global Gateway account, call their technical support on: +44 (0)1223 258 493.
 +
 +Note that you will need to have an account that can use the XML Direct functionality, which may require a Corporate Account (and not the Business Account). This is because FoxyCart hosts the secure checkout page (which allows you to customize it to match your site) rather than relying on the WorldPay hosted page.
 +
 +If you get the "The payment gateway returned an invalid HTTP status code: 401" error while checking out, it means that you probably entered incorrect merchant code / XML password. Be careful about your merchant code, it's not the same as your login. The merchant code can be found in the status panel:
 +
 +{{:gateways:worldpay_merchant_code.png?nolink&|}}
 +
 +If you get the following error and do not plan to use 3D-Secure, ask WorldPay to disable 3D-Secure on your account..
 +<code>Invalid payment details : missing info for 3D-secure transaction: acceptHeader (7)</code>
 +==== Other Requirements for Your Site ====
 +  - You have to include the following details in the store website
 +    * Your company's registration name
 +    * Your company's registered office address
 +    * A contact telephone number
 +    * An email address
 +  - REFUND POLICY for services (The following text one of the feedback from worldpay)
 +    * "We have been unable to locate a suitable refund policy. Under WorldPay regulations you must let your customers know that under certain circumstances a refund will be given at the discretion of the management. You can state that customers are not 'entitled' to a refund once they are using the service, but there may be circumstances where a refund is deemed necessary - e.g. technical problems where the customer is not getting the service they believed they signed up for. \\ Please therefore amend all references to refunds by adding that 'refunds may occasionally be offered at the discretion of the management', or something similar"
 +
 +==== XML Password ====
 +You will need to obtain your XML password.
 +
 +For a business account you can find your password under the Installations menu:
 +{{ :gateways:worldpay-password-business.png?direct&300 |}}
 +
 +The password for a corporate account can be found under the Profile -> Merchant Environment menu:
 +{{ :gateways:worldpay-password-corporate.png?direct&300 |}}
 +
 +==== 3D Secure v2 ====
 +
 +To enable 3D Secure v2 for your Foxy store, you will need to have 3DS Flex enabled within your Worldpay account. To action this, you will need to [[https://www.worldpay.com/en-us/support|contact Worldpay support]] and request it be enabled for your account.
 +
 +Once enabled, they will provide you with the three values that you need to enter into the Foxy administration within your Worldpay integration settings on the "payment" page. These are the ''issuer'', ''encryption key'' and ''orgunitid''. You will need to ensure that "3d secure options" is set to "enabled" within your gateway settings on the "payment" page in the Foxy administration for the fields for those three options to be visible.
  
 ===== Testing ===== ===== Testing =====
Line 30: Line 53:
 ==== Testing Transactions ==== ==== Testing Transactions ====
 A number of different cases can be tested by entering the following values as the  A number of different cases can be tested by entering the following values as the 
-card/accountholder name in the order:+cardholder **first name** in the order:
  
 REFUSED will simulate a refused payment REFUSED will simulate a refused payment
Line 39: Line 62:
  
 ERROR will simulate a payment that ends in error. ERROR will simulate a payment that ends in error.
 +
 +if the cardHolderName is 3D then the Test environment will act as if the credit card is participating in 3-D Secure (that is, the 3-D Security Directory would respond with enrolled).
 +
 +if the cardHolderName is NO3D then the Test environment will act as if the credit card is not participating in 3-D Secure (that is, the Directory
 +would respond with not-enrolled).
 +
  
 All other card/accountholder names will simulate an authorised payment.  All other card/accountholder names will simulate an authorised payment. 

Page Tools

Site Tools