X-Cart:Adjusting PayPal Configuration Settings in X-Cart - Revision history

Seyfin: /* PayPal Payments Pro configuration settings */

2013-12-12T07:39:49Z

‎PayPal Payments Pro configuration settings

Dohtur: /* Website Payments Pro Hosted configuration settings */

2013-04-22T12:06:59Z

‎Website Payments Pro Hosted configuration settings

Dohtur: /* Website Payments Pro Hosted configuration settings */

2013-04-22T11:48:29Z

‎Website Payments Pro Hosted configuration settings

Dohtur: /* Website Payments Pro Hosted configuration settings */

2013-04-10T14:03:03Z

‎Website Payments Pro Hosted configuration settings

Dohtur at 14:00, 10 April 2013

2013-04-10T14:00:31Z

Dohtur at 13:30, 10 April 2013

2013-04-10T13:30:21Z

Dohtur: /* PayPal Payments Standard configuration settings */

2013-04-03T14:12:33Z

‎PayPal Payments Standard configuration settings

Dohtur at 19:21, 24 December 2012

2012-12-24T19:21:45Z

Show changes

Seyfin at 10:56, 12 December 2012

2012-12-12T10:56:08Z

Seyfin: /* Adjusting the settings for Website Payments Pro and Website Payments Pro Payflow Edition */

2012-11-08T08:09:10Z

‎Adjusting the settings for Website Payments Pro and Website Payments Pro Payflow Edition

@@ Line 47: / Line 47: @@
 == PayPal Payments Pro configuration settings ==
