PayPal REST API Release Notes 2017


December 21

December 14

December 06


November 09

November 02


October 25

  • Updated the REST direct credit card deprecation note to remove the mention of guest payments or a vaulted card on Billing Agreements API Reference and Billing Plans API Reference.
  • Added information about how to capture an authorization after placing an order to Orders.
  • Added an auth-assertion header example to and removed references to credit cards, vaulted credit cards, and debit cards from Orders Integration Guide.
  • Corrected the permissions for Managed accounts on the Managed account permissions page.
  • Updated the Managed Accounts API Reference with the following changes:
    • Added constraints to the alternate_full_name, city, merchant_category_code, category, and sub_category fields.
    • Updated the date_of_birth parameter with information about the supported date-time formats.
    • Updated the update managed account with a table of supported paths for update operations.

October 20

October 19

October 11

October 05


September 22

  • Rolled back release of OpenAPI-based Orders API and added note about Express Checkout.

September 21

September 14

  • Updated the disclaimer for the Disputes API reference and overview.
  • Changed the Set account permissions link text to Managed account permissions in the Managed Onboarding Integration Guide.
  • Replaced an actual partner payer ID in a code sample with the <your_partner_id> variable in URL Onboarding.
  • Updated the checkout.js script version number on the Upgrade to checkout.js V4.0.0 page to 4.
  • Removed a duplicate image from and corrected sandbox links in code samples in the Additional checkout experience options topic in the Orders Integration Guide.
  • Removed the information about the GetVerifiedStatus, CreateAccount, GetVerifiedStatus, and get user information operations from the Enable Connect with PayPal topic because those operations do not apply to that topic.
  • The Direct Credit Card REST API has transitioned to restricted status. The PayPal developer documentation, developer dashboard, developer portal, and GitHub have been updated to reflect this.

September 07


August 31

  • Express Checkout Integration Guide

  • PayPal Commerce Platform Connected Integration Guide

    • Added documentation for Progressive Onboarding and URL Onboarding.
    • Added link to list of available permissions under the requested_capabilities section.
    • Added image for the Shortcut checkout experience.
  • Added CUSTOMER.DISPUTE.UPDATED event to Webhook event names.

August 24

August 16

August 11

  • In a hot fix update, replaced the missing left hand navigation sections.
  • Abstracted <partner_id> in the Partners Connect Onboarding Integration Guide.
  • Added missing quotation marks to the cURL sample in Negative Testing for REST.

August 09

August 04


July 27

July 19

July 13

  • Added documentation for the PayPal Commerce Platform, including a solution overview, on-boarding integration guides, and API integration guides and reference, is now available for select partners.

  • Added a note about re-using tokens to How PayPal uses OAuth 2.0.

  • The disputes webhooks on the Webhooks event names now point to the Partners Disputes Integration Guide.

July 06


June 28

June 22

June 15

June 09

  • Corrected the code samples in Create payouts and create batch payouts to reflect a single currency.


May 25

  • Added the correct HTTP status codes to method descriptions in the Payments and Vault API References. Removed the incorrect ID from the create payment example in the Vault overview.

May 11

May 04


April 25

April 13


March 30

March 23

March 16

  • Updated the charge_models type description in Billing Plans API Reference.
  • Updated the code samples and updated formatting and style to match other REST API integration guides in Credit cards payments and Orders.
  • Updated the Payments and Orders resource groups' code samples in Payments API Reference.
  • Updated the to links in many sample responses in REST API Reference. The updated URLs more accurately represent actual API responses.
  • Enhanced information about access tokens in REST API overviews and references.
  • Removed the transmissions and status response fields from the show event notification details method, updated the code sample for the resend event notification method, and added the missing sample request to the list available events method in Webhooks API Reference.


February 27

February 16

  • The Payouts API synchronous mode, which immediately returns the results of a payout, will soon be deprecated. It is no longer available for new integrations but continues to be supported for existing integrations.
  • Noted that PayPal recommends that all new integrations use the REST Payments API for Express Checkout integrations. See Express Checkout deprecated documentation.
  • Added related resources to Webhook event names.

February 02

  • Corrected the recipient_name field in the code samples to specify the name as <first-name> last-name rather than <last-name>, first-name in the Payments API Reference.


January 25

January 05

Additional release notes