PayPal Merchant API Release Notes - Version 106.0

Version 106 of the Merchant API includes the following PayPal releases:

Code release version Release date Description
106 8/20/2013 Changes to the API are described below.
107 9/11/2013 No changes to the API

These release notes address the API operations within the PayPal Merchant API WSDL and associated schemas:

The document covers changes to the Merchant APIs, which include:

  • Express Checkout
  • Direct Payment
  • Authorization and Capture
  • Recurring Payments
  • Mass Pay
  • Button Manager

These products use this API:

  • PayPal Payments Standard
  • PayPal Payments Advanced
  • Website Payments Pro


No new announcements.

Affected Products

These products are affected by this release:

  • Express Checkout
  • Website Payments Pro - see the Express Checkout section for related release notes

Express Checkout

For a current list of known issues, go to the PayPal Notifications page and enter the product or API of interest, such as Express Checkout, in the search box.

Express Checkout - New API Operations

There are no new API operations.

Express Checkout - Changed API Operations

There are no changed API operations.

Express Checkout - Schema Changes

Name AddressType.AddressNormalizationStatusCodeType in
Part of Schema Element
Type of Change New enumeration value
Description The enumeration value UserPreferred was added to the AddressNormalizationStatusCodeType. This new value may be returned in the PAYMENTREQUEST_n_ADDRESSNORMALIZATIONSTATUS NVP response field or the AddressNormalizationStatus SOAP response field in the GetExpressCheckoutDetails (NVP | SOAP) API operation.

Express Checkout - New Features

There are no new features in this release.

Express Checkout - Changed Functionality

There is no new functionality in this release.

Additional Documentation Updates

Express Checkout - Additional Documentation Updates

Updates to the Merchant API Reference and Express Checkout Documentation (Sep. 19, 2013)

  • Updated the MassPay integration guide. PayPal will place a temporary hold on the total monetary value of the Mass Payment, plus associated fees, until the status of the transaction is changed to Processed. After the release, if one or more transactions is declined, your PayPal account balance may exceed the available account balance shown during the period of the hold.

Updates to the Merchant API Reference and Express Checkout Documentation (Sep. 09, 2013)

  • Updated the Express Checkout guide on recovering from funding failures. Starting with release 107 on 9/11/2013, error code 10486 will also be returned for Express Checkout implementations with a PaymentAction value of Order (in addition to Sale and Authorization). This feature is not applicable to reference transactions and recurring payments.

  • Updated the description of the SHIPTOSTATE NVP field and the StateOrProvince SOAP field. The shipping address state or province is required if the address is in one of the following countries: Argentina, Brazil, Canada, China, Indonesia, India, Japan, Mexico, Thailand, USA. Updated the following API operation reference pages: CreateRecurringPaymentsProfile (NVP | SOAP), DoAuthorization (NVP | SOAP), DoDirectPayment (NVP | SOAP), DoExpressCheckoutPayment (NVP | SOAP), DoReferenceTransaction (NVP | SOAP), GetExpressCheckoutDetails (NVP | SOAP), GetRecurringPaymentsProfileDetails (NVP | SOAP), GetTransactionDetails (NVP | SOAP), SetExpressCheckout (NVP | SOAP), UpdateAuthorization (NVP | SOAP), UpdateRecurringPaymentsProfile (NVP | SOAP).

  • Added information about the default refund period of 60 days for issuing refunds using the RefundTransaction (NVP | SOAP) API operation.

  • Added the TotalType SOAP and TOTALTYPE NVP request fields to the SetExpressCheckout (NVP | SOAP) API operation.

  • Added the DirectPayment API operation 10576 error code.

  • Added the DoAuthorization API operation 10486 error code.

  • Added InvoiceItemType fields to the GetTransactionDetails (NVP | SOAP) API operation reference page.

Updates to the Merchant API Reference and Express Checkout Documentation (Aug. 21, 2013)

  • Added the new Express Checkout Integration Overview guide (PDF | HTML).
  • Updated the Merchant API error codes page.