Difference between revisions of "X-Cart:Configuring Payment Methods in X-Cart 4.5.0-4.5.2"

From X-Cart 4 Classic
Jump to: navigation, search
m
m
Line 16: Line 16:
 
* Government Check,
 
* Government Check,
 
* Traveler's Check.
 
* Traveler's Check.
Please note that manual processing of credit cards is not supported by X-Cart versions 4.5.0 and later due to PCI-DSS requirements; thus, the Credit Card payment method requiring manual processing of credit card data is no longer included.  
+
Please note that manual processing of credit cards is not supported by X-Cart versions 4.5.0 and later due to PCI-DSS requirements; thus, the Credit Card payment method requiring manual processing of credit card data is no longer included.
  
 
You can enable/disable any of the payment methods listed in the <u>Payment methods</u> section: simply select the check boxes for the payment methods you want to use and clear the check boxes for the payment methods you want to disable. Be sure to click '''Apply''' after you make any changes.
 
You can enable/disable any of the payment methods listed in the <u>Payment methods</u> section: simply select the check boxes for the payment methods you want to use and clear the check boxes for the payment methods you want to disable. Be sure to click '''Apply''' after you make any changes.
Line 28: Line 28:
 
* '''Membership''': The user membership level(s) to which the payment method is available. Hold down the Ctrl key to select multiple levels. Select ''All'' to make a payment method available to all users.
 
* '''Membership''': The user membership level(s) to which the payment method is available. Hold down the Ctrl key to select multiple levels. Select ''All'' to make a payment method available to all users.
 
* '''Pos.''': The number defining the position of the payment method; this affects the order in which payment methods are displayed to your customers.
 
