On This Page
REST API
Recent Revisions to This Document
24.06
- Added Use Cases for Transactions Using Tokens
- Added a section on use cases for transactions that use TMS tokens, Flex Micro Form tokens, and for tokenized cards. For more information, see Token Use Cases.
- Added Use Cases for 3RI Transactions
- Added a section on use cases for all types of 3RI transactions. For more information, see Merchant Initiated Transactions.
- Added Non-Payment Authentication Use Case
- Updated the use cases to include Non-Payment Authentication (NPA). For more information, see Use Case: Non-Payment Authentication.
- Updated Content in the Testing Section about the ECI Raw Value
- Updated the wording describing the ECI raw values for test cases 2.6, 2.7, 2.8, and 2.9 to note to point out that unlike the other test scenarios in this section, those tests do not return an ECI raw value. See Test Case 2.6: Authentication Not Available on Lookup.
- Updated Use Case Example Payloads
- Updated the payload code samples to eliminate the use of the fieldclientReferenceInformation.codefield in the use cases since this is not a required field and does not need to be in the example code.
- Updated Test Card Data
- Updated card type values for mada and JCB J/Secure cards and verified and updated some test card numbers used in test cases. See Test Cases for 3-D Secure 2.x
24.05
- Updated List of Browser Fields
- The browser value fields listed for the check enrollment service were updated. See Step 3: Payer Authentication Check Enrollment Service.
- Updated
- Added new API field,consumerAuthenticationInformation.authenticationBrandthat is used with mada transactions to indicate which directory server was used during authentication. This field was added to the optional fields for checking enrollment and validation. See Optional Fields for
- Updated Content in the Testing Section about the ECI Raw Value
- Updated the wording describing the ECI raw values for test cases 2.6, 2.7, 2.8, and 2.9 to note to point out that unlike the other test scenarios in this section, those tests do not return an ECI raw value. See Test Case 2.6: Authentication Not Available on Lookup.
- Updated Use Case Example Payloads
- Updated the payload code samples to eliminate the use of the fieldclientReferenceInformation.codefield in the use cases since this is not a required field and does not need to be in the example code.
- Updated Test Card Data
- Updated card type values for mada and JCB J/Secure cards and verified and updated some test card numbers used in test cases. See Test Cases for 3-D Secure 2.x
24.04
- Corrected Test Case Card Number
- For Test Case 2.5: Rejected Frictionless Authentication by the Issurer, the test card numbers for Mastercard 2.2.0 and Mastercard (mada) were updated. See Test Case 2.5: Rejected Frictionless Authentication.
- Added list of HTTP Status Codes
- Added a list of HTTP status codes to the testing section. For more information, see HTTP Status Codes.
- Added use cases for setup and enrollment check with tokens.
- Updated the use cases to include using tokens during payer authentication. For more information, see Use Case: Collecting Device Data Collection Using Stored Payment Credential (TMS Token) and Use Case: Checking Enrollment When Using a TMS Token.
- Added Support for Test cases for mada
- Updated the test cases for the 3-D Secure 2.x section to include test results for the mada card. For more information, see Test Cases for 3-D Secure 2.x.
- Highlighted API fields specific to Meeza card usage
- Added API fields to the country-specific section for the setup and check enrollment use cases that are required when using the Meeza card. For more information, see Use Case: Setting Up Payer Authentication and Use Case: Checking Enrollment in Payer Authentication.
24.03
Updated the test cases to mention that the Meeza card is supported for payer authentication
as card type 067, and should be tested using Mastercard numbers. For more information, see
Test Cases for 3-D Secure 2.x.
24.02
Added a short description of the other products in the risk management portfolio that work
with payer authentication. For more information, see Introduction to Payer Authentication.
24.01
Updated the date that a Visa Secure 3-D Secure mandate that changes some conditionally
optional fields to required fields occurs. The effective date was pushed back by six months
to August 12, 2024. For more information, see Optional Fields for Checking Enrollment in
Payer Authentication.