Difference between revisions of "X-Payments:3D-Secure settings"

From X-Payments Help
Jump to: navigation, search
m
m
Line 28: Line 28:
 
(More up-to-date information on the type of 3-D Secure system supported by specific payment gateways integrated with X-Payments can be found in the [[X-Payments:Supported_payment_gateways|X-Payments:Supported payment gateways]] table.)
 
(More up-to-date information on the type of 3-D Secure system supported by specific payment gateways integrated with X-Payments can be found in the [[X-Payments:Supported_payment_gateways|X-Payments:Supported payment gateways]] table.)
  
If you are going to use a payment solution that provides a built-in 3-D Secure authentication service, you do not need to set up 3-D Secure in X-Payments: 3-D Secure authentication will work for your payment transactions out of the box. However, if you are going to use 3-D Secure via CardinalCommerce, you will need to configure some 3-D Secure settings in X-Payments.
+
Please note that using 3-D Secure requires cardholder data to be stored temporarily by X-Payments. No worries about that - cardholder data is only needed while the transaction is in progress. X-Payments will not store CHD longer than is necessary and will remove the stored CHD for the transactions that have been finalized as often as every few minutes.
<br /><br />
+
So, before you start using 3-D Secure payer authentication with X-Payments, make sure that storage of cardholder data has been enabled in the [[X-Payments:General_settings|General_settings]] section (Settings -> General settings). Also ensure that [[X-Payments:Encryption_keys|cardholder data encryption keys]] have been properly generated.
CardinalCommerce's 3-D Secure is configured differently in different versions of X-Payments. For instructions, see the appropriate section below:
+
 
 +
For payment gateways providing native (built-in) 3-D Secure, no further steps to configure 3-D Secure in X-Payments need to be taken: everything should work automatically as soon as you have properly configured the required settings in your account with the respective payment processing provider. To use 3-D Secure via CardinalCommerce, however, you will need to sign up for the respective service with CardinalCommerce (CardinalCommerce can be contacted at xpayments@cardinalcommerce.com) and implement some further 3-D Secure related configuration in X-Payments. For instructions, see the appropriate section below:
 
