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.
- https://www.paypalobjects.com/wsdl/PayPalSvc.wsdl
- https://www.paypal.com/wsdl/eBLBaseComponents.xsd
- https://www.paypal.com/wsdl/CoreComponentTypes.xsd
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 PayPal product and API issues, as well as upcoming maintenance events, go to PayPal Status.
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. |
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. |
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. |
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. |
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 who use 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. |