Documentation release notes

DocsCurrentLast updated: April 6th 2022, @ 4:06:12 pm


When we add, remove, or update product documentation, we write a note on this page.

Checkout

2022

February

2021

July

June

  • Users can selectively request authentication with the SCA_WHEN_REQUIRED parameter of the 3D Secure JavaScript SDK. Available for businesses and platforms.

  • Updated the Multi-seller Payments guide to indicate that merchant-id and data-merchant-id are required for JavaScript SDK integrations with the multi-seller payments feature.

  • Venmo Pay is now available for US-based PayPal merchants.

March

2020

November

October

September

August

June

  • On Advanced credit and debit currency availability, added American Express as a supported currency for the following newly-added countries: UK, France, Italy, Spain, Finland, and the Netherlands.

  • Updated the 3DS topic to include the newly-added 3DS parameters: LiabilityShift, EnrollmentStatus, and AuthenticationResult. Added an animation that shows how 3DS works.

April

2019

November

October

August

July

  • Added curl sample code to the PayPal Checkout server samples.
  • Added a note about contacting Sales to Set Up Your Development Environment for the Checkout integration guide. This is part of a 90-day trial to support the Sales team.
  • Added the PayPal Shopping Cart demo link to the Checkout guide in the Server and Best Practices sections.
  • Changed ProductionEnvironment to LiveEnvironment in the Setup SDK Guide.

April

Classic

2019

October

  • Removed the AppID for the Adaptive APIs section from API Credentials because you can no longer go live with the Adaptive Payments API.
  • Provided guidance to merchants in Shopping Cart HTML Variables to pass 25 or fewer items in a single call.

June

May

  • Updated Website Payments Pro (DoDirectPayment) 3-D Secure topic to reflect new CardinalCommerce platform, Cardinal Cruise. Added content to inform merchants of the September 14, 2019 deadline to implement Strong Customer Authentication (SCA) in Europe.
  • Removed outdated content about the PayPal Payments Standard Modify Subscription button. Added information to the modify parameter in the Deprecated Variables list to help users update code that's using the deprecated values for modify.
  • Changed supported locale code for India from en-IN to en_IN. We let a little air out of the hyphen to make it an underscore.
  • Added div id="paypal-button-container" to a code sample on Express Checkout with Payflow Gateway. The PayPal button now renders as expected when developers paste the code.

April

Disputes

2019

July

  • Updated the case_type and reason_codes for Dispute Resolution IPN variables to reflect current reality.
    • case_type - Marked bankreturn as deprecated.
    • reason_codes - Marked adjustment_reimburse and billing as deprecated. Noted that complaint and dispute case types have the same reason codes.
  • Replaced the disputes methods table with an available actions table and added two sequence diagrams and instructions for creating buyer-side credentials to the Disputes Integration Guide.
  • Replaced the disputes management flow with a new image.
  • Renamed Customer Disputes API to Disputes API.

May

