# Release History
source: https://developer.mastercard.com/pclo-presentment/documentation/release-history/index.md

Note: Mastercard supports OAuth 2.0 for authenticating application HTTP requests. Refer to the following resources for guidance and documentation:   

* [Offers for Publishers (Legacy) OAuth 2.0 authentication and first call tutorial](https://developer.mastercard.com/pclo-presentment/documentation/tutorials-and-guides/index.md)
* [Using OAuth 2.0 to Access Mastercard APIs](https://developer.mastercard.com/platform/documentation/authentication/using-oauth-2-to-access-mastercard-apis/)
* [OAuth 2.0 reference application on GitHub](https://github.com/Mastercard/oauth2-client-java): Customers are advised to update the specification file and certificates as instructed in the README.md file to ensure access and alignment with OAuth 2.0 requirements.
* [Offers for Publishers API](https://developer.mastercard.com/presentment/documentation/release-history/) updated documentation

<br />

Support for OAuth 1.0a authentication remains available.
Note: A new version of the Offers for Publishers API is available on Mastercard Developers. This new version will serve as the primary reference point for ongoing development. The existing API displays as **Offers for Publishers (Legacy)** . While it remains operational, all future enhancements will be documented exclusively under the **Offers for Publishers API** . The functionality is still accessible through **Offers for Publishers (Legacy)** , but it will not be explicitly documented in the legacy documentation. To stay aligned with the latest enhancements, refer to the API documentation labeled [Offers for Publishers API](https://developer.mastercard.com/presentment/documentation) on Mastercard Developers.

## Non-release changes {#non-release-changes}

|                                  Description of change                                  |                                                                                                                       Section                                                                                                                        |    Date    |
|-----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------|
| Updated API response with OAuth 2.0 error structure.                                    | [User Presentment](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/user-presentment/index.md), [Platform Admin](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/platform-admin/index.md) | July 2026  |
| Updated description for transactionAuthorizationCode in the GET /adjustments endpoints. | [User Presentment](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/user-presentment/index.md), [Platform Admin](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/platform-admin/index.md) | April 2026 |

## 25.2 release changes {#252-release-changes}

The table provides a summary of changes applicable to the 25.2 release of the Offers for Publishers API.

|                                                                                                                                                               Description of change                                                                                                                                                                |                                                                                                                         Section                                                                                                                         |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| The GET /savings endpoint within User Presentment supports the adjustmentsBonusPointsTotal and cashbackLocalBonusAmount fields. These fields display the bonus portion of the offer, helping cardholders clearly see the full amount that they have earned.                                                                                        | [User Presentment](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/user-presentment/index.md)                                                                                                                             |
| The GET / adjustments endpoint within User Presentment returns bonus redemptions with a distinct type. It delivers both base and bonus redemptions as separate entries, each labeled with its respective type. This gives API users the flexibility to either combine the values for a combined display or present them separately to cardholders. | [User Presentment](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/user-presentment/index.md)                                                                                                                             |
| The GET/ adjustments endpoint within User Presentment and Platform Admin includes the merchant logo and short description data points. This allows cardholders to view offer details relevant to their rebates.                                                                                                                                    | [User Presentment](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/user-presentment/index.md) and [Platform Admin](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/platform-admin/index.md) |
| Added FAQ regarding the emergency stop function.                                                                                                                                                                                                                                                                                                   | [Support](https://developer.mastercard.com/pclo-presentment/documentation/support/index.md)                                                                                                                                                             |
| Removed API use cases and references for updating and retrieving offer ratings.                                                                                                                                                                                                                                                                    | Not applicable                                                                                                                                                                                                                                          |

## 25.1 release changes {#251-release-changes}

The table provides a summary of changes applicable to the 25.1 release of the Offers for Publishers API.

|                                                                                                                                                                                                           Description of change                                                                                                                                                                                                           |                                                                                                                         Section                                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| The new activationType field, PASSIVE_ACTIVATION, displays in the response for all APIs returning offer data. PASSIVE_ACTIVATION signifies that a cardholder may earn a specific cashback amount without activating an offer but could receive a higher cashback amount if the offer is activated. Note: Availability for this new activation type varies based on the program construct and the Merchant or Publisher funding the offer. | [Platform Admin](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/platform-admin/index.md) and [User Presentment](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/user-presentment/index.md) |
| The GET /savings endpoint within User Presentment supports the cashbackLocalCurrency and cashbackLocalAmount fields to display cashback in the cardholder's local currency rather than the Merchant's currency.                                                                                                                                                                                                                           | [User Presentment](https://developer.mastercard.com/pclo-presentment/documentation/api-reference/user-presentment/index.md)                                                                                                                             |

## Documentation on Technical Resource Center {#documentation-on-technical-resource-center}

Mastercard provides release notes and updated guides to help customers of Offers for Publishers understand the content of each release.

Release notes and guides are published to the Technical Resource Center (TRC) on Mastercard Connect™ on a quarterly basis. The target publication months are tentative and subject to change.

### Release notes publication schedule {#release-notes-publication-schedule}

| Release |             Publication name             | Publication month |
|---------|------------------------------------------|-------------------|
| 25.1    | 25.1 Release Notes Offers for Publishers | April 2025        |
| 25.2    | 25.2 Release Notes Offers for Publishers | July 2025         |
| 25.3    | 25.3 Release Notes Offers for Publishers | October 2025      |
| 25.4    | 25.4 Release Notes Offers for Publishers | January 2026      |

### Guide publication schedule {#guide-publication-schedule}

| Release | Publication month |
|---------|-------------------|
| 25.1    | April 2025        |
| 25.2    | July 2025         |
| 25.3    | October 2025      |
| 25.4    | January 2026      |

### Access Offers guides and release notes on the TRC {#access-offers-guides-and-release-notes-on-the-trc}

Follow these steps to access Offers guides and release notes on the TRC.

1. Navigate to Mastercard Connect.
2. Enter your **User ID** and **Password / RSA SecurID token**.
3. Select **Sign in**.
4. Access the TRC using one of the following options:
   1. Select **Visit the TRC** from the Mastercard Connect homepage.
   2. Navigate to the **My Items** navigation bar on the left side of the page and select **Technical Resource Center**.
5. Select **Guides**.
6. Locate the **Product/Service** filter on the left.
7. Type **Offers** in the **Product/Service** search bar and select the check box.   

   Results: The filtered list of guides display. Release notes are categorized under **Guides**.
