Draft:Adjusting PayPal Configuration Settings in X-Cart

After you choose the PayPal payment method you would like to use at your store, you must adjust its configuration settings. The configuration settings for the chosen PayPal payment method are displayed in the lower part of the PayPal configuration page.

This article provides notes on adjusting the configuration settings for specific PayPal payment methods.

PayPal Payments Standard configuration settings

The page where you adjust the configuration settings for PayPal Payments Standard is as follows:

You need to adjust the following fields:

• Account: The email address you use to access your PayPal Business account.
• Description of the purchase that will be displayed on PayPal payment page: A generic description of the purchase that should be displayed to the customer (i.e. books. music, etc). This field is optional.
• Currency: The currency that should be used for payments via this method.
• Order prefix: Your trading name or any other prefix that will help you to identify a payment transaction as originating from this store.
  
  Note: The "Order prefix" field is required when using the same PayPal account for several online stores (refer to this article for more details).
• Test/Live mode: PayPal operating mode ('live' should be selected for live stores, 'test' - for testing. Information on using PayPal in test mode is provided in the section ' Testing X-Cart's PayPal Integration').
• Action to be performed on order placement: Choose Auth only or Auth and Capture.
• Address override: When this option is enabled, the address specified by the customer during checkout in X-Cart and passed from X-Cart to PayPal overrides the PayPal member's stored address. The customer is shown the passed-in address but cannot edit it. When this option is disabled, the customer can edit the passed-in address or select another address that he/she has stored with PayPal.
  
  Note: Disabling this option may lead to a situation when the address specified by the customer during checkout in X-Cart and saved in the X-Cart order details differs from the address in the relevant PayPal transaction details. This can cause confusion as to which address the order should be shipped to.

If you have opted in for the Auth only action to be performed on order placement or if you are going to process refunds via X-Cart back-office, you must also provide your API access credentials. API access will be used to establish connection between X-Cart and PayPal API to perform Capture/Void/Refund transactions.

Note: Help on retrieving your API access credentials is available here: http://qwyx.co/apihowto.

Adjust the following fields:

• API access username: Your API access username as provided in your PayPal account profile.
• API access password: Your API access password as provided in your PayPal account profile.
• Use PayPal authentication method: The type of authentication method that you wish to use (API signature or API certificate). If you choose to use an API SSL client-side certificate as your credential, install the certificate on the web server in the directory <xcart_dir>/payment/certs/, where <xcart_dir> is the name of the directory in which X-Cart is installed.
• API certificate filename: If you have chosen API certificate as your PayPal authentication method, specify the filename of your API certificate.
• API signature: If you have chosen API signature as your PayPal authentication method, copy and paste your API signature into this field.

PayPal Payments Pro configuration settings

The following notes refer only to PayPal Payments Pro payment method using PayPal API. For notes on the configuration settings for Website Payments Pro Payflow Edition (the PayPal Payments Pro method using Payflow API), see the Website Payments Pro Payflow Edition configuration settings section.

The page where you adjust the configuration settings for PayPal Payments Pro is as follows:

To ensure that PayPal integration will work correctly for your store, you must configure PayPal Payments Pro in X-Cart in exactly the same way as you have configured PayPal Payments Pro (PayPal API) in X-Payments:

• Select payment method configured on X-Payments side: Select the name of the payment configuration you will use.
• API Access username Same as contents of the "API Access Username" field for the selected payment configuration in X-Payments.
• API Access password: Same as contents of the "API Access Password" field for the selected payment configuration in X-Payments.
• Use PayPal authentication method: The type of authentication method specified in the "API method" field for the selected payment configuration in X-Payments. If you have chosen an API SSL client-side certificate as your credential, install the certificate on the web server in the directory <xcart_dir>/payment/certs/, where <xcart_dir> is the name of the directory in which X-Cart is installed.
• API certificate filename: If you have chosen API certificate as your PayPal authentication method, specify the filename of your API certificate.
• API signature: If you have chosen API signature as your PayPal authentication method, copy and paste your API signature into this field.
• Currency: The currency specified in the "Currency" field for the selected payment configuration in X-Payments.
• Test/Live mode: The PayPal operating mode specified in the "Test/Live mode" field for the selected payment configuration in X-Payments.
• Action to be performed on order placement: The action specified in the "Initial transaction" field for the selected payment configuration in X-Payments.
• Order prefix: The order prefix specified in the "Order prefix" field for the selected payment configuration in X-Payments.

You can also adjust the following optional fields:

• Express Checkout specific: Gradient color: and Express Checkout specific: Header Image URL:

Website Payments Pro Payflow Edition configuration settings

The page where you adjust the configuration settings for Website Payments Pro Payflow Edition is as follows:

To ensure that PayPal integration will work correctly for your store, you must configure Website Payments Pro Payflow Edition in exactly the same way as you have configured PayPal Payments Pro (Payflow API) in X-Payments:

• Select payment method configured on X-Payments side: Select the name of the payment configuration you will use.
• Partner: Same as contents of the "Partner name" field for the selected payment configuration in X-Payments.
• Merchant login: Same as contents of the "Merchant login" field for the selected payment configuration in X-Payments.
• User: Same as contents of the "User" field for the selected payment configuration in X-Payments.
• Password: Same as contents of the "Password" field for the selected payment configuration in X-Payments.
• Currency: The currency specified in the "Currency" field for the selected payment configuration in X-Payments.
• Test/Live mode: The PayPal operating mode specified in the "Test/Live mode" field for the selected payment configuration in X-Payments.
• Action to be performed on order placement: The action specified in the "Initial transaction" field for the selected payment configuration in X-Payments.
• Order prefix: The order prefix specified in the "Order prefix" field for the selected payment configuration in X-Payments.

You can also adjust the following optional fields:

• Express Checkout specific: Gradient color: and Express Checkout specific: Header Image URL:
• Express Checkout specific: Page Style:

Express Checkout configuration settings

The page where you adjust the configuration settings for PayPal Express Checkout is as follows:

You need to adjust the following fields:

• API access username: Your API access username as provided in your PayPal account profile.
• API access password: Your API access password as provided in your PayPal account profile.
• Use PayPal authentication method: The type of authentication method that you wish to use (API signature or API certificate). If you choose to use an API SSL client-side certificate as your credential, install the certificate on the web server in the directory <xcart_dir>/payment/certs/, where <xcart_dir> is the name of the directory in which X-Cart is installed.
• API certificate filename: If you have chosen API certificate as your PayPal authentication method, specify the filename of your API certificate.
• API signature: If you have chosen API signature as your PayPal authentication method, copy and paste your API signature into this field.
• Action to be performed on order placement: Choose Auth only or Auth and Capture.
• Test/Live mode: PayPal operating mode ('live' should be selected for live stores, 'test' - for testing. Information on using PayPal in test mode is provided in the section ' Testing X-Cart's PayPal Integration').
• Currency: The currency that should be used for payments via this method.
• Order prefix: Your trading name or any other prefix that will help you to identify a payment transaction as originating from this store.
  
  Note: The "Order prefix" field is required when using the same PayPal account for several online stores (refer to this article for more details).

You can also adjust the following optional fields:

• Gradient color: and Header Image URL:
  

Important:

• If you intend to use Express Checkout, you must make the Title field not required on the User Profile page in X-Cart Admin area. Express Checkout does not return this value when checkout is completed on the PayPal side, so if this field is required, X-Cart will not be able to complete checkout without it.
• If you want PayPal Express Checkout to be available to your customers in the US and Canada, make sure the State field is available to them during profile creation. If this field is not specified in the customer profile, PayPal Express Checkout will not function correctly.

PayPal Payments Advanced configuration settings

The page where you adjust the configuration settings for PayPal Payments Advanced is as follows:

You need to adjust the following fields:

• Partner: Partner ID of the partner that signed you up for the account. If you signed up directly through PayPal, this will be "PayPal".
• Merchant login: The merchant login name that you chose when you signed up for the service.
• User: The username that you have set up for running transactions. If you have not specifically set up a username to run transactions, then this will be the same as the "Merchant login".
• Password: The password for the user account denoted in the "User" field.
  
  Note: The values for the fields Partner name, Merchant login, User and Password are your Payflow API credentials that were set up when you created your PayPal Manager (Payflow) account. They are the same as your PayPal Manager login at https://paypal.manager.com.
• Currency: The currency that should be used for payments via this method.
• Test/Live mode: PayPal operating mode. ('Live' should be selected for live stores, 'Test' - for testing. Information on using PayPal in test mode is provided in the section ' Testing X-Cart's PayPal Integration').
• Action to be performed on order placement: Choose Auth or Auth and capture.
• Order prefix: Your trading name or any other prefix that will help you to identify a payment transaction as originating from this store.
  
  Note: The "Order prefix" field is required when using the same PayPal account for several online stores (refer to this article for more details).
• Gradient color:
• Header Image URL:
• Section border color:
• Section header text color:
• Payment button background color:
• Payment button text color:
• Express Checkout specific: Page Style:

Important:

• To enhance the security of your PayPal Payments Advanced/Payflow Link account, PayPal recommends that you enable the Secure Token setting in your PayPal Manager account. To enable this setting, log in to PayPal Manager, then go to Service Settings > Hosted Checkout Pages > Set Up, and set Enable Secure Token to Yes. When you are done, click Save Changes.

Payflow Link configuration settings

The page where you adjust the configuration settings for Payflow Link is as follows:

The configuration settings for Payflow Link should be adjusted the same way as for PayPal Payments Advanced.