April

  • Updated the Disputes API Reference to add the Partner Actions resource group and the partially update dispute action and show dispute action details methods.

  • Added evidence types:

     * `PROOF_OF_REFUND_OUTSIDE_PAYPAL`
     * `RECEIPT_OF_MERCHANDISE`
     * `CUSTOMS_DOCUMENT`
     * `CUSTOMS_FEE_RECEIPT`
     * `INFORMATION_ON_RESOLUTION`
     * `ADDITIONAL_INFORMATION_OF_ITEM`
     * `DETAILS_OF_PURCHASE`
     * `PROOF_OF_SIGNIFICANT_DIFFERENCE`
     * `PROOF_OF_SOFTWARE_OR_SERVICE_NOT_AS_DESCRIBED`
     * `PROOF_OF_CONFISCATION`
     * `PROOF_OF_DAMAGE`
     * `COPY_OF_LAW_ENFORCEMENT_AGENCY_REPORT`
     * `ADDITIONAL_PROOF_OF_SHIPMENT`
     * `PROOF_OF_DENIAL_BY_CARRIER`
     * `THIRDPARTY_PROOF_FOR_DAMAGE_OR_SIGNIFICANT_DIFFERENCE`
     * `VALID_SUPPORTING_DOCUMENT`
     * `LEGIBLE_SUPPORTING_DOCUMENT`
     * `RETURN_TRACKING_INFORMATION`
     * `DELIVERY_RECEIPT`
     * `PROOF_OF_INSTORE_RECEIPT`
     * `ADDITIONAL_TRACKING_INFORMATION`
     * `PROOF_OF_SHIPMENT_POSTAGE`
     * `ONLINE_TRACKING_INFORMATION`
     * `PROOF_OF_INSTORE_REFUND`
     * `PROOF_FOR_SOFTWARE_OR_SERVICE_DELIVERED`
     * `RETURN_ADDRESS_FOR_SHIPPING`
     * `COPY_OF_THE_EPARCEL_MANIFEST`
     * `COPY_OF_SHIPPING_MANIFEST`
     * `APPEAL_AFFIDAVIT`
     * `RECEIPT_OF_REPLACEMENT`
     * `COPY_OF_DRIVERS_LICENSE`
     * `ACCOUNT_CHANGE_INFORMATION`
     * `DELIVERY_ADDRESS`
     * `CONFIRMATION_OF_RESOLUTION`
     * `MERCHANT_RESPONSE`
     * `PERMISSION_DESCRIPTION`
     * `STATUS_OF_MERCHANDISE`
     * `LOST_CARD_DETAILS`
     * `LAST_VALID_TRANSACTION_DETAILS`
    

2021

October

General

2019

August

  • Updated all currency notes surrounding BRL. PayPal's usage policy with the Brazilian Real has changed to include cross-border payment conversion and a notice for the conversion rate fee.

March

Invoicing

2019

October

Log in with PayPal

2019

July

May

April

January

Marketplaces and Platforms

2020

July

NVP/SOAP

2019

November

  • Removed DoAuthorization, DoReauthorization and DoUATPAuthorization from the 10486 error code listing because these methods don't apply to that code.

September

April

  • Deprecated the NVP and SOAP RefundTransaction method fields:

    NVP

    • RefundTransaction request fields: SHIPPINGAMT, TAXAMT

    • InvoiceItemType fields:L_INVOICEITEMNAME_n_, L_DESCRIPTION_n_, L_EAN_n_, L_SKU_n_, L_PRICE_n_, L_PRICECURRENCYCODE_n_, L_ITEMPRICE_n_, L_ITEMPRICECURRENCYCODE_n_, L_ITEMCOUNT_n_, L_ITEMCOUNTUNIT_n_, L_TAXRATE_n_, L_ADDITIONALFEES_n_TYPE_m_, L_ADDITIONALFEES_n_AMT_m_, L_ADDITIONALFEES_n_CURRENCY_m_, L_MPN_n_, L_ISBN_n_, L_PLU_n_, L_MODELNUMBER_n_, and L_STYLENUMBER_n_

      SOAP

    • RefundTransaction request fields: RefundItemDetails, ShippingAmount, TaxAmount

    • InvoiceItemType fields: Name, Description, EAN, SKU, Price, ItemPrice, ItemCount, ItemCountUnit, TaxRate, AdditionalFees, MPN, ISBN, PLU, ModelNumber, and StyleNumber

  • Deprecated these NVP and SOAP DoCapture method fields:

    • NVP: TAXAMT, TRANSACTIONTYPE, RECEIPTID
    • SOAP: TaxAmount, TransactionType, ReceiptID

March

Payflow

2019

September

  • Added information to the Payflow Developer Guide to clarify merchants can complete 3-D Secure authentication using the Buyer Authentication service or by using a 3rd-party plug-in.

Payouts

2022

May

2020

April

March

  • Added a list of currencies that PayPal can automatically exchange payments to and from, as long as the payer has a PayPal balance in a currency on the list.

February

2019

November

October

  • Added a new page for Payouts Approvals.
  • As currency conversion expanded to more countries, added code samples to the currency conversion features page, and added a list of country exclusions.

August

May

  • Removed the internal USER_NAME enumerated value from the recipient_type string and the mention of the internal recipient_wallet string from the Payouts API Reference.

Pay Later

2022

February

  • Updated DE Pay Later to include the new Pay in 30 offering.

  • Removed the buyerCountry parameter from the Reference for

    • FR
    • UK
    • US

