Search Descriptions Version
 
 
This article applies to: MultiStore

PayPal


PayPal Logo
The shopping cart software integrates with 5 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, with order notification sent back to the cart. This method does not require customers to have a PayPal account.
PayPal Express Checkout - This service also takes customers off of the store site to pay, and brings them back for shipping and final order processing, providing notifications of new orders for store admins.
PayPal Payments Advanced - This option allows customers to pay by credit card or with their PayPal account, without ever leaving your site. Payment is handled through a form on PayPal's site which is embedded on your checkout page. This means your site never 'touches' the credit card information, which is great for PCI compliance.
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. Note that if you enable PayPal Website Payments Pro, you also enable PayPal Express Checkout.
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. Note that if you enable PayPal PayFlow Pro, you also enable PayPal Express Checkout.

NOTE: PayPal Standard, Express and Advanced options now include the Bill Me Later feature.

NOTE: Version 9410 introduces an easy way to advertise the Bill Me Later feature, available with all PayPal payment methods.

NOTE: Only one non-gateway PayPal service can be enabled at one time on the checkout page. If multiple methods are enabled (PayPal Standard and PayPal Express Checkout, for example) only one will be shown. The options are shown in this order of precedence:

PayPal Account Creation

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

1 - Open a PayPal Business account by clicking the PayPal logo at the top of this page.

2 - Log into your Paypal Account

3 - Click on the Profile tab

4 - Click the "View details" link in the API Access section

5 - Click the “Request API Credentials” link. NOTE: If you see information on this page about 'Certificates', the wrong integration method was chosen on a previous attempt. Click the 'Remove' button to clear out the certificate, and then move on to step 6 choosing the Signature method.

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.

NOTE: In 9200 and older versions 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 Setup

Once you have followed the steps in the 'PayPal Account Creation' section and have your PayPal account details, to enable PayPal Standard:

1. In the AspDotNetStorefront admin console, go to the Site Configuration Wizard page.

2. In the Payment Methods section, click the 'configure' link next to the PayPal Website Payments Standard entry (in MSx 9300 this is called PayPal Payments Standard).

3. Put in the values you obtained from PayPal for the 'API Username', 'API Password', 'API Signature', and 'PayPal Business ID' (in MSx 9300+ you only need the 'PayPal Account Email Address' which is the 'PayPal Business ID' email).

4. Click 'Save and Close'.

5. Finally, check the box next to PayPal Website Payments Standard and then click the 'Submit' button at the top or bottom of the page.

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: You should also set the PayPal.ReturnOKURL AppConfig to a custom topic page that complies with PayPal's terms and conditions such as pps_return.aspx once you have enabled the IPN service, or duplicate orders can get created.

NOTE: In MSx 9300 'PayPal Payments Standard' is not supported in the Smart One Page Checkout.

PayPal Express


NOTE: Click here for instructions on setting up PayPal Express in 9.4.0.0.+

Once you have followed the steps in the 'PayPal Account Creation' section and have your PayPal account details, to enable PayPal Express:

1. In the AspDotNetStorefront admin console, go to the Site Configuration Wizard page.

2. In the Payment Methods section, click the 'configure' link next to the PayPal Express Checkout entry.

3. Put in the values you obtained from PayPal for the 'API Username', 'API Password', and 'API Signature'.

4. Click 'Save and Close'.

5. Finally, check the box next to PayPal Express Checkout and then click the 'Submit' button at the top or bottom of the page.

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 first. Enabling this also requires setting either the AllowCustomerDuplicateEMailAddresses Global Config to true (Configuration - Store Maintenance), or in version 9200+ the Global Config: Anonymous.AllowAlreadyRegisteredEmail (recommended), AND the AppConfig: PasswordIsOptionalDuringCheckout
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.

NOTE: PayPal Express does not work in the Basic One Page Checkout (deprecated as of MSx9.1.0.0) option in version MSx9.3.1.0/9.3.1.1

PayPal Website Payments Pro

Once you have followed the steps in the 'PayPal Account Creation' section and have your PayPal account details, to enable PayPal Website Payments Pro:

1. In the AspDotNetStorefront admin console, go to the Site Configuration Wizard page.

2. In the Payment Gateways section, click the 'configure' link next to the PayPal Website Payments Pro entry.

3. Put in the values you obtained from PayPal for the 'API Username', 'API Password', 'API Signature', and 'PayPal BUsiness ID'.

4. Click 'Save and Close'.

5. Finally, click the radio button next to PayPal Website Payments Pro and then click the 'Submit' button.

NOTE: Enabling PayPalPro also automatically enables PayPal Express.

Telephone Support

• If you have sales related questions about setting up NEW PayPal service and would like to speak directly to a PayPal Product Specialist, call 877-455-1484.

• If you have customer service related questions regarding an EXISTING PayPal account and would like to speak directly to a PayPal Customer Service agent, call 888-221-1161.