💡
This topic explains the 3DS Authentication API workflow and how to integrate with the API to support the OOB authentication method:
Disclaimer: The corresponding API for 3DS is under development. In this topic, we explain how Enfuce supports the OOB authentication method.
- We receive a cardholder authentication request from the payment network, including the merchant information.
-
Enfuce sends a webhook notification, Initiate OOB Authentication Challenge, to your registered endpoint, including the following:
-
authenticationId: A unique ID assigned to the authentication request; you must send the sameauthenticationIdwhen you are returning the authentication result via the Submit Authentication Challenge Result Endpoint. -
challengeId: Enfuce-generated unique ID assigned to the specific authentication challenge method. -
cardholder.customerNumber: Unique identifier of the cardholder whom you want to authenticate.
-
-
Return a
204HTTP response within 2 seconds, if you have successfully received the notification. -
Once you have received a result of cardholder authentication, send the result via the Submit Authentication Challenge Result Endpoint.
This is a time-based request; send your request within 150 seconds of the OOB authentication request being initiated.
- We forward the authentication result to the payment network. If the cardholder is successfully authenticated, the transaction lifecycle proceeds with authorisation.

