Merchant API release notes - v93.0

This release note addresses the API operations within the PayPal Merchant API WSDL and associated schemas:

The Merchant APIs include:

  • Express Checkout
  • Direct Payment
  • Recurring Payments
  • Mass Pay
  • Button Manager
  • PayPal Payments Standard
  • Website Payments Pro

Affected products

This release affects these products:

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

Express Checkout

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

Express Checkout - Changed calls

  • GetTransactionDetails
  • DoExpressCheckoutPayment

Express Checkout - Schema changes

Name Part of schema Type of change
GetTransactionDetailsResponse.PaymentTranstionDetails.SecondaryAddress Element New

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:

  • SHIPTOSECONDARYADDRESSLINE1

  • SHIPTOSECONDARYADDRESSLINE2

  • SHIPTOSECONDARYCITY

  • SHIPTOSECONDARYSTATE

  • SHIPTOSECONDARYCOUNTRYNAME

  • SHIPTOSECONDARYZIP

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 you omit the shipping address, you must include these parameters:

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