# Release History source: https://developer.mastercard.com/presentment/documentation/release-history/index.md ## 26.1C release changes {#261c-release-changes} | Description of change | Section | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Added information regarding the enablement of OAuth 2.0 authentication for Offers for Publishers and User Account Administration APIs. Support for OAuth 1.0a authentication remains available. | - [API Basics](https://developer.mastercard.com/presentment/documentation/api-basics/index.md) - [Quick Start Guide](https://developer.mastercard.com/presentment/documentation/quick-start-guide/index.md) - [Tutorials and Guides](https://developer.mastercard.com/presentment/documentation/tutorials-and-guides/index.md) - [Integration and Testing](https://developer.mastercard.com/presentment/documentation/integration-and-testing/index.md) - [Reference Application](https://developer.mastercard.com/presentment/documentation/reference-application/index.md) - [Code and Formats](https://developer.mastercard.com/presentment/documentation/code-and-formats/index.md) | | Added the Access redemption data use case. | [Presentment](https://developer.mastercard.com/presentment/documentation/use-cases/presentment/index.md) | | Updated description in the User Account Administration API reference specification. | [User Account Administration](https://developer.mastercard.com/presentment/documentation/api-reference/user-account-admin/index.md) | | Introduced the GET /platforms/redeemed-transactions endpoint. | [Presentment](https://developer.mastercard.com/presentment/documentation/api-reference/presentment/index.md) | | The presentment and platform APIs return new fields that indicate whether an offer uses delayed redemption or clawback functionality. These updates help merchants manage scenarios where rewards are held until defined approval conditions are met, supporting more flexibility when returns or cancellations occur. Note: For clawback scenarios, a clawback reflects a previously awarded amount that is reversed when a transaction no longer qualifies, such as in a return or cancellation. The following changes apply: - A new offer value identifies whether the offer is a regular offer, a delayed redemption offer, or a clawback offer. - A numeric value indicates an approval rule that automatically approves a transaction after (a) a set number of days from the transaction date, (b) after a set number of days from the offer end date, or (c) after a specific calendar date. - A field provides either the number of days to delay the redemption or the specific date on which the redemption will be approved. For clawback scenarios in the adjustment APIs for presentment and platform offers: - Rewards and clawbacks are available in the response. - An indicator specifies whether each entry is an award given or an amount revoked. - User savings are presented as a net value (awards minus clawbacks). These enhancements enable merchants to delay, approve, or retract rewards when returns or cancellations occur. This also helps reduce the number of customer inquiries by making cardholders aware of cashback or points delay. | [Presentment](https://developer.mastercard.com/presentment/documentation/api-reference/presentment/index.md) | ## Non-release changes {#non-release-changes} | Description of change | Section | |--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------| | Added base URLs to the Environments section. | [API Basics](https://developer.mastercard.com/presentment/documentation/api-basics/index.md) | | Updated HTTP status codes/reason codes table and added resolution tips. | [Code and Formats](https://developer.mastercard.com/presentment/documentation/code-and-formats/index.md) | | Updated onboarding and integration FAQs and added contextual links within FAQs to related sections of the documentation. | [Support](https://developer.mastercard.com/presentment/documentation/support/index.md) | ## Past updates {#past-updates} ### 26.1B release changes {#261b-release-changes} | Description of change | Section | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| | Added the following use cases: Submit rebate transaction, Retrieve rebates. | [User Account Administration](https://developer.mastercard.com/presentment/documentation/use-cases/user-account-administration/index.md) | | Introduced new endpoints for rebate processing: POST /rebates and GET /rebates. These endpoints enable Offers for Publishers partner integrators to initiate cashback or statement credits directly to Mastercard card accounts, without relying on offer redemption processing. This provides greater flexibility and control by allowing partners to manage statement credits independently and process rebates more efficiently. | [User Account Administration](https://developer.mastercard.com/presentment/documentation/api-reference/user-account-admin/index.md) | ### Non-release changes {#non-release-changes-1} | Description of change | Section | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------| | Added the **Company Verification** section within the Quick Start Guide. This is a required prerequisite before you can request Production access for a service on Mastercard Developers. | [Quick Start Guide](https://developer.mastercard.com/presentment/documentation/quick-start-guide/index.md) | | Updated description for transactionAuthorizationCode in GET /adjustments and GET /platforms/adjustments endpoints. | [Presentment](https://developer.mastercard.com/presentment/documentation/api-reference/presentment/index.md) | ### 26.1A release changes {#261a-release-changes} | Description of change | Section | |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------| | Added the Retrieve platform rewards use case. | [Presentment](https://developer.mastercard.com/presentment/documentation/use-cases/presentment/index.md) | | Updated the GET /adjustments endpoint and added the GET /platforms/adjustments endpoint to enable Publishers to retrieve redeemed offers and associated redemption details for their cardholders within a specified time period. | [Presentment](https://developer.mastercard.com/presentment/documentation/api-reference/presentment/index.md) | ### 25.4 release changes {#254-release-changes} The table provides a summary of changes applicable to the 25.4 release of the Offers for Publishers API. | Description of change | Section | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | The specification file has been updated to ensure improved clarity and alignment with the current API functionality. This update includes refinements to parameter descriptions, validation rules, and response structures to provide developers with accurate and comprehensive guidance when integrating account management features. | [User Account Administration](https://developer.mastercard.com/presentment/documentation/api-reference/user-account-admin/index.md) | | The specification file has been updated to ensure improved clarity and alignment with current API functionality. This update includes refinements to OAuth credentials and the contents of ApiClientConfiguration.java to provide developers with accurate and comprehensive guidance when integrating account management features. | [User Account Administration integration and testing tutorial](https://developer.mastercard.com/presentment/tutorial/user-account-admin-integration-and-testing/step-3/index.md) | ### 25.3 release changes {#253-release-changes} The table provides a summary of changes applicable to the 25.3 release of the Offers for Publishers API. | Description of change | Section | |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------| | Added Geo-filtering of Dining Offers as a geo-graphic search to find offer programs. | [Presentment](https://developer.mastercard.com/presentment/documentation/use-cases/presentment/index.md) | | Added **Affiliate** as a new offer type displayed next to card-linked offers. | [Presentment](https://developer.mastercard.com/presentment/documentation/api-reference/presentment/index.md) | | The response for all GET offers calls in both presentment and platform offers APIs now includes a new field: redemptionMerchantSetId. This field returns the set ID when an offer uses set IDs to define its redemption criteria, rather than the traditional redeemingMerchant JSON. If an offer does not use a set ID, the field will be blank. Publishers can use the set ID to reference groups of locations associated with an offer. | [Presentment](https://developer.mastercard.com/presentment/documentation/api-reference/presentment/index.md) | | The User Account Administration APIs now include additional fields that expand the scope of customer and account-related data available to downstream consumers. | [User Account Administration](https://developer.mastercard.com/presentment/documentation/api-reference/user-account-admin/index.md) | ### Unified performance reporting view {#unified-performance-reporting-view} APIs related to Offers, Offers activation, and Offer redemption can now return a unified performance reporting view designed to provide merchants and publishers with a comprehensive, system-wide perspective on campaign performance. Its key features include: * Integrated Reporting Interface: Consolidates performance data across all offers into a single, unified view. * Source-Agnostic Insights: Offers visibility regardless of how offers were sourced, adjudicated, or delivered. * Holistic Campaign Analysis: Enables users to evaluate effectiveness across the full campaign lifecycle, reducing fragmentation and improving strategic clarity.
This release supports a holistic understanding of campaign performance, empowering users to make informed decisions based on complete and contextualized data. By eliminating silos and streamlining reporting, we enhance transparency and operational efficiency that will impact: * An improvement in cross-channel performance visibility. * An enablement of data sharing between two systems. * A reduction in manual data reconciliation. * The support of data-driven optimization strategies. ### User Account Administration enhancements {#user-account-administration-enhancements} | Description of change | Section | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| | Updated the Quick Start Guide to include User Account Administration as an API service and to reference relevant tutorials for prerequisite requirements. | [Quick Start Guide](https://developer.mastercard.com/presentment/documentation/quick-start-guide/index.md) | | Added the Tutorials and Guides page with new tutorials: - Create a Sandbox project - User Account Administration Integration and Testing Tutorial | [Tutorials and Guides](https://developer.mastercard.com/presentment/documentation/tutorials-and-guides/index.md) | | Updated Use Cases page to reference new User Account Administration APIs. | [Use Cases](https://developer.mastercard.com/presentment/documentation/use-cases/index.md) | | Added User Account Administration use cases. | [User Account Administration](https://developer.mastercard.com/presentment/documentation/use-cases/user-account-administration/index.md) | | Added the new User Account Administration APIs to the API Reference section. | [User Account Administration](https://developer.mastercard.com/presentment/documentation/api-reference/user-account-admin/index.md) | | Added the User Account Administration reference application. | [Reference Application](https://developer.mastercard.com/presentment/documentation/reference-application/index.md) | | Removed references to Mastercard Loyalty Management's User Account Management APIs. Note: Customers may refer to different API documentation depending on their integration platform: * Offers Direct Integration Platform: Use the Offers for Publishers User Account Administration APIs for key functionalities such as cardholder enrollment, account updates, card replacements, and accessing sensitive identifiers. * Mastercard Loyalty Management Platform: Customers who have not migrated to the new Offers platform can continue using the Mastercard Loyalty Management User Account Management APIs. In this case, refer to the [User Account Management API documentation](https://developer.mastercard.com/user-account-management-service/documentation/) on Mastercard Developers. | Throughout | ### Offers aggregation enhancements {#offers-aggregation-enhancements} This release introduces a new version of the Offers for Publishers API, providing a unified integration point for accessing offer content from both the Mastercard Offers platform and external sources. Publishers can retrieve offer content through a single, filterable endpoint, simplifying integration and enabling more efficient offer management. Capabilities with this enhancement include: * Unified offer retrieval: Publishers can access offer content directly from the Offers platform through a single API endpoint. * Filterable offer queries: The endpoint supports query-level filters, allowing Publishers to efficiently narrow results and surface the most relevant offers. * Cardholder enrollment: Cardholders can enroll in the card-linked offers program with automatic management of their tokenized cardholder ID. This helps to ensure a smoother user experience, allowing cardholders to activate and redeem offers. * Cardholder offer activation: Supports activation of offers originating from Mastercard to maintain continuity in offer activation and redemption activities. * Offer retrieval support: The Publisher API endpoint supports retrieval of offers from the Offers platform and external sources. * Batch files for aggregator offer data: Daily batch files provide activation and redemption data for aggregator offers, supporting reporting and personalization use cases. ### De-duplication logic application {#de-duplication-logic-application} De-duplication logic is implemented to improve the relevance and quality of offers presented to cardholders. Since offers are sourced from multiple providers, this logic ensures that duplicate entries are filtered out effectively. De-duplication is performed using a combination of merchant names and addresses to serve the best available content to users without redundancy. ### 25.2 release changes {#252-release-changes} The table provides a summary of changes applicable to the 25.3 release of the Offers for Publishers API. | Description of change | Section | |---------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------| | Updated the Retrieve User Offers use case to sort offers by likelihood of redemption. | [Presentment](https://developer.mastercard.com/presentment/documentation/use-cases/presentment/index.md) | | Added the Activities use cases to support cardholder offer preferences. | [Presentment](https://developer.mastercard.com/presentment/documentation/use-cases/presentment/index.md) | | Added the FAQ regarding the emergency stop function. | [Support](https://developer.mastercard.com/presentment/documentation/support/index.md) | ## Offers 2026 communication schedule {#offers-2026-communication-schedule} The Offers communication schedule provides publication dates for Release notes, updates to guides, and updates to API documentation. **Note:** Publication dates are subject to change. Offers Release notes follow this schedule for publication to the Technical Resource Center (TRC). ### Release notes publication schedule {#release-notes-publication-schedule} | Release | Publication date | |---------|-------------------| | 26.1A | 3 March 2026 | | 26.1B | 31 March 2026 | | 26.1C | 28 April 2026 | | 26.2A | 2 June 2026 | | 26.2B | 30 June 2026 | | 26.2C | 28 July 2026 | | 26.3A | 1 September 2026 | | 26.3B | 29 September 2026 | | 26.3C | 27 October 2026 | | 26.4A | 1 December 2026 | | 26.4B | 29 December 2026 | | 26.4C | 26 January 2027 | Updates to Offers guides follow this schedule for publication to the TRC. ### Guide publication schedule {#guide-publication-schedule} | Release | Publication month | |---------|-------------------| | 26.1 | 28 April 2026 | | 26.2 | 28 July 2026 | | 26.3 | 27 October 2026 | | 26.4 | 26 January 2027 | Updates to Offers API documentation follow this schedule for publication to Mastercard Developers. ### Mastercard Developers publication schedule {#mastercard-developers-publication-schedule} | Release | Publication date | |---------|-------------------| | 26.1A | 4 March 2026 | | 26.1B | 1 April 2026 | | 26.1C | 29 April 2026 | | 26.2A | 3 June 2026 | | 26.2B | 1 July 2026 | | 26.2C | 29 July 2026 | | 26.3A | 2 September 2026 | | 26.3B | 30 September 2026 | | 26.3C | 28 October 2026 | | 26.4A | 2 December 2026 | | 26.4B | 30 December 2026 | | 26.4C | 27 January 2027 | ### Access Offers documentation on the TRC {#access-offers-documentation-on-the-trc} Follow these steps to access the latest version of 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. Use the additional filters on the left: * Select **Bulletin announcement** under the **Type** filter. * Type **Offers** in the **Product/Service** search bar and select the check box. Results: This will display the filtered list of Offers-related documents, including guides, Release notes, and bulletin announcements. Use the **Sort by** drop-down menu to sort results by **Publication date**.