# Release History source: https://developer.mastercard.com/mastercard-send-funding/documentation/release-history/index.md ## Release Notes {#release-notes} The Mastercard Send releases are quarterly. Mastercard will share advance Release Notes to help notify participants of intended changes. For the release dates and Release Notes, see [Mastercard Send Release Notes](https://developer.mastercard.com/mastercard-send/documentation/send-release-notes/). To stay current on all Mastercard Send API updates, be sure to visit that page regularly. ## Release History {#release-history} Notable changes specific to this API are listed below (in reverse chronological order). The Release Date is when the change takes effect in Production. Changes prior to release 20.R1 (25 May 2020) are not included. Ensure you check the main Release Notes page (see section above) for any other changes that may affect use of this API. | Release Date | Notes | |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 23 January 2026 25.4 | Updated the API specification server domains to the new RNTZ domains. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.4.pdf#page=3). | | 7 October 2025 25.3 | `sender.address.postal_code` and `recipient.address.postal_code` made optional (previously required). Note that existing rules for Visa AFT transactions and Canada have not changed. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.3.pdf#page=4). | | 9 September 2025 25.2 | Added `Repeat-Flag` header parameter. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.2.pdf#page=7). For Funding POST response, removed code 02 from `network_decision_code` field description because it is not relevant to that response. | | August 2025 25.2 | Changed `acceptor_tax_id` field description to add guidance for Chile, Paraguay, and Peru. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.2.pdf#page=6). | | 21 May 2025 | Adjusted the API specification to include 'All fields' example payloads that show all possible fields. | | 8 May 2025 25.1 | `transaction_purpose` code mapped to the Visa Purpose of Transaction code for Visa AFT transactions, see [Transaction Purpose](https://developer.mastercard.com/mastercard-send-funding/documentation/field-uris-codes/transaction-purpose/index.md). | | 11 April 2025 25.1 | Added `transaction_purpose` codes 17 and 18. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.1.pdf#page=12). Added to request and responses: * `acceptor_tax_id` and `acceptor_tax_id_name` for Brazil use - see [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.1.pdf#page=8) * `payment_facilitator_id` and `sub_merchant_id` for Mastercard transactions - see [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.1.pdf#page=9) * `additional_networks` object that contains a `visa_network` object with fields required for Visa AFT transactions - see [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.1.pdf#page=10)
Implemented validations to prevent processing newlines (\\n) and carriage returns (\\r) for some request fields. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-25.1.pdf#page=13). | | 16 January 2025 | Updated the API specification to add `card_type` to Funding POST response. | | 15 November 2024 | Added `merchant_advice_code` response field that is present when the transaction was declined by the issuer. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-24.3.pdf#page=9). | | 22 October 2024 24.3 | Added optional `mastercard_assigned_merchant_id` field to request and responses. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-24.3.pdf#page=8). | | 23 September 2024 | Improved the API specification, including adding sample request payloads. | | 11 September 2024 24.2 | Added `network_decision_code` response field that is present when the transaction was declined by the Mastercard Network instead of the issuer. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-24.2.pdf#page=6). Added `transaction_purpose` code 16. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-24.2.pdf#page=7). Added optional `merchant_verification_value` and `participant_mpg_id` fields to request and responses. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-24.3.pdf#page=4). | | 4 September 2024 | Added the new Sandbox URL to the API specification, which involved adjusting the server base URLs and paths. The MTF and Production APIs and endpoints did not change. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-24.3.pdf#page=2). | | 13 June 2024 | Removed `payment_type` code 'PSM' from the API specification because that code is not supported. | | 29 May 2024 24.1 | Added a POST API request `decline_details` query parameter which, if set to 'true', will cause declined transactions/reversals to be returned as 201 responses (Funding API) or 200 responses (Funding Reversal API), instead of 402 error responses (the default). The 201/200 decline response will have `status` as 'DECLINED' and additional `network_status_code` and `network_status_description` fields. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-24.1.pdf#page=10). | | 23 April 2024 | Improved `sender.address` and `recipient.address` field descriptions. | | 17 April 2024 | Corrected `transfer_acceptor_address.line1` field description to maximum length 48. | | 25 September 2023 23.R2 | Added optional `card_acceptor_id` field to request and responses. This enables participants to provide the Card Acceptor ID (CAID) to identify the merchant. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-23.R2.pdf#page=5). | | 1 November 2022 22.R3 | Updated the APIs to return the `authorization_id` value (when provided by the card issuer) for all payment types. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-22.R3.pdf#page=3). | | 12 September 2022 | Updated the API specification (presented in the documentation pages) to OpenAPI 3.0.3 and improved some of the definition names. | | 26 July 2022 22.R2 | Added `payment_type` code 'P2C' (Person-to-Person Transfer to Card Account) to support a new use case. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-22.R2.pdf#page=4). | | 19 April 2022 22.R1 | Enhanced Sender and Recipient field descriptions in the API specification to provide better guidance for VISA AFT transactions. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-22.R1.pdf#page=2). | | 3 March 2022 21.R4 | Added optional `transaction_purpose` field to request and responses. This enables participants to provide accurate information about the purpose of the transaction, which can be passed to downstream networks. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-21.R4.pdf#page=6). Added `funding_source` field to Funding API request and responses (not Funding Reversal). This enables participants to provide accurate information about the source of the transaction, which can be passed to downstream networks. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-21.R4.pdf#page=7). | | 28 January 2022 | Updated the API specification, including improving Funding Reversal response sample and adding `payment_origination_country` field to requests and responses. | | 11 November 2021 21.R3 | Added `electronic_commerce_indicators` field to responses, enabling participants to receive the Electronic Commerce Indicators (ECI). This relates to support of the SPA2/3DS 2.0 protocol. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-21.R3.pdf#page=4). Added optional `sender.account_type` and `recipient.account_type` fields to request and responses. This enables participants to identify the type of account number passed in the Account URI fields (`sender_account_uri` and `recipient_account_uri`). In addition, the 'raw' schema for the Account URI fields has been enhanced to support the different account types. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-21.R3.pdf#page=7). | | 1 September 2021 | Updated the API specification from Swagger 2.0 to OpenAPI 3.0, adjusting the server base URLs. | | 24 August 2021 21.R2 | Added optional `canada_domestic_indicator` field to request and responses. This enables participants in Canada (who have elected to include Debit Mastercard in scope) to provide a value of 'true' for Canada DMC, MCC and cross-border transactions. Mastercard will decline a transaction if the value is not passed as 'true' and it is a Canada DMC. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-21.R2.pdf#page=10). Added fields and values to support the SPA2/3DS 2.0 protocol based on the UCAF data: * Added `token_cryptogram.type` value 'DSRP_DPD' to support Digital Payment Data. The cryptogram in `token_cryptogram.value` is used to transport the digital payment data for electronic commerce (ecommerce) transactions. * Added `token_cryptogram.type` value 'CONTACT_CHIP' to carry the cryptogram value when the cryptogram is the result of PAN auto-entry via chip. * Added optional `ds_transaction_id` field for providing the Directory Server Transaction ID. Transaction Initiators and Receiving Institutions will need to provide UCAF data following the SPA2/3DS 2.0 protocol. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-21.R2.pdf#page=3). | | 25 May 2021 21.R1 | Added optional `transfer_acceptor_address` object. This enables participants to provide the Transfer Acceptor Address when it is different from the Sender Address, to ensure accurate information is passed to downstream networks. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-21.R1.pdf#page=8). | | 25 August 2020 20.R2 | Added `payment_type` codes 'PCL' (Prepaid Card Load) and 'SWL' (Stage Wallet Load) to support new use cases. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-20.R2.pdf#page=5). Made expiration date optional for pan schema in the `sender_account_uri` and `recipient_account_uri` fields. Participants requesting payments to PANs issued in the U.S. must provide an expiration date. Including the expiration date in the request will increase the approval rate. See [Release Notes](https://static.developer.mastercard.com/content/mastercard-send/release-notes/mastercard-send-release-notes-20.R2.pdf#page=2). | ## Announcements {#announcements} Mastercard regularly publishes announcements relating to Operations, Rules/Standards, and other categories that might impact Mastercard Send API customers. To help you identify which announcements might be relevant to your business, we provide an Announcements spreadsheet. See [Announcements](https://developer.mastercard.com/mastercard-send/documentation/announcements/).