Merchant API v106.0 release notes

Merchant API v106.0 includes the following PayPal releases:

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

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

The Merchant APIs 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

Affected products

This release affects these products:

  • Express Checkout
  • Website Payments Pro — See the Express Checkout section for related release notes

Express Checkout

For a current list of PayPal product and API issues, as well as upcoming maintenance events, go to PayPal Status.

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.

Additional documentation updates

Express Checkout - Additional documentation updates

Merchant API and Express Checkout documentation updates (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.

Merchant API and Express Checkout documentation updates (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.

Merchant API and Express Checkout documentation updates (Aug. 21, 2013)

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