[Magento] Setting PayPal Express checkout

click to see full-sizeimage

Setting Up Your PayPal Payment Methods Toconfigure PayPal for your Magento store: In the Magento AdminPanel, choose System→Configuration. Select the PayPal tab on theleft. You'll see the following options: In the Merchant Accountpanel, you can set the following values: Merchant Country - Selectthe merchant's country, i.e. the country to which the Merchant'sPayPal account is associated. The countries available for selectionare listed according to the PayPal Worldwide reference. If themerchant country is not specified, its value is taken from DefaultCountry field located under System→Configuration→Generaltab→Countries Options panel. The payment method selectionsavailable below will be changed to reflect only those that arevalid for this country. Email Associated with PayPal MerchantAccount - Enter the email address that was used when registering amerchant account with PayPal. If not yet registered with PayPal,simply enter your email address. If the Email Associated withPayPal Merchant Account field is empty, the Website PaymentsStandard payment method will be unavailable and the ExpressCheckout method is only available if the API credentials arespecified. Instant Payment Notifications (IPNs) from PayPal are notavailable if the email address for sending IPNs and the onespecified in the Merchant Account configuration are different. Inthe Select a PayPal Solution panel, select which of the followingPayPal payment methods you'd like to have available in your store:Express Checkout Website Payments Standard Website Payments ProWebsite Payments Pro Payflow Edition (includes its own ExpressCheckout) Payflow Pro Gateway Express Checkout with Payflow ProGateway Depending on the payment method(s) you've selected, thecorresponding payment method configuration panel will becomesavailable below. Each of these is described in more detail in thefollowing sections. Enter the required information for each of yourselected PayPal payment method(s). After you've entered therequired configuration information, click the [Save Config] buttonin the upper right.

The following PayPal payment methods require that your customersalso have customer accounts in PayPal:

• Express Checkout
• Website Payments Standard
• Express Checkout for Payflow Pro

These PayPal payment methods do not require your customers tohave a PayPal account and allow them to enter their credit cardinformation directly on your website during the checkoutprocess:

• Website Payments Pro
• Website Payments Pro Payflow Edition
• Payflow Pro Gateway

Express Checkout

With this payment method enabled, the [Checkout with PayPal]button becomes available on the product view pages, in the shoppingcart, and in the mini shopping cart. Clicking the button allows thecustomer to review the shopping cart price information on thePayPal site. To use this method of payment, the customer needs tolog on to his or her customer account in PayPal. The payment systemuses the customer’s billing and shipping information taken from thecustomer’s PayPal account. The customer can then continue and willbe redirected to the Magento Review Order page. After placing theorder in Magento, the payment information is submitted to PayPaland the payment transaction is settled there.

If the customer does not use the express checkout button, thepayment information is submitted to PayPal after an order isplaced. The Express Checkout payment method can be used standalone;if the API credentials are not specified, the payment method isused in the unilateral mode. With the Express Checkout paymentmethod enabled, make sure that the API Username, API Password, andAPI Signature fields are populated; otherwise, the payment methodwill work in the unilateral mode.

Express Checkout is automatically disabled if the WebsitePayments Pro Payflow Edition payment method is enabled.

The Express Checkout payment method is applied in all countriesfrom the PayPal Worldwide reference list.

Config Options in the Express Checkout Settings Panel

• Title - Enter the name of the payment methodthat will be displayed to the customer in the Payment Informationsection of the shopping cart Checkout page. This parameter can beset up for each store view. We recommend that you use the PayPalvalue in the Title field for each store view.
• Sort Order - When you use several paymentmethods, in the Sort Order field determine the order this methodwill be displayed in the Payment Information section of theshopping cart Checkout page in the frontend.
• Payment Action - Choose the way payments willbe authorized in the PayPal payment system and the entities thatwill be created in the backend as a result of the paymentprocedure. The following options are available:
  • Authorization- payments are only authorized at the side of the PayPal system andonly an order is created in the backend of your store. The storeadministrator needs log to on to the merchant account on the PayPalsite and capture the transaction.
  • Sale- apayment is authorized and captured at PayPal's side and as a resultan order and an invoice are created in the backend of yourstore.
