Set Paypal As A Secondary Checkout For Your Store



PayPal recognizes that not every business is building its digital commerce experience in-house. If you are one of those businesses, PayPal has good news for you. More than 300 eCommerce solution providers already offer a PayPal integrated option out of the box. Following is a snapshot of the most popular eCommerce and ERP platforms that offer PayPal integration capabilities.

For a more comprehensive list of 3rd party solution platforms, see the Solution Providers Directory.

Note: To use a third-party shopping cart, you need to set up third-party permissions for the provider as described in Granting a third party permissions. For additional instructions, refer to the documentation from the shopping cart provider. No shopping cart specific instructions are available on this site. For transaction errors, see API error codes.

Online stores

Whether you are updating your existing shopping cart to set-up your PayPal integration or you are comparing different platforms for a new online store, the following ecommerce providers offer a variety of out-of-the-box or custom cart configurations. Online stores are further categorized based on the level of customization offered in the solution:

Valid before February 2019. Customers who use checkout.js can access reference and support material in this Checkout guide. However, PayPal does not update checkout.js with new features and enhancements. PayPal Checkout offers several style options to customize the appearance and behavior of your smart payment button. PayPal has just introduced one of the first major changes to its checkout process in years. Shiny new branding and checkout page styling options are being rolled out for merchants to take advantage of. The new checkout pages have been rated faster in usability testing by PayPal which helps tremendously to reduce shopping cart abandonment. Also introduced with the.

Set PayPal as a Secondary Checkout For Your Store Now, in just a few quick steps, your store can accept both credit cards and PayPal. With PayPal as a secondary checkout your store can provide new payment combinations between credit card gateways (Stripe or Authorize.net) and PayPal.

Marketplaces

Secondary

Marketplace solution providers allow you to set up a personal storefront within a sellers' conglomerate or specialty platform.

Websites

Website solution providers specialize in full-scale design, development, and systems integration services for your eCommerce website. Explore PayPal's full websites provider directory.

In-person payments

In-Person solution providers help you integrate your POS system to accept mobile payments using PayPal for both remote orders that pick-up in store, or full in-store transactions at the point of sale. Explore PayPal's full in-person provider directory.

Order forms

Paypal

Does your business rely on more complex ordering capabilities? PayPal works with several solution providers that offer form design, management, logistics, and payments to help you streamline your supply chain. Explore PayPal's full order forms provider directory.

Accounting

Accounting solution providers offer tools for integrating PayPal into your financial management strategy, from invoicing, to recurring subscription billing, to payroll. Explore PayPal's full accounting provider directory.

Fundraising

Fundraising solution providers specialize in providing support for the unique needs of non-profits and clubs, including membership management, event registration, crowd-sourcing, and fundraising. Explore PayPal's fundraising provider directory.

Entertainment and Promotions

Ticket sales and event booking require a different kind of website than a traditional online store. PayPal works with a variety of solution providers that understand the unique challenges of the entertainment, travel, and sports sales and marketing platforms. Explore PayPal's entertainment and promotions provider directory.

Important: This integration method is deprecated as of January 1, 2017. PayPal continues to support existing merchants using this method, but please be advised new features and enhancements will not be applied to these integrations. For new integrations, see the PayPal Checkout Integration Guide.

You can make these customizations to the buyer's checkout experience:

Include your company logo

You can include your company logo at the top of PayPal checkout pages.

  1. Create a logo image up to 90 pixels wide by 60 pixels high and save it in a valid graphics format, such as .gif, .jpg, or .png.
  2. Store the URL to the image on a secure (HTTPS) server.
  3. Assign the URL to the LOGOIMG parameter for NVP, or the cpp-logo-image parameter for SOAP, in the SetExpressCheckout. For example:

Note: You can also specify your company logo in your PayPal account Profile. If you specify LOGOIMG in your Express Checkout API call, it overrides the image stored in your account Profile.

Provide line item details

After a buyer logs in to PayPal, you can show line item details:

Note: If you provide PayPal a user's itemized shopping cart list and a mismatch occurs between the sum of those items and the transaction total, PayPal processes the transaction using the sum of the cart items only when the difference is within $0.50.

Item name Identifies the item and distinguishes it from other line items in the order.
Item description Identifies which of several items the buyer is purchasing. For example, you may be offering an item in different sizes. Knowing the size helps the buyer decide whether the one they selected was appropriate. If the item is an eBay auction item, it is recommended that you provide the phrase 'eBay item' in this field.
Item number Identifies an item by a number. If the item is an eBay auction item, it is recommended that you provide the eBay item number in this field.
Item unit price Specifies exactly how much one unit of the item costs. It can be a positive or negative value but not zero.
Item unit quantity Identifies the number of units the buyer is ordering. PayPal calculates the total as the product of line-item unit price and line-item unit quantity. You can also show other detailed information about the order:
  • Item total and tax. Reflects total of all items in the order and the tax, respectively.
  • Shipping and handling. Reflects the sum of the shipping and handling amounts. You must determine actual shipping and handling amounts.
  • Shipping discount. Appears as a credit in this field if the buyer is receiving a discount on shipping.
  • Insurance. Shows the insurance fee when there is insurance on shipping.
  • Total. Reflects the total of the order, including shipping, handling, tax, and other price adjustment-related items.

Note: The buyer can click the Enter gift certificate, reward, or discount link to redeem certificates, rewards, or discounts that PayPal issues, but not merchant-issued incentives.

