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

Dohtur: Redirected page to X-Cart:Adjusting PayPal Configuration Settings in X-Cart

2012-12-24T22:55:35Z

Redirected page to X-Cart:Adjusting PayPal Configuration Settings in X-Cart

Dohtur: /* Express Checkout configuration settings */

2012-12-19T23:48:17Z

‎Express Checkout configuration settings

Dohtur at 23:46, 19 December 2012

2012-12-19T23:46:21Z

Dohtur: /* Express Checkout configuration settings */

2012-12-19T23:43:39Z

‎Express Checkout configuration settings

Dohtur: /* Express Checkout configuration settings */

2012-12-19T22:55:07Z

‎Express Checkout configuration settings

Dohtur: /* PayPal Payments Standard configuration settings */

2012-12-19T22:52:45Z

‎PayPal Payments Standard configuration settings

Dohtur: /* PayPal Payments Advanced configuration settings */

2012-12-19T18:47:38Z

‎PayPal Payments Advanced configuration settings

Dohtur at 10:51, 19 December 2012

2012-12-19T10:51:36Z

Dohtur at 10:49, 19 December 2012

2012-12-19T10:49:00Z

Dohtur at 10:36, 19 December 2012

2012-12-19T10:36:50Z

← Older revision		Revision as of 22:55, 24 December 2012
Line 1:		Line 1:
		+	#REDIRECT [[X-Cart: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.		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.

@@ Line 80: / Line 80: @@
 :[[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.
+:* '''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").
+:* '''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].}}

@@ Line 83: / Line 83: @@
 :* '''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:
 :* '''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.

@@ Line 79: / Line 79: @@
 The page where you adjust the configuration settings for <u>PayPal Express Checkout</u> is as follows:
 :[[File:Pp_express_checkout.png|border]]
-You need to adjust the following fields:
+Start by choosing the type of credentials you will use for Express Checkout:
 :* '''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.
@@ Line 85: / Line 88: @@
 :* '''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''.
+After providing your credentials, adjust the rest of the fields:
 :* '''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]]').
 :* '''Currency''': The currency that should be used for payments via this method.

@@ Line 82: / Line 82: @@
 :* '''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 <u><xcart_dir>/payment/certs/</u>, where <u><xcart_dir></u> is the name of the directory in which X-Cart is installed.
+:* '''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.
 :* '''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.
@@ Line 96: / Line 96: @@
 :* 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.
 <br /><br />
 == PayPal Payments Advanced configuration settings ==
 The page where you adjust the configuration settings for <u>PayPal Payments Advanced</u> is as follows:

@@ Line 107: / Line 107: @@
 :* '''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.<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:
+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 of PayPal Express Checkout pages and the design of PayPal Payments Advanced embedded template so they look like your own pages, giving the customer a consistent visual presentation:
 :* '''Gradient color''': Gradient fill color of the border around the cart review area.
 :* '''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.
-:* '''Section border color''':
+:* '''Section border color''': The color of the border around the embedded template.
-:* '''Section header text color''':
+:* '''Section header text color''': The color of text in the embedded template header.
-:* '''Payment button background color''':
+:* '''Payment button background color''': The color of the '''Pay Now'''/'''Submit''' button.
-:* '''Payment button text color''':
+:* '''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.
@@ Line 129: / Line 129: @@
 :* 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'''.
 <br /><br />
 == Payflow Link configuration settings ==
 The page where you adjust the configuration settings for <u>Payflow Link</u> is as follows:

@@ Line 43: / Line 43: @@
 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.
-:* '''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, .png, and .swf. 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: 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 61: / Line 61: @@
 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.
-:* '''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, .png, and .swf. 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: 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.
@@ Line 90: / Line 90: @@
 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:
 :* '''Gradient color:''' Gradient fill color of the border around the cart review area.
-:* '''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, .png, and .swf. 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 />
+:* '''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 />
 '''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.
@@ Line 109: / Line 109: @@
 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:
 :* '''Gradient color''': Gradient fill color of the border around the cart review area.
-:* '''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, .png, and .swf. 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.
+:* '''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.
 :* '''Section border color''':
 :* '''Section header text color''':