# Announcements and Release History source: https://developer.mastercard.com/iccp/documentation/ann-and-rh/index.md ## Announcements {#announcements} Here you can find information about upcoming changes that are planned for the Alerts for In Control for Commercial Payments (ICCP) API. All announcements-related terms of use, pricing, and other general information about the In Control for Commercial Payments service can be found in the [Technical Resource Center](https://trc-techresource.mastercard.com/) opens in a new tab on Mastercard Connect. ## Release History {#release-history} This page contains a history of features implemented for the ICCP API service. Changes for each release are detailed in the following table. | Release | Description | |---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | April 2026 | * Added a new error code `VCDFCL` for custom data field's length to the [List of Codes](https://developer.mastercard.com/iccp/documentation/error_handling/06error_codes/index.md#list-of-codes). * Replaced multiple references to the **Company Site Configuration** page with the new **Company Settings** page. The **Company Site Configuration** page is decommissioned. | | February 2026 | * Added list of all countries available for [GeographyControl](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/control_elements/index.md#geographycontrol-countries). * Added a new error code `VCDFAN` to the [List of Codes](https://developer.mastercard.com/iccp/documentation/error_handling/06error_codes/index.md#list-of-codes). * Added [Quick Start Guide](https://developer.mastercard.com/iccp/documentation/quick-start-guide/index.md). * Enable [Idempotency](https://developer.mastercard.com/iccp/documentation/api_basics/idempotency/idempotency-soap/index.md) for ICCP API. | | December 2025 | Updated sample request and sample response with Clearing Controls function for following APIs: * [CreateVCNClearingDecisionsReport](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/create_reports/index.md#sample-createvcnclearingdecisionsreportrequest) * [GetVCNClearingDecisionsReport](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#sample-getvcnclearingdecisionsreportrequest) | | October 2025 | * Following two error codes are added to the [List of Codes](https://developer.mastercard.com/iccp/documentation/error_handling/06error_codes/index.md#list-of-codes) for existing restrictions: * `VMTN` * `VMTLE` * Clearing Decision Code 48 is added to [In Control Clearing Decision values](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#in-control-clearing-decision-values). | | August 2025 | * The following APIs are updated with the **Clearing Controls** functionality: * [submitPurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/submitpurchaserequest/index.md#clearing-controls) * [updatePurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/updatepurchaserequest/index.md#clearing-controls) * As part of **Clearing Controls** , the following two new reporting APIs have been introduced: * [CreateVCNClearingDecisionsReport](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/create_reports/index.md#sample-createvcnclearingdecisionsreportrequest) * [GetVCNClearingDecisionsReport](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#sample-getvcnclearingdecisionsreportrequest) * Following new error codes are added to the [Error code](https://developer.mastercard.com/iccp/documentation/error_handling/06error_codes/index.md#list-of-codes) list for `CreateVCNClearingDecisionsReport`:: * `VP` * `VCINFO` * `CCDCF` * `VFD` * `VSD` * Added maximum field length in request and response fields of following APIs: * [submitPurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/submitpurchaserequest/index.md) * [getPurchaseRequestDetail](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/getpurchaserequestdetail/index.md) * [updatePurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/updatepurchaserequest/index.md) * [cancelPurchaseRequests](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/cancelpurchaserequest/index.md) * [CreateVCNAuthsReport](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/create_reports/index.md) * [CreateVCNClearingsReport](https://developer.mastercard.com/iccp/documentation/error_handling/06error_codes/index.md) * [Controls: Elements and Attributes](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/control_elements/index.md) | | June 2025 | * A new functionality to Block / Unblock ICCP VCNs is added to [CancelPurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/cancelpurchaserequest/index.md). * A new `digitizationGuid` functionality is added to the following APIs: * [submitPurchaseRequestResponse](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/submitpurchaserequest/index.md) * [updatePurchaseRequestResponse](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/updatepurchaserequest/index.md) * [getPurchaseRequestResponse](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/getpurchaserequestdetail/index.md) This change requires an updated PurchaseControl2.xsd file. See the most recent WSDL and XSD files in [ICCP_WSDL_XSD.zip](https://static.developer.mastercard.com/content/iccp/uploads/ICCP_WSDL_XSD.zip) (149KB). | | February 2025 | * A new optional http header `Idempotency-Key` has been added to support Idempotent calls for the following API endpoints: * [Invoice Addenda Data](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/invoice_addenda_data/addaddenda/index.md#request-headers) * [sendSupplierEmail](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/sendsupplieremail/index.md#request-headers) * [emailCardImage](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/emailcardimage/index.md#request-headers) * [VCN Reports](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/index.md#request-headers) * Updated the ICMP enabled response of the following reports with TokenRequestorId and TokenType fields: * [GetVCNAuthsReportResponse](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#sample-getvcnauthsreportresponse-icmp-enabled) * [GetVCNClearingsReportResponse](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#sample-getvcnclearingsreportresponse-icmp-enabled) | | October 2024 | * A new optional http header `Idempotency-Key` has been added to support Idempotent calls for [submitPurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/submitpurchaserequest/index.md) and [updatePurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/updatepurchaserequest/index.md). * A new optional parameter `referenceID` will be added to submitPurchaseRequest and updatePurchaseRequest API calls. There is no external applicability of this field at the moment. `referenceID` is an external identifier that customers can pass along with the Purchase request. A new REST-based endpoint will be introduced in subsequent releases that will allow users to query purchase requests using the `referenceId` passed as part of the request. | | August 2024 | * The `supplierDetails` field is now an optional field when submitting or updating a purchase request through the In Control for Mobile Payments API. * Email addresses for purchase requests will be validated to ensure that the email address is valid. * Following new error codes are as added: * `VSPRMSD` * `VUPRMSD` * `VUPRIUEF` | | April 2024 | The dates for the upcoming release are included here. | Environment | Dates | |---------------------------------|-------------| | Production | 13-14 April | | Mastercard Test Facility (MTF2) | 9 May | | | February 2024 | * The dates for the upcoming release are included here. | Environment | Dates | |---------------------------------|----------------| | Production | 10-11 February | | Mastercard Test Facility (MTF2) | 7 March | * Added *Blocked* to `requestStatus` in [Get purchase request detail](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/getpurchaserequestdetail/index.md#parameters). * Added *Blocked* to `PurchaseRequestStatus` to [authorization or clearing report](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#authinfos-transaction-attributes). * Add the TokenPan element to [Get Reports](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md). * Download the necessary February 2024 XSD files for this feature: [ICCP_WSDL_XSD.zip](https://static.developer.mastercard.com/content/iccp/uploads/ICCP_WSDL_XSD.zip) (149KB). | | August 2023 | * The dates for the upcoming release are included here. | Environment | Dates | |---------------------------------|--------------| | Production | 12-13 August | | Mastercard Test Facility (MTF2) | 7 September | * Following error codes are added to [Error Handling](https://developer.mastercard.com/iccp/documentation/error_handling/06error_codes/index.md): * `VICMPGEN` * `VPRIVCND` * `VPRMVCND` * `VUPRIUDCCF` * `VUPRIUMF` * `VUPRNSUEF` | | June 2023 | * The dates for the upcoming release are included here. | Environment | Dates | |---------------------------------|------------| | Production | 10-11 June | | Mastercard Test Facility (MTF2) | 6 July | * A new optional parameter `disableCardImage` is added to the [submitPurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/submitpurchaserequest/index.md#parameters), [updatePurchaseRequest](https://developer.mastercard.com/iccp/documentation/05_api_reference/purchaserequest/soap_api/updatepurchaserequest/index.md#parameters), and [getPurchaseRequestDetail](https://developer.mastercard.com/iccp/documentation/05_api_reference/purchaserequest/soap_api/getpurchaserequestdetail/index.md#parameters) API requests. Where the `disableCardImage` parameter is included in API requests and a valid value is passed, this value overrides any settings configured in the user interface at Purchase Template, Company Settings, or Program Options level. * This requires an updated **PurchaseControl2.xsd** file. See the most recent WSDL and XSD files in [ICCP_WSDL_XSD.zip](https://static.developer.mastercard.com/content/iccp/uploads/ICCP_WSDL_XSD.zip) (149KB). * New attributes are added to [Get Report](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#responses) that are included in **getVCNAuthsReport** and **GetVCNClearingsReport** reports: * `ICMPUserFirstName` * `ICMPUserLastName` * `ICMPUserEmail` * `ICMPUserPhoneCountryCode` * `ICMPUserMobileNumber` | | April 2023 | * The dates for the upcoming release are included here. | Environment | Dates | |---------------------------------|-------------| | Production | 15-16 April | | Mastercard Test Facility (MTF2) | 11 May | * An In Control for Mobile Payments (ICMP) flag (*icmpEnabled* ) is added to [GetCompanyPurchaseTemplateDetail](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/configuration-details/getcompanypurchasetemplatedetail/index.md#response). * This requires an updated **PurchaseControl2.xsd** file. See the most recent WSDL and XSD files in [ICCP_WSDL_XSD.zip](https://static.developer.mastercard.com/content/iccp/uploads/ICCP_WSDL_XSD.zip) (149KB). ICMP will be released in Q3 2023. Note: The **PurchaseRequestStatus** field for virtual cards in payment control activity reporting enhancement functionality is only fully effective on April 30. The **PurchaseRequestStatus** field is available from April 15. From April 15 to April 30, users will receive an error when generating either the **getVCNAuthsReport** or the **GetVCNClearingsReport** through the API and filtering the API response with a *Cancelled* status for the **PurchaseRequestStatus** field. * The **getVCNAuthsReport** and **GetVCNClearingsReport** reports now have an optional Purchase Request Status field in the API response. The statuses are *Approved* , *Declined* , *Cancelled* , *Pending batch approval* , or *Pending* . The ability to report on cancelled cards can improve reconciliation processes, and the management of virtual cards. * Status field for virtual cards added to Authorization and Clearing [Activity Report responses](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md#authinfos-transaction-attributes). | ## Next Steps {#next-steps} * Use the [API Reference](https://developer.mastercard.com/iccp/documentation/05_api_reference/index.md) information for details about the fields and values relevant to your specific needs. * For any questions about the ICCP API service, refer to the FAQs in the [Support](https://developer.mastercard.com/iccp/documentation/support/index.md) section.