NVP/SOAP Integration

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.

Express Checkout minimizes the number of steps customers must complete when they check out. It's designed for merchants who don't have an Internet Merchant Account for processing credit and debit card payments. With Express Checkout, your buyers can pay with PayPal or credit and debit cards.

The In-Context PayPal Express Checkout helps improve conversion rates with an easier way to pay online. The simplified design speeds buyers through payment in as few as one or two clicks — without leaving your website — for a secure and seamless check out. A consistent experience for computers, tablets, and smart phones gives customers a trusted way to pay across different devices.

Note: On Macs and PCs, the In-Context Checkout window keeps the merchant website in view while providing customers with a streamlined and tightly-integrated checkout experience.

Smart phones and tablets display an optimized full-page checkout window

You can see a demo of In-Context Checkout on the PayPal Demo.

Benefits of In-Context Checkout for merchants

  • Keep buyers on your website — Buyers can now pay with PayPal without leaving your website.
  • Simplified design — The new PayPal Express Checkout experience keeps buyers focused on what matters most, completing purchases quickly in 1 or 2 clicks.
  • Secure, with simplified PCI compliance — With Express Checkout, you can securely accept payments without complex PCI requirements. PayPal keeps customer payment data secure for you so your PayPal Express Checkout transactions are PCI compliant.
  • Consistent experience across devices — Deliver a trusted PayPal experience on PCs, tablets, or smart phones; to make mobile shopping familiar and faster, the checkout experience is optimized for the mobile screens.

Benefits of In-Context Checkout for buyers

  • Easier way to pay with PayPal
  • Complete payments in 1 or 2 clicks
  • Quick and easy mobile purchases on smart phones and tablets

The In-Context Checkout flow

The Express Checkout full-page checkout experience redirects buyers to a PayPal screen where they can log in, review and approve a payment before being redirected back to your website's payment confirmation page. The story board for an Express Checkout In-Context Checkout transaction is as follows:

Web Flow — Displays a PayPal In-Context Checkout window with the merchant website in the background

Mobile Flow — Displays a mobile-optimized full-page checkout window

You can see a demo of Express Checkout on the PayPal Demo.


To determine whether your Express Checkout integration is a good candidate for the In-Context Checkout experience, review the following eligibility requirements and current integration limitations. If In-Context Checkout does not support a feature that you currently use, your buyers are presented with the Express Checkout full-page redirect checkout flow.

Supported browsers

In-Context Checkout supports these browsers:

  • Internet Explorer version 9 and later
  • Chrome version 27 and later
  • Firefox version 30 and later
  • Safari version 5.1 and later
  • Opera version 23 and later

Buyers who use earlier browsers see the full-page checkout experience.

Note: In-Context Checkout does not support interstitial or shim pages.

Supported features

In-Context Checkout supports:

  • The mobile-optimized experience
  • AJAX calls
  • Mixed HTTP and HTTPS protocols
  • Express Checkout API version 62 or later
  • Mobile Express Checkout direct integration
  • Reference transactions

Additionally, In-Context Checkout supports:

Feature Description
Currency Supported currencies are:
  • US Dollar
  • Euro
  • British Pound
  • Canadian Dollar
  • Australian Dollar
  • Brazilian Real
  • Danish Krone
  • Norwegian Krone
  • Polish Zloty
  • Swedish Krona
  • Swiss Franc
Payment actions Sale, authorization, and order
Closed loop offers The following merchant accounts only:
  • United States
  • United Kingdom
  • Germany
  • France
  • Hong Kong
  • Singapore
Shopping cart details Item description, quantity, and unit price
Buyer phone number required The existing account phone number is not displayed to the buyer but is returned to the merchant. If no phone number exists, the buyer is prompted to add one.

Unsupported features

In-Context Checkout does not support:

  • Parallel payments or multi-seller payments
  • Callback / Instant Update API operations
  • Billing agreements that use the deprecated SetCustomerBillingAgreement API operation

Additionally, In-Context Checkout does not support:

Feature Description
Merchant account In-Context Checkout does not support merchant accounts in:
  • Japan
  • Algeria
  • Bahrain
  • Bhutan
  • Brunei
  • Israel
  • Jordan
  • Kuwait
  • Morocco
  • Oman
  • Qatar
  • Saudi Arabia
  • Tunisia
  • United Arab Emirates
  • Yemen
Buyer Account In-Context Checkout does not support buyer accounts in:
  • Japan
  • China (domestic buyers)
  • India (domestic buyers)
  • Algeria
  • Bahrain
  • Bhutan
  • Brunei
  • Israel
  • Jordan
  • Kuwait
  • Morocco
  • Oman
  • Qatar
  • Saudi Arabia
  • Tunisia
  • United Arab Emirates
  • Yemen
PayPal Credit (formerly Bill Me Later) second button integration UserSelectedFundingSource=BML in the SetExpressCheckout call
Unilateral payments Based on merchant account field in the SetExpressCheckout call
Digital goods Based on the DIGITAL item category in only the SetExpressCheckout call

Unsupported parameters


The NVP SetExpressCheckout call ignores these unsupported parameters:

  • L_BILLINGAGREEMENTDESCRIPTIONn (the recurring transaction flow is still supported)


The SOAP SetExpressCheckout call ignores these unsupported parameters:

  • AllowNote
  • BillingAgreementDescription (the recurring transaction flow is still supported)
  • GiftMessageEnable
  • GiftReceiptEnable
  • GiftWrapAmount
  • GiftWrapEnable
  • GiftWrapName
  • LandingPage=Billing
  • NoteToBuyer
  • PageStyle
  • SurveyChoice
  • SurveyEnable
  • SurveyQuestion
  • TotalType

Merchant profiles

A merchant profile ignores these unsupported parameters:

  • Gift messages, gift receipts, and gift wrap parameters
  • Survey setting parameters
  • Third-party privacy policy messaging parameters — based on merchant profile setting


Additional information