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/11/16 21:13] – adding required things from Worldpay 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            : RBS WorldPay (Global) +name            : WorldPay (Global) 
-countries       : UK, 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, UK, US, UM+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
 support-added   : 0.7.1 support-added   : 0.7.1
 support-removed :  support-removed : 
 +supports-3dsecure: yes
 +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 Global Gateway for FoxyCart ===== ===== Setting Up WorldPay Global Gateway for FoxyCart =====
  
-If you have questions about setting up your WorldPay Global Gateway account, you can reach out to Ben Ablett at WorldPay, +44 (0)7917 560 684 or [[mailto:ben.ablett@worldpay.com|by email]].+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. 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 and 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:+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&|}} {{:gateways:worldpay_merchant_code.png?nolink&|}}
Line 22: Line 24:
 If you get the following error and do not plan to use 3D-Secure, ask WorldPay to disable 3D-Secure on your account.. 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> <code>Invalid payment details : missing info for 3D-secure transaction: acceptHeader (7)</code>
- 
 ==== Other Requirements for Your Site ==== ==== Other Requirements for Your Site ====
   - You have to include the following details in the store website   - You have to include the following details in the store website
Line 32: Line 33:
     * "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"     * "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 40: 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 49: 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. 

Site Tools