:* [[#Managing your 3-D Secure system configuration in X-Payments 1.0 or 2.0|Managing your 3-D Secure system configuration in X-Payments 1.0 or X-Payments 2.0]]
 
:* [[#Managing your 3-D Secure system configuration in X-Payments 1.0 or 2.0|Managing your 3-D Secure system configuration in X-Payments 1.0 or X-Payments 2.0]]
 
:* [[#Managing your 3-D Secure system configuration in X-Payments 2.1|Managing your 3-D Secure system configuration in X-Payments 2.1]]
 
:* [[#Managing your 3-D Secure system configuration in X-Payments 2.1|Managing your 3-D Secure system configuration in X-Payments 2.1]]
 
<br /><br />
 
<br /><br />
  
====Managing your 3-D Secure system configuration in X-Payments 1.0 or 2.0====
+
==Managing your 3-D Secure system configuration in X-Payments 1.0 or 2.0==
To start using CardinalCommerce 3-D Secure payer authentication in X-Payments 1.0 or 2.0:
+
To configure X-Payments to use 3-D Secure payer authentication via CardinalCommerce:
# Sign up for the respective service with CardinalCommerce (CardinalCommerce can be contacted at xpayments@cardinalcommerce.com).
 
# CardinalCommerce 3-D Secure requires X-Payments to temporarily store cardholder data, so make sure that storage of cardholder data has been enabled in the [[X-Payments:General_settings|Settings -> General settings]] section and [[X-Payments:Encryption_keys|cardholder data encryption keys]] have been properly generated.
 
 
# Add a 3-D Secure system configuration for the CardinalCommerce module.
 
# Add a 3-D Secure system configuration for the CardinalCommerce module.
 
# Enable your CardinalCommerce 3-D Secure system configuration.
 
# Enable your CardinalCommerce 3-D Secure system configuration.
Line 78: Line 77:
 
<br /><br />
 
<br /><br />
  
====Managing your 3-D Secure system configuration in X-Payments 2.1====
+
==Managing your 3-D Secure system configuration in X-Payments 2.1==
To start using CardinalCommerce 3-D Secure payer authentication in X-Payments 2.1:
+
To configure X-Payments to use 3-D Secure payer authentication via CardinalCommerce:
# Sign up for the respective service with CardinalCommerce (CardinalCommerce can be contacted at xpayments@cardinalcommerce.com).
 
# CardinalCommerce 3-D Secure requires X-Payments to temporarily store cardholder data, so make sure that storage of cardholder data has been enabled in the [[X-Payments:General_settings|Settings -> General settings]] section and [[X-Payments:Encryption_keys|cardholder data encryption keys]] have been properly generated.
 
 
# Add and enable 3-D Secure for each payment configuration in your X-Payments installation that needs to use 3-D Secure via CardinalCommerce.
 
# Add and enable 3-D Secure for each payment configuration in your X-Payments installation that needs to use 3-D Secure via CardinalCommerce.
 
# In the details of all the online stores that will be using your 3-D Secure enabled payment configuration, specify the template that should be used for the 3-D Secure payer authentication step.
 
# In the details of all the online stores that will be using your 3-D Secure enabled payment configuration, specify the template that should be used for the 3-D Secure payer authentication step.

Revision as of 00:15, 1 December 2015

X-Payments user manual
  1. X-Payments:General information
  2. What's New
  3. System requirements
  4. Installation
  5. Two-factor user authentication
  6. Configuring X-Payments
  7. Managing users
  8. Customizing the interface
  9. Managing payments
  10. Unistalling X-Payments
  11. Upgrading
  12. Moving X-Payments from one host to another
  13. Viewing X-Payments logs
  14. FAQ
  15. Troubleshooting
  16. Glossary
  17. Supported payment gateways
  18. Popular Payment Methods Configuration Instructions

X-Payments allows you to use 3-D Secure Payer Authentication for a number of payment methods that support it. 3-D Secure provides an additional layer of security for payment transactions via your store by implementing Verified by Visa and MasterCard SecureCode.

Some payment solutions supported by X-Payments provide their own built-in integrated 3-D Secure authentication systems that can be used with X-Payments. Such solutions include:

  • PayPal's Payflow Pro;
  • Cardinal Commerce Centinel;
  • Elavon Payment Gateway;
  • Global Iris/HSBC - RealAuth Remote;
  • Realex;
  • Sage Pay Go - Direct Interface;
  • Worldpay Corporate Gateway - Direct Model.

For many other payment solutions it is possible to use the 3-D Secure authentication by CardinalCommerce (X-Payments provides an integrated module for this purpose). Solutions that can be used with 3-D Secure authentication by CardinalCommerce include:

  • PayPal Payments Pro;
  • Authorize.Net AIM, AIM XML and CIM;
  • Bean Stream, a Digital River Company/FirstData Canada;
  • Caledon;
  • CyberSource - SOAP toolkit API;
  • DIBS;
  • Digital River World Payments / Beanstream;
  • ECHO NVP;
  • eSELECTplus;
  • HeidelPay;
  • Netbilling - Direct Mode 3.1;
  • PSiGate XML API;
  • USA ePay - Transaction Gateway API;
  • WebXpress.

(More up-to-date information on the type of 3-D Secure system supported by specific payment gateways integrated with X-Payments can be found in the X-Payments:Supported payment gateways table.)

Please note that using 3-D Secure requires cardholder data to be stored temporarily by X-Payments. No worries about that - cardholder data is only needed while the transaction is in progress. X-Payments will not store CHD longer than is necessary and will remove the stored CHD for the transactions that have been finalized as often as every few minutes. So, before you start using 3-D Secure payer authentication with X-Payments, make sure that storage of cardholder data has been enabled in the General_settings section (Settings -> General settings). Also ensure that cardholder data encryption keys have been properly generated.

For payment gateways providing native (built-in) 3-D Secure, no further steps to configure 3-D Secure in X-Payments need to be taken: everything should work automatically as soon as you have properly configured the required settings in your account with the respective payment processing provider. To use 3-D Secure via CardinalCommerce, however, you will need to sign up for the respective service with CardinalCommerce (CardinalCommerce can be contacted at xpayments@cardinalcommerce.com) and implement some further 3-D Secure related configuration in X-Payments. For instructions, see the appropriate section below:



Managing your 3-D Secure system configuration in X-Payments 1.0 or 2.0

To configure X-Payments to use 3-D Secure payer authentication via CardinalCommerce:

  1. Add a 3-D Secure system configuration for the CardinalCommerce module.
  2. Enable your CardinalCommerce 3-D Secure system configuration.
  3. Assign your CardinalCommerce 3-D Secure system configuration to the payment configuration for which you want to use 3-D Secure.


To add a 3-D Secure system configuration for the CardinalCommerce module:

  1. On the '3D-Secure Settings' page (Settings -> 3-D Secure settings), click Add new next to New configuration for: CardinalCommerce.
    XP2.0 3d secure.png
    A page titled 'Add new 3D-Secure configuration' will be opened displaying the dialog box for providing your CardinalCommerce module configuration settings:
    XP2.0 3d secure add.png
  2. Adjust the configuration settings for CardinalCommerce module:
    • Currency: The currency your online store uses to conduct transactions.
    • Test/Live mode: The mode in which you wish to use 3-D Secure (Test or Live).
    • Merchant ID: The MerchantID value provided to you by CardinalCommerce.
    • Processor ID: The ProcessorID value provided to you by CardinalCommerce.
    • Transaction password: The Transaction password provided to you by CardinalCommerce.
    • Transaction URL: The TransactionURL provided to you by CardinalCommerce. The transaction URL for testing purposes is https://centineltest.cardinalcommerce.com:443/maps/txns.asp.
  3. When you are done adjusting all the fields, click Save to save the changes.

That is all, you have just added your 3-D Secure system configuration. Now you need to enable it and assign it to the payment configuration or which you want to use 3-D Secure.

After a 3-D Secure system configuration has been added, you can see it on the '3-D Secure Settings' page:

XP2.0 3d secure cardinalcommerce.png

The following actions are available:

  • View/edit the configuration details;
  • Enable/disable the configuration;
  • Delete the configuration.

To view/edit the details of your 3-D Secure system configuration:

  • On the '3-D Secure settings' page: Click on the name of the configuration (CardinalCommerce). The page showing the configuration details will be opened. If necessary, adjust the settings and click Save.

To enable/disable your 3-D Secure system configuration:

  • On the '3-D Secure settings' page:
    X-Payments 1.0: Click the [ enable ] / [ disable ] link opposite the configuration name.
    X-Payments 2.0: Click the button dropdown element opposite the configuration name and select the required action (Enable / Disable) from the menu.
    XP2.0 3d secure enable disable l.png
  • On the '3-D configuration: <configuration name>' page:
    X-Payments 1.0: Click on the 'Configuration is active [ make inactive ] / 'Configuration is inactive [ make active ] link.
    X-Payments 2.0: Click the button dropdown element near the configuration name and select the required action (Enable/Disable).
    XP2.0 3d secure enable disable detpage.png

To delete your 3-D Secure system configuration:

  • On the '3-D Secure settings' page:
    X-Payments 1.0: Click the delete icon Xp-14 x button.gif opposite the configuration name.
    X-Payments 2.0: Click the button dropdown element opposite the configuration name and select the required action (Delete configuration) from the menu.
  • On the '3-D configuration: <configuration name>' page:
    Click on the Delete configuration link at the bottom of the page. Confirm the deletion.

To assign your 3-D Secure system configuration to a payment configuration:

  • Locate the payment configuration to which you want to assign your 3-D Secure system configuration, open its details for viewing|editing, enable the option Use external module (CardinalCommerce) and save the changes.
    Note: The setting 'Use external module (CardinalCommerce)' appears on the payment configuration page only after steps 1-3 of the 'add a 3-D Secure system configuration' procedure have been properly completed.



Managing your 3-D Secure system configuration in X-Payments 2.1

To configure X-Payments to use 3-D Secure payer authentication via CardinalCommerce:

  1. Add and enable 3-D Secure for each payment configuration in your X-Payments installation that needs to use 3-D Secure via CardinalCommerce.
  2. In the details of all the online stores that will be using your 3-D Secure enabled payment configuration, specify the template that should be used for the 3-D Secure payer authentication step.


To add and enable 3-D Secure for a payment configuration:

  1. Go to the 'Payment Configurations' page (Settings -> Payment configurations) and locate the payment configuration for which you want to enable 3-D Secure payer authentication via CardinalCommerce. Click on the "3-D Secure: CardinalCommerce" link for this payment configuration. For example, if we want to configure 3-D Secure payer authentication for Authorize.Net AIM, we need to select this link:
    3d secure link 4 authorize net aim.png
    A page titled 'CardinalCommerce 3D-Secure configuration settings' opens:
    3d secure 4 authorize net aim0.png
  2. Use the 'CardinalCommerce 3D-Secure configuration settings' page to provide your CardinalCommerce module configuration settings for the selected payment configuration:
    1. Adjust the following fields:
      • Merchant ID: The MerchantID value provided to you by CardinalCommerce.
      • Processor ID: The ProcessorID value provided to you by CardinalCommerce.
      • Transaction password: The Transaction password provided to you by CardinalCommerce.
      • Test/Live mode: The mode in which you wish to use 3-D Secure (Test or Live).
      • Transaction URL: The TransactionURL provided to you by CardinalCommerce. The transaction URL for testing purposes is https://centineltest.cardinalcommerce.com:443/maps/txns.asp.
    2. When you are done adjusting all the fields, click Save to save the changes.
      The 3-D Secure system configuration will be created.
  3. Enable the 3-D Secure system configuration you have created: On the 'CardinalCommerce 3D-Secure configuration settings' page for your selected payment configuration, click the Disabled button located next to the title "Payment configuration: <Payment configuration name> 3-D Secure", and select the action Enable from the button menu:
    3d secure enable.png
    This will enable 3-D Secure payer authentication via CardinalCommerce for the selected payment configuration.


The status of 3-D Secure payer authentication service for any payment configuration can be found on the 'Payment configurations' page (Settings -> Payment configurations):

3d secure status.png

or on the 'Payment configuration details page:

3d secure status1.png


To disable/re-enable 3-D Secure for a payment configuration:

  1. Go to the 'Payment Configurations' page (Settings -> Payment configurations) and locate the payment configuration for which you want to disable/re-enable 3-D Secure payer authentication via CardinalCommerce. Click on the "3-D Secure: CardinalCommerce" link for this payment configuration. This opens the 'CardinalCommerce 3D-Secure configuration settings' page.
  2. Use the action button located at the top of the page next to the title "Payment configuration: <Payment configuration name> 3-D Secure" to select the action you require (Disable/Enable):
    3d secure disable.png


To specify the template that should be used in a specific store for 3-D Secure checks:

  1. Go to the 'Online Stores' page (Settings -> Online stores), click on the name of the store for which you want to set the template that should be used for the 3-D Secure payer authentication step.
  2. On the page that opens, select the template you require from the Template for 3-D Secure check box:
    3d secure tpl.png
  3. Click Save at the bottom of the page to save the changes.
PDF button.png This article can be downloaded as a PDF file