PayPal Merchant API Release Notes - Version 94.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

Announcements

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

  • DoCancel
  • DoReauthorization
  • DoVoid
  • RefundTransaction

Express Checkout - Schema Changes

Name Part of Schema Type of Change
DoCancelRequestType.MsgSubID Element New
DoCancelResponseType.MsgSubID Element New
DoReauthorizationRequestType.MsgSubID Element New
DoReauthorizationResponseType.MsgSubID Element New
DoVoidRequestType.MsgSubID Element New
DoVoidResponseType.MsgSubID Element New
RefundTransactionRequestType.PayerID Element New
SetExpressCheckoutRequestDetailsType.PaymentDetailsType.FulfillmentReferenceNumber Element New
DoExpressCheckoutRequestDetailsType.PaymentDetailsType.FulfillmentReferenceNumber Element New
GetExpressCheckoutDetailsResponseDetailsType.PaymentDetailsType.FulfillmentReferenceNumber Element New

Express Checkout - New Features

None for this release.

Express Checkout - Changed Functionality

TransactionID or PayerID acceptable for RefundTransaction

For RefundTransaction, the TransactionID is now optional, though you must either provide the TransactionID or PayerID.

Idempotency (MsgSubID) added to DoCancel, DoReauthorization, and DoVoid

Idempotency via MsgSubID, which was added in Release 92, is now available for DoCancel, DoReauthorization, and DoVoid.

FulfillmentReferenceNumber for Global Shipping (Sep. 18, 2012)

In conjunction with eBay's Global Shipping Program, PayPal now provides the option to pass a reference number (FulfillmentReferenceNumber) associated with the third-party shipping or fulfillment center.

Additional Documentation Updates

Express Checkout - Additional Documentation Updates

Updates to the API Reference Documentation (Dec. 14, 2012)

Updated the API Error Code tables. Added error code 11084 to the DoExpressCheckoutPayment API call error codes. Added error codes 10507 and 10606 to the DoReferenceTransaction API call error codes. Added suggestions on handling specific DoExpressCheckoutPayment and DoReferenceTransaction errors.

Updated the Currency Codes tables. Amount values for the currencies: Japanese Yen (JPY) and Taiwan dollar (TWD) cannot be decimals. An error will be thrown if you pass a decimal value for these currencies.

Updated the Address request fields for the DoExpressCheckoutPayment API call. Updated the AddressType request fields for the SetExpressCheckout API call. Both of these API calls accept only one shipping address per transaction.

Updated the Payer Name response fields for the NVP GetExpressCheckoutDetails API call Updated the PayerNameType response fields for the SOAP GetExpressCheckoutDetails API call Removed the payer Salutation field which is not returned in the GetExpressCheckoutDetails response.

Update to the API Reference Documentation (Nov. 28, 2012)

Updated the API Error Code tables. Added error code 10069 to the DoReferenceTransaction API call error codes.

Updates to the API Reference Documentation (Nov. 14, 2012)

Updated country code for China in the Country Codes table.

A new error code was added to the API error codes tables. Error code 10014 will be returned if you exceed your call rate limit.

Documentation Changes and Errata (Nov. 02, 2012)

Corrected the following fields in the DoExpressCheckoutPayment Response documentation: Payment Information fields: PAYMENTINFO_n_PAYMENTREQUESTID Payment Error Type fields: PAYMENTINFO_n_SHORTMESSAGE, PAYMENTINFO_n_LONGMESSAGE, PAYMENTINFO_n_ERRORCODE, PAYMENTINFO_n_SEVERITYCODE, PAYMENTINFO_n_ACK Seller Details Type fields: PAYMENTINFO_n_SELLERPAYPALACCOUNTID, PAYMENTINFO_n_SECUREMERCHANTACCOUNTID

Corrected the following fields in the GetTransactionDetails Response documentation: Payment Item fields: L_EBAYITEMTXNID_n_ and L_Name_n_

Removed from the DoExpressCheckoutPayment and SetExpressCheckout API Error Code documentation: API errors that were listed without an error code and that are not applicable.

Update to DoReferenceTransaction Documentation (Oct. 12, 2012)

Documentation related to DoReferenceTransaction has been updated to clarify that eCheck is not an acceptable PaymentType field value.

Documentation related to UpdateRecurringPaymentsProfile has been updated to include a note clarifying that credit card information cannot be updated for Express Checkout profiles.

Update to Express Checkout Reference Transaction Documentation (Sep. 18, 2012)

Documentation related to obtaining the most recent billing address has been updated to include instructions for enabling Billing Address access.

Documentation related to UpdateRecurringPaymentsProfile has been updated to include a note clarifying that credt card information cannot be updated for Express Checkout profiles.

PayPal Payments Standard - Additional Documentation Updates

Update to the PayPal Payments Standard Integration Guide (Nov. 02, 2012)

Documentation related to PayPal Payments Standard buttons has been updated to show the new URL path for buttons: https://www.paypalobjects.com/en_US/i/btn/...