• Payment Applicable From - Choose customers ofwhich countries can use this method of payment. Choose between thefollowing options:
  • All AllowedCountries – customers from the default countries list canuse this payment method. (The default list of countries is definedin the Allow Countries field located under System >Configuration > General > CountriesOptions.)
  • SpecificCountries – only customers whose billing address includesone of the countries listed in the Countries Payment ApplicableFrom field that becomes available can use this payment method. Thefield basically works as a filter; so that this payment method willonly be listed for those customers whose billing address is one ofthese selected countries.
• Debug Mode - Specify whether data messagesabout all sent to the payment system and received from itinformation will be written into the system log file. The creditcard related information is not written to the log file in order toprevent credit card fraud.
• Transfer Cart Line Items - Choose whethershopping cart lines, i.e. items and their prices, are transferredseparately line by line or they are transferred as one whole withtheir price total value. If the parameter is enabled, the TransferShipping Options field becomes available.
• Transfer Shipping Options - Allows thecustomer change shipping addresses and shipping method on thePayPal web site. In the live mode, the parameter works via theHTTPS protocol only. The parameter does not work if more than tenshipping options are available.
• Shortcut on Shopping Cart - Choose whether thecustomer can use the express checkout button on the shopping cartpage and in the mini shopping cart. Clicking the button redirectsthe customer to the PayPal site where the shopping cart priceinformation can be reviewed. If the parameter is set to No, theexpress checkout button on the product page still remainsavailable.
• Shortcut on Product View - Choose whether theexpress checkout button is available on the product view page.
• Shortcut Buttons Flavor - Choose whether adynamic or a static PayPal Acceptance Mark image will be displayednext to the payment method in the Payment Information section ofthe shopping cart Checkout page. (For better image management, werecommend that you replace static images in your system withdynamic ones.)
  • Dynamic – Theappearance of dynamic images is dynamically changed by PayPal. Whensigning up for a PayPal campaign, the appearance of the imagedynamically changes during the campaign based on the parameterinformation that you add to the image URL. The express checkoutimage displayed in the following figure is a default one used byPayPal.
  • Static – Thestatic images cannot be changed dynamically. When participating ina PayPal campaign, the image code must be manually updated tochange the image displayed and restore the default image when thecampaign is over.
• Enable PayPal Guest Checkout - If set to Yes,Magento customers who are not registered with PayPal have theability to perform the payment without registering with PayPal. Inthis case, the customer needs to specify credit card informationand billing address. After PayPal validates the credit cardinformation, the customer can proceed to review the paymentinformation and perform the actual payment. If the field is set toNo, the customer must register with PayPal prior to proceeding tothe payment.
• Billing Agreement Signup - Specify whether thecustomer can sign a billing agreement when there are no activebilling agreements available in the customer account. Thestoreowner needs to apply to PayPal for enabling billing agreementsfeature. The Billing Agreement Signup parameter must be enabledonly after PayPal confirms that billing agreements are enabled foryour merchant account. Choose between the following options in theBilling Agreement Signup field:
  • Auto – thecustomer needs to sign a billing agreement.
  • Ask Customer –the customer can decide whether to sign a billing agreement.
  • Never – thecustomer cannot sign a billing agreement.

Website Payments Standard

This method redirects the customer to the PayPal site when theyplace their order. For customers with a PayPal customer accountwith credit card information specified, payment is a one-stepprocedure as the customer only needs to click the Pay Now buttonand expect for purchased items delivery.

The Website Payments Standard payment method will be unavailableor becomes disabled if Website Payments Pro and/or Website PaymentsPro Payflow Edition are enabled. The Website Payments Standardmethod of payment is applied in all countries from the PayPalWorldwide reference list.

Config Options in the Website Payment Standard Panel

For detailed information about the configuration parameters ofthe Website Payments Standard payment method, refer to the Express Checkout section above.

Website Payments Pro

When the Website Payments Pro method is enabled customers don'tneed to have an account with PayPal and they are not redirected tothe PayPal web site during checkout. They only need to providetheir credit card information in the Payment Information section ofthe Checkout process when they place an order. PayPal will processthe payment using the specified credit card information through itsPayPal all-in-one solution. The Express Checkout payment method(described above) is also automatically selected and cannot bedisabled when the Website Payments Pro payment method isenabled.

