PayPal Merchant API Release Notes - Version 93.0

This release note addresses 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
  • Recurring Payments
  • Mass Pay
  • Button Manager
  • PayPal Payments Standard
  • Website Payments Pro


No new announcements.

Affected Products

These products are affected by this release:

  • Express Checkout
  • PayPal Payments Pro - see 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 Calls

No new calls in this release.

Express Checkout - Changed Calls

  • GetTransactionDetails
  • DoExpressCheckoutPayment

Express Checkout - Schema Changes

Name Part of Schema Type of Change
GetTransactionDetailsResponse.PaymentTranstionDetails.SecondaryAddress Element New

Express Checkout - New Features

None for this release.

Express Checkout - Changed Functionality

Secondary Address for Global Shipping

In conjunction with eBay's Global Shipping Program, GetTransactionDetails now provides information about the secondary address in cases where the primary address is that of a global shipping provider or fulfillment center.

Starting with version 93, a new element, SecondaryAddress, contains information about the secondary address using the AddressType type,

For NVP, the following new fields related to the secondary address are returned:







New Redirect Code for Backup Funding Instrument

When a user is present during a payment transaction and the payments fails due to a processor decline, the DoExpressCheckoutPayment API response can now include the following error:

10486 This transaction couldn't be completed. Please redirect your customer to PayPal.

This new error code allows merchants to redirect users back to the PayPal using the original token to select a new funding instrument and then continue to the merchant site for another attempt at the payment transaction.

Benefits of this new code include:

  • Differentiate processor declines from other types of declines
  • Provide a way for merchants to send customers back to PayPal
  • Offer customers the ability to choose another financial instrument to complete the transaction

Express Checkout - Additional Documentation Updates

Correction to GetExpressCheckoutDetails API Reference Documentation

TAXIDDETAILS has been corrected to TAXID. (Aug. 22, 2012)

Correction to TransactionSearch API Reference Documentation

PROFILEID has been added as a possible field for filtering search transaction requests.

Correction to Instant Update Callback Documentation

Documentation related to the Instant Update API has been corrected. If no shipping address is included, then three parameters must be included:

METHOD=CallbackResponse NO_SHIPPING_OPTION_DETAILS =1 CALLBACKVERSION= <61.0 or="" greater="">