January

2021

August

  • Updated Pay Later offers to explain how to display the Pay Later button for merchants using the JavaScript SDK integration.

July

March

  • Added new site features for Pay Later docs, including a country dropdown selection, breadcrumbs, page subtitles, and a new style for tables.

2020

November

PayPal Commerce Platform

2020

November

  • Added support for the Mercado Pago alternative payment method.

March

January

2019

October

  • Created new Downloadable Shopping Cart Onboarding for first-party onboarding.
  • Added Partner Referrals V2 API and revised before payment seller onboarding topic to reflect version 2 of the API.
  • Revised Partner Onboarding page to align with the content and positioning presented in the Partner lead form.

May

  • Added the Add Smart Payment Buttons topic to describe how to create Smart Payment Buttons with the PayPal JavaScript SDK instead of using checkout.js.

April

  • Updated the get onboarding status sample response to show the POST call to seller onboarding items.

  • Clarified descriptions of a few request fields and added a redirect section to platforms onboarding seller information.

  • Updated the issue a refund code samples and parameters.

  • Added that partners' new business account for onboarding needs a zero balance to the following pages:

    • Partner Onboarding
    • v1 Partner Onboarding
  • Added the Webhooks entry to the nav bar:

    • Configure Webhooks
    • v1 Configure Webhooks
    • Updated the sample response for GET seller's onboarding status to reflect the information sent in the create call earlier in the text.
    • Redirected partners' doc links and added context and how-to image for before payment onboarding doc.

February

  • Removed the obsolete PayPal-Client-Metadata-Id header from the PayPal Commerce Platform Orders API Integration Guide.
  • Corrected the path for the show order status call in the PayPal Commerce Platform Orders API Integration Guide.
  • Removed mention of casual sellers from seller onboarding docs.
  • Added the PayPal Commerce Platform Update an Order page.
  • Added link to the PayPal Commerce Platform country support to the Reference section of these pages:
    • Reference
    • v1 Reference
  • Clarified where to enter a seller's email on the after payment seller onboarding page.
  • Added links to the Referenced Payouts API Reference on the PayPal Commerce Platform Reference.

PayPal Here

2021

July

2019

October

  • Changed some wording about a merchant's POS Software. Also added detailed instruction for what to do in the completion of isSetupComplete instead of just using the word "Done".

August

  • Added new information about the iOS and Android PayPal Here Web SDK including code samples for Objective C, Swift, and Android.

May

PayPal Payments Pro

2021

January

2019

May

Reports

2021

July

  • Updated the Case Report to include the new dispute case ID format.

2020

April

2019

May

  • Increased the file limits of some reports to 1 million transactions per file in PayPal Reports.

REST APIs

2022

May

2021

July

2020

January

2019

October

June

May

April

February

January

Subscriptions

2021

August

January

  • Introduced in-product help in the subscriptions dashboard to help you get answers to frequently asked questions. You can also read subscription FAQs on the PayPal Help Center.

2020

December

October

August

  • Added documentation for how to start a subscription at a future date to the business and marketplaces sections of the site.

July

  • Introduced the capability to configure two trial periods for a subscription. Use a trial period to let subscribers try your product at a free or discounted price before regular billing cycles start.

May

  • Added custom attributes for subscriptions. These attributes support tagging subscriptions with business data to reconcile.

April

February

January

  • Introduced the capability to update the one-time setup fee for your subscription plans.

  • Introduced webhooks for subscription payment failure events. You can now listen to webhooks for subscription payment failure.

2019

November

September

May

April

Third Party Solutions

2019

September

  • Published marketplaces, a new category of third party solutions.

August

  • Added a 3rd Party Solutions directory for integrating PayPal with standard eCommerce platform solutions.

Webhooks

2019

October

  • Updated the Webhook Event Names table to include CHECKOUT.CHECKOUT.BUYER-APPROVED. This webhook lets users know when an Express Checkout payment is created and approved by the buyer.

September

January

  • Added the BILLING_AGREEMENTS.AGREEMENT.CREATED and BILLING_AGREEMENTS.AGREEMENT.CANCELLED event names to Webhook Event Names.