https://www.marqeta.com/docs/developer-guides/upcoming-release-announcements/rss.xml
This page provides advance notice of changes to the Marqeta platform that aren’t yet in production.
When a change goes live, Marqeta moves its announcement to the matching product release notes and leaves a link in the Archive section of this page.
All dates on this page are estimated launch dates and might change.
How to read this page
Filter tags
Each announcement has three filter tags, shown under its date. To show only the announcements with specific filter tags, select them in theFilters panel on the right.
- Lifecycle status: Where the change is in the release process, as described in the following table.
- Impact category: The kind of change, as described in the following table.
- Action requirement:
Action requiredmeans you must update your integration or processes.No action requiredmeans the change doesn’t require any updates from you.
Usage limit values above 100 will be capped
Announced: July 20, 2026Action required by: December 31, 2026Breaking changeMarqeta will enforce the documented allowable range for theusage_limit field on velocity controls.
The usage_limit field defines the maximum number of times a card can be used within the time period defined by the velocity_window field.When this change takes effect, Marqeta rejects usage_limit values greater than 100 on new or updated velocity controls.
Marqeta also updates existing velocity controls with a usage_limit greater than 100 to -1 (unlimited), so there is no adverse change in enforcement.- Production enforcement: January 1, 2027
- Action required: Only if your program creates or updates velocity controls with a
usage_limitgreater than 100. Update those requests to use a value of 100 or lower, or-1for unlimited. If you want an existing control that Marqeta updates to-1to keep a cap, set itsusage_limitto 100 or lower.
MCC values in authorization and velocity controls limited to 4 characters
Announced: November 9, 2026Action required by: December 31, 2026Breaking changeMarqeta will enforce the documented maximum length for the merchant category code (MCC) in themerchant_scope.mcc field of authorization controls and velocity controls.
A merchant category code is a four-digit code, and the field accepts a single MCC of up to 4 characters.When this change takes effect, Marqeta will reject any request that creates or updates an authorization control or velocity control with a merchant_scope.mcc value longer than 4 characters.
This change affects the following endpoints:Marqeta doesn’t change your existing controls.
If you have an active control with a
merchant_scope.mcc value longer than 4 characters, you must update it to a valid 4-character MCC or deactivate it.To apply a control to more than one MCC, create one control for each MCC, or create an MCC group and reference its token in the merchant_scope.mcc_group field.
MCC groups already require each code to be 4 digits, so this change doesn’t affect them.- Production enforcement: January 1, 2027
- Action required: Only if your program creates or updates authorization controls or velocity controls with a
merchant_scope.mccvalue longer than 4 characters.
- Send a
GETrequest to the/authcontrolsand/velocitycontrolsendpoints, and review themerchant_scope.mccvalue of each control. - For each active control with a value longer than 4 characters, send a
PUTrequest to updatemerchant_scope.mccto a valid 4-character MCC, or setactivetofalseto deactivate the control. - If you meant to reference an MCC group, use the
merchant_scope.mcc_groupfield instead ofmerchant_scope.mcc. - Update any automated processes so they no longer send a
merchant_scope.mccvalue longer than 4 characters.
Visa card network changes
Announced: September 29, 2026Action required by: January 2027The VisaNet Business Enhancements take effect in January 2027. To support them, Marqeta will make the following changes:- Production enforcement: January 2027
- Action required: Update any parsing of the account owner date of birth to accept the
yyyymmddformat. If you submit Visa disputes for reason codes13.2or13.3, also see New fields for Visa dispute reason codes 13.2 and 13.3.
New fields for Visa dispute reason codes 13.2 and 13.3
Announced: August 24, 2026Action required by: January 2027To support the mandatory Visa Resolve Online (VROL) changes in the VisaNet Business Enhancements (Visa article 2.5), Marqeta will add new fields toPOST /cases for cancelled recurring transaction and lodging-related disputes.Reason code 13.2(“Cancelled recurring transaction”): For a dispute with dispute_reason set to CANCELLED_RECURRING_TRANSACTION, where the transaction card_acceptor.country_code matches one of the following countries, Marqeta will add a new merchant_facilities_withdrawn field to certify that the merchant facilities were withdrawn. When you set merchant_facilities_withdrawn to true, you must provide the date the lodging facility withdrew or cancelled its services, or made them inaccessible to the cardholder, in the new facilities_withdrawn_date field.Reason code
13.3(“Not as described or defective merchandise”), all regions: For a dispute with dispute_reason set to NOT_AS_DESCRIBED_OR_DEFECTIVE_MERCHANDISE that involves lodging services (merchandise_or_services set to SERVICES and an MCC of 7011 or in the range 3501–3856), Marqeta will add a new date_cardholder_checked_out_from_hotel field to capture the date the cardholder checked out of the lodging facility.- Production enforcement: January 2027
- Action required: Update your dispute submission logic to populate the new fields for qualifying reason code
13.2and13.3disputes.
Mastercard card network changes
Announced: September 29, 2026Action required by: January 2027Mastercard Release 26.Q4 takes effect in January 2027. To support it, Marqeta will make the following changes:- Production enforcement: January 2027
- Action required: Required for programs using Sunday delivery of the T461 file.
If you have processes scheduled around the Sunday delivery of the T461 file, you must adjust them before the change takes effect.
Starting that day, the first Sunday delivery arrives at 05:00 CT (11:00 UTC) instead of 10:00 CT (16:00 UTC).
Delivery on Monday through Saturday doesn’t change.
New Mastercard token assurance method values 12 and 25
Announced: September 28, 2026Action required by: January 2027Starting in January 2027, Mastercard begins sending two new Token Assurance Method (TAM) values,12 and 25 (Mastercard AN 13368.2).
TAM is the method used to verify the cardholder before a digital wallet token was provisioned.
Marqeta returns it in the token_assurance_method field on the transaction’s digital_wallet_token.token_service_provider object, in post-transaction webhook payloads and in Gateway JIT Funding requests, including program gateway funding sources.- Live now: The
token_assurance_methodfield, released in platform release 2026.9.28.0, and the values10(account verification) and11(one-factor cardholder authentication). - Coming January 2027: The values
12(two-factor cardholder authentication) and25(tenured token).
token_assurance_level field is unchanged.- Production enforcement: January 2027
- Action required: Only if you use token assurance data in your risk or authorization logic. Add handling for the two new values before the effective date.
Mastercard authorizations continue on cardholder-deactivated digital wallet tokens
Announced: September 28, 2026Mastercard is requiring issuer processors to keep authorizing certain transactions against a digital wallet token that the cardholder has deactivated in the wallet (Mastercard AN 13503.1). Marqeta currently terminates the digital wallet token as soon as the cardholder deactivates it, and declines every later authorization on that token.From the effective date, when a cardholder deactivates a Mastercard digital wallet token, Marqeta evaluates the following authorizations on that token normally. Marqeta evaluates these authorizations against your authorization controls, available funds, and Just-in-Time (JIT) Funding decision, if configured.- Merchant-initiated transactions, such as recurring payments, installments, standing orders, unscheduled credential-on-file transactions, and industry-practice transactions, for the remainder of the 540-day token lifetime.
- Cardholder-initiated transactions, within 48 hours of the deactivation. After 48 hours, Marqeta declines them, as it does today.
- Production enforcement: January 2027
- Action required: None. Marqeta applies this update automatically to keep your program compliant with the Mastercard standard. However, if your program treats a
TERMINATEDdigital wallet token as permanently unusable, review any risk, reconciliation, or JIT Funding logic that depends on those authorizations being declined.
Custom number-of-days and number-of-hours velocity control windows deprecated
Announced: October 5, 2026Action required by: January 2027DeprecationMarqeta is standardizing the time windows that velocity controls support. Effective January 2027, Marqeta is deprecating the custom number-of-days and number-of-hours window configurations, so that velocity controls are calculated consistently across all programs.From January 2027, thevelocity_window field on the Velocity Controls API supports only the following values:If you have velocity controls that use a custom number-of-days or number-of-hours window, update them to a supported window before January 2027.
After that date:
- You can no longer view or update controls that use these windows.
- The API rejects any new control that has a number-of-days or number-of-hours parameter.
- Marqeta no longer counts controls that still use an unsupported window toward transaction decisioning. Velocity limits might then be applied inconsistently, which can affect cardholder transactions.
- Production enforcement: January 2027
-
Action required: Review your active velocity controls. For each control that uses a custom number-of-days or number-of-hours window, either update it to a supported window or deactivate it by setting
activetofalse.
PUT request to the /velocitycontrols/{token} endpoint.
For questions, contact your Marqeta account team.Managed KYC and KYB onboarding outside the US
Announced: October 1, 2026Marqeta will add a managed, non-delegated Know Your Customer (KYC) and Know Your Business (KYB) onboarding product for programs in the EU, UK, Canada, and Australia. You will integrate with a single verification API. Marqeta plans to release KYC verification in January 2027 and KYB verification in March 2027.- Action required: None. The product is optional.
Mastercard technical fallback declined outside the US region
Announced: September 28, 2026Action requiredMastercard is phasing out technical fallback outside the United States region (Mastercard AN 13700), with an earliest effective date of January 2027. Technical fallback occurs when a chip-capable terminal can’t read the chip on a card and the transaction falls back to a less secure entry method, such as a magnetic stripe swipe or a manually keyed card number.From the effective date, Marqeta declines a Mastercard technical fallback authorization unless the card issuer or the card acceptor (the merchant or terminal) is in the United States region, which includes Puerto Rico, the US Virgin Islands, Guam, American Samoa, and the Northern Mariana Islands.- Production enforcement: January 2027 (earliest)
- Action required: Only if your program issues Mastercard cards outside the United States region. Review any logic that depends on technical fallback authorizations succeeding.
pos.pan_entry_mode field, see the Transaction object.Widgets moving to the UX Toolkit
Announced: September 4, 2026Action required by: February 2027DeprecationWidgets are being sunset and moving to the UX Toolkit. The UX Toolkit will offer full feature parity with Widgets, including card activation, PIN set and reveal, and card display. It also adds capabilities that Widgets don’t offer, such as freezing and unfreezing cards, card replacement, transaction history, account balances, dispute filing, account funding, statements, and user onboarding.Marqeta is migrating customers from Widgets to the UX Toolkit in waves, so each customer moves at a different time. Marqeta plans to move all customers to the UX Toolkit by February 2027.- Transition complete: February 2027
- Action required: To find out when your migration is scheduled, contact your Account Manager.
Archive
The following announcements are now live. Each note links to the release notes entry for the change.- Card product-level authorization control default behavior override: Effective Sep 2026 — Moved to Card Issuing and Processing September 2026 Release Notes.
- Documentation site information architecture enhancements: Effective Aug 24, 2026 — Moved to Card Issuing and Processing August 2026 Release Notes.
- Expanded cryptocurrency transaction support: Effective Jul 24, 2026 — Moved to Card Issuing and Processing July 2026 Release Notes.
- New message reason in Digital Wallet: Effective Jun 2026 — Moved to Card Issuing and Processing June 2026 Release Notes.
- Updates to Disputes reason codes 13.6 and 13.7: Effective Apr 18, 2026 — Moved to Card Network Certifications April 2026.
- Domestic account funding transactions in Brazil: Effective Apr 17, 2026 — Moved to Card Network Certifications April 2026.
- New transaction types and fields: Effective Mar 30, 2026 — Moved to Card Issuing and Processing March 2026 Release Notes.
- New optional field in the Transactions API: Effective Jan 2026 — Moved to Card Issuing and Processing January 2026 Release Notes.
- New transaction response codes for JIT Funding timeouts: Effective Nov 2025 — Moved to Card Issuing and Processing November 2025 Release Notes.