Release Notes
June 2023
Copy section link
New features
Copy section link
New Dashboard navigation
Copy section link
We’ve updated Dashboard navigation to make managing your program easier:
-
New content navigation - The content switcher lets you change between workspaces to quickly access the information relevant to you.
-
Program Controls workspace - Manage your program, users, and audit logs via the Program Controls workspace.
-
Data & Insights workspace - Access all of your Reports from the Data & Insights workspace with dynamic filtering, sorting, and interactive visualizations.
-
Collapsible sidebar - Use the collapsible sidebar to open up the dashboard for easier viewing and smoother workflows.
If you’re not ready for these changes, you can select the Revert to old button in the Welcome banner at the top of the Dashboard to temporarily revert to the old navigation. Revert is available until June 12, 2023.
New webhook for 3DS smart rejects
Copy section link
Beginning June 2, 2023, when a user submits a fraud dispute on a 3DS transaction, the case management system creates a webhook when it smart-rejects the dispute. See Smart rejects for 3DS case events.
May 2023
Copy section link
New features
Copy section link
Subscribe to the Release Notes Newsletter
Copy section link
Would you like to keep on top of the latest Marqeta deployments and be notified whenever new release notes are published? Get our new biweekly newsletter conveniently delivered to your inbox by subscribing in the release notes section of the homepage.
You do not need to be a Marqeta customer to sign up, and you can unsubscribe hassle-free at any time.
Simulations 2.0 (Beta) — Direct Deposits
Copy section link
You can simulate direct deposit event types in both the public and private sandbox environments. For more information, see Simulations 2.0 (Beta) — Direct Deposits.
Postman collection for Simulations 2.0 (Beta)
Copy section link
You can use Postman to run requests for card transaction and direct deposit simulations endpoints. This collection of requests has been saved as a YAML file for your convenience. To access the YAML file, see Postman Collection for Simulations 2.0 (Beta).
Four new cardholder notification languages
Copy section link
There are four new languages available for cardholder notifications such as 3D Secure one-time passcode (OTP) notifications and digital wallet token notifications. You now have the option to send notifications in Dutch, Greek, Portuguese, and Romanian in addition to Czech, French, German, Italian, Polish, Spanish, and Swedish. The default language for notifications is still English. For more information, see Configuring Notification Languages.
Platform release 2023.5.29.0
Copy section link
The 2023.5.29.0 release of the Marqeta platform contains infrastructure improvements and back-end issue fixes only. There are no customer-facing enhancements or fixed issues in this release.
Platform release 2023.5.15.0
Copy section link
Changed functionality
Copy section link
Special condition indicator now included in transaction payloads
Copy section link
The special_condition_indicator
field is now included in the transaction payloads of JIT Gateway requests, webhooks, and GET /transactions
API requests for transactions on the Visa card network.
When a payload includes the special_condition_indicator
field, it means that the transaction involves quasi-cash (i.e., traveler’s checks, money orders, foreign currency, gaming chips), a cryptocurrency purchase (including transactions that load or unload cryptocurrency wallets), or debt repayment.
For more information about the special_condition_indicator
field, see the Transactions API reference.
Platform release 2023.5.1.0
Copy section link
Changed functionality
Copy section link
Network metadata now included in Transaction Model v1 payloads
Copy section link
The network_metadata
object is now included in the transaction payloads of JIT Gateway requests, webhooks, and GET /transactions
API requests using Transaction Model v1 of the Marqeta Core API.
For more information about the network_metadata
object, see the Transactions API reference.
New transaction response code
Copy section link
This release of the Marqeta platform includes a new transaction response code: 1927: Account transfer not allowed
.
The Marqeta platform returns this response code to decline account transfer transactions, which Marqeta does not support.
For more information about the codes that are returned by the Marqeta platform to help you understand the response to a transaction, see Transaction response codes.
Fixed: Mismatch between GPA load and clearing amounts
Copy section link
An issue that caused a mismatch between GPA loads and clearing transactions has been resolved in this release.
Fixed: Refund clearing transactions associated with incorrect authorizations
Copy section link
An issue that caused refund.authorization.clearing
transactions to be associated with the incorrect refund.authorization
transaction has been resolved in this release.
Notable documentation changes
Copy section link
Simulations 2.0 (Beta) reference renamed and updated
Copy section link
The API reference page previously called Simulations 2.0 (Beta) is now specific to the Simulations 2.0 API for card transactions. See Simulations 2.0 (Beta) — Card Transactions.
April 2023
Copy section link
New features
Copy section link
Real-time health information available online for Marqeta products and services
Copy section link
We are pleased to announce the launch of the Marqeta Status Page. This new, publicly available page is simple to navigate and displays real-time health information for Marqeta’s products and services. Use the status page to stay informed about the critical operational and incident updates happening at Marqeta. It is also a great place to check for the latest announcements and planned maintenance schedules.
To get started, access the status page and subscribe to your preferred notification method. We support email, text messages, webhooks, atom feeds, and RSS feeds. Reach out to your Marqeta representative if you have any questions.
Upcoming Direct Deposit API version update
Copy section link
Marqeta currently provides support for Direct Deposit API version 2.0. Version 3.0 is in development and will replace v2 upon release. As this could require changes to your workflows, we are providing notice well in advance so you can plan to update your processes accordingly.
We plan to start migrating programs to the new version in Q3 of 2023. More specific timing and details about the changes required will be available as development progresses. Contact your Marqeta representative for more information.
Compelling Evidence 3.0 for disputes in the Visa network
Copy section link
Beginning 15 April 2023, Visa will implement Compelling Evidence 3.0 changes for Card Not Present (10.4) Visa disputes. Effective on that date, a 10.4 dispute raised against a merchant who has signed up for Compelling Evidence 3.0 can be rejected by Visa, provided there are at least two historic transactions that meet the Remedy Prior undisputed transactions criteria. For details, see the "Rejection from the Visa network for Compelling Evidence 3.0-enabled merchants" section in Managing Visa Disputes and Disputes in the Dashboard.
Dispute reason code changes for Visa
Copy section link
The text of the following two reason codes has changed in the Visa questionnaire.
Cancelled Recurring Transaction Details, 13.2
Copy section link
The Cancellation date
text has changed to Date cardholder withdrew permission to charge the Payment Credential
.
If a value is entered for this field, contact method details with the merchant are required.
For details, see Dispute questionnaires in Managing Visa Disputes and the cancelled_recurring_transaction_details object in the Cases (Visa) API Reference.
Cancelled Merchandise or Services, 13.7
Copy section link
Visa now requires that two additional questions be answered for cancelled services:
-
Did the cardholder attempt to resolve the dispute with the merchant?
-
If No to the above, is the attempt prohibited by regulation?
For details, see Dispute questionnaires in Managing Visa Disputes and the cancelled_merchandise_or_services_details object in the Cases (Visa) API Reference.
Reporting fraud from the Disputes dashboard or Cases endpoint
Copy section link
The Visa network now requires issuers and programs to report fraud to the card network, regardless of the amount. Whenever a cardholder reports fraud, a fraud report must be created with the card network. Noncompliance with network rules results in fines and suspension of the ability to process chargebacks. For details, see Reporting Fraud in Disputes in the Dashboard and Reporting Fraud in Managing Visa Disputes.
Enhanced transaction details
Copy section link
The Transaction Details page of the Marqeta Dashboard has been enhanced to include additional information about transactions, such as transaction and merchant summaries, related transactions, and point-of-sale details. For a detailed guide on how to use the page to investigate commonly occurring issues, see Investigating Transactions in the Dashboard.
Search by transaction token
Copy section link
Global search, available at the top of the Marqeta Dashboard, has been enhanced to search by transaction token.
New chargeback transition event
Copy section link
The prearbitration.responded
event has been added; the scope of this chargeback transition event is limited to Fraud and Authorization reason codes.
See Chargeback transition events.
Level 2 and Level 3 webhooks
Copy section link
Marqeta now supports sharing Level 2 (L2) and Level 3 (L3) data for card programs by webhook. Enhanced transaction data provide you with detailed information, including important non-financial details about purchases, to help inform your program. For more information, see Level 2 and Level 3 card data events. Contact your Marqeta representative to learn more and get access.
Platform release 2023.4.17.0
Copy section link
The 2023.4.17.0 release of the Marqeta platform contains infrastructure improvements and back-end issue fixes only. There are no customer-facing enhancements or fixed issues in this release.
Platform release 2023.4.3.0
Copy section link
The 2023.4.3.0 release of the Marqeta platform contains infrastructure improvements and back-end issue fixes only. There are no customer-facing enhancements or fixed issues in this release.
Notable documentation changes
Copy section link
New endpoints added to Simulations 2.0 API (Beta)
Copy section link
Use the new endpoints to simulate the following transaction types:
-
account.funding.auth_plus_capture
-
account.funding.auth_plus_capture.reversal
-
authorization.atm.withdrawal
-
authorization.cashback
-
authorization.clearing.atm.withdrawal
-
authorization.clearing.quasi.cash
-
authorization.quasi.cash
-
original.credit.authorization
-
original.credit.authorization.clearing
-
original.credit.auth_plus_capture
-
original.credit.auth_plus_capture.reversal
-
pindebit.quasi.cash
Note that these endpoints are currently in beta and subject to change. For more information, see Simulations 2.0 (Beta) — Card Transactions.
March 2023
Copy section link
Platform release 2023.3.20.0
Copy section link
The 2023.3.20.0 release of the Marqeta platform contains infrastructure improvements and back-end issue fixes only. There are no customer-facing enhancements or fixed issues in this release.
Platform release 2023.3.7.0
Copy section link
New features
Copy section link
State code conversion for Visa transactions
Copy section link
For Visa transactions in the United States and Canada, the Marqeta platform now converts the two-digit ANSI state or provincial code received from the card network to an alpha-2 state or provincial code in the card_acceptor.state
field.
Changed functionality
Copy section link
Fixed: Inconsistent value for payment_channel field between authorization and clearing
Copy section link
An issue that caused inconsistent payment_channel
values between a transaction’s authorization and its clearing has been resolved in this release.
Fixed: Corrected gpa.impacted_amount field in Mastercard clearing transactions
Copy section link
An issue that caused the gpa.impacted_amount
field to show a different value than the settlement_data.amount
field has been resolved in this release.
The gpa.impacted_amount
field now includes both the billing amount and any applicable currency conversion fees.
You can now use the gpa.impacted_amount
field to update your cardholder’s ledger without performing any additional adjustments or calculations.
Fixed: Cards blocked when merchant entered incorrect expiration date
Copy section link
An issue that caused the Marqeta platform to reject transactions and block cards if merchants entered the card expiration date incorrectly has been resolved in this release.
Fixed: Incremental transactions not handled correctly
Copy section link
An issue that caused some incremental transactions to be treated as initial transactions has been resolved in this release.
Fixed: Incorrect impacted amount in some ATM partial reversals
Copy section link
In some partial reversal transactions completed at an automated teller machine (ATM), the impacted_amount
field incorrectly included the card network fee in cases where that fee should also have been reversed.
This issue has been resolved in this release.
Notable documentation changes
Copy section link
New pindebit event types added for journal entries
Copy section link
The Marqeta credit platform supports PIN-debit credit transactions, force-capture PIN-debit credit authorizations, and PIN-debit credit refunds.
For more information, see the related pindebit
, pindebit.authorization.clearing
, and pindebit.refund
event types in the Credit journal entry events reference and the About Credit Account Journal Entries guide.
New endpoints added to Simulations 2.0 API (Beta)
Copy section link
Use the new endpoints to simulate the following transaction types:
-
authorization.advice
-
authorization.incremental
-
pindebit
-
pindebit.authorization
-
pindebit.authorization.clearing
-
pindebit.authorization.reversal
-
pindebit.cashback
-
pindebit.refund
-
pindebit.atm.withdrawal
-
pindebit.balanceinquiry
-
refund
-
refund.authorization
-
refund.authorization.clearing
-
refund.authorization.reversal
Note that these endpoints are currently in beta and subject to change. For more information, see Simulations 2.0 (Beta) — Card Transactions.
February 2023
Copy section link
New features
Copy section link
Simulations 2.0 (Beta)
Copy section link
You can simulate various transaction event types in both the public and private sandbox environments. For more information about how to simulate these transaction events, see Simulations 2.0 (Beta) — Card Transactions.
New RiskControl Real-Time Decisioning reports
Copy section link
Two new RiskControl Real-Time Decisioning reports have been added to the Marqeta Dashboard:
-
The RiskControl Real-Time Decisioning—Authorizations report provides information on all the transaction authorizations processed by Real-Time Decisioning.
-
The RiskControl Real-Time Decisioning—Transaction Count by Rules report provides the count of transactions per triggered rule for a program.
Learn how to use these reports in the Marqeta Dashboard by reading Reports in the Dashboard. Additional details about these reports are provided in Reports In-depth.
To retrieve the transaction count by rules using the DiVA API GET /views/cptrxn/rule/detail
endpoint, see Real-Time Decisioning Transaction Count by Rules.
For details on using the DiVA API GET /views/cpauth/detail
endpoint to retrieve the authorizations data, see Real-Time Decisioning Authorizations.
New Delinquency endpoints added to Credit Account Servicing
Copy section link
The Delinquency feature is now available. Delinquency is a part of the Marqeta credit platform’s Credit Account Servicing offerings.
Use the new Delinquency endpoints to view details on a credit account’s delinquency state and delinquency state transitions. An account is considered delinquent if it is past due on its payments.
For the complete endpoint reference, see Delinquency.
Marqeta sends webhook notifications when an account’s delinquency state transitions between delinquent and current. For more, see Credit account delinquency transition events in Event Types.
New Interactive Voice Response (IVR) platform
Copy section link
Marqeta’s Interactive Voice Response (IVR) is a program-specific, white-label product used by your cardholders to interact with the Marqeta platform. With IVR, your cardholders use their landline or mobile telephone to perform basic functions such as activating a card, checking an account balance, reporting a card as lost/stolen, and speaking with a customer support representative. You can also use the IVR product to comply with Payment Card Industry Data Security Standard (PCI DSS) requirements for your program.
The IVR product has recently been migrated to a newer high-performance platform that shortens the time required to launch your program by up to 75%. Built on a modern, elastic stack, this new platform provides greater availability and heightened visibility, enabling Marqeta to monitor IVR health more proactively and react even faster in the event of an issue.
To learn more about IVR and activating it for your program, contact your Marqeta representative.
Platform release 2023.2.27.0
Copy section link
Marqeta platform releases now occur biweekly until further notice. The next release of the Marqeta platform will be on 7 March 2023.
Platform release 2023.2.20.0
Copy section link
Changed functionality
Copy section link
Multi-currency transaction settlement data included in Pulse card network transaction payloads
Copy section link
You can now view multi-currency transaction settlement data for Pulse card network transactions in Gateway JIT messages, transaction webhooks, and in the response to a call made to GET /transactions
.
See the currency_conversion.network.settlement_data
object documentation in the Transactions page for more information.
Gateway JIT Funding requests for international address verification system transactions
Copy section link
The Marqeta platform now sends Gateway JIT Funding requests for all international address verification system (AVS) transactions.
Fixed: Contactless ATM transactions excluded from strong customer authentication rules
Copy section link
An issue that caused transactions at contactless ATMs to be excluded from strong customer authentication (SCA) rules has been resolved in this release of the Marqeta platform.
Fixed: Race condition for cards activated upon issuance
Copy section link
An issue that caused a race condition for card programs configured to activate cards upon issuance has been resolved in this release.
Platform release 2023.2.13.0
Copy section link
Marqeta platform release 2023.2.13.0 was rolled back on 21 February 2023.
Platform release 2023.2.6.0
Copy section link
Changed functionality
Copy section link
Changed reporting expected afternoon refresh times
Copy section link
Expected refresh times for the afternoon data run have been changed to 3:45 AM UTC (start time) and 7:45 AM UTC (completion time). See Expected refresh and settlement timelines.
Fixed: Incorrect value for offline PIN transactions on Visa network
Copy section link
An ongoing issue that set the pin_present
field value to false
for all offline PIN transactions on the Visa network has been resolved in this release.
Fixed: Pre-authorization indicator not included in Pulse transactions
Copy section link
An issue that caused the pre-authorization indicator to be excluded from pindebit.authorization
transactions on the Pulse card network has been resolved in this release.
Notable documentation changes
Copy section link
Updated allowable values on Digital Wallets Management page
Copy section link
The allowable values for the encrypted_pass_data
and ephemeral_public_key
fields on the Digital Wallets Management page of the Core API collection have been corrected from 255 char max
to Any value
.
Corrected field description on Card Transitions page
Copy section link
The Card Transitions page of the Core API collection now correctly describes that setting the sync_state_with_dwts
field to true
synchronizes the state of the card’s associated tokens with the card’s new state.
Expanded credit section on Platform Overview page
Copy section link
The Credit Programs and Accounts section of Platform Overview has been expanded to include information about credit programs, credit account management, rewards and redemptions, and more.
Added explanation of time fields for journal entries
Copy section link
The About Credit Account Journal Entries page now has a section, Time fields, that explains how the meanings of the created_time
, request_time
, and impact_time
journal entry fields change for different transaction types and status
field values.
Added explanation of the difference between the status
and state
fields
Copy section link
The About Credit Account Journal Entries page now includes a section that describes the differences between the state
and status
fields, fields of journal entries.
January 2023
Copy section link
New features
Copy section link
Additional language support for PCI-compliant widgets
Copy section link
Marqeta’s customizable widgets enable your cardholders to securely interact with your customer applications in compliance with the Payment Card Industry Data Security Standard (PCI DSS). Beginning in January 2023, the widgets offer support for an additional language: Portuguese (Brazil), which complements the existing language set of English (US), Czech, French (Canada), French (France), German, Italian, Polish, Spanish, and Swedish.
Platform release 2023.1.30.0
Copy section link
The 2023.1.30.0 release of the Marqeta platform was rolled back on 2 February 2023.
Platform release 2023.1.23.0
Copy section link
The 2023.1.23.0 release of the Marqeta platform contains infrastructure improvements and back-end issue fixes only. There are no customer-facing enhancements or fixed issues in this release.
Platform release 2023.1.16.0
Copy section link
New features
Copy section link
Application Transaction Counter enabled for all programs
Copy section link
The Marqeta platform now returns the Application Transaction Counter (ATC) for Mastercard transactions that include this data element.
New decline reasons for Gateway Just-in-Time Funding transactions
Copy section link
This release adds two new values to the Gateway Just-in-Time (JIT) Funding object’s decline_reason
field: CARD_NOT_ACTIVE
and CARDHOLDER_NOT_ACTIVE
.
Changed functionality
Copy section link
Changes to 3D Secure authentication requests
Copy section link
This release of the Marqeta platform includes two new fields in the ThreeDSAuthenticationRequest
object: three_ds_requestor_url
and three_ds_requestor_app_url
.
These fields provide more information about merchants requesting 3D Secure authentication.
-
The
three_ds_requestor_url
field shows the fully qualified URL of the merchant’s website or customer care site. This data element provides additional information to help troubleshoot any problems that arise, along with the merchant’s contact information. -
The
three_ds_requestor_app_url
field shows the fully qualified URL of the merchant application that initiated the 3D Secure authentication request. For app e-commerce transactions, you can use thethree_ds_requestor_app_url
field to redirect your cardholders back to the merchant application after they have completed 3D Secure authentication in their mobile banking application. Redirecting cardholders in this way makes their payment experience smoother and more seamless, thereby reducing cardholder abandonment.
For more information about these new fields, see The ThreeDSAuthenticationRequest object.
Fixed: Incorrect value for offline PIN transactions
Copy section link
An issue that set the value of the pin_present
field to false
for all offline PIN transactions has been resolved in this release for both the Visa and Mastercard networks.
Fixed: Filtering GET /digitalwallettokens results
Copy section link
This release of the Marqeta platform fixes an issue that prevented filtering results from the GET /digitalwallettokens
endpoint by the token
field.
Fixed: Duplicate transactions from misidentified pre-authorizations
Copy section link
An issue that caused pre-authorization transactions to be incorrectly identified, thus creating duplicate transactions, has been resolved in this release.