* '''Pos.''': The number defining the position of the payment method; this affects the order in which payment methods are displayed to your customers.
You can edit any of the payment methods' options as you require. However, remember to click the '''Apply''' button after you make changes, or your changes will be lost.<br />
+
You can edit any of the payment methods' options as you require. However, remember to click the '''Apply''' button after you make changes, or your changes will be lost.<br /><br />
  
 
X-Cart allows you to choose a payment method for orders with zero total cost (See the ''Use this payment method for orders with zero total cost'' box below the <u>Payment methods</u> section):
 
X-Cart allows you to choose a payment method for orders with zero total cost (See the ''Use this payment method for orders with zero total cost'' box below the <u>Payment methods</u> section):
 
: [[Image:Payment_method_zero.png]]
 
: [[Image:Payment_method_zero.png]]
The payment method selected from this box will be forced on your customers when no other offline or online payment method is available for any reason. To disable this feature, leave the box empty.<br />
+
The payment method selected from this box will be forced on your customers when no other offline or online payment method is available for any reason. To disable this feature, leave the box empty.<br /><br />
  
 +
Besides payment methods that require manual payment processing, X-Cart supports a number of payment methods providing online payment processing (methods in which payments are processed automatically by payment systems external to X-Cart). Methods providing online payment processing are initially not on the list of methods displayed by the '<u>Payment methods</u>' dialog box, but can be added there. After being added to the list of payment methods, each payment method requiring online processing needs to be configured and enabled.
  
 +
To add a payment method providing online payment processing to your list of payment methods, you need to scroll down to the '<u>Payment gateways</u>' dialog box and use it to select the payment gateway or system through which the processing will be done:
 
: [[Image:Payment_gateways.png]]
 
: [[Image:Payment_gateways.png]]
 +
After selecting the desired payment gateway, click the '''Add''' button. The respective payment method will be added to the list in the '<u>Payment methods</u>' section.
 +
 +
To configure a payment method providing online payment processing, you need to adjust the standard payment method configuration fields ('''Protocol''', '''Membership''', etc) and to provide the information needed by X-Cart software to use the required payment processing API. The said information can be provided on the configuration page of the respective payment processor (can be accessed using the <u>Configure</u> link below the name of the payment method).
 +
 +
Please note that some payment gateways (like Authorize.Net, 2Checkout. Version 2, PayPal, etc) can be set up to work in test or in live mode. Live mode is the mode in which a payment gateway normally works. In live mode, all payment transactions are real, and money actually changes hands. Test mode is provided for the purpose of testing. In test mode, payment gateways work the same way as in live mode, with the exception that no actual payments are made. The mode of operation of a payment processor (test or live) can be selected, where available, on the payment processor's configuration page.
 +
 +
Payment methods providing online processing are enabled in exactly the same way as methods using manual processing: in the <u>Payment methods</u> section you select the check box to the left of the name of the payment method that needs to be enabled and click '''Apply'''.
 +
 +
{{Note1|Note: If you use any online payment methods, make sure you do not close access to the <xcart_root>/payment directory by your .htaccess file. In case access to this directory is closed, when an external server of a payment gateway tries to send a callback to X-Cart, it gets an "access denied" reply. As a result, the order will never be processed.}}
 +
 +
Information on configuring the most popular payment methods used with X-Cart is available is the [[X-Cart:User manual contents#Most Popular Payment Methods Supported by X-Cart | Most Popular Payment Methods Supported by X-Cart]] section of this manual.

Revision as of 12:01, 25 September 2012

Your store's payment methods can be managed using the Payment methods page of your store's Admin area (Settings menu -> Payment methods).

When you start working on your payment methods, the first thing you should look for on this page is the section titled Payment methods:

Payment methods1.png

Initially, this section holds a list of popular 'offline' payment methods supported by X-Cart (By 'offline' we mean payment methods that require manual processing of customers' payment details by the merchant, i.e. the store administrator, as opposed to methods in which payments are processed automatically through online payment processors). Currently, the list of X-Cart's offline payment methods includes the following:

  • Phone Ordering,
  • C.O.D. (cash on delivery),
  • Check,
  • Gift Certificate,
  • Fax Ordering,
  • Money Order,
  • Purchase Order,
  • Personal Check,
  • Business Check,
  • Wire Transfer,
  • Government Check,
  • Traveler's Check.

Please note that manual processing of credit cards is not supported by X-Cart versions 4.5.0 and later due to PCI-DSS requirements; thus, the Credit Card payment method requiring manual processing of credit card data is no longer included.

You can enable/disable any of the payment methods listed in the Payment methods section: simply select the check boxes for the payment methods you want to use and clear the check boxes for the payment methods you want to disable. Be sure to click Apply after you make any changes.

For each method, the following information is provided:

  • Methods: The payment method name as it appears to your customers. If you are not happy with the name of any method, you can change it: simply edit the contents of the 'Methods' field and click Apply. Also, if your store supports more than one language, you can use the multilanguage feature to translate the names of payment methods for your international customers. To add a translation, select the desired language from the Language selector, enter the translation into the 'Methods' field and click Apply.
  • Extra charge: Some payment methods may require an additional processing charge. Thus, the 'Extra charge' field shows the amount that customers using a specific payment method are charged as processing fee. The 'Extra charge' value can be defined as a percentage of the amount due in payment for the goods or as a flat value expressed in currency units.
  • Cash on delivery: Whether the payment method is of the type in which payment for goods is made at the time of delivery.
  • Special instructions (optional): Instructions for customers using specific payment methods. These can also be translated into multiple languages. To add a translation, select the desired language from the Language selector, enter the translation into the 'Special instructions' field and click Apply.
  • Protocol: The protocol (HTTP or HTTPS) used to transfer the customer's payment information. HTTPS should be used for any methods in which sensitive data will be entered on your website and transferred over the Internet. If you enable the HTTPS protocol for any method, make sure you have a valid SSL certificate installed and configured on your web server and the variable $https_location in config.php is defined properly. For details please refer to: Configuring HTTPS.
  • Membership: The user membership level(s) to which the payment method is available. Hold down the Ctrl key to select multiple levels. Select All to make a payment method available to all users.
  • Pos.: The number defining the position of the payment method; this affects the order in which payment methods are displayed to your customers.

You can edit any of the payment methods' options as you require. However, remember to click the Apply button after you make changes, or your changes will be lost.

X-Cart allows you to choose a payment method for orders with zero total cost (See the Use this payment method for orders with zero total cost box below the Payment methods section):

Payment method zero.png

The payment method selected from this box will be forced on your customers when no other offline or online payment method is available for any reason. To disable this feature, leave the box empty.

Besides payment methods that require manual payment processing, X-Cart supports a number of payment methods providing online payment processing (methods in which payments are processed automatically by payment systems external to X-Cart). Methods providing online payment processing are initially not on the list of methods displayed by the 'Payment methods' dialog box, but can be added there. After being added to the list of payment methods, each payment method requiring online processing needs to be configured and enabled.

To add a payment method providing online payment processing to your list of payment methods, you need to scroll down to the 'Payment gateways' dialog box and use it to select the payment gateway or system through which the processing will be done:

Payment gateways.png

After selecting the desired payment gateway, click the Add button. The respective payment method will be added to the list in the 'Payment methods' section.

To configure a payment method providing online payment processing, you need to adjust the standard payment method configuration fields (Protocol, Membership, etc) and to provide the information needed by X-Cart software to use the required payment processing API. The said information can be provided on the configuration page of the respective payment processor (can be accessed using the Configure link below the name of the payment method).

Please note that some payment gateways (like Authorize.Net, 2Checkout. Version 2, PayPal, etc) can be set up to work in test or in live mode. Live mode is the mode in which a payment gateway normally works. In live mode, all payment transactions are real, and money actually changes hands. Test mode is provided for the purpose of testing. In test mode, payment gateways work the same way as in live mode, with the exception that no actual payments are made. The mode of operation of a payment processor (test or live) can be selected, where available, on the payment processor's configuration page.

Payment methods providing online processing are enabled in exactly the same way as methods using manual processing: in the Payment methods section you select the check box to the left of the name of the payment method that needs to be enabled and click Apply.

Note: If you use any online payment methods, make sure you do not close access to the <xcart_root>/payment directory by your .htaccess file. In case access to this directory is closed, when an external server of a payment gateway tries to send a callback to X-Cart, it gets an "access denied" reply. As a result, the order will never be processed.

Information on configuring the most popular payment methods used with X-Cart is available is the Most Popular Payment Methods Supported by X-Cart section of this manual.