2021 Release Notes
December 2021
Copy section link
New features
Copy section link
Managing webhooks in the Marqeta Dashboard
Copy section link
Webhooks enable public sandbox users to configure and manage notifications about API events.
You can now use the Marqeta Dashboard to create and modify webhook configurations for the sandbox environment associated with your account.
You can also use it to subscribe to any number of event listeners you need for your transactions workflow.
In previous releases, configuring webhooks required sending requests to the /webhooks
endpoint of the Core API.
For more information on configuring webhooks, see the Access developer tools section of the Dashboard Overview and Quick Start.
Approval queue added to Credit in the Marqeta Dashboard (beta)
Copy section link
The Approval queue in Credit Programs in the Marqeta Dashboard allows those with creator and approver roles to view a list of credit products that are in review or revision. For more on the Approval queue, see Approval queue in the Managing Credit Programs in the Marqeta Dashboard guide.
Changed functionality
Copy section link
Ability to edit active credit products in the Marqeta Dashboard (beta)
Copy section link
Those with the creator role for Credit Programs in the Marqeta Dashboard can now edit active credit products. Prior to this update, creators could only edit credit products in draft. For more on editing credit products, see the Editing a credit product tutorial in the Managing Credit Programs in the Marqeta Dashboard guide.
Notable documentation changes
Copy section link
Updated API reference documentation pages
Copy section link
Several API reference pages are now generated directly by parsing Marqeta’s API definition files in OpenAPI format. This single-source approach ensures that the documentation remains synchronized with the API at all times.
You may therefore notice slight differences in the information architecture of these new pages:
Note that the Orders page has been renamed to GPA Orders. In addition, the Transfers page has been divided into three shorter pages (Fee Transfers, Peer Transfers, and Program Transfers) to make it easier to find information related to a specific kind of transfer.
Credit docs out of beta
Copy section link
Marqeta’s Credit program is no longer in beta. To learn more about activating a Credit program with Marqeta, contact your Marqeta representative.
November 2021
Copy section link
New features
Copy section link
Cardholder authentication data for Mastercard e-commerce transactions
Copy section link
The transaction payload in webhooks, JIT Funding requests, and GET /transactions
operations includes cardholder authentication data for Mastercard e-commerce transactions beginning in Marqeta platform release 21.11.
For detailed information about the cardholder authentication data in transaction payloads, see the cardholder_authentication
object in Transactions.
Limited state for cards
Copy section link
Beginning in release 21.11, the Marqeta platform now supports a new LIMITED
state for cards.
In the LIMITED
state, a card is temporarily non-functional except for card-on-file transactions such as installment payments or recurring charges.
For more information about card states, see the The card lifecycle.
Changed functionality
Copy section link
New response code for declined card-not-present transactions
Copy section link
To comply with card network mandates, card-not-present transactions declined due to invalid card security codes receive the new response code 1915: Invalid CVV2
in transaction webhooks beginning in Marqeta platform release 21.11.
In previous releases, declined card-not-present transactions triggered response code 1825: Invalid CID. Card security code is invalid; CVV does not match.
Marqeta will continue to use code 1825
for declined card-present transactions.
For more information about transaction response codes including code 1915
, see transaction response codes.
Account funding transaction data now provided by default
Copy section link
Beginning in Marqeta platform release 21.11, account funding transaction data is available by default in webhooks, JIT Funding requests, and GET /transactions
operations.
For detailed information about account funding transaction data, see the account_funding
object in Transactions.
Fixed: Inaccurate CAVV data handling
Copy section link
Inaccurate data provided by acquirers resulted in declined transactions because Visa could not validate the cardholder authentication verification value (CAVV) correctly.
This issue is fixed in Marqeta platform release 21.11. Marqeta can now overwrite the CAVV validation result from Visa. Contact your Marqeta representative to enable this fix for your card program.
DiVA API changes and enhancements
Copy section link
DiVA API V2 Scaled is now released, providing a vast improvement to DiVA API infrastructure, which includes enhanced performance, security, and the ability for the product to scale over time. Below is a summary of key enhancements and changes.
For more on DiVA API and reporting, see Reporting and DiVA API Reference.
Performance and throughput
Copy section link
Performance and throughput are significantly improved for DiVA API and Reports users. Average response times in particular are nearly three times faster with the implementation of DiVA API V2 Scaled.
Security
Copy section link
A variety of infrastructural changes were implemented to enhance overall security and address outstanding vulnerabilities.
Concurrency
Copy section link
The legacy version of DiVA API V2 had a maximum concurrency of 12 users or queries at a single time. DiVA API V2 Scaled supports up to 1,000 concurrent requests, allowing the service to scale gracefully over time.
Improved sort capability
Copy section link
Ascending or descending sorts can now be performed on individual fields.
By default, fields sort in ascending order.
Placing a minus sign (-
) in front of a field changes its sort order
to descending.
For example, sort_by=-transaction_date,account_id
is interpreted as ORDER BY transaction_date DESC, account_id ASC
.
Changing the parameters to sort_by=-transaction_date,-account_id
would sort both fields in descending order, interpreted as ORDER BY transaction_date DSC, account_id DESC
.
Previously, any -
in the sort_by
string caused the final field to be sorted in descending order and all other fields in ascending order.
New timeout handling
Copy section link
How responses are reported when a timeout occurs has changed.
{ "message": "Endpoint request timed out" }
is now returned with HTTP 504
.
The timeout duration has been reduced from 60 seconds to 30 seconds.
Use asynchronous or download requests for long running queries, such as applying async=true
to your call.
Changes to fields
Copy section link
The fields acting_uai
, parent_uai
, and user_uai
are now handled more consistently.
For example, the string 000000000
is now returned as 0
in the JSON response.
This addresses a bug that potentially caused the last several digits of these fields to be modified in large requests.
Minor changes to endpoints and reports
Copy section link
Endpoint/report | Change |
---|---|
|
Added the The The default filter order has changed. |
|
The default filter order has changed. |
|
This report has been removed. |
|
Integer fields in this report now return an integer result.
For example, |
|
The fields |
|
The fields For |
|
The |
|
The fields |
|
These reports are now classified as aggregate reports. Aggregation and group by are used when querying this endpoint. |
|
The default order of this report has changed. |
|
The fields |
|
The |
Metadata changes
Copy section link
The calculation of start_date
and end_date
response fields returned with query results have changed.
For more about DiVA metadata and query results, see Response field details.
The start_date
field is now calculated using the returned records instead of the filter used to retrieve them.
This represents the minimum value of the datetime field used to filter the list of returned records.
If multiple datetime filters are used, both are applied but start_time
is calculated using only the first filter.
Previously, this was echoing the provided filter’s start date.
The end_date
field is now calculated using the returned records instead of the filter used to retrieve them.
This represents the minimum value of the datetime field used to filter the list of returned records.
If multiple datetime filters are used, both are applied but end_time
is calculated using only the first filter.
Previously, this was echoing the provided filter’s end date.
Notable documentation changes
Copy section link
New guide for credit account ledger entries (beta)
Copy section link
Learn about credit account ledger entries on the Marqeta platform in About Credit Account Ledger Entries.
Ability to retrieve credit product lineage (beta)
Copy section link
You can now retrieve the lineage of a credit product using the /credit/products/{token}/lineage
endpoint.
To learn more, see Retrieve credit product lineage.
Updated API reference documentation pages
Copy section link
Several API reference pages are now generated directly by parsing Marqeta’s API definition files in OpenAPI format. This single-source approach ensures that the documentation remains synchronized with the API at all times.
You may therefore notice slight differences in the information architecture of these new pages:
October 2021
Copy section link
Changed functionality
Copy section link
New transaction response code for invalid CVV2/CVC2 codes
Copy section link
CVV2 and CVC2 codes are three-digit validators for cards issued by Visa and Mastercard, respectively. These validators are used during card-not-present transactions to reduce fraud.
Beginning with Marqeta platform release 21.10, Marqeta sends a new transaction response code: 1915: Invalid CVV2
for transactions where the CVV2 or CVC2 code is invalid.
For more information about transaction response codes, see transaction response codes.
Support for deferred original credit transaction processing for Visa transactions
Copy section link
Beginning in Marqeta platform release 21.10, the original_credit
object includes the deferred_hold_by
field when original credit transactions are deferred by either the acquirer or Visa.
This field is included to support changes Visa has made to deferred original credit transaction (OCT) processing.
You can see the deferred_hold_by
field in the original_credit
object of JIT Gateway messages and webhooks, as well as in the response body of calls made to the GET /transactions
endpoint.
For detailed information about this new field, see the original_credit
object in Transactions.
Support for authentication outage indicators for Visa transactions
Copy section link
Visa now requires issuers in Europe to support the Acceptance Environment Authentication Outage indicator field and values. The Acceptance Environment Authentication Outage indicator is used to show that authentication was attempted for a transaction but there was an outage in the authentication flow between the merchant, gateway 3D Secure server, and the Visa Directory Server. In such cases, authentication requests fail.
To support Visa’s Acceptance Environment Authentication Outage indicator, the Marqeta platform includes new enumerated value not_verified_authentication_outage
in the cardholder_authentication_data.verification_result
field beginning in Marqeta platform release 21.10.
For detailed information about this new enumerated value, see the cardholder_authentication_data
object in Transactions.
Support for refunds using Mastercard MoneySend Payments
Copy section link
Mastercard now lets merchants use MoneySend Payments to issue faster refunds. Participating merchants can inform cardholders that funds will be available in near real time on either the card that was used for the original purchase transaction or on a different card.
Beginning in Marqeta platform release 21.10, the Marqeta platform includes two new enumerated values for the original_credit.transaction_purpose
field to indicate a MoneySend Payments refund: refund_to_original_card
and refund_to_new_card
.
For detailed information about these new enumerated values, see the original_credit
object in Transactions.
Support for deferred authorizations for Mastercard transactions
Copy section link
Point-of-sale (POS) terminals support offline processing for transactions made, for example, while aboard an airplane or during a service maintenance window, as well as for transactions impacted by technological interruptions such as inclement weather. Mastercard now indicates such deferred authorizations to inform issuers when authorization requests are sent on a deferred basis to explain any discrepancy between the time that the transaction occurred and the time that the authorization request was received.
To support Mastercard’s deferred authorization indicators, the Marqeta platform includes the is_deferred_authorization
field in the transaction_metadata
object in webhooks and in the response body of calls made to the GET /transactions
endpoint, beginning in Marqeta platform release 21.10.
For detailed information about the is_deferred_authorization
field, see the transaction_metadata
object in Transactions.
Support for Mastercard 3D Secure 2.2.0
Copy section link
Marqeta 3D Secure (3DS) is now certified to process Mastercard 3DS 2.2.0 requests from merchants. The new message protocol offers all the benefits of 2.1.0, plus more flexibility and control over strong customer authentication (SCA) exemptions and the authentication experience. To participate in Mastercard 3DS 2.2.0, you must enroll your bank identification number (BIN) ranges for 2.2.0 with Mastercard and enable 3DS 2.2.0 on the Marqeta Dashboard.
For more information about Mastercard 3DS 2.2.0 processing, contact your Marqeta representative.
Enhancements to the API Keys page in the Marqeta Dashboard
Copy section link
The API Keys page of the Marqeta Dashboard has been redesigned to reflect takeaways collected from recent usability research. Knowing what is available within the public sandbox and what to do with your API keys once you have them is a common stumbling block for new developers. Among the improvements made to the page are descriptions of what assets are provisioned in the public sandbox environment (such as a default card product) and a new sample request formatted within a code block that supports multiple programming languages.
Notable documentation changes
Copy section link
Updated API reference documentation for Authorization Controls
Copy section link
The Authorization Controls API reference page is now generated directly from the feature’s OpenAPI specification, ensuring that the documentation remains synchronized with the API at all times. You may notice some slight differences in the information architecture of the new page.
September 2021
Copy section link
New features
Copy section link
Introducing the summary of credit resources (beta)
Copy section link
Learn about the interactions and dependencies of Marqeta’s credit-related Core API resources. See Summary of Credit Resources.
Changed functionality
Copy section link
New account funding data for Mastercard transactions
Copy section link
Beginning in Marqeta platform release 21.9, the transaction payload in webhooks, JIT Funding requests, and GET /transactions
operations can now include an account_funding
object to capture details about account funding transactions on the Mastercard network.
If you want to receive these enhanced account funding transaction details, contact your Marqeta representative.
For detailed information about the account_funding
object, see Transactions.
Additional merchant details in transaction payloads
Copy section link
Beginning in Marqeta platform release 21.9, the transaction payload in webhooks, JIT Funding requests, and GET /transactions
operations now includes the following additional merchant details in the card_acceptor
object:
-
The
payment_facilitator_id
field captures the identifier of the payment facilitator involved in the transaction, if present. -
The
independent_sales_organization_id
field captures the identifier of the independent sales organization involved in the transaction, if present. -
The
sub_merchant_id
field captures the identifier of the sub-merchant involved in the transaction, if present.
For detailed information about these new fields, see the card_acceptor
object Transactions.
Merchant groups now accept alphanumeric merchant identifiers
Copy section link
Beginning in Marqeta platform release 21.9, you can use alphanumeric merchant identifiers (MIDs) on the /merchantgroups
endpoint, rather than strictly numeric MIDs.
For detailed information about /merchantgroups
MIDs, see Merchant Groups.
Improved handling of automated teller machine fees for declined transactions
Copy section link
Beginning in Marqeta platform release 21.9, when an automated teller machine (ATM) transaction is declined but an ATM fee is incurred, Marqeta sends these fees to you in webhooks and Gateway JIT Funding messages. ATM fees for declined transactions are typical in regions outside the United States of America.
Support for new ACH return codes
Copy section link
ACH transactions can be returned for a variety of reasons, and support for several new ACH return codes has been added to the Marqeta platform beginning in Marqeta platform release 21.9.
To view all supported codes, see the reason_code
field in the Direct Deposits API reference page.
Improved sandbox creation process
Copy section link
The Marqeta platform provides a private testing and development environment called the sandbox where you can explore the capabilities of the Core API. The sandbox creation process has recently been rearchitectured for increased speed and reliability. To create your own public sandbox and user, sign up for an account on the Marqeta platform.
Deprecated features
Copy section link
Allow cardholders to set PIN during first card transaction
Copy section link
Beginning in Marqeta platform release 21.9, the ability to allow cardholders to set a personal identification number (PIN) during the first transaction with their new card (the allow_first_pin_set_via_financial_transaction
field in the config.transaction_controls
object) has been deprecated, and will be removed in a future release.
For more information, see the config.transaction_controls object.
Notable documentation changes
Copy section link
New guide for credit account payments (beta)
Copy section link
See how to manage credit account payments using the Marqeta platform, in About Credit Account Payments.
Updates to the transaction response model
Copy section link
Learn about the newly added account_funding
object for Mastercard transactions, as well as three additional fields for the card_acceptor
object (payment_facilitator_id
, independent_sales_organization_id
, and sub_merchant_id
).
See Transactions.
How to Use Marqeta Webhooks
Copy section link
Over in the Marqeta Knowledge Base there’s a new write-up about using webhooks on our platform, including a detailed walkthrough. See How to use Marqeta Webhooks.
Added transition for users
Copy section link
You can now transition users from Active to Unverified. See Create user transition and The account holder lifecycle.
August 2021
Copy section link
New features
Copy section link
Introducing the Marqeta Developer Community
Copy section link
The Marqeta Developer Community is a place where developers can engage directly with us (and each other) to share best practices, tips, and solutions. This new channel includes a forum, knowledge base, engineering blogs, and much more. We expect this community will grow into a vibrant hub where developers can make meaningful connections, share ideas, and learn from the experiences of others building on top of the Marqeta platform.
Improved error handling for early direct deposit transitions
Copy section link
If your program registers to use the Early Pay feature, you can manually transition direct deposit transactions to APPLIED
before the settlement date and make your cardholder’s funds available up to two days faster.
To do this, send a POST
request to /directdeposits/transitions
.
A new error code (400280
) is returned if a program that has not registered to use the Early Pay feature attempts to transition a direct deposit to APPLIED
before the settlement date.
This same error code is returned when attempting to transition an ineligible transaction such as a debit.
If you see this error, simply wait until the settlement date to proceed with the transition.
To access the settlement date for a transaction, send a GET
request to /directdeposits/{token}
.
Changed functionality
Copy section link
Enhanced stand-in processing decline codes for Visa
Copy section link
Visa has implemented changes to modify response codes used during stand-in processing to provide descriptive values that identify the primary reason for the transaction decline.
Beginning in Marqeta platform release 21.8, Marqeta has made an enhancement to ensure it is able to receive new values in authorization response and advice messages and support Visa’s use case.
Enhanced 3D Secure Advanced Authentication flow
Copy section link
The 3D Secure (3DS) Advanced Authentication flow has been enhanced to allow the authentication screen to be automatically submitted when a cardholder completes authentication in a mobile banking app.
This enhancement eliminates a step that required the cardholder to go back to the authentication screen and click the Done
button.
It is intended to reduce cardholder transaction abandonment.
Better parsing of 3D Secure CAVV data
Copy section link
Some acquirers do not parse lowercase characters in 3DS cardholder authentication verification value (CAVV) data, replacing those characters with zeroes. This causes a mismatch of CAVV data which in turn leads to transactions being declined by VISA. Beginning in Marqeta platform release 21.8, the Marqeta platform changes all lowercase characters in CAVV data to uppercase before sending it to the network to avoid mismatches and allow transactions to be approved as expected.
Fixed: Incorrect values for zero-exponent currencies
Copy section link
In previous versions, the Marqeta platform added two extra zeroes to zero-exponent currency values in the original_amount
field of clearing webhooks, which caused a mismatch between the authorization and the clearing amounts.
Beginning in Marqeta platform release 21.8, Marqeta now uses the correct format in this field so clearing and authorization amounts for zero-exponent currencies match correctly.
Fixed: Transactions declined in Stand-in Processing miscategorized
Copy section link
In previous versions, the Marqeta platform marked refund authorizations declined by stand-in processing (STIP) as authorizations rather than refund authorizations, resulting in incorrect transaction data. Beginning in Marqeta platform release 21.8, these declined refund authorizations now show the correct transaction type.
Notable documentation changes
Copy section link
Updated list of transaction response codes
Copy section link
The full list of transaction response codes has been validated and updated.
New guide for credit account statements (beta)
Copy section link
New guide for Credit in the Dashboard (beta)
Copy section link
New Credit events (beta) added to Event Types documentation
Copy section link
The following events are added:
July 2021
Copy section link
New features
Copy section link
Program Funding via ACH (Beta)
Copy section link
You can use the /banktransfers
endpoint to initiate funds movement between your program funding account and an external account over the ACH Network.
For more information about this kind of bank transfer, also known as ACH origination, see Program Funding via ACH (Beta).
Changed functionality
Copy section link
Phone field now optional for business objects
Copy section link
Beginning in Marqeta platform release 21.7, the phone
field is now an optional field for /businesses
objects, rather than a required field.
New stand-in processing advice codes for Mastercard transactions
Copy section link
Beginning in Marqeta platform release 21.7, Mastercard transaction response data in GET /transactions
, webhooks, and Gateway JIT Funding messages now includes stand-in processing (STIP) advice codes and descriptions when they are provided by the card network.
See the advice_reason_code
and advice_reason_details
field documentation in Transactions.
Notable documentation changes
Copy section link
New credit account disputes guide
Copy section link
Learn how the credit account dispute process works, including provisional credits in About Credit Account Disputes (Beta).
New endpoint for creating a credit balance refund
Copy section link
See the new /createBalanceRefund
endpoint in the Credit Accounts API reference.
New ACH origination guide
Copy section link
Learn about Marqeta’s implementation of Automated Clearing House (ACH) origination and what happens when an originator enters an ACH transaction into the ACH payments system on behalf of the receiver in ACH Origination.
New API reference on program funding via ACH
Copy section link
See how to use a transfer to move funds entirely within the Marqeta platform in Program Funding via ACH (Beta).
New API reference for merchant groups
Copy section link
See how to use merchant groups for authorization controls and in card product configurations in Merchant Groups.
Additions and updates to Disputes documentation
Copy section link
Several additions and updates have been made to the Mastercard and Visa Disputes documentation, including:
-
Updated naming conventions to clarify the difference between the Dispute Case lifecycle and the Network Dispute lifecycle.
-
Added the
OPEN_WITH_ACTION_REQUIRED
state and clarified some state descriptions. -
Added and updated several response details and samples.
-
Updated the Dispute Network Transitions information for Mastercard Disputes.
-
Added new
document_category
details. -
Added new endpoints to get content and status, update a document, and delete a document.
See the following:
New report details
Copy section link
Added a new page with detailed report information. See Reports In-depth.
Updated DiVA endpoint schemas
Copy section link
Updated schema descriptions to include the Core API Transaction Token for the following DiVA API endpoints.
Guide to building a card program moved and renamed
Copy section link
The Card Program Requirements guide is updated and consolidated in Building Your Card Program.
June 2021
Copy section link
New features
Copy section link
New merchant group API
Copy section link
Beginning in Marqeta platform release 21.6, you can use the /merchantgroups
endpoint to create groups of merchants by their merchant identifier.
With merchant groups, you can, for example, exempt groups of merchants from certain transaction types, such as quasi-cash transactions.
To learn more, see the Merchant Groups Core API reference page.
Changed functionality
Copy section link
Additional decline reasons for Gateway Just-in-Time Funding transactions
Copy section link
Beginning in Marqeta platform release 21.6, Gateway JIT messages include additional decline reasons.
Merchants can use these additional decline reasons to better help cardholders take the appropriate action to complete a transaction.
See the decline_reason
field documentation on the Gateway JIT Funding Messages page.
Pre-authorization transaction indicator
Copy section link
Beginning in Marqeta platform release 21.6, transaction payloads include the is_preauthorization
field to indicate if a transaction is a pre-authorization.
See the is_preauthorization
field documentation in Transactions for more information.
3D Secure acquirer exemptions for Mastercard transactions
Copy section link
Beginning in Marqeta platform release 21.6, 3D Secure acquirer exemptions are available for Mastercard transactions in the transaction payload.
See the cardholder_authentication_data.acquirer_exemption
field documentation in Transactions for more information.
Notable documentation changes
Copy section link
Developer webinar: Getting started with Marqeta APIs
Copy section link
Have you been thinking about trying out Marqeta’s open API platform to create a customized card program, but don’t know where to begin? Our latest webinar, Getting started with Marqeta APIs, walks you through spinning up a card program prototype then testing it using simulated transactions in a public sandbox environment. You’ll also see a demo of updates to our dev tools like the Transaction Timeline. After 60 minutes, you will know how to get started with Marqeta and begin building your own card experiences with our open APIs.
Ability to create payments in the Credit Accounts API (beta)
Copy section link
We added an API reference page for the POST /credit/accounts/{token}/payments
endpoint to the Credit Accounts API.
New glossary of payment cards concepts
Copy section link
See overviews of the concepts used in payment card programs on the Payment Cards Concepts page. Some of this content was previously found on the Money Movement Overview page.
3D Secure Tech Brief offers a deep dive on this fraud prevention technology
Copy section link
Does your program support 3D Secure? In this Tech Brief, read all about how Marqeta’s 3D Secure solution helps card programs fight online fraud without compromising the user experience.
May 2021
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 Marqeta platform release 21.5, the widgets offer support for five additional languages: French (France), Spanish, Italian, Swedish, and German, which complement the existing language set of English (US), Polish, French (Canada), and Czech. More descriptive error messages have also been added to all supported languages.
New Credit reference and reporting docs
Copy section link
See the newly published API reference doc for Payment Sources and new endpoints published in the API reference doc for Credit Accounts, both products currently in beta: Credit Overview. See the Credit Reporting API reference docs and the Credit Reports in the Marqeta Dashboard guide, also currently in beta: DiVA API Credit Reference and Marqeta Dashboard Report Types.
Support for Mastercard SecureCode Accountholder Authentication Value (AAV) Verification Service results
Copy section link
Beginning in Marqeta platform release 21.5, you can view Mastercard SecureCode AAV verification results for e-commerce transactions in Gateway JIT messages, transaction webhooks, and in GET /transactions
.
You must have a Mastercard BIN configured with On-behalf Service (OBS) 05 or 06 to receive the relevant result codes.
See the cardholder_authentication_data.verification_result
field documentation for more information: Transactions.
Multi-currency transaction settlement data included in clearing payloads
Copy section link
Beginning in Marqeta platform release 21.5, you can view multi-currency transaction settlement data for clearing transactions in Gateway JIT messages, transaction webhooks, and in GET /transactions
.
See the currency_conversion.network.settlement_data
object documentation for more information: Transactions.
Changed functionality
Copy section link
Transaction Timeline tool enhancements
Copy section link
The Transaction Timeline tool enables users of the Marqeta public sandbox to better understand the role of transactions in their integration and the broader payments space. This release of the Transaction Timeline tool applies to all public sandbox accounts with the Developer role and provides the following enhancements:
-
Existing active cards are now conveniently listed in a drop-down list, eliminating the need to manually copy/paste the card information.
-
The tool automatically builds the timeline, using the selected card from the drop-down list.
-
New transactions are added to the timeline as they occur in the public sandbox. No need to refresh the page.
More accurate response codes sent to Visa
Copy section link
Beginning in Marqeta platform release 21.5, Marqeta sends more accurate response codes to Visa for transactions declined due to invalid cards, inactive digital wallet tokens, and inactive cardholders. Your cardholders may see more specific decline messages at points of sale due to this change.
Ability to overwrite Cardholder Authentication Verification Value (CAVV)
Copy section link
Beginning in Marqeta platform release 21.5, you can overwrite the Cardholder Authentication Verification Value received from Visa.
This change allows you to make your own cardholder verification decisions if you do not want to rely solely on the verification results from Visa.
See the cardholder_authentication_data.verification_result
field documentation for more information: Transactions.
New transaction response code for unactivated cards
Copy section link
Beginning in Marqeta platform release 21.5, Marqeta uses the new transaction response code 1901: Card not activated
to indicate declined transactions due to unactivated cards.
Terminated cards continue to return transaction response code 1806: Card not active
for declined transactions.
For more information, see transaction response codes.
Increased capacity for quasi-cash transaction merchant exception list
Copy section link
Beginning in Marqeta platform release 21.5, the capacity of the list of exempted merchant identifiers for quasi-cash transactions has been increased from 15 to 100. For more information about configuring quasi-cash exempt merchant identifiers, see The config.transaction_controls object.
Fixed: All transactions over the low-value payment limit declined
Copy section link
An issue that caused all merchant-initiated transactions for amounts over the strong customer authentication low-value payment limit to be declined has been resolved in Marqeta platform release 21.5.
Notable documentation changes
Copy section link
Updates to Push-to-Card documentation
Copy section link
The Push-to-Card Payments API reference documentation has been updated with new field names and descriptions.
Updates to the Transaction response model documentation
Copy section link
Transactions is updated with new fields and descriptions.
New and updated reference docs for Credit (beta)
Copy section link
We newly published a reference doc for the Payment Sources endpoint, which lets you manage an external payment source for a credit account holder: Payments Sources. The Credit Accounts reference adds ten new endpoints, and the Credit Products is also updated.
April 2021
Copy section link
New features
Copy section link
Digital wallet token card art enhancements
Copy section link
Beginning in Marqeta platform release 21.4, digital wallet token card art is configured at the card product level. This feature is useful for consumer card programs that include multiple versions of card art. It also enables Marqeta to update the card art and other metadata for the tokenized card whenever that card is reissued, rather than only when the token is first issued.
Settlement data for multi-currency transactions
Copy section link
Beginning in Marqeta platform release 21.4, authorization transactions include settlement data for multi-currency transactions if that data is provided by the card network.
Settlement data is included in the currency_conversion.network.settlement_data
object.
See Transactions.
Support for Visa Article 2.7
Copy section link
To support Visa Article 2.7 — Changes to Credit Voucher and Merchandise Return Authorization Processing, Marqeta only allows response codes that are applicable to these transaction types, beginning in Marqeta platform release 21.4. No action is required from you to accommodate this change.
Field to support future enhanced commercial card data
Copy section link
Beginning in Marqeta platform release 21.4, clearing webhooks include the enhanced_data_token
field.
Values in this field will be used to associate clearing transactions with enhanced commercial card data (level 2 and level 3 data) in a future Marqeta release.
Changed functionality
Copy section link
State fields in business objects accept spaces
Copy section link
Beginning in Marqeta platform release 21.4, the state
fields in businesses
objects now accept spaces.
For example, New York
rather than NewYork
.
Improved stand-in processing data from partial-approval capable terminals
Copy section link
Beginning in Marqeta platform release 21.4, Mastercard transactions performed at partial-approval capable point-of-sale terminals now include standin_by
and standin_approved
fields in webhook payloads and GET /transactions
responses.
Fixed: International ATM access fees not included in transaction payloads
Copy section link
An issue that caused international ATM access fees to be excluded from transaction payloads has been resolved in Marqeta platform release 21.4.
Fixed: Incorrect formatting of zero exponent currencies
Copy section link
An issue that caused zero-exponent currencies, such as Japanese Yen ( ¥ ), to be formatted incorrectly has been resolved in Marqeta platform release 21.4.
Notable documentation changes
Copy section link
New landing pages for APIs
Copy section link
We added overviews of the docs that help you use Marqeta services. Example: Cards.
New Credit guides and reference docs (beta)
Copy section link
See newly published API reference docs and guides for Credit Products and Credit Accounts, both products currently in beta: Credit Overview.
Updates to KYC documentation
Copy section link
There is new guidance for KYC verification failures and clarification of fictitious business names/DBAs: KYC Verification.
Added associated transactions to the Visa Cases guide and reference docs
Copy section link
March 2021
Copy section link
New features
Copy section link
Support of the Copy to Clipboard functionality restored
Copy section link
The v1.1.0 release of the Marqeta.js library restores support for the Copy to Clipboard feature. Using this feature, you can build seamless, modern user experiences that enable your cardholders to copy sensitive card information to their device’s clipboard in a single click while still maintaining PCI compliance.
Although the previous version of Marqeta.js is still currently available, it is recommended to upgrade to v1.1.0 in order to continue supporting all major browsers. For details on both versions of the library, see Using Marqeta.js.
Extended stand-in processing codes captured for Visa transactions
Copy section link
Beginning in Marqeta platform release 21.3, Marqeta captures extended stand-in processing codes for Visa transactions. This change went into effect on April 18, 2021.
Support for Mastercard MoneySend business-to-business transfers
Copy section link
Beginning in Marqeta platform release 21.3, Marqeta supports business-to-business transfers over Mastercard MoneySend.
Transaction purpose field for Mastercard MoneySend transactions
Copy section link
Beginning in Marqeta platform release 21.3, Marqeta includes the transaction_purpose
field for single- and dual-message Mastercard MoneySend transactions.
This field contains information about the purpose of the transaction if such information is captured by the merchant and sent to the card network.
Changed functionality
Copy section link
Improved validation of OpenAPI specification
Copy section link
Marqeta has improved how the output of the /v3/swagger.json
endpoint is validated, enabling you to generate SDKs for your integration.
By programmatically validating for structural errors such as duplicate operationId
values, we can confidently release an OpenAPI specification to production that won’t break your codebase.
Note that this enhanced validation does not include checking for semantic errors.
Improved PII handling for digital wallet tokens
Copy section link
Beginning in Marqeta platform release 21.3, Marqeta removes personally identifiable information (PII) from digital wallet token transaction messages to better comply with the terms of service for both Apple and Google.
This change is currently opt-in only, and will be gradually rolled out to all Marqeta customers over time. For more information about this change, contact your Marqeta representative.
Fixed: Maestro STIP transactions processed as financial advice messages
Copy section link
An issue that caused STIP transactions on the Maestro card network to be processed as financial advice messages is resolved in Marqeta platform release 21.3. Marqeta processes Maestro STIP transactions as standard single message authorizations with additional STIP details.
Fixed: Incorrect AVS responses for cards issued in the UK
Copy section link
An issue that caused incorrect AVS responses for cards issued in the United Kingdom has been resolved in Marqeta platform release 21.3.
Notable documentation changes
Copy section link
Marqeta Documentation has a new home
Copy section link
Marqeta’s developer documentation now has a central landing page called Home that provides an overview of all available content and directs you to pertinent resources in fewer clicks. The homepage makes it even easier to find the relevant Developer-facing content you are looking for, such as Guides, API Reference pages, SDKs, and the API status.
Complete Transaction response model documentation
Copy section link
Newly published! The entire Marqeta Transaction response model, for the first time, here: Transactions.
New About Customer Due Diligence guide
Copy section link
New Using the Marqeta.js v1.1.0 Library guide
Copy section link
New Configuring Low-value E-commerce Payment Limits guide
Copy section link
Revisions to Case states and Network Dispute states
Copy section link
Includes a more detailed process with a new dispute lifecycle diagram. See The Dispute Lifecycle.
New guide for Disputes in the Dashboard
Copy section link
See Disputes.
February 2021
Copy section link
New features
Copy section link
Support for Directive (EU) 2015/2366 (revised Payment Services Directive, or PSD 2) regulatory technical standards article 16 on Mastercard
Copy section link
Beginning in Marqeta platform release 21.2, you can configure low-value payments (LVP) e-commerce limits for strong customer authentication (SCA) at the card product level. These configuration options support compliance with the PSD 2 regulatory technical standards article 16 for your card issuance region.
Upon reaching the limits you have configured, the Marqeta platform requires cardholders to authenticate themselves before attempting additional transactions.
For more information, contact your Marqeta account representative and see the strong customer authentication limits documentation.
3D Secure advanced authentication screen displays remaining time
Copy section link
Beginning in Marqeta platform release 21.2, the 3D Secure advanced authentication screen displays the time remaining for a cardholder to authenticate, helping cardholders respond in a timely manner and reducing the transaction abandonment rate.
Quasi-cash transaction authorization control exceptions by merchant identifier
Copy section link
Beginning in Marqeta platform release 21.2, you can exempt specific merchants from the quasi-cash transaction authorization control by configuring exemptions at the card product level.
For more information, contact your Marqeta account representative and see the transaction controls documentation.
Changed functionality
Copy section link
Fixed: Incorrect values in webhook payment_channel fields
Copy section link
An issue that caused the payment_channel
to contain a different value in authorization and clearing webhooks for a given transaction has been resolved in Marqeta platform release 21.2.
Fixed: Authorizations incorrectly processed as incremental
Copy section link
An issue that caused some authorizations to be processed as incremental has been resolved in Marqeta platform release 21.2.
Fixed: Mail order/telephone order (MOTO) transactions captured incorrectly
Copy section link
An issue that caused some mail order/telephone order transactions to be captured incorrectly during clearing transactions has been resolved in Marqeta platform release 21.2.
Fixed: Incorrect currency codes for ATM balance inquiries
Copy section link
An issue that caused incorrect currency codes to be returned when customers performed ATM balance inquiries has been resolved in Marqeta platform release 21.2. This issue was experienced by cardholders whose accounts held balances in multiple currencies.
January 2021
Copy section link
New features
Copy section link
New support for European Union Payment Services Directive (PSD2) mandates
Copy section link
Beginning in release 21.1, the Marqeta platform provides the following new features to support PSD2 compliance:
-
Marqeta captures low-value payment exemption counters and cumulative spending at the card level.
-
You can configure low-value payment exemption limits at the card product level.
Capture and storage of acquirer exemption reasons
Copy section link
Beginning in release 21.1, the Marqeta platform captures and stores acquirer exemption reasons for Mastercard e-commerce transactions to support future reporting.
Acquirer reference number included in clearing webhooks
Copy section link
Beginning in Marqeta platform release 21.1, the Marqeta platform includes the acquirer reference number in clearing webhooks for Visa and Mastercard transactions.
The acquirer reference number is a 23-digit string that appears in the acquirer_reference_data
field in the webhook payload.
Changed functionality
Copy section link
Improved HTTP client performance
Copy section link
Beginning in Marqeta platform release 21.1, the Marqeta platform uses an updated HTTP client for better performance. The new HTTP client helps alleviate some HSM timeout issues.
Fixed: Cards on file no longer require CVV2/CVC2 data
Copy section link
Beginning in Marqeta platform release 21.1, transactions originated using cards on file are no longer declined by Marqeta for missing CVV2/CVC2 data.
Fixed: Mismatched authorization and clearing payloads
Copy section link
Marqeta platform release 21.1 resolves an issue that caused mismatches between the values of the payment_channel
field in the authorization payload and the clearing payload for a given transaction.
Fixed: Authorizations incorrectly processed as incremental
Copy section link
Marqeta platform release 21.1 resolves an issue that caused some authorizations to be incorrectly processed as incremental.
Fixed: Mail order/telephone order (MOTO) transactions captured incorrectly
Copy section link
Marqeta platform release 21.1 resolves an issue that caused some mail order/telephone order indicators to be captured incorrectly in clearing transactions.
Fixed: Child cardholder account refunds processed incorrectly
Copy section link
Marqeta platform release 21.1 resolves an issue that caused refunds for child cardholders not to be applied to the parent cardholder when the uses_parent_account
flag was true
and child cardholder was in an inactive state.