Submit a post-tokenization authentication decision

POST//

Use this endpoint to submit a post-tokenization authentication decision from the customer to Marqeta in a secure card on file scenario. Marqeta validates the request, stores it, and forwards the authentication decision to Mastercard Digital Enablement Service (MDES) in real time. Marqeta then returns the MDES response back to the customer synchronously. This enables issuers to notify MDES of the cardholder’s authentication outcome following tokenization, ensuring that the token requestor receives timely and accurate decisioning.

Request body

Fields	Description
tokenUniqueReference string Required	Unique identifier of the token allocated to the card. Allowable Values: 1–64 chars
authRequestCorrelationId string Optional	Correlates multiple authentication requests. Allowable Values: 1–64 chars
authenticationMethod string Required	Authentication method used to verify the cardholder. Allowable Values: `Issuer Application`, `Web Portal`
decision string Required	Issuer decision after cardholder authentication. Allowable Values: `SUCCESS`, `FAILED`
commentText string Optional	Optional comment related to the decision. Allowable Values: 500 char max

Response body

Fields	Description
status string Returned	Indicates if the operation was successful. Allowable Values: `SUCCESS`, `FAILED`
message string Returned	Human-readable description of the outcome. Allowable Values: 255 char max

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience

Submit a post-tokenization authentication decision

Request body

Response body

​Request body

​Response body

Request body

Response body