Order detail parameters

To include order details as part of the buyer's checkout experience, call the SetExpressCheckout or DoExpressCheckoutPayment operations with these parameters:

NVP fieldSOAP fieldDescription and comments
L_PAYMENTREQUEST_n_NAMEmName Item name.
L_PAYMENTREQUEST_n_NUMBERmNumberItem number.
L_PAYMENTREQUEST_n_DESCmDescription Item description. The DESC (NVP) and OrderDescription (SOAP) fields still exist for backwards compatibility. However, L_DESCn and Description enable you to provide a more precise description for each different item purchased, such as hiking boots or cooking utensils rather than one general purpose description such as camping supplies.
L_PAYMENTREQUEST_n_AMTmAmount Item unit price. PayPal calculates the product of the item unit price and item unit quantity (below) in the Amount column of the cart review area. The item unit price can be a positive or a negative value, but not 0. You may provide a negative value to reflect a discount on an order, for example.
L_PAYMENTREQUEST_n_QTYmQuantityItem unit quantity.
PAYMENTREQUEST_n_ITEMAMTItemTotalSum of costs of all items in this order.
PAYMENTREQUEST_n_TAXAMTTaxTotalSum of tax for all items in this order.
PAYMENTREQUEST_n_SHIPPINGAMTShippingTotalTotal shipping cost for this order (8). PayPal calculates the sum of the shipping cost and the handling cost. Although you may change the value later, try to pass in a shipping amount that is reasonably accurate.
PAYMENTREQUEST_n_HANDLINGAMTHandlingTotalTotal handling cost for this order.
PAYMENTREQUEST_n_SHIPDISCAMTShippingDiscountShipping discount for this order. You specify this value as a negative number.
PAYMENTREQUEST_n_INSURANCEAMTInsuranceTotalTotal shipping insurance cost for this order.
PAYMENTREQUEST_n_AMTOrderTotalTotal of order, including shipping, handling, tax, and any other billing adjustments such as a credit due.

If you pass the generic order description parameter (PAYMENTREQUEST_n_DESC) along with any two of the following line-item parameters, the order description value does not display.

  • LPAYMENTREQUESTn_NAMEm
  • LPAYMENTREQUESTn_NUMBERm
  • LPAYMENTREQUESTn_DESCm

This example shows how to set line-item parameters in the SetExpressCheckout call.

Change the locale

You can change the locale of PayPal pages to match the language on your website using either a 2-character country code or a 5-character locale code from the supported codes listed on the NVP/SOAP API locale codes page. To change the language displayed on the PayPal pages, set the LOCALECODE parameter to one of the allowable values in the SetExpressCheckout call.

This example sets LOCALCODE to ES for Spain.

Manage shipping addresses

You can use one of these options to handle a buyer's shipping address:

Suppress the shipping address

You can suppress the display of the buyer's shipping address. You might do this if you sell a product or service that does not require shipping or if you want to handle shipping addresses separately. To suppress the shipping address, set the NOSHIPPING parameter to 1 in the SetExpressCheckout call.

Override the shipping address

If your website registration requests the buyer's shipping address, you can override the buyer's shipping address stored on PayPal. This replaces it with one you specify in the SetExpressCheckout call. The buyer cannot edit the overridden address.

To override the shipping address set the ADDROVERRIDE parameter to 1 and the following shipping address parameters in the SetExpressCheckout call:

Automatically fill out shipping and contact information

When you pass the buyer's shipping address, telephone number and email address in the SetExpressCheckout call, PayPal automatically fills out this information in the debit or credit card form fields on the PayPal page.

After the SetExpressCheckout call, the buyer is redirected to the PayPal. Buyers with a PayPal account can log in with their email address and password. Buyers who do not have an account can use their debit or credit card to pay and will have their shipping and contact information filled out.

This example call automatically fills out the buyer's shipping and contact information:

This figure shows the Pay with debit or credit card section expanded with the buyer shipping and contact fields filled out.

Set Paypal As A Secondary Checkout For Your Store Online

Display a Pay Now button

You can expedite the checkout flow by letting a buyer skip your order confirmation page and complete their purchase on PayPal.

Generally, a buyer selects a payment method as the last step before they complete their purchase. If you collect no additional information after a buyer returns from PayPal, you can skip the confirm-order page on your website. If you collect additional information that does not affect the payment, PayPal recommends that you collect it after the buyer completes their purchases.

The useraction query parameter determines whether a buyer completes their purchase on PayPal or on your website. You can include or omit this parameter from the URL query string:

  • If you include useraction=commit in the query string, the flow redirects the buyer to the PayPal payment page and displays a Pay Now button. When the buyer clicks Pay Now, PayPal redirects the buyer back to your site, at which point you call DoExpressCheckoutPayment to complete the payment without additional interaction from the buyer. Choose this flow when you know the final payment amount when you initiate the checkout flow.
  • If you omit useraction from the query string, the default flow redirects the buyer to the PayPal payment page and displays the Continue button. When the buyer clicks Continue, they can edit the payment amount. Choose this flow when you do not know the final payment amount when you initiate the checkout flow.

The following sample code shows the redirect to let buyers pay on PayPal:

Additional information

Set Paypal As A Secondary Checkout For Your Store Bought

Set paypal as a secondary checkout for your store card

Set Paypal As A Secondary Checkout For Your Store Card

  • GetExpressCheckoutDetails NVP/SOAP