-The following notes refer only to <u>PayPal Payments Pro</u> payment method using PayPal API. For notes on the configuration settings for <u>Website Payments Pro Payflow Edition</u> (the PayPal Payments Pro method using Payflow API), see the [[Draft:Adjusting_PayPal_Configuration_Settings_in_X-Cart#Website Payments Pro Payflow Edition configuration settings | Website Payments Pro Payflow Edition configuration settings]] section.<br /><br />
+The following notes refer only to <u>PayPal Payments Pro</u> payment method using PayPal API. For notes on the configuration settings for <u>Website Payments Pro Payflow Edition</u> (the PayPal Payments Pro method using Payflow API), see the [[X-Cart:Adjusting_PayPal_Configuration_Settings_in_X-Cart#Website Payments Pro Payflow Edition configuration settings | Website Payments Pro Payflow Edition configuration settings]] section.<br /><br />
 The page where you adjust the configuration settings for <u>PayPal Payments Pro</u> is as follows:
 : [[File:Pp_payments_pro.png|border]]
@@ Line 65: / Line 65: @@
 :* '''Express Checkout specific: Header Image URL:''' Logo to be displayed on the header of the PayPal payment pages. Enter the URL for an image that is a maximum size of 750 pixels wide by 90 pixels high; larger images will be cut to this size. The image must be in a valid graphics format such as .gif, .jpg or .png. The image will appear at the top left of the payment page.<br />We recommend that you enter an image URL only if the image is stored on a secure (https) server. Otherwise, your customer's web browser will display a message that the payment page contains nonsecure items.
 <br /><br />
 == Website Payments Pro Payflow Edition configuration settings ==

@@ Line 39: / Line 39: @@
 :* '''Order prefix''':  Your trading name or any other prefix that will help you to identify a payment transaction as originating from this store.<br />{{Note1 | '''Note:''' The "Order prefix" field is required when using the same PayPal account for several online stores (refer to [[X-Cart:PayPal#This_invoice_has_already_been_paid._For_more_information.2C_please_contact_the_merchant | this article]] for more details).}}
 :* '''Payflow vendor''': The Login ID or merchant login you created when you signed up for PayPal Merchant Services. The user is also the vendor, unless you have created additional accounts (users) within PayPal Manager.
-:* '''Payflow partner''': Your partner depends on how you registered for your Payflow account.
+:* '''Payflow partner''': The PayPal partner/reseller through which you registered for your Payflow account.
 The page also inludes options for presenting the checkout pages that appear when the buyer logs into PayPal during checkout. You can use them to customize the appearance PayPal Express Checkout pages so they look like your own pages, giving the customer a consistent visual presentation:
 :* '''Express Checkout specific: Gradient color:''' Gradient fill color of the border around the cart review area.

@@ Line 38: / Line 38: @@
 :* '''Action to be performed on order placement''': ''Auth only'' 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.<br />{{Note1 | '''Note:''' The "Order prefix" field is required when using the same PayPal account for several online stores (refer to [[X-Cart:PayPal#This_invoice_has_already_been_paid._For_more_information.2C_please_contact_the_merchant | this article]] for more details).}}
 The page also inludes options for presenting the checkout pages that appear when the buyer logs into PayPal during checkout. You can use them to customize the appearance PayPal Express Checkout pages so they look like your own pages, giving the customer a consistent visual presentation:
 :* '''Express Checkout specific: Gradient color:''' Gradient fill color of the border around the cart review area.

@@ Line 37: / Line 37: @@
 :* '''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 '[[X-Cart:PayPal#Testing_your_PayPal_payment_methods | Testing your PayPal payment methods]]').
 :* '''Action to be performed on order placement''': ''Auth only'' 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.
+:* '''Order prefix''':  Your trading name or any other prefix that will help you to identify a payment transaction as originating from this store.<br />{{Note1 | '''Note:''' The "Order prefix" field is required when using the same PayPal account for several online stores (refer to [[X-Cart:PayPal#This_invoice_has_already_been_paid._For_more_information.2C_please_contact_the_merchant | this article]] for more details).}}
 The page also inludes options for presenting the checkout pages that appear when the buyer logs into PayPal during checkout. You can use them to customize the appearance PayPal Express Checkout pages so they look like your own pages, giving the customer a consistent visual presentation:
 :* '''Express Checkout specific: Gradient color:''' Gradient fill color of the border around the cart review area.

@@ Line 30: / Line 30: @@
 : [[File:Pp_hosted.png|border]]
 You need to adjust the following fields:
+:* '''API Access username''' and '''API Access password''': Your API username and API password as provided by your PayPal account.<br />{{Note1|'''Note''': Help on retrieving your API username and API password, as well as your API signature/certificate, is available here: http://qwyx.co/apihowto }}
 <br /><br />

@@ Line 1: / Line 1: @@
 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.
@@ Line 24: / Line 24: @@
 :* '''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.
 <br /><br />
@@ Line 63: / Line 70: @@
 :* '''Express Checkout specific: Gradient color:''' Gradient fill color of the border around the cart review area.
 :* '''Express Checkout specific: Header Image URL:''' Logo to be displayed on the header of the PayPal payment pages. Enter the URL for an image that is a maximum size of 750 pixels wide by 90 pixels high; larger images will be cut to this size. The image must be in a valid graphics format such as .gif, .jpg or .png. The image will appear at the top left of the payment page.<br />We recommend that you enter an image URL only if the image is stored on a secure (https) server. Otherwise, your customer's web browser will display a message that the payment page contains nonsecure items.
 :* '''Express Checkout specific: Page Style:''' Name of the page style that you created in your PayPal profile. If you haven't created one, leave this blank.
 To create your custom PayPal payment page, follow these steps:
@@ Line 79: / Line 86: @@
 The page where you adjust the configuration settings for <u>PayPal Express Checkout</u> is as follows:
 :[[File:Pp_express_checkout.png|border]]
 Start by choosing the type of credentials you will use for Express Checkout:
 :* '''E-Mail address to accept PayPal payments''': This option allows you to start accepting Express Checkout payments immediately by simply plugging in the email address where you would like to receive payments. With this option enabled only basic Express Checkout functionality will be available (no support for Auth initial transactions with subsequent Capture/Refund). This option is a good choice for beginner merchants: you will be able to create a PayPal account later after you have received a real transaction from your customers.
 :* '''API credentials for payments and post-checkout operations''': This option should be selected if you are going to use "post-checkout operations" in your store (Auth initial transactions with subsequent Capture/Refund).
 If you have selected the '''API credentials for payments and post-checkout operations''' option, specify your API credentials:
 :: {{Note1|'''Note:''' Help on retrieving your API access credentials is available here: [http://qwyx.co/apihowto http://qwyx.co/apihowto].}}
 :* '''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'').<br />The simplest authentication method is using an API Signature, an encrypted string value that you include with your API calls to identify yourself. Use this method if you want the fastest and easiest way to use the PayPal API.<br />An API Certificate is a file that you download from PayPal that contains a private key and public certificate which identify you to PayPal. Use this method if you have full control of your web server and are familiar with SSL encryption.<br />If you choose to use an API SSL client-side certificate as your credential, install the certificate on the web server in the directory <u><xcart_dir>/payment/certs/</u>, where <u><xcart_dir></u> is the name of the directory in which X-Cart is installed.
@@ Line 121: / Line 128: @@
 :* '''Payment button background color''': The color of the '''Pay Now'''/'''Submit''' button.
 :* '''Payment button text color''': The color of the text on the '''Pay Now'''/'''Submit''' button.
 :* '''Express Checkout specific: Page Style''': Name of the page style that you created in your PayPal profile. If you haven't created one, leave this blank.
 To create your custom PayPal payment page, follow these steps:

@@ Line 13: / Line 13: @@
 :* '''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.<br />{{Note1 | '''Note:''' The "Order prefix" field is required when using the same PayPal account for several online stores (refer to [[X-Cart:PayPal#This_invoice_has_already_been_paid._For_more_information.2C_please_contact_the_merchant | 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 '[[X-Cart:Testing_PayPal_Integration | Testing X-Cart's PayPal Integration]]').
+:* '''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 '[[X-Cart:PayPal#Testing_your_PayPal_payment_methods | Testing your PayPal payment methods]]').
 :* '''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.<br />{{Note1|'''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.
 :: {{Note1|'''Note:''' Help on retrieving your API access credentials is available here: [http://qwyx.co/apihowto 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'').<br />The simplest authentication method is using an API Signature, an encrypted string value that you include with your API calls to identify yourself. Use this method if you want the fastest and easiest way to use the PayPal API.<br />An API Certificate is a file that you download from PayPal that contains a private key and public certificate which identify you to PayPal. Use this method if you have full control of your web server and are familiar with SSL encryption.<br />If you choose to use an API SSL client-side certificate as your credential, install the certificate on the web server in the directory <u><xcart_dir>/payment/certs/</u>, where <u><xcart_dir></u> is the name of the directory in which X-Cart is installed.

@@ Line 1: / Line 1: @@
 The page allowing you to adjust PayPal configuration settings can be accessed by clicking the link 'Configure' below PayPal entry in the <u>'Payment methods</u>' dialog box. The page is titled '<u>Payment gateways</u>', and it contains a dialog box titled '<u>Settings</u>'. The upper part of the '<u>Settings</u>' dialog box provides names of PayPal solutions pre-integrated with X-Cart and allows you to choose a solution that you would like to use at your store. The lower part provides a set of fields that need to be adjusted to configure the selected solution (The contents of the lower part changes depending on the solution selected).
@@ Line 106: / Line 108: @@
 *If you want PayPal Express Checkout to be available for customers from the US and Canada, make sure that the 'State' field is available to them during profile creation. If the 'State' field is not specified in the customer profile, PayPal Express Checkout will not function correctly.}}
 [[Category:X-Cart user manual]]
 [[Category:X-Cart user manual]]

@@ Line 28: / Line 28: @@
 . Click the '''Update''' button to save the changes.
-== Adjusting the settings for Website Payments Pro and  Website Payments Pro Payflow Edition ==
+== Adjusting the settings for Website Payments Pro and Website Payments Pro Payflow Edition ==
 For PayPal Pro, X-Cart provides two options: '<u>Website Payments Pro</u>' and '<u>Website Payments Pro Payflow Edition</u>'.