PayPal Merchant API Release Notes - Version 117.0

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

Code release version Release date Description
117 08/20/2014 See release details.

These release notes include 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 Payments
  • Button Manager
  • PayPal Payments Standard
  • Website Payments Pro

Release details

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.

New features

Support for PLCC and co-branded payment cards

The following fields have been added to the Express Checkout API operations to support private label credit cards (PLCC) and co-branded payment cards. For code samples that show how to integrate the following new fields, see How To Use Loyalty Programs and PLCC in Express Checkout.

New / Modified element Description Type
GetExpressCheckoutDetailsResponseDetailsType.
InstrumentDetails
Added a new response field that is returned when a promotional payment instrument is used in the payment, such as PayPal Credit® (formerly Bill Me Later®) or a private label credit card (PLCC) payment. For details, see the GetExpressCheckoutDetails (NVP | SOAP) API operation. ebl:InstrumentDetailsType
GetExpressCheckoutDetailsResponseDetailsType.
InstrumentDetails.InstrumentDetailsType.InstrumentCategory
Added a new response field that returns the category of the promotional payment instrument used in the payment, such as, PayPal Credit® (formerly Bill Me Later) or a private label credit card (PLCC) payment. For details, see the GetExpressCheckoutDetails (NVP | SOAP) API operation. xs:string
GetExpressCheckoutDetailsResponseDetailsType.
InstrumentDetails.InstrumentDetailsType.InstrumentID
Added a new response field that returns the instrument ID (issued by the external party) corresponding to the funding source used in the payment. For details, see the GetExpressCheckoutDetails (NVP | SOAP) API operation. xs:string
DoExpressCheckoutPaymentRequestDetailsType.
PaymentDetails.PaymentDetailsType.MerchantData
Added new request fields than can be used to pass any merchant-specific data. For details, see the DoExpressCheckoutPayment (NVP | SOAP) API operation. ebl:MerchantDataType
DoExpressCheckoutPaymentRequestDetailsType.
PaymentDetails.PaymentDetailsType.
MerchantData.MerchantDataTuple
This new request field holds all of the merchant data key-value pairs passed from the merchant. For details, see the DoExpressCheckoutPayment (NVP | SOAP) API operation. ebl:MerchantDataType
DoExpressCheckoutPaymentRequestDetailsType.
PaymentDetails.PaymentDetailsType.
MerchantData.MerchantDataTuple.Key
Added a new request field for the merchant data key name, part of a key-value pair. For details, see the DoExpressCheckoutPayment (NVP | SOAP) API operation. xs:string
DoExpressCheckoutPaymentRequestDetailsType.
PaymentDetails.PaymentDetailsType.
MerchantData.MerchantDataTuple.Value
Added a new request field for merchant data value, part of a key-value pair. For details, see the DoExpressCheckoutPayment (NVP | SOAP) API operation. xs:string

Error and warning codes

The following new error messages were added in this release:

API operation Code
DoUATPAuthorization.
See details.
14001
ManagePendingTransactionStatus.
See details.
11614

Changed functionality

No changed functionality.