Merchant API v119.0 release notes

Merchant API v119.0 includes the following PayPal releases:

Code release version Release date Description
119 10/08/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, see PayPal Notifications page and enter the product or API of interest, such as Express Checkout, in the search box.

New features

New RefundTransaction request fields

The following fields have been added to the RefundTransaction API operation to support passing shipping and tax amounts in the refund request, as well as merchant-specific information passed in the form of key-value pairs.

New element Description Type
RefundTransactionRequestType.
ShippingAmount
Added a new request field for shipping amount. The field name is ShippingAmount for SOAP integrations and SHIPPINGAMT for NVP integrations. For details, see the RefundTransaction (NVP | SOAP) API operation. cc:BasicAmountType
RefundTransactionRequestType.
TaxAmount
Added a new request field for tax amount. The field name is TaxAmount for SOAP integrations and TAXAMT for NVP integrations. For details, see the RefundTransaction (NVP | SOAP) API operation. cc:BasicAmountType
RefundTransactionRequestType.
MerchantDataType
Added a new request field for merchant-specific information passed with the transaction in the form of key value pairs, typically used for private label credit card information. The field name is MerchantDataType for SOAP integrations and MERCHANTDATAnKEY as well as MERCHANTDATAnVALUE for NVP integrations. For details, see the RefundTransaction (NVP | SOAP) API operation. ebl:MerchantData

New SetExpressCheckout funding source enumeration value

The following enumeration value has been added to the SetExpressCheckout API operation for passing QIWI as a funding source.

New element Description Type
SetExpressCheckoutRequestDetailsType.
FundingSourceDetailsType.UserSelectedFundingSourceType
Added a new enumeration value QIWI. For details, see the SetExpressCheckout (NVP | SOAP) API operation. New enumeration value

Error and warning codes

This release adds these error codes:

API operation Code
DoDirectPayment 10004
DoExpressCheckout 17200, 17203 and 17204
DoReferenceTransaction 10606
MassPay 8331

See API error codes and MassPay failed transactions IPN reason codes.

Changed functionality

Country codes update for Website Payments Pro

Website Payments Pro merchants using the DoDirectPayment API operation (NVP | SOAP ) can now use the complete list of PayPal supported countries, similar to Express Checkout merchants. See the Country Codes reference page for details.

Fields changed to optional

The following response fields are now marked as (Optional). If the transaction fails, the response might not return them.

Field Details
DoAuthorizationResponseType.TransactionID See the DoAuthorization (NVP | SOAP) API operation for details.
DoDirectPaymentResponseType.TransactionID See the DoDirectPayment (NVP | SOAP) API operation for details.
ManagePendingTransactionStatusResponseType.TransactionID See the ManagePendingTransactionStatus (NVP | SOAP) API operation for details.
UpdateAuthorizationResponseType.TransactionID See the UpdateAuthorization (NVP | SOAP) API operation for details.
DoVoidResponseType.AuthorizationID See the DoVoid (NVP | SOAP) API operation for details.