Simulate assisted 3DS authentication - Biometric 2FA
Simulate Assisted 3DS authentication — Biometric 2FA / Out-of-Band (OOB) allows you to emulate the behavior of an assisted 3D Secure verification process. This facilitates testing and validation of your integration’s handling of authentication flows, ensuring a smoother user experience during real-world transactions.
Prerequisites
- The partner program has already been enabled and configured for Assisted 3DS authentication — Biometric 2FA / Out-of-Band (OOB).
- The partner must subscribe to the following webhook to receive the payload containing the OTP that will need to be passed to the end-user.
| Webhook message sent by the MatchMove platform containing the authentication details based on the enabled 3DS authentication mode configured for the program. |
API Workflow
Note:
The set of endpoints below is only available and enabled in the staging environment.
These endpoints allow you to simulate Initiate Card Authentication, Resend Card Authentication, and test Assisted 3DS Authentication - Biometric 2FA before the live environment.
1
Initiate a card authentication request
The Simulate Initiate Card Authentication (POST /simulate/cards/authentication/start) will simulate an authentication request for a biometric authentication code.
This API will trigger the platform to send a CARDS.3DS.AUTHENTICATION webhook to your backend.
Request parameters:
card_id- Required. Card ID.challenge_method- Required. Verification method. Allowed value:oobtype- Required. OOB category. Allowed value:biometrics
Simulate Initiate Card Authentication request
curl --location 'https://{{cards_simulation_base_url}}/{{program_code}}/v1/simulate/cards/authentication/start' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"card_id": "{{card_id}}",
"challenge_method": "oob",
"type": "biometrics"
}'
Simulate Initiate Card Authentication response (success)
{
"message": "authentication started and oob challenge sent successfully",
"transaction_authentication_id": "45ee8cd0-9f57-4704-83d8-97c5b1a0d62a"
}
2
Resend another card authentication request
The Simulate Resend Card Authentication (POST /simulate/cards/authentication/resend) will simulate a fresh authentication request for a biometric authentication code. This process is needed when the previous authentication code has expired and is invalid for authentication.
This API will re-trigger the platform to send a CARDS.3DS.AUTHENTICATION webhook to your backend.
Request parameters:
transaction_authentication_id- Required. Transaction authentication ID received from Simulate Initiate Card Authentication response.
Simulate Resend Card Authentication request
curl --location 'https://{{cards_simulation_base_url}}/{{program_code}}/v1/simulate/cards/authentication/resend' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
"transaction_authentication_id":"45ee8cd0-9f57-4704-83d8-97c5b1a0d62a"
}'
Simulate Resend Card Authentication response
{
"message": "message resent"
}
Related Links
On this page
- Simulate assisted 3DS authentication - Biometric 2FA