Search Descriptions Version
 
 
This article applies to: ML8

PayPal


The shopping cart software integrates with 4 PayPal services to provide customers different checkout options:

PayPal Website Payment Standard - This is the original PayPal service. Customers are taken off of the store site to PayPal's site to complete payment.
PayPal Express Checkout - This service also takes customers off of the store site to pay, providing notifications of new orders for store admins.
PayPal Website Payments Pro - This solution allows customers to pay by credit card directly through the store site and the funds will quickly and easily be posted to the named PayPal account.
PayPal PayFlow Pro - Probably the #1 payment gateway among our user base. Payments are captured, transmitted and processed securely and funds will go directly to the merchant account of choice. Please see this page for setup information for the PayPal PayFlow Pro gateway.

Base Setup

These steps are required for all 3 PayPal services. Version-specific additional directions are provided below.

1 - Open a PayPal Business account at http://www.paypal.com
2 - Log into your Paypal Account
3 - Go to the Profile page
4 - Click the “API Access” link
5 - Click the “Request API Credentials” link
6 - Choose the API Signature method
7 - Agree to the terms and click submit
8 - Click this link and enter the username and password you created for your PayPal Business account. You will be provided with the 3 API values needed for further steps below.
9 - Populate the following AppConfigs:

- PayPal.API.Username
- PayPal.API.Password
- PayPal.API.Signature
- PayPal.BusinessID

NOTE: In older versions of the software you may get an error when attempting a TEST PayPal purchase: "Failed to start PayPal Express Checkout! Please try another payment method." Verify that the AppConfig: PayPal.API.TestURL contains the updated URL: https://api-3t.sandbox.paypal.com/2.0/

PayPal Standard

After completing the steps above, all that is left to enable basic PayPal Standard checkout is to add it as an allowed payment method. Do that by adding 'PAYPAL' (no quotes) to the list of methods in the PaymentMethods AppConfig.

The following AppConfigs may also need to be adjusted, depending on your store's needs:

AppConfigDescription
PayPal.DefaultLocaleCodeTwo-character locale code for pages displayed by PayPal (on Paypal's end, not your storefront). Supported values: AU, DE, FR, IT, GB, ES, US
PayPal.ForceCaptureIf this is set to true, orders placed through PayPal will always be captured immediately, regardless of the transaction mode in use for the rest of the site.
PayPal.RequireConfirmedAddressIf this is set to true, only customers who have verified their address through PayPal will be allowed to complete payment.
PayPal.UseInstantNotificationPayPal orders generally require the customer to click a 'Return to Merchant' button at the end to complete checkout. Customers don't always do this, which can lead to lost orders. PayPal has created a service called 'Instant Payment Notification' that cuts down on the frequency of this. If you are using that service (configured on PayPal's end), set this AppConfig to true. NOTE: If this is set to true, you should also set the PayPal.ReturnOKURL AppConfig to 'default.aspx'.

PayPal Express

After completing the steps above, all that is left to enable PayPal Express checkout is to add it as an allowed payment method. Do that by adding 'PayPalExpress' (no quotes) to the list of methods in the PaymentMethods AppConfig.

NOTE: Enabling PayPalPro also automatically enables PayPal Express.

The following AppConfigs may also need to be adjusted, depending on your store's needs:

AppConfigDescription
PayPal.Express.AllowAnonCheckoutIf you set this to true, customers will be able to checkout through PayPal Express without registering on your site. Enabling this also requires setting the AllowCustomerDuplicateEMailAddresses AppConfig to true.
PayPal.Express.ShowOnCartPageThis determines whether or not the 'Checkout with PayPal Express' button is visible on the shopping cart page as well, or just on the final payment page.

PayPalPro

After completing the steps above, all that is left to enable PayPalPro is to set it as the payment gateway. Do that by setting the PaymentGateway AppConfig to 'PAYPALPRO' (no quotes).

NOTE: Enabling PayPalPro also automatically enables PayPal Express.