The Website Payments Pro method of payment is only applied inthe United States, the United Kingdom, and Canada.

Config Options in the Website Payments Pro Panel

• Title - We recommend that for each store viewyou set the payment method title (which will be visible on yourcheckout pages) to something meaningful for your customers.Generally "Debit Card" or "Credit Card" work well.
• Under Credit Card Settings section, in theAllowed Credit Card Types field, select allallowed types of credit cards that can be used for performingpayments through the PayPal system. In the Payment Informationsection of the Checkout page in the frontend, the customer canchoose among the specified in this list credit card types. Thefollowing credit card types are available:
  • AmericanExpress (Note: American Express cards require signing anadditional agreement. You can learn more at http://www.paypal.com/amexupdate.)
  • Visa
  • MasterCard
  • Discover
  • Switch/Maestro
  • Solo
• Require CVV Entry - Choose whether a creditcard verification number must be provided by the customer whenentering credit card information during checkout. The Card SecurityCode provides an additional security measure to prevent card misusewithin on-line transactions. (The Card Security Code is also knownas the Card Verification Value.)
• 3D Secure Card Validation - Choose whethercredit cards will be verified through the Centinel 3D Securesystem. The 3D Secure functionality used for credit cardverification must first be set up under System >Configuration > SALES > PaymentServices > 3D Secure Credit Card Verification. Inthis case, credit card validation will be performed by the externalCentinel® system when the PayPal Website Payments Pro paymentmethod is selected. If the parameter is enabled, the following twofields become available: Severe 3D Secure CardValidation - Choose whether severe validation will beapplied to credit cards by the Centinel system. Severe credit cardvalidation removes the charge back liability on merchant.
• Centinel Custom Api URL - Enter the URLprovided by Centinel which will establish the connection with theCentinel system for credit card validation.

For detailed information about the rest of the configurationparameters for the Website Payments Pro payment method, refer tothe Express Checkout section above.

Website Payments Pro (Payflow Edition)

Customers using this payment method do not need to have acustomer account with PayPal. Credit card information is enteredduring the checkout process. After the order is placed, the PayPalpayment system processes credit card payments through the PayflowPro Gateway.

When Website Payments Pro Payflow Edition is enabled, theExpress Checkout for Payflow Pro payment method is automaticallyenabled and it uses Website Payments Pro Payflow Edition APIcredentials for connecting to PayPal.

The Website Payments Pro Payflow Edition payment method is onlyapplied for United States and the United Kingdom. The storeownerneeds to have a Payflow Pro account with PayPal to set up theconnection to the payment system. The account information providedduring registration must be entered in the Api/Integration fieldgroup. For more information about the Api/Integration parameters,refer to the Setting Up API Integration section of thisarticle.

The allowed credit card types for the Website Payments ProPayflow Edition payment method are Visa, MasterCard,Switch/Maestro, and Solo.

Config Options in the Website Payments Pro (Payflow Edition)Panel

For detailed information about the rest of the configurationparameters for the Website Payments Pro Payflow Edition paymentmethod, refer to the Express Checkout section above.

Payflow Pro Gateway

Customers using this payment method do not need to have acustomer account with PayPal. Credit card information is enteredduring the checkout process. After the order is placed, the PayPalpayment system processes credit card payments through the PayflowPro Gateway.

The Payflow Pro Gateway payment method, also known as VeriSign,is only applied in the United States, the United Kingdom,Australia, and New Zealand.

The merchant needs to have a Payflow Pro account with PayPal toset up the connection to the payment system. The accountinformation provided during registration must be entered in theApi/Integration field group. For more information about theApi/Integration parameters, refer to the Setting Up API Integrationsection of this article.

The allowed credit card types for the Website Payments ProPayflow Edition payment method are American Express, Visa,MasterCard, Discover, and JCB. American Express cards requiresigning an additional agreement. You can learn more at http://www.paypal.com/amexupdate.

Config Options in the Payflow Pro Gateway Panel

For detailed information about the rest of the configurationparameters for the Payflow Pro Gateway payment method, refer to theExpress Checkout section above.

Express Checkout for Payflow Pro

Express Checkout for Payflow Pro cannot be used standalone. Ituses API credentials of the Payflow Pro Gateway or Website PaymentsPro Payflow Edition payment methods. If both these methods areenabled, Express Checkout will use API credentials of the WebsitePayments Pro Payflow Edition payment method.

Customers using the Express Checkout payment method do not haveto enter billing and shipping information during the checkoutprocess as this information is stored in the PayPal payment systemand the customers do not have to re-enter it on your website againand again.

Config Options in the Express Checkout for Payflow ProPanel

Configuring API Integration to PayPal

API credentials must be specified in order to establish aconnection to the PayPal API server. The Website Payments ProPayflow Edition and Payflow Pro Gateway payment methods require thespecific API credentials the merchant received when registering fora Payflow Pro merchant account.

To set up the API:

1. In the Magento Admin Panel, chooseSystem→Configuration. Select thePayPal tab on the left. You'll see the followingoptions:
2. In the API/Integration Setting panel, you canset the following values:
   • In the API Username, APIPassword, and API Signature fields, enterthe API username, password, and signature provided by the PayPalpayment system. API credentials can be located by clicking the APICredentials link in your PayPal merchant account.
   • Click the [Get Credentials from PayPal] buttonto be redirected to the PayPal site where you can get the APIcredentials for your merchant account. When in dev and testingphases, click the Sandbox Credentials button in your PayPal accountto log on to your sandbox test account, and click the APICredentials link to acquire the necessary information.
   • Sandbox Mode - Indicate if you're in test orproduction mode for the PayPal payment system merchant account. TheSandbox mode helps testing the integration of Magento with thePayPal payment system. Transactions that are submitted while theaccount is in the Sandbox mode are not actually submitted to thecredit card and electronic check processing networks, and creditcard or bank accounts are not actually charged. Therefore, they donot have a valid transaction ID. Once you've finished testing theintegration and website, the sandbox mode must be turned off.
   • API Uses Proxy - Indicate whether a proxyserver will be used for establishing the connection between yourMagento store and the PayPal payment system. This is used if theserver has a firewall, and there’s no direct access to the PayPalserver. You can use a third party server to relay the traffic.
     • If you select Yes, two additional fields for specifying theproxy host and port become available. In the ProxyHost and Proxy Port fields, specify theaddress of the proxy server and its port number to establish theconnection between Magento and the PayPal payment system.
   • Click the [Save Config] button or proceed tofurther payment methods configuration.

Configuring the Frontend Experience

You can also easily set the style of the payment page and thePayPal logo used by Magento without having to customize your themeor code.

1. In the Magento Admin Panel, chooseSystem→Configuration. Select thePayPal tab on the left. You'll see the followingoptions:
2. In the Frontend Experience Settings panel, youcan set the following values:
   • PayPal Product Logo - Choose an additionalPayPal logo that will be displayed on the catalog and product viewpages and on the home. Out-of-the-box the logo is displayed in theright column on the home page. Customers who are already used tousing PayPal for payments can easily see that your store supportsPayPal payments. The following options are available:
     • No Logo
     • We prefer PayPal (150 x 60)
     • We prefer PayPal (150 x 40)
     • Now accepting PayPal (150 x 60)
     • Now accepting PayPal (150 x 40)
     • Payments by PayPal (150 x 60)
     • Payments by PayPal (150 x 40)
     • Shop now using (150 x 60)
     • Shop now using (150 x 40)
   • In the PayPal Merchant Pages Style section,make changes to the appearance of pages on the PayPal web sitewhere the customer is redirected.
     • Page Style - Specify the custom payment pagestyle from your merchant account profile. The allowed values are"paypal", "primary" (default), your_custom_value.
     • Header Image URL - Specify the URL for theimage that will be displayed in the upper left part of the checkoutpage. The size of an image should not exceed 750 X 90 pixels.
     • Header Background Color - Specify acase-insensitive six-character HTML hexadecimal color code inASCII. This will be the background color for the header of thecheckout page.
     • Header Border Color - Specify acase-insensitive six-character HTML hexadecimal color code inASCII. This is the color of the 2-pixel line around the headerspace.
     • Page Background Color - Specify acase-insensitive six-character HTML hexadecimal color code inASCII. This is the background color of the checkout page around theheader and payment form.
3. Click the [Save Config] button and make sureto refresh page cache after making changes to